From 5f61a09d9f960167b2f52b803f1a44579d7f396f Mon Sep 17 00:00:00 2001
From: Arpit Bruno <arpit@usebruno.com>
Date: Mon, 14 Sep 2026 18:55:28 +0530
Subject: [PATCH 01/21] chore(integrations): scaffold the integrations sub-tree

---
 integrations/README.md          |    9 +
 integrations/eslint.config.mjs  |   82 ++
 integrations/mise.toml          |    2 +
 integrations/package-lock.json  | 1583 +++++++++++++++++++++++++++++++
 integrations/package.json       |   22 +
 integrations/tsconfig.base.json |   13 +
 6 files changed, 1711 insertions(+)
 create mode 100644 integrations/README.md
 create mode 100644 integrations/eslint.config.mjs
 create mode 100644 integrations/mise.toml
 create mode 100644 integrations/package-lock.json
 create mode 100644 integrations/package.json
 create mode 100644 integrations/tsconfig.base.json

diff --git a/integrations/README.md b/integrations/README.md
new file mode 100644
index 00000000..3da4da38
--- /dev/null
+++ b/integrations/README.md
@@ -0,0 +1,9 @@
+# Bruno API Docs — framework integrations
+
+Serve a Bruno collection as API docs from inside your own app, behind your own auth.
+
+```sh
+cd integrations
+npm ci
+npm run lint
+```
diff --git a/integrations/eslint.config.mjs b/integrations/eslint.config.mjs
new file mode 100644
index 00000000..21c89160
--- /dev/null
+++ b/integrations/eslint.config.mjs
@@ -0,0 +1,82 @@
+import globals from 'globals';
+import js from '@eslint/js';
+import stylistic from '@stylistic/eslint-plugin';
+import tsPlugin from '@typescript-eslint/eslint-plugin';
+import tsParser from '@typescript-eslint/parser';
+
+// The repo's stylistic rules, minus everything browser-shaped.
+export default [
+  {
+    ignores: ['**/node_modules/**', '**/dist/**', '**/shell/shell.js']
+  },
+  {
+    plugins: {
+      '@stylistic': stylistic,
+      '@typescript-eslint': tsPlugin
+    },
+    languageOptions: {
+      parser: tsParser,
+      parserOptions: {
+        ecmaVersion: 'latest',
+        sourceType: 'module'
+      },
+      globals: {
+        ...globals.node
+      }
+    },
+    files: ['eslint.config.mjs', '**/src/**/*.ts', '**/test/**/*.{ts,mjs}'],
+    rules: {
+      ...js.configs.recommended.rules,
+      ...stylistic.configs.customize({
+        indent: 2,
+        quotes: 'single',
+        semi: true,
+        jsx: false
+      }).rules,
+      '@stylistic/comma-dangle': ['error', 'never'],
+      '@stylistic/brace-style': ['error', '1tbs', { allowSingleLine: true }],
+      '@stylistic/arrow-parens': ['error', 'always'],
+      '@stylistic/array-bracket-spacing': ['error', 'never'],
+      '@stylistic/arrow-spacing': ['error', { before: true, after: true }],
+      '@stylistic/function-call-spacing': ['error', 'never'],
+      '@stylistic/semi-style': ['error', 'last'],
+      '@stylistic/max-len': ['error', {
+        code: 120,
+        ignoreUrls: true,
+        ignoreStrings: true,
+        ignoreTemplateLiterals: true,
+        ignoreRegExpLiterals: true
+      }],
+
+      'curly': ['error', 'multi-line'],
+
+      'no-undef': 'off',
+      'no-unused-vars': 'off',
+      '@typescript-eslint/no-unused-vars': ['error', {
+        argsIgnorePattern: '^_',
+        varsIgnorePattern: '^_',
+        caughtErrorsIgnorePattern: '^_'
+      }],
+
+      '@typescript-eslint/no-explicit-any': 'warn',
+      '@typescript-eslint/consistent-type-imports': ['error', { prefer: 'type-imports' }],
+
+      'eqeqeq': ['error', 'always', { null: 'ignore' }],
+      'no-debugger': 'error',
+      'no-var': 'error',
+      'prefer-const': 'error',
+
+      'no-console': ['error', { allow: ['log', 'warn', 'error'] }]
+    }
+  },
+  {
+    files: ['**/example/**/*.{js,mjs,cjs}'],
+    languageOptions: {
+      sourceType: 'commonjs',
+      globals: { ...globals.node }
+    },
+    rules: {
+      'no-console': 'off'
+    }
+  }
+];
diff --git a/integrations/mise.toml b/integrations/mise.toml
new file mode 100644
index 00000000..6a0493c6
--- /dev/null
+++ b/integrations/mise.toml
@@ -0,0 +1,2 @@
+[tools]
+node = "22"
diff --git a/integrations/package-lock.json b/integrations/package-lock.json
new file mode 100644
index 00000000..0ad9cef9
--- /dev/null
+++ b/integrations/package-lock.json
@@ -0,0 +1,1583 @@
+{
+  "name": "bruno-api-docs-integrations",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "": {
+      "name": "bruno-api-docs-integrations",
+      "license": "MIT",
+      "workspaces": [
+        "nodejs/*"
+      ],
+      "devDependencies": {
+        "@eslint/js": "^9.39.5",
+        "@stylistic/eslint-plugin": "^5.3.1",
+        "@typescript-eslint/eslint-plugin": "^8.65.0",
+        "@typescript-eslint/parser": "^8.39.0",
+        "eslint": "^9.21.0",
+        "globals": "^16.0.0",
+        "typescript": "^5.7.0"
+      }
+    },
+    "node_modules/@eslint-community/eslint-utils": {
+      "version": "4.10.1",
+      "resolved": "https://registry.npmjs.org/@eslint-community/eslint-utils/-/eslint-utils-4.10.1.tgz",
+      "integrity": "sha512-cuadcxVFE8sDK6iWJbs8Sn0av2Nrh2QSGQhVlBW9AaAHqHwjWsZHT8LJ4hFGPh7ASBV2deFdM7H/DPjulmh8rg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "eslint-visitor-keys": "^3.4.3"
+      },
+      "engines": {
+        "node": "^12.22.0 || ^14.17.0 || >=16.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/eslint"
+      },
+      "peerDependencies": {
+        "eslint": "^6.0.0 || ^7.0.0 || >=8.0.0"
+      }
+    },
+    "node_modules/@eslint-community/eslint-utils/node_modules/eslint-visitor-keys": {
+      "version": "3.4.3",
+      "resolved": "https://registry.npmjs.org/eslint-visitor-keys/-/eslint-visitor-keys-3.4.3.tgz",
+      "integrity": "sha512-wpc+LXeiyiisxPlEkUzU6svyS1frIO3Mgxj1fdy7Pm8Ygzguax2N3Fa/D/ag1WqbOprdI+uY6wMUl8/a2G+iag==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "engines": {
+        "node": "^12.22.0 || ^14.17.0 || >=16.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/eslint"
+      }
+    },
+    "node_modules/@eslint-community/regexpp": {
+      "version": "4.12.2",
+      "resolved": "https://registry.npmjs.org/@eslint-community/regexpp/-/regexpp-4.12.2.tgz",
+      "integrity": "sha512-EriSTlt5OC9/7SXkRSCAhfSxxoSUgBm33OH+IkwbdpgoqsSsUg7y3uh+IICI/Qg4BBWr3U2i39RpmycbxMq4ew==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": "^12.0.0 || ^14.0.0 || >=16.0.0"
+      }
+    },
+    "node_modules/@eslint/config-array": {
+      "version": "0.21.2",
+      "resolved": "https://registry.npmjs.org/@eslint/config-array/-/config-array-0.21.2.tgz",
+      "integrity": "sha512-nJl2KGTlrf9GjLimgIru+V/mzgSK0ABCDQRvxw5BjURL7WfH5uoWmizbH7QB6MmnMBd8cIC9uceWnezL1VZWWw==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@eslint/object-schema": "^2.1.7",
+        "debug": "^4.3.1",
+        "minimatch": "^3.1.5"
+      },
+      "engines": {
+        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
+      }
+    },
+    "node_modules/@eslint/config-array/node_modules/balanced-match": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-1.0.2.tgz",
+      "integrity": "sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/@eslint/config-array/node_modules/brace-expansion": {
+      "version": "1.1.18",
+      "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.18.tgz",
+      "integrity": "sha512-Edep/X9fGqVNmzKBVsDYIOtD+z1tuezV70LBjdCst9Tqu76lsnvRiZ6oTic1n+/BIwX6QDGAO94PN4N2SADvtw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "balanced-match": "^1.0.0",
+        "concat-map": "0.0.1"
+      }
+    },
+    "node_modules/@eslint/config-array/node_modules/minimatch": {
+      "version": "3.1.5",
+      "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.5.tgz",
+      "integrity": "sha512-VgjWUsnnT6n+NUk6eZq77zeFdpW2LWDzP6zFGrCbHXiYNul5Dzqk2HHQ5uFH2DNW5Xbp8+jVzaeNt94ssEEl4w==",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "brace-expansion": "^1.1.7"
+      },
+      "engines": {
+        "node": "*"
+      }
+    },
+    "node_modules/@eslint/config-helpers": {
+      "version": "0.4.2",
+      "resolved": "https://registry.npmjs.org/@eslint/config-helpers/-/config-helpers-0.4.2.tgz",
+      "integrity": "sha512-gBrxN88gOIf3R7ja5K9slwNayVcZgK6SOUORm2uBzTeIEfeVaIhOpCtTox3P6R7o2jLFwLFTLnC7kU/RGcYEgw==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@eslint/core": "^0.17.0"
+      },
+      "engines": {
+        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
+      }
+    },
+    "node_modules/@eslint/core": {
+      "version": "0.17.0",
+      "resolved": "https://registry.npmjs.org/@eslint/core/-/core-0.17.0.tgz",
+      "integrity": "sha512-yL/sLrpmtDaFEiUj1osRP4TI2MDz1AddJL+jZ7KSqvBuliN4xqYY54IfdN8qD8Toa6g1iloph1fxQNkjOxrrpQ==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@types/json-schema": "^7.0.15"
+      },
+      "engines": {
+        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
+      }
+    },
+    "node_modules/@eslint/eslintrc": {
+      "version": "3.3.7",
+      "resolved": "https://registry.npmjs.org/@eslint/eslintrc/-/eslintrc-3.3.7.tgz",
+      "integrity": "sha512-F42g89Qd5oAWtp0k0nnSrjziAKza7w8SVT4mStc18LZMaRb4J1HQAHLCalEtDCxrTuksx7NU9qsmeLwpOfPqWw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "ajv": "^6.14.0",
+        "debug": "^4.3.2",
+        "espree": "^10.0.1",
+        "globals": "^14.0.0",
+        "ignore": "^5.2.0",
+        "import-fresh": "^3.2.1",
+        "js-yaml": "^4.3.2",
+        "minimatch": "^3.1.5",
+        "strip-json-comments": "^3.1.1"
+      },
+      "engines": {
+        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/eslint"
+      }
+    },
+    "node_modules/@eslint/eslintrc/node_modules/balanced-match": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-1.0.2.tgz",
+      "integrity": "sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/@eslint/eslintrc/node_modules/brace-expansion": {
+      "version": "1.1.18",
+      "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.18.tgz",
+      "integrity": "sha512-Edep/X9fGqVNmzKBVsDYIOtD+z1tuezV70LBjdCst9Tqu76lsnvRiZ6oTic1n+/BIwX6QDGAO94PN4N2SADvtw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "balanced-match": "^1.0.0",
+        "concat-map": "0.0.1"
+      }
+    },
+    "node_modules/@eslint/eslintrc/node_modules/globals": {
+      "version": "14.0.0",
+      "resolved": "https://registry.npmjs.org/globals/-/globals-14.0.0.tgz",
+      "integrity": "sha512-oahGvuMGQlPw/ivIYBjVSrWAfWLBeku5tpPE2fOPLi+WHffIWbuh2tCjhyQhTBPMf5E9jDEH4FOmTYgYwbKwtQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/@eslint/eslintrc/node_modules/ignore": {
+      "version": "5.3.2",
+      "resolved": "https://registry.npmjs.org/ignore/-/ignore-5.3.2.tgz",
+      "integrity": "sha512-hsBTNUqQTDwkWtcdYI2i06Y/nUBEsNEDJKjWdigLvegy8kDuJAS8uRlpkkcQpyEXL0Z/pjDy5HBmMjRCJ2gq+g==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 4"
+      }
+    },
+    "node_modules/@eslint/eslintrc/node_modules/minimatch": {
+      "version": "3.1.5",
+      "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.5.tgz",
+      "integrity": "sha512-VgjWUsnnT6n+NUk6eZq77zeFdpW2LWDzP6zFGrCbHXiYNul5Dzqk2HHQ5uFH2DNW5Xbp8+jVzaeNt94ssEEl4w==",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "brace-expansion": "^1.1.7"
+      },
+      "engines": {
+        "node": "*"
+      }
+    },
+    "node_modules/@eslint/js": {
+      "version": "9.39.5",
+      "resolved": "https://registry.npmjs.org/@eslint/js/-/js-9.39.5.tgz",
+      "integrity": "sha512-QywQuszQh77pIXCsq998c8hbhSTI/azTty1Z6N53dmAudKHhy573j3yvRLsX2BSp8YpLtoCEG8E9DJe+8zUh4A==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
+      },
+      "funding": {
+        "url": "https://eslint.org/donate"
+      }
+    },
+    "node_modules/@eslint/object-schema": {
+      "version": "2.1.7",
+      "resolved": "https://registry.npmjs.org/@eslint/object-schema/-/object-schema-2.1.7.tgz",
+      "integrity": "sha512-VtAOaymWVfZcmZbp6E2mympDIHvyjXs/12LqWYjVw6qjrfF+VK+fyG33kChz3nnK+SU5/NeHOqrTEHS8sXO3OA==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "engines": {
+        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
+      }
+    },
+    "node_modules/@eslint/plugin-kit": {
+      "version": "0.4.1",
+      "resolved": "https://registry.npmjs.org/@eslint/plugin-kit/-/plugin-kit-0.4.1.tgz",
+      "integrity": "sha512-43/qtrDUokr7LJqoF2c3+RInu/t4zfrpYdoSDfYyhg52rwLV6TnOvdG4fXm7IkSB3wErkcmJS9iEhjVtOSEjjA==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@eslint/core": "^0.17.0",
+        "levn": "^0.4.1"
+      },
+      "engines": {
+        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
+      }
+    },
+    "node_modules/@humanfs/core": {
+      "version": "0.19.2",
+      "resolved": "https://registry.npmjs.org/@humanfs/core/-/core-0.19.2.tgz",
+      "integrity": "sha512-UhXNm+CFMWcbChXywFwkmhqjs3PRCmcSa/hfBgLIb7oQ5HNb1wS0icWsGtSAUNgefHeI+eBrA8I1fxmbHsGdvA==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@humanfs/types": "^0.15.0"
+      },
+      "engines": {
+        "node": ">=18.18.0"
+      }
+    },
+    "node_modules/@humanfs/node": {
+      "version": "0.16.8",
+      "resolved": "https://registry.npmjs.org/@humanfs/node/-/node-0.16.8.tgz",
+      "integrity": "sha512-gE1eQNZ3R++kTzFUpdGlpmy8kDZD/MLyHqDwqjkVQI0JMdI1D51sy1H958PNXYkM2rAac7e5/CnIKZrHtPh3BQ==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@humanfs/core": "^0.19.2",
+        "@humanfs/types": "^0.15.0",
+        "@humanwhocodes/retry": "^0.4.0"
+      },
+      "engines": {
+        "node": ">=18.18.0"
+      }
+    },
+    "node_modules/@humanfs/types": {
+      "version": "0.15.0",
+      "resolved": "https://registry.npmjs.org/@humanfs/types/-/types-0.15.0.tgz",
+      "integrity": "sha512-ZZ1w0aoQkwuUuC7Yf+7sdeaNfqQiiLcSRbfI08oAxqLtpXQr9AIVX7Ay7HLDuiLYAaFPu8oBYNq/QIi9URHJ3Q==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "engines": {
+        "node": ">=18.18.0"
+      }
+    },
+    "node_modules/@humanwhocodes/module-importer": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/@humanwhocodes/module-importer/-/module-importer-1.0.1.tgz",
+      "integrity": "sha512-bxveV4V8v5Yb4ncFTT3rPSgZBOpCkjfK0y4oVVVJwIuDVBRMDXrPyXRL988i5ap9m9bnyEEjWfm5WkBmtffLfA==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "engines": {
+        "node": ">=12.22"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/nzakas"
+      }
+    },
+    "node_modules/@humanwhocodes/retry": {
+      "version": "0.4.3",
+      "resolved": "https://registry.npmjs.org/@humanwhocodes/retry/-/retry-0.4.3.tgz",
+      "integrity": "sha512-bV0Tgo9K4hfPCek+aMAn81RppFKv2ySDQeMoSZuvTASywNTnVJCArCZE2FWqpvIatKu7VMRLWlR1EazvVhDyhQ==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "engines": {
+        "node": ">=18.18"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/nzakas"
+      }
+    },
+    "node_modules/@stylistic/eslint-plugin": {
+      "version": "5.10.0",
+      "resolved": "https://registry.npmjs.org/@stylistic/eslint-plugin/-/eslint-plugin-5.10.0.tgz",
+      "integrity": "sha512-nPK52ZHvot8Ju/0A4ucSX1dcPV2/1clx0kLcH5wDmrE4naKso7TUC/voUyU1O9OTKTrR6MYip6LP0ogEMQ9jPQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@eslint-community/eslint-utils": "^4.9.1",
+        "@typescript-eslint/types": "^8.56.0",
+        "eslint-visitor-keys": "^4.2.1",
+        "espree": "^10.4.0",
+        "estraverse": "^5.3.0",
+        "picomatch": "^4.0.3"
+      },
+      "engines": {
+        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
+      },
+      "peerDependencies": {
+        "eslint": "^9.0.0 || ^10.0.0"
+      }
+    },
+    "node_modules/@types/estree": {
+      "version": "1.0.9",
+      "resolved": "https://registry.npmjs.org/@types/estree/-/estree-1.0.9.tgz",
+      "integrity": "sha512-GhdPgy1el4/ImP05X05Uw4cw2/M93BCUmnEvWZNStlCzEKME4Fkk+YpoA5OiHNQmoS7Cafb8Xa3Pya8m1Qrzeg==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/@types/json-schema": {
+      "version": "7.0.15",
+      "resolved": "https://registry.npmjs.org/@types/json-schema/-/json-schema-7.0.15.tgz",
+      "integrity": "sha512-5+fP8P8MFNC+AyZCDxrB2pkZFPGzqQWUzpSeuuVLvm8VMcorNYavBqoFcxK8bQz4Qsbn4oUEEem4wDLfcysGHA==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/@typescript-eslint/eslint-plugin": {
+      "version": "8.70.0",
+      "resolved": "https://registry.npmjs.org/@typescript-eslint/eslint-plugin/-/eslint-plugin-8.70.0.tgz",
+      "integrity": "sha512-/v8HZt6RlyIZxB3ntehELOcUcfxKPVGWXnQdJuHRmzrqgF8nQypcC/oxGW+Ot4VGKDq81XugPKxx0n5PBtf9PA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@eslint-community/regexpp": "^4.12.2",
+        "@typescript-eslint/scope-manager": "8.70.0",
+        "@typescript-eslint/type-utils": "8.70.0",
+        "@typescript-eslint/utils": "8.70.0",
+        "@typescript-eslint/visitor-keys": "8.70.0",
+        "ignore": "^7.0.5",
+        "natural-compare": "^1.4.0",
+        "ts-api-utils": "^2.5.0"
+      },
+      "engines": {
+        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/typescript-eslint"
+      },
+      "peerDependencies": {
+        "@typescript-eslint/parser": "^8.70.0",
+        "eslint": "^8.57.0 || ^9.0.0 || ^10.0.0",
+        "typescript": ">=4.8.4 <6.1.0"
+      }
+    },
+    "node_modules/@typescript-eslint/parser": {
+      "version": "8.70.0",
+      "resolved": "https://registry.npmjs.org/@typescript-eslint/parser/-/parser-8.70.0.tgz",
+      "integrity": "sha512-zYvrmj9Yxd63UGaXw+kdt6A0F0s0qveJyuatIM77bYC2DE4pgmg7a50u8LR7PRtXd0x+h+Tl3eXabGm06SWd3Q==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@typescript-eslint/scope-manager": "8.70.0",
+        "@typescript-eslint/types": "8.70.0",
+        "@typescript-eslint/typescript-estree": "8.70.0",
+        "@typescript-eslint/visitor-keys": "8.70.0",
+        "debug": "^4.4.3"
+      },
+      "engines": {
+        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/typescript-eslint"
+      },
+      "peerDependencies": {
+        "eslint": "^8.57.0 || ^9.0.0 || ^10.0.0",
+        "typescript": ">=4.8.4 <6.1.0"
+      }
+    },
+    "node_modules/@typescript-eslint/project-service": {
+      "version": "8.70.0",
+      "resolved": "https://registry.npmjs.org/@typescript-eslint/project-service/-/project-service-8.70.0.tgz",
+      "integrity": "sha512-hFHbTNqhU9G+2eKFXCBVb1tjFT/LceiJ4+HfLO4pTpDI0KHi6iajpcFFkaSQ9gXmCh7n82A0PthaayEdN6mspQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@typescript-eslint/tsconfig-utils": "^8.70.0",
+        "@typescript-eslint/types": "^8.70.0",
+        "debug": "^4.4.3"
+      },
+      "engines": {
+        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/typescript-eslint"
+      },
+      "peerDependencies": {
+        "typescript": ">=4.8.4 <6.1.0"
+      }
+    },
+    "node_modules/@typescript-eslint/scope-manager": {
+      "version": "8.70.0",
+      "resolved": "https://registry.npmjs.org/@typescript-eslint/scope-manager/-/scope-manager-8.70.0.tgz",
+      "integrity": "sha512-8nP3Kwh5hlgZ4FicGvmznAmJe8UL4sdU8tLukrPaMuQmDuk4Y8xYfzu/aYZW4xT2JCgc7H/TpDI5cGlxcWJSqQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@typescript-eslint/types": "8.70.0",
+        "@typescript-eslint/visitor-keys": "8.70.0"
+      },
+      "engines": {
+        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/typescript-eslint"
+      }
+    },
+    "node_modules/@typescript-eslint/tsconfig-utils": {
+      "version": "8.70.0",
+      "resolved": "https://registry.npmjs.org/@typescript-eslint/tsconfig-utils/-/tsconfig-utils-8.70.0.tgz",
+      "integrity": "sha512-adnkeeNq9Sq1sUf4+FRVc0KdgYghzsgFpZSQVZVvY0LCuUuN0FnQgyGzCJeC4fW1cdXseBAjU2EOqUIjbNcZUw==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/typescript-eslint"
+      },
+      "peerDependencies": {
+        "typescript": ">=4.8.4 <6.1.0"
+      }
+    },
+    "node_modules/@typescript-eslint/type-utils": {
+      "version": "8.70.0",
+      "resolved": "https://registry.npmjs.org/@typescript-eslint/type-utils/-/type-utils-8.70.0.tgz",
+      "integrity": "sha512-NUMKIhYVaVIVLnRL9CRt+VVcuLgSHUCpXn4/+K8wql+vdInUzvx8BjUO1oJ7cG9shjFJKtF8F8Hh2kCh3/KBVw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@typescript-eslint/types": "8.70.0",
+        "@typescript-eslint/typescript-estree": "8.70.0",
+        "@typescript-eslint/utils": "8.70.0",
+        "debug": "^4.4.3",
+        "ts-api-utils": "^2.5.0"
+      },
+      "engines": {
+        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/typescript-eslint"
+      },
+      "peerDependencies": {
+        "eslint": "^8.57.0 || ^9.0.0 || ^10.0.0",
+        "typescript": ">=4.8.4 <6.1.0"
+      }
+    },
+    "node_modules/@typescript-eslint/types": {
+      "version": "8.70.0",
+      "resolved": "https://registry.npmjs.org/@typescript-eslint/types/-/types-8.70.0.tgz",
+      "integrity": "sha512-asTOIYhDg4zdzOScCyaytrsV3cR6B4ecPQlXw/dJIm7J/MZTtCtfVII9JD8Geh4jTCrK/Xe6cg5UevoleMcoJQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/typescript-eslint"
+      }
+    },
+    "node_modules/@typescript-eslint/typescript-estree": {
+      "version": "8.70.0",
+      "resolved": "https://registry.npmjs.org/@typescript-eslint/typescript-estree/-/typescript-estree-8.70.0.tgz",
+      "integrity": "sha512-d9NmHMPEKQ7QCLLm1jI3zmoQBwT5KwFYjXBJ9ymZfKCUU+5rmTRykKAFvH5Qn/ZCds3CEAFS9OC9M/jkl0X2bA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@typescript-eslint/project-service": "8.70.0",
+        "@typescript-eslint/tsconfig-utils": "8.70.0",
+        "@typescript-eslint/types": "8.70.0",
+        "@typescript-eslint/visitor-keys": "8.70.0",
+        "debug": "^4.4.3",
+        "minimatch": "^10.2.2",
+        "semver": "^7.7.3",
+        "tinyglobby": "^0.2.15",
+        "ts-api-utils": "^2.5.0"
+      },
+      "engines": {
+        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/typescript-eslint"
+      },
+      "peerDependencies": {
+        "typescript": ">=4.8.4 <6.1.0"
+      }
+    },
+    "node_modules/@typescript-eslint/utils": {
+      "version": "8.70.0",
+      "resolved": "https://registry.npmjs.org/@typescript-eslint/utils/-/utils-8.70.0.tgz",
+      "integrity": "sha512-oZmtKJz/4fufZ2p3+Cn3ijEojcdfR+1zYDH2xKYrEly0dR/Q/1xUPRCOlKGxod78nWlU2UnDe09GZ3TaknBFGA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@eslint-community/eslint-utils": "^4.9.1",
+        "@typescript-eslint/scope-manager": "8.70.0",
+        "@typescript-eslint/types": "8.70.0",
+        "@typescript-eslint/typescript-estree": "8.70.0"
+      },
+      "engines": {
+        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/typescript-eslint"
+      },
+      "peerDependencies": {
+        "eslint": "^8.57.0 || ^9.0.0 || ^10.0.0",
+        "typescript": ">=4.8.4 <6.1.0"
+      }
+    },
+    "node_modules/@typescript-eslint/visitor-keys": {
+      "version": "8.70.0",
+      "resolved": "https://registry.npmjs.org/@typescript-eslint/visitor-keys/-/visitor-keys-8.70.0.tgz",
+      "integrity": "sha512-BoC8PiO4Hkdo0TVJh9Ntxr5MxPDI7/oFsrygN5ADelFSeXG/qgNuucIGA+L5Z6JpPTE/uRfcTWtscjbUaufepQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@typescript-eslint/types": "8.70.0",
+        "eslint-visitor-keys": "^5.0.0"
+      },
+      "engines": {
+        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/typescript-eslint"
+      }
+    },
+    "node_modules/@typescript-eslint/visitor-keys/node_modules/eslint-visitor-keys": {
+      "version": "5.0.1",
+      "resolved": "https://registry.npmjs.org/eslint-visitor-keys/-/eslint-visitor-keys-5.0.1.tgz",
+      "integrity": "sha512-tD40eHxA35h0PEIZNeIjkHoDR4YjjJp34biM0mDvplBe//mB+IHCqHDGV7pxF+7MklTvighcCPPZC7ynWyjdTA==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "engines": {
+        "node": "^20.19.0 || ^22.13.0 || >=24"
+      },
+      "funding": {
+        "url": "https://opencollective.com/eslint"
+      }
+    },
+    "node_modules/acorn": {
+      "version": "8.18.0",
+      "resolved": "https://registry.npmjs.org/acorn/-/acorn-8.18.0.tgz",
+      "integrity": "sha512-lGq+9yr1/GuAWaVYIHRjvvySG5/4VfKIvC8EWxStPdcDh/Ka7FG3twP6v4d5BkravUilhIAsG4Qj83t02LWUPQ==",
+      "dev": true,
+      "license": "MIT",
+      "bin": {
+        "acorn": "bin/acorn"
+      },
+      "engines": {
+        "node": ">=0.4.0"
+      }
+    },
+    "node_modules/acorn-jsx": {
+      "version": "5.3.2",
+      "resolved": "https://registry.npmjs.org/acorn-jsx/-/acorn-jsx-5.3.2.tgz",
+      "integrity": "sha512-rq9s+JNhf0IChjtDXxllJ7g41oZk5SlXtp0LHwyA5cejwn7vKmKp4pPri6YEePv2PU65sAsegbXtIinmDFDXgQ==",
+      "dev": true,
+      "license": "MIT",
+      "peerDependencies": {
+        "acorn": "^6.0.0 || ^7.0.0 || ^8.0.0"
+      }
+    },
+    "node_modules/ajv": {
+      "version": "6.15.0",
+      "resolved": "https://registry.npmjs.org/ajv/-/ajv-6.15.0.tgz",
+      "integrity": "sha512-fgFx7Hfoq60ytK2c7DhnF8jIvzYgOMxfugjLOSMHjLIPgenqa7S7oaagATUq99mV6IYvN2tRmC0wnTYX6iPbMw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "fast-deep-equal": "^3.1.1",
+        "fast-json-stable-stringify": "^2.0.0",
+        "json-schema-traverse": "^0.4.1",
+        "uri-js": "^4.2.2"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/epoberezkin"
+      }
+    },
+    "node_modules/ansi-styles": {
+      "version": "4.3.0",
+      "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz",
+      "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "color-convert": "^2.0.1"
+      },
+      "engines": {
+        "node": ">=8"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/ansi-styles?sponsor=1"
+      }
+    },
+    "node_modules/argparse": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/argparse/-/argparse-2.0.1.tgz",
+      "integrity": "sha512-8+9WqebbFzpX9OR+Wa6O29asIogeRMzcGtAINdpMHHyAg10f05aSFVBbcEqGf/PXw1EjAZ+q2/bEBg3DvurK3Q==",
+      "dev": true,
+      "license": "Python-2.0"
+    },
+    "node_modules/balanced-match": {
+      "version": "4.0.4",
+      "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-4.0.4.tgz",
+      "integrity": "sha512-BLrgEcRTwX2o6gGxGOCNyMvGSp35YofuYzw9h1IMTRmKqttAZZVU67bdb9Pr2vUHA8+j3i2tJfjO6C6+4myGTA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": "18 || 20 || >=22"
+      }
+    },
+    "node_modules/brace-expansion": {
+      "version": "5.0.9",
+      "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-5.0.9.tgz",
+      "integrity": "sha512-ScQ4IuvIEF1TMlP7Zt+vjJ//9zlPb2SDcxWxM3bk8s6t6GGdJ7KO1dCcTidOPJKePW30LE/2cT7wCyPho9/Wxg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "balanced-match": "^4.0.2"
+      },
+      "engines": {
+        "node": "20 || >=22"
+      }
+    },
+    "node_modules/callsites": {
+      "version": "3.1.0",
+      "resolved": "https://registry.npmjs.org/callsites/-/callsites-3.1.0.tgz",
+      "integrity": "sha512-P8BjAsXvZS+VIDUI11hHCQEv74YT67YUi5JJFNWIqL235sBmjX4+qx9Muvls5ivyNENctx46xQLQ3aTuE7ssaQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/chalk": {
+      "version": "4.1.2",
+      "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz",
+      "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "ansi-styles": "^4.1.0",
+        "supports-color": "^7.1.0"
+      },
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/chalk?sponsor=1"
+      }
+    },
+    "node_modules/color-convert": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz",
+      "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "color-name": "~1.1.4"
+      },
+      "engines": {
+        "node": ">=7.0.0"
+      }
+    },
+    "node_modules/color-name": {
+      "version": "1.1.4",
+      "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz",
+      "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/concat-map": {
+      "version": "0.0.1",
+      "resolved": "https://registry.npmjs.org/concat-map/-/concat-map-0.0.1.tgz",
+      "integrity": "sha512-/Srv4dswyQNBfohGpz9o6Yb3Gz3SrUDqBH5rTuhGR7ahtlbYKnVxw2bCFMRljaA7EXHaXZ8wsHdodFvbkhKmqg==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/cross-spawn": {
+      "version": "7.0.6",
+      "resolved": "https://registry.npmjs.org/cross-spawn/-/cross-spawn-7.0.6.tgz",
+      "integrity": "sha512-uV2QOWP2nWzsy2aMp8aRibhi9dlzF5Hgh5SHaB9OiTGEyDTiJJyx0uy51QXdyWbtAHNua4XJzUKca3OzKUd3vA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "path-key": "^3.1.0",
+        "shebang-command": "^2.0.0",
+        "which": "^2.0.1"
+      },
+      "engines": {
+        "node": ">= 8"
+      }
+    },
+    "node_modules/debug": {
+      "version": "4.4.3",
+      "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.3.tgz",
+      "integrity": "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "ms": "^2.1.3"
+      },
+      "engines": {
+        "node": ">=6.0"
+      },
+      "peerDependenciesMeta": {
+        "supports-color": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/deep-is": {
+      "version": "0.1.4",
+      "resolved": "https://registry.npmjs.org/deep-is/-/deep-is-0.1.4.tgz",
+      "integrity": "sha512-oIPzksmTg4/MriiaYGO+okXDT7ztn/w3Eptv/+gSIdMdKsJo0u4CfYNFJPy+4SKMuCqGw2wxnA+URMg3t8a/bQ==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/escape-string-regexp": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-4.0.0.tgz",
+      "integrity": "sha512-TtpcNJ3XAzx3Gq8sWRzJaVajRs0uVxA2YAkdb1jm2YkPz4G6egUFAyA3n5vtEIZefPk5Wa4UXbKuS5fKkJWdgA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/eslint": {
+      "version": "9.39.5",
+      "resolved": "https://registry.npmjs.org/eslint/-/eslint-9.39.5.tgz",
+      "integrity": "sha512-DgZS62aPLXKlnxILS/AYCoRvHaZeXceIzlXPkkGGzJWSow1aEk0lbTlxUSlyjC8jcaKxAdOnTDz+o1JFSBsyjw==",
+      "deprecated": "This version is no longer supported. Please see https://eslint.org/version-support for other options.",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@eslint-community/eslint-utils": "^4.8.0",
+        "@eslint-community/regexpp": "^4.12.1",
+        "@eslint/config-array": "^0.21.2",
+        "@eslint/config-helpers": "^0.4.2",
+        "@eslint/core": "^0.17.0",
+        "@eslint/eslintrc": "^3.3.6",
+        "@eslint/js": "9.39.5",
+        "@eslint/plugin-kit": "^0.4.1",
+        "@humanfs/node": "^0.16.6",
+        "@humanwhocodes/module-importer": "^1.0.1",
+        "@humanwhocodes/retry": "^0.4.2",
+        "@types/estree": "^1.0.6",
+        "ajv": "^6.14.0",
+        "chalk": "^4.0.0",
+        "cross-spawn": "^7.0.6",
+        "debug": "^4.3.2",
+        "escape-string-regexp": "^4.0.0",
+        "eslint-scope": "^8.4.0",
+        "eslint-visitor-keys": "^4.2.1",
+        "espree": "^10.4.0",
+        "esquery": "^1.5.0",
+        "esutils": "^2.0.2",
+        "fast-deep-equal": "^3.1.3",
+        "file-entry-cache": "^8.0.0",
+        "find-up": "^5.0.0",
+        "glob-parent": "^6.0.2",
+        "ignore": "^5.2.0",
+        "imurmurhash": "^0.1.4",
+        "is-glob": "^4.0.0",
+        "json-stable-stringify-without-jsonify": "^1.0.1",
+        "lodash.merge": "^4.6.2",
+        "minimatch": "^3.1.5",
+        "natural-compare": "^1.4.0",
+        "optionator": "^0.9.3"
+      },
+      "bin": {
+        "eslint": "bin/eslint.js"
+      },
+      "engines": {
+        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
+      },
+      "funding": {
+        "url": "https://eslint.org/donate"
+      },
+      "peerDependencies": {
+        "jiti": "*"
+      },
+      "peerDependenciesMeta": {
+        "jiti": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/eslint-scope": {
+      "version": "8.4.0",
+      "resolved": "https://registry.npmjs.org/eslint-scope/-/eslint-scope-8.4.0.tgz",
+      "integrity": "sha512-sNXOfKCn74rt8RICKMvJS7XKV/Xk9kA7DyJr8mJik3S7Cwgy3qlkkmyS2uQB3jiJg6VNdZd/pDBJu0nvG2NlTg==",
+      "dev": true,
+      "license": "BSD-2-Clause",
+      "dependencies": {
+        "esrecurse": "^4.3.0",
+        "estraverse": "^5.2.0"
+      },
+      "engines": {
+        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/eslint"
+      }
+    },
+    "node_modules/eslint-visitor-keys": {
+      "version": "4.2.1",
+      "resolved": "https://registry.npmjs.org/eslint-visitor-keys/-/eslint-visitor-keys-4.2.1.tgz",
+      "integrity": "sha512-Uhdk5sfqcee/9H/rCOJikYz67o0a2Tw2hGRPOG2Y1R2dg7brRe1uG0yaNQDHu+TO/uQPF/5eCapvYSmHUjt7JQ==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "engines": {
+        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/eslint"
+      }
+    },
+    "node_modules/eslint/node_modules/balanced-match": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-1.0.2.tgz",
+      "integrity": "sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/eslint/node_modules/brace-expansion": {
+      "version": "1.1.18",
+      "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.18.tgz",
+      "integrity": "sha512-Edep/X9fGqVNmzKBVsDYIOtD+z1tuezV70LBjdCst9Tqu76lsnvRiZ6oTic1n+/BIwX6QDGAO94PN4N2SADvtw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "balanced-match": "^1.0.0",
+        "concat-map": "0.0.1"
+      }
+    },
+    "node_modules/eslint/node_modules/ignore": {
+      "version": "5.3.2",
+      "resolved": "https://registry.npmjs.org/ignore/-/ignore-5.3.2.tgz",
+      "integrity": "sha512-hsBTNUqQTDwkWtcdYI2i06Y/nUBEsNEDJKjWdigLvegy8kDuJAS8uRlpkkcQpyEXL0Z/pjDy5HBmMjRCJ2gq+g==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 4"
+      }
+    },
+    "node_modules/eslint/node_modules/minimatch": {
+      "version": "3.1.5",
+      "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.5.tgz",
+      "integrity": "sha512-VgjWUsnnT6n+NUk6eZq77zeFdpW2LWDzP6zFGrCbHXiYNul5Dzqk2HHQ5uFH2DNW5Xbp8+jVzaeNt94ssEEl4w==",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "brace-expansion": "^1.1.7"
+      },
+      "engines": {
+        "node": "*"
+      }
+    },
+    "node_modules/espree": {
+      "version": "10.4.0",
+      "resolved": "https://registry.npmjs.org/espree/-/espree-10.4.0.tgz",
+      "integrity": "sha512-j6PAQ2uUr79PZhBjP5C5fhl8e39FmRnOjsD5lGnWrFU8i2G776tBK7+nP8KuQUTTyAZUwfQqXAgrVH5MbH9CYQ==",
+      "dev": true,
+      "license": "BSD-2-Clause",
+      "dependencies": {
+        "acorn": "^8.15.0",
+        "acorn-jsx": "^5.3.2",
+        "eslint-visitor-keys": "^4.2.1"
+      },
+      "engines": {
+        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/eslint"
+      }
+    },
+    "node_modules/esquery": {
+      "version": "1.7.0",
+      "resolved": "https://registry.npmjs.org/esquery/-/esquery-1.7.0.tgz",
+      "integrity": "sha512-Ap6G0WQwcU/LHsvLwON1fAQX9Zp0A2Y6Y/cJBl9r/JbW90Zyg4/zbG6zzKa2OTALELarYHmKu0GhpM5EO+7T0g==",
+      "dev": true,
+      "license": "BSD-3-Clause",
+      "dependencies": {
+        "estraverse": "^5.1.0"
+      },
+      "engines": {
+        "node": ">=0.10"
+      }
+    },
+    "node_modules/esrecurse": {
+      "version": "4.3.0",
+      "resolved": "https://registry.npmjs.org/esrecurse/-/esrecurse-4.3.0.tgz",
+      "integrity": "sha512-KmfKL3b6G+RXvP8N1vr3Tq1kL/oCFgn2NYXEtqP8/L3pKapUA4G8cFVaoF3SU323CD4XypR/ffioHmkti6/Tag==",
+      "dev": true,
+      "license": "BSD-2-Clause",
+      "dependencies": {
+        "estraverse": "^5.2.0"
+      },
+      "engines": {
+        "node": ">=4.0"
+      }
+    },
+    "node_modules/estraverse": {
+      "version": "5.3.0",
+      "resolved": "https://registry.npmjs.org/estraverse/-/estraverse-5.3.0.tgz",
+      "integrity": "sha512-MMdARuVEQziNTeJD8DgMqmhwR11BRQ/cBP+pLtYdSTnf3MIO8fFeiINEbX36ZdNlfU/7A9f3gUw49B3oQsvwBA==",
+      "dev": true,
+      "license": "BSD-2-Clause",
+      "engines": {
+        "node": ">=4.0"
+      }
+    },
+    "node_modules/esutils": {
+      "version": "2.0.3",
+      "resolved": "https://registry.npmjs.org/esutils/-/esutils-2.0.3.tgz",
+      "integrity": "sha512-kVscqXk4OCp68SZ0dkgEKVi6/8ij300KBWTJq32P/dYeWTSwK41WyTxalN1eRmA5Z9UU/LX9D7FWSmV9SAYx6g==",
+      "dev": true,
+      "license": "BSD-2-Clause",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/fast-deep-equal": {
+      "version": "3.1.3",
+      "resolved": "https://registry.npmjs.org/fast-deep-equal/-/fast-deep-equal-3.1.3.tgz",
+      "integrity": "sha512-f3qQ9oQy9j2AhBe/H9VC91wLmKBCCU/gDOnKNAYG5hswO7BLKj09Hc5HYNz9cGI++xlpDCIgDaitVs03ATR84Q==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/fast-json-stable-stringify": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/fast-json-stable-stringify/-/fast-json-stable-stringify-2.1.0.tgz",
+      "integrity": "sha512-lhd/wF+Lk98HZoTCtlVraHtfh5XYijIjalXck7saUtuanSDyLMxnHhSXEDJqHxD7msR8D0uCmqlkwjCV8xvwHw==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/fast-levenshtein": {
+      "version": "2.0.6",
+      "resolved": "https://registry.npmjs.org/fast-levenshtein/-/fast-levenshtein-2.0.6.tgz",
+      "integrity": "sha512-DCXu6Ifhqcks7TZKY3Hxp3y6qphY5SJZmrWMDrKcERSOXWQdMhU9Ig/PYrzyw/ul9jOIyh0N4M0tbC5hodg8dw==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/fdir": {
+      "version": "6.5.0",
+      "resolved": "https://registry.npmjs.org/fdir/-/fdir-6.5.0.tgz",
+      "integrity": "sha512-tIbYtZbucOs0BRGqPJkshJUYdL+SDH7dVM8gjy+ERp3WAUjLEFJE+02kanyHtwjWOnwrKYBiwAmM0p4kLJAnXg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=12.0.0"
+      },
+      "peerDependencies": {
+        "picomatch": "^3 || ^4"
+      },
+      "peerDependenciesMeta": {
+        "picomatch": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/file-entry-cache": {
+      "version": "8.0.0",
+      "resolved": "https://registry.npmjs.org/file-entry-cache/-/file-entry-cache-8.0.0.tgz",
+      "integrity": "sha512-XXTUwCvisa5oacNGRP9SfNtYBNAMi+RPwBFmblZEF7N7swHYQS6/Zfk7SRwx4D5j3CH211YNRco1DEMNVfZCnQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "flat-cache": "^4.0.0"
+      },
+      "engines": {
+        "node": ">=16.0.0"
+      }
+    },
+    "node_modules/find-up": {
+      "version": "5.0.0",
+      "resolved": "https://registry.npmjs.org/find-up/-/find-up-5.0.0.tgz",
+      "integrity": "sha512-78/PXT1wlLLDgTzDs7sjq9hzz0vXD+zn+7wypEe4fXQxCmdmqfGsEPQxmiCSQI3ajFV91bVSsvNtrJRiW6nGng==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "locate-path": "^6.0.0",
+        "path-exists": "^4.0.0"
+      },
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/flat-cache": {
+      "version": "4.0.1",
+      "resolved": "https://registry.npmjs.org/flat-cache/-/flat-cache-4.0.1.tgz",
+      "integrity": "sha512-f7ccFPK3SXFHpx15UIGyRJ/FJQctuKZ0zVuN3frBo4HnK3cay9VEW0R6yPYFHC0AgqhukPzKjq22t5DmAyqGyw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "flatted": "^3.2.9",
+        "keyv": "^4.5.4"
+      },
+      "engines": {
+        "node": ">=16"
+      }
+    },
+    "node_modules/flatted": {
+      "version": "3.4.4",
+      "resolved": "https://registry.npmjs.org/flatted/-/flatted-3.4.4.tgz",
+      "integrity": "sha512-5+ybhBZANEJxaH3X5evAFatUxLfEHSr7n6kYJ+1Qd0mUqr4eu9gIf6GDbWHf8RJijHrjjO8G+la14SlL2SeS1Q==",
+      "dev": true,
+      "license": "ISC"
+    },
+    "node_modules/glob-parent": {
+      "version": "6.0.2",
+      "resolved": "https://registry.npmjs.org/glob-parent/-/glob-parent-6.0.2.tgz",
+      "integrity": "sha512-XxwI8EOhVQgWp6iDL+3b0r86f4d6AX6zSU55HfB4ydCEuXLXc5FcYeOu+nnGftS4TEju/11rt4KJPTMgbfmv4A==",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "is-glob": "^4.0.3"
+      },
+      "engines": {
+        "node": ">=10.13.0"
+      }
+    },
+    "node_modules/globals": {
+      "version": "16.5.0",
+      "resolved": "https://registry.npmjs.org/globals/-/globals-16.5.0.tgz",
+      "integrity": "sha512-c/c15i26VrJ4IRt5Z89DnIzCGDn9EcebibhAOjw5ibqEHsE1wLUgkPn9RDmNcUKyU87GeaL633nyJ+pplFR2ZQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/has-flag": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz",
+      "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/ignore": {
+      "version": "7.0.9",
+      "resolved": "https://registry.npmjs.org/ignore/-/ignore-7.0.9.tgz",
+      "integrity": "sha512-brTTsvFRt5C1gGHtPst/281UjPD5t9fBqbgoMPlVWy11ZLTPfu7HxK4ZYqO9H7o/yC9rSTCI85EaQ4OoY12qYw==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 4"
+      }
+    },
+    "node_modules/import-fresh": {
+      "version": "3.3.1",
+      "resolved": "https://registry.npmjs.org/import-fresh/-/import-fresh-3.3.1.tgz",
+      "integrity": "sha512-TR3KfrTZTYLPB6jUjfx6MF9WcWrHL9su5TObK4ZkYgBdWKPOFoSoQIdEuTuR82pmtxH2spWG9h6etwfr1pLBqQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "parent-module": "^1.0.0",
+        "resolve-from": "^4.0.0"
+      },
+      "engines": {
+        "node": ">=6"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/imurmurhash": {
+      "version": "0.1.4",
+      "resolved": "https://registry.npmjs.org/imurmurhash/-/imurmurhash-0.1.4.tgz",
+      "integrity": "sha512-JmXMZ6wuvDmLiHEml9ykzqO6lwFbof0GG4IkcGaENdCRDDmMVnny7s5HsIgHCbaq0w2MyPhDqkhTUgS2LU2PHA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.8.19"
+      }
+    },
+    "node_modules/is-extglob": {
+      "version": "2.1.1",
+      "resolved": "https://registry.npmjs.org/is-extglob/-/is-extglob-2.1.1.tgz",
+      "integrity": "sha512-SbKbANkN603Vi4jEZv49LeVJMn4yGwsbzZworEoyEiutsN3nJYdbO36zfhGJ6QEDpOZIFkDtnq5JRxmvl3jsoQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/is-glob": {
+      "version": "4.0.3",
+      "resolved": "https://registry.npmjs.org/is-glob/-/is-glob-4.0.3.tgz",
+      "integrity": "sha512-xelSayHH36ZgE7ZWhli7pW34hNbNl8Ojv5KVmkJD4hBdD3th8Tfk9vYasLM+mXWOZhFkgZfxhLSnrwRr4elSSg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "is-extglob": "^2.1.1"
+      },
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/isexe": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/isexe/-/isexe-2.0.0.tgz",
+      "integrity": "sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw==",
+      "dev": true,
+      "license": "ISC"
+    },
+    "node_modules/js-yaml": {
+      "version": "4.3.2",
+      "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-4.3.2.tgz",
+      "integrity": "sha512-SFNOvSJ+Dgf/9An904Yx+CgSlIPCkIpao4qo51lpee25TIRejdH3rhR4EZMGoNx3/TP3O+wzWuiTFl4sqbltzA==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/puzrin"
+        },
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/nodeca"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "argparse": "^2.0.1"
+      },
+      "bin": {
+        "js-yaml": "bin/js-yaml.js"
+      }
+    },
+    "node_modules/json-buffer": {
+      "version": "3.0.1",
+      "resolved": "https://registry.npmjs.org/json-buffer/-/json-buffer-3.0.1.tgz",
+      "integrity": "sha512-4bV5BfR2mqfQTJm+V5tPPdf+ZpuhiIvTuAB5g8kcrXOZpTT/QwwVRWBywX1ozr6lEuPdbHxwaJlm9G6mI2sfSQ==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/json-schema-traverse": {
+      "version": "0.4.1",
+      "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-0.4.1.tgz",
+      "integrity": "sha512-xbbCH5dCYU5T8LcEhhuh7HJ88HXuW3qsI3Y0zOZFKfZEHcpWiHU/Jxzk629Brsab/mMiHQti9wMP+845RPe3Vg==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/json-stable-stringify-without-jsonify": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/json-stable-stringify-without-jsonify/-/json-stable-stringify-without-jsonify-1.0.1.tgz",
+      "integrity": "sha512-Bdboy+l7tA3OGW6FjyFHWkP5LuByj1Tk33Ljyq0axyzdk9//JSi2u3fP1QSmd1KNwq6VOKYGlAu87CisVir6Pw==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/keyv": {
+      "version": "4.5.4",
+      "resolved": "https://registry.npmjs.org/keyv/-/keyv-4.5.4.tgz",
+      "integrity": "sha512-oxVHkHR/EJf2CNXnWxRLW6mg7JyCCUcG0DtEGmL2ctUo1PNTin1PUil+r/+4r5MpVgC/fn1kjsx7mjSujKqIpw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "json-buffer": "3.0.1"
+      }
+    },
+    "node_modules/levn": {
+      "version": "0.4.1",
+      "resolved": "https://registry.npmjs.org/levn/-/levn-0.4.1.tgz",
+      "integrity": "sha512-+bT2uH4E5LGE7h/n3evcS/sQlJXCpIp6ym8OWJ5eV6+67Dsql/LaaT7qJBAt2rzfoa/5QBGBhxDix1dMt2kQKQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "prelude-ls": "^1.2.1",
+        "type-check": "~0.4.0"
+      },
+      "engines": {
+        "node": ">= 0.8.0"
+      }
+    },
+    "node_modules/locate-path": {
+      "version": "6.0.0",
+      "resolved": "https://registry.npmjs.org/locate-path/-/locate-path-6.0.0.tgz",
+      "integrity": "sha512-iPZK6eYjbxRu3uB4/WZ3EsEIMJFMqAoopl3R+zuq0UjcAm/MO6KCweDgPfP3elTztoKP3KtnVHxTn2NHBSDVUw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "p-locate": "^5.0.0"
+      },
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/lodash.merge": {
+      "version": "4.6.2",
+      "resolved": "https://registry.npmjs.org/lodash.merge/-/lodash.merge-4.6.2.tgz",
+      "integrity": "sha512-0KpjqXRVvrYyCsX1swR/XTK0va6VQkQM6MNo7PqW77ByjAhoARA8EfrP1N4+KlKj8YS0ZUCtRT/YUuhyYDujIQ==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/minimatch": {
+      "version": "10.2.6",
+      "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-10.2.6.tgz",
+      "integrity": "sha512-vpLQEs+VLCr1nU0BXS07maYoFwlDAH0gngQuuttxIwutDFEMHq2blX+8vpgxDdK3J1PwjCJiep77OitTZ4Ll1A==",
+      "dev": true,
+      "license": "BlueOak-1.0.0",
+      "dependencies": {
+        "brace-expansion": "^5.0.8"
+      },
+      "engines": {
+        "node": "18 || 20 || >=22"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/isaacs"
+      }
+    },
+    "node_modules/ms": {
+      "version": "2.1.3",
+      "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz",
+      "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/natural-compare": {
+      "version": "1.4.0",
+      "resolved": "https://registry.npmjs.org/natural-compare/-/natural-compare-1.4.0.tgz",
+      "integrity": "sha512-OWND8ei3VtNC9h7V60qff3SVobHr996CTwgxubgyQYEpg290h9J0buyECNNJexkFm5sOajh5G116RYA1c8ZMSw==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/optionator": {
+      "version": "0.9.4",
+      "resolved": "https://registry.npmjs.org/optionator/-/optionator-0.9.4.tgz",
+      "integrity": "sha512-6IpQ7mKUxRcZNLIObR0hz7lxsapSSIYNZJwXPGeF0mTVqGKFIXj1DQcMoT22S3ROcLyY/rz0PWaWZ9ayWmad9g==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "deep-is": "^0.1.3",
+        "fast-levenshtein": "^2.0.6",
+        "levn": "^0.4.1",
+        "prelude-ls": "^1.2.1",
+        "type-check": "^0.4.0",
+        "word-wrap": "^1.2.5"
+      },
+      "engines": {
+        "node": ">= 0.8.0"
+      }
+    },
+    "node_modules/p-limit": {
+      "version": "3.1.0",
+      "resolved": "https://registry.npmjs.org/p-limit/-/p-limit-3.1.0.tgz",
+      "integrity": "sha512-TYOanM3wGwNGsZN2cVTYPArw454xnXj5qmWF1bEoAc4+cU/ol7GVh7odevjp1FNHduHc3KZMcFduxU5Xc6uJRQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "yocto-queue": "^0.1.0"
+      },
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/p-locate": {
+      "version": "5.0.0",
+      "resolved": "https://registry.npmjs.org/p-locate/-/p-locate-5.0.0.tgz",
+      "integrity": "sha512-LaNjtRWUBY++zB5nE/NwcaoMylSPk+S+ZHNB1TzdbMJMny6dynpAGt7X/tl/QYq3TIeE6nxHppbo2LGymrG5Pw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "p-limit": "^3.0.2"
+      },
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/parent-module": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/parent-module/-/parent-module-1.0.1.tgz",
+      "integrity": "sha512-GQ2EWRpQV8/o+Aw8YqtfZZPfNRWZYkbidE9k5rpl/hC3vtHHBfGm2Ifi6qWV+coDGkrUKZAxE3Lot5kcsRlh+g==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "callsites": "^3.0.0"
+      },
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/path-exists": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/path-exists/-/path-exists-4.0.0.tgz",
+      "integrity": "sha512-ak9Qy5Q7jYb2Wwcey5Fpvg2KoAc/ZIhLSLOSBmRmygPsGwkVVt0fZa0qrtMz+m6tJTAHfZQ8FnmB4MG4LWy7/w==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/path-key": {
+      "version": "3.1.1",
+      "resolved": "https://registry.npmjs.org/path-key/-/path-key-3.1.1.tgz",
+      "integrity": "sha512-ojmeN0qd+y0jszEtoY48r0Peq5dwMEkIlCOu6Q5f41lfkswXuKtYrhgoTpLnyIcHm24Uhqx+5Tqm2InSwLhE6Q==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/picomatch": {
+      "version": "4.0.7",
+      "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-4.0.7.tgz",
+      "integrity": "sha512-qcJu88Q2IWqJsDD529JKMdwGm/dvInW4HvQnRwiH9JtihJvzGOscDtHE3x1pBKeUOTysQ8kVmLnJ2kJu7yhcGA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/jonschlinkert"
+      }
+    },
+    "node_modules/prelude-ls": {
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/prelude-ls/-/prelude-ls-1.2.1.tgz",
+      "integrity": "sha512-vkcDPrRZo1QZLbn5RLGPpg/WmIQ65qoWWhcGKf/b5eplkkarX0m9z8ppCat4mlOqUsWpyNuYgO3VRyrYHSzX5g==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.8.0"
+      }
+    },
+    "node_modules/punycode": {
+      "version": "2.3.1",
+      "resolved": "https://registry.npmjs.org/punycode/-/punycode-2.3.1.tgz",
+      "integrity": "sha512-vYt7UD1U9Wg6138shLtLOvdAu+8DsC/ilFtEVHcH+wydcSpNE20AfSOduf6MkRFahL5FY7X1oU7nKVZFtfq8Fg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/resolve-from": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/resolve-from/-/resolve-from-4.0.0.tgz",
+      "integrity": "sha512-pb/MYmXstAkysRFx8piNI1tGFNQIFA3vkE3Gq4EuA1dF6gHp/+vgZqsCGJapvy8N3Q+4o7FwvquPJcnZ7RYy4g==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/semver": {
+      "version": "7.8.5",
+      "resolved": "https://registry.npmjs.org/semver/-/semver-7.8.5.tgz",
+      "integrity": "sha512-Y7/KDsb8LjooZpwaqGyulO6DQlksgCncchHGk+sZIY4SBvUocMBEFH5Ur1fI4dV+Jvl0w6cjvucaIi40puRioA==",
+      "dev": true,
+      "license": "ISC",
+      "bin": {
+        "semver": "bin/semver.js"
+      },
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/shebang-command": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/shebang-command/-/shebang-command-2.0.0.tgz",
+      "integrity": "sha512-kHxr2zZpYtdmrN1qDjrrX/Z1rR1kG8Dx+gkpK1G4eXmvXswmcE1hTWBWYUzlraYw1/yZp6YuDY77YtvbN0dmDA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "shebang-regex": "^3.0.0"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/shebang-regex": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/shebang-regex/-/shebang-regex-3.0.0.tgz",
+      "integrity": "sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/strip-json-comments": {
+      "version": "3.1.1",
+      "resolved": "https://registry.npmjs.org/strip-json-comments/-/strip-json-comments-3.1.1.tgz",
+      "integrity": "sha512-6fPc+R4ihwqP6N/aIv2f1gMH8lOVtWQHoqC4yK6oSDVVocumAsfCqjkXnqiYMhmMwS/mEHLp7Vehlt3ql6lEig==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/supports-color": {
+      "version": "7.2.0",
+      "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz",
+      "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "has-flag": "^4.0.0"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/tinyglobby": {
+      "version": "0.2.17",
+      "resolved": "https://registry.npmjs.org/tinyglobby/-/tinyglobby-0.2.17.tgz",
+      "integrity": "sha512-wXR/dYpcqKmfWpEdZjiKJOwCNFndD0DMnrW/cYjVGttEkBfVgcLFHoNrlj47mjOVic9yyNu65alsgF4NQyTa2g==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "fdir": "^6.5.0",
+        "picomatch": "^4.0.4"
+      },
+      "engines": {
+        "node": ">=12.0.0"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/SuperchupuDev"
+      }
+    },
+    "node_modules/ts-api-utils": {
+      "version": "2.5.0",
+      "resolved": "https://registry.npmjs.org/ts-api-utils/-/ts-api-utils-2.5.0.tgz",
+      "integrity": "sha512-OJ/ibxhPlqrMM0UiNHJ/0CKQkoKF243/AEmplt3qpRgkW8VG7IfOS41h7V8TjITqdByHzrjcS/2si+y4lIh8NA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=18.12"
+      },
+      "peerDependencies": {
+        "typescript": ">=4.8.4"
+      }
+    },
+    "node_modules/type-check": {
+      "version": "0.4.0",
+      "resolved": "https://registry.npmjs.org/type-check/-/type-check-0.4.0.tgz",
+      "integrity": "sha512-XleUoc9uwGXqjWwXaUTZAmzMcFZ5858QA2vvx1Ur5xIcixXIP+8LnFDgRplU30us6teqdlskFfu+ae4K79Ooew==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "prelude-ls": "^1.2.1"
+      },
+      "engines": {
+        "node": ">= 0.8.0"
+      }
+    },
+    "node_modules/typescript": {
+      "version": "5.9.3",
+      "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.9.3.tgz",
+      "integrity": "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "bin": {
+        "tsc": "bin/tsc",
+        "tsserver": "bin/tsserver"
+      },
+      "engines": {
+        "node": ">=14.17"
+      }
+    },
+    "node_modules/uri-js": {
+      "version": "4.4.1",
+      "resolved": "https://registry.npmjs.org/uri-js/-/uri-js-4.4.1.tgz",
+      "integrity": "sha512-7rKUyy33Q1yc98pQ1DAmLtwX109F7TIfWlW1Ydo8Wl1ii1SeHieeh0HHfPeL2fMXK6z0s8ecKs9frCuLJvndBg==",
+      "dev": true,
+      "license": "BSD-2-Clause",
+      "dependencies": {
+        "punycode": "^2.1.0"
+      }
+    },
+    "node_modules/which": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/which/-/which-2.0.2.tgz",
+      "integrity": "sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA==",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "isexe": "^2.0.0"
+      },
+      "bin": {
+        "node-which": "bin/node-which"
+      },
+      "engines": {
+        "node": ">= 8"
+      }
+    },
+    "node_modules/word-wrap": {
+      "version": "1.2.5",
+      "resolved": "https://registry.npmjs.org/word-wrap/-/word-wrap-1.2.5.tgz",
+      "integrity": "sha512-BN22B5eaMMI9UMtjrGd5g5eCYPpCPDUy0FJXbYsaT5zYxjFOckS53SQDE3pWkVoWpHXVb3BrYcEN4Twa55B5cA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/yocto-queue": {
+      "version": "0.1.0",
+      "resolved": "https://registry.npmjs.org/yocto-queue/-/yocto-queue-0.1.0.tgz",
+      "integrity": "sha512-rVksvsnNCdJ/ohGc6xgPwyN8eheCxsiLM8mxuE/t/mOVqJewPuO1miLpTHQiRgTKCLexL4MeAFVagts7HmNZ2Q==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    }
+  }
+}
diff --git a/integrations/package.json b/integrations/package.json
new file mode 100644
index 00000000..0e21347e
--- /dev/null
+++ b/integrations/package.json
@@ -0,0 +1,22 @@
+{
+  "name": "bruno-api-docs-integrations",
+  "private": true,
+  "description": "Serve a Bruno collection as API docs from inside your own app, behind your own auth.",
+  "license": "MIT",
+  "workspaces": [
+    "nodejs/*"
+  ],
+  "scripts": {
+    "lint": "eslint",
+    "lint:fix": "eslint --fix"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.5",
+    "@stylistic/eslint-plugin": "^5.3.1",
+    "@typescript-eslint/eslint-plugin": "^8.65.0",
+    "@typescript-eslint/parser": "^8.39.0",
+    "eslint": "^9.21.0",
+    "globals": "^16.0.0",
+    "typescript": "^5.7.0"
+  }
+}
diff --git a/integrations/tsconfig.base.json b/integrations/tsconfig.base.json
new file mode 100644
index 00000000..604bdf01
--- /dev/null
+++ b/integrations/tsconfig.base.json
@@ -0,0 +1,13 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "CommonJS",
+    "moduleResolution": "Node",
+    "strict": true,
+    "esModuleInterop": true,
+    "declaration": true,
+    "sourceMap": false,
+    "skipLibCheck": true,
+    "types": ["node"]
+  }
+}

From 68b22c459a772d07c540fa3b7d77f4d442143c87 Mon Sep 17 00:00:00 2001
From: Arpit Bruno <arpit@usebruno.com>
Date: Mon, 14 Sep 2026 22:03:54 +0530
Subject: [PATCH 02/21]  node core options, types and the hardened collection
 walk

---
 .../fixtures/walk-oversize/big.yml            |   3 +
 .../fixtures/walk-oversize/opencollection.yml |   4 +
 .../walk-safety/.github/workflows/deploy.yml  |   4 +
 .../fixtures/walk-safety/control/not-utf8.yml |   2 +
 .../fixtures/walk-safety/control/ping.yml     |   7 ++
 .../walk-safety/environments/Local.yml        |   6 +
 .../fixtures/walk-safety/opencollection.yml   |   4 +
 .../fixtures/walk-safety/secret.yml           |   1 +
 .../fixtures/walk-safety/temp.yml~            |   2 +
 integrations/nodejs/core/package.json         |  17 +++
 .../nodejs/core/src/collection/walk.ts        | 111 ++++++++++++++++++
 integrations/nodejs/core/src/options.ts       |  47 ++++++++
 integrations/nodejs/core/test/walk.test.mjs   |  41 +++++++
 integrations/nodejs/core/tsconfig.json        |   8 ++
 integrations/package-lock.json                |  30 +++++
 integrations/package.json                     |   5 +-
 16 files changed, 291 insertions(+), 1 deletion(-)
 create mode 100644 integrations/contract-tests/fixtures/walk-oversize/big.yml
 create mode 100644 integrations/contract-tests/fixtures/walk-oversize/opencollection.yml
 create mode 100644 integrations/contract-tests/fixtures/walk-safety/.github/workflows/deploy.yml
 create mode 100644 integrations/contract-tests/fixtures/walk-safety/control/not-utf8.yml
 create mode 100644 integrations/contract-tests/fixtures/walk-safety/control/ping.yml
 create mode 100644 integrations/contract-tests/fixtures/walk-safety/environments/Local.yml
 create mode 100644 integrations/contract-tests/fixtures/walk-safety/opencollection.yml
 create mode 120000 integrations/contract-tests/fixtures/walk-safety/secret.yml
 create mode 100644 integrations/contract-tests/fixtures/walk-safety/temp.yml~
 create mode 100644 integrations/nodejs/core/package.json
 create mode 100644 integrations/nodejs/core/src/collection/walk.ts
 create mode 100644 integrations/nodejs/core/src/options.ts
 create mode 100644 integrations/nodejs/core/test/walk.test.mjs
 create mode 100644 integrations/nodejs/core/tsconfig.json

diff --git a/integrations/contract-tests/fixtures/walk-oversize/big.yml b/integrations/contract-tests/fixtures/walk-oversize/big.yml
new file mode 100644
index 00000000..7dc42b66
--- /dev/null
+++ b/integrations/contract-tests/fixtures/walk-oversize/big.yml
@@ -0,0 +1,3 @@
+info:
+  name: big
+################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################################
\ No newline at end of file
diff --git a/integrations/contract-tests/fixtures/walk-oversize/opencollection.yml b/integrations/contract-tests/fixtures/walk-oversize/opencollection.yml
new file mode 100644
index 00000000..a4809616
--- /dev/null
+++ b/integrations/contract-tests/fixtures/walk-oversize/opencollection.yml
@@ -0,0 +1,4 @@
+opencollection: 1.0.0
+info:
+  name: Hostile Fixture
+bundled: false
diff --git a/integrations/contract-tests/fixtures/walk-safety/.github/workflows/deploy.yml b/integrations/contract-tests/fixtures/walk-safety/.github/workflows/deploy.yml
new file mode 100644
index 00000000..5503c449
--- /dev/null
+++ b/integrations/contract-tests/fixtures/walk-safety/.github/workflows/deploy.yml
@@ -0,0 +1,4 @@
+name: deploy
+on: push
+env:
+  DEPLOY_SECRET: leaked-if-served
diff --git a/integrations/contract-tests/fixtures/walk-safety/control/not-utf8.yml b/integrations/contract-tests/fixtures/walk-safety/control/not-utf8.yml
new file mode 100644
index 00000000..0a214b3b
--- /dev/null
+++ b/integrations/contract-tests/fixtures/walk-safety/control/not-utf8.yml
@@ -0,0 +1,2 @@
+info:
+  name: bad encoding ��
diff --git a/integrations/contract-tests/fixtures/walk-safety/control/ping.yml b/integrations/contract-tests/fixtures/walk-safety/control/ping.yml
new file mode 100644
index 00000000..9ba66522
--- /dev/null
+++ b/integrations/contract-tests/fixtures/walk-safety/control/ping.yml
@@ -0,0 +1,7 @@
+info:
+  name: ping
+  type: http
+  seq: 1
+http:
+  method: GET
+  url: "{{baseUrl}}/ping"
diff --git a/integrations/contract-tests/fixtures/walk-safety/environments/Local.yml b/integrations/contract-tests/fixtures/walk-safety/environments/Local.yml
new file mode 100644
index 00000000..aec24b90
--- /dev/null
+++ b/integrations/contract-tests/fixtures/walk-safety/environments/Local.yml
@@ -0,0 +1,6 @@
+name: Local
+variables:
+  - name: baseUrl
+    value: http://localhost:9999
+  - name: apiKey
+    value: fake-key-should-not-leak-in-endstate
diff --git a/integrations/contract-tests/fixtures/walk-safety/opencollection.yml b/integrations/contract-tests/fixtures/walk-safety/opencollection.yml
new file mode 100644
index 00000000..a4809616
--- /dev/null
+++ b/integrations/contract-tests/fixtures/walk-safety/opencollection.yml
@@ -0,0 +1,4 @@
+opencollection: 1.0.0
+info:
+  name: Hostile Fixture
+bundled: false
diff --git a/integrations/contract-tests/fixtures/walk-safety/secret.yml b/integrations/contract-tests/fixtures/walk-safety/secret.yml
new file mode 120000
index 00000000..3594e94c
--- /dev/null
+++ b/integrations/contract-tests/fixtures/walk-safety/secret.yml
@@ -0,0 +1 @@
+/etc/passwd
\ No newline at end of file
diff --git a/integrations/contract-tests/fixtures/walk-safety/temp.yml~ b/integrations/contract-tests/fixtures/walk-safety/temp.yml~
new file mode 100644
index 00000000..97915215
--- /dev/null
+++ b/integrations/contract-tests/fixtures/walk-safety/temp.yml~
@@ -0,0 +1,2 @@
+info:
+  name: stray editor file
diff --git a/integrations/nodejs/core/package.json b/integrations/nodejs/core/package.json
new file mode 100644
index 00000000..8371f5c1
--- /dev/null
+++ b/integrations/nodejs/core/package.json
@@ -0,0 +1,17 @@
+{
+  "name": "@usebruno/api-docs-core",
+  "version": "0.1.0-beta.1",
+  "private": true,
+  "description": "Bruno API Docs core for Node: serves a Bruno collection's docs from inside your own app. Framework wrappers are one line over this.",
+  "license": "MIT",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "shell/shell.html",
+    "shell/shell.js"
+  ],
+  "engines": {
+    "node": ">=20"
+  }
+}
diff --git a/integrations/nodejs/core/src/collection/walk.ts b/integrations/nodejs/core/src/collection/walk.ts
new file mode 100644
index 00000000..2084338f
--- /dev/null
+++ b/integrations/nodejs/core/src/collection/walk.ts
@@ -0,0 +1,111 @@
+import fs from 'node:fs';
+import path from 'node:path';
+
+export interface WalkedFile {
+  path: string;
+  text: string;
+}
+
+export interface SkippedFile {
+  path: string;
+  rule: string;
+}
+
+export interface WalkResult {
+  files: WalkedFile[];
+  skipped: SkippedFile[];
+}
+
+export const CAPS = Object.freeze({
+  fileBytes: 1024 * 1024,
+  totalBytes: 5 * 1024 * 1024,
+  fileCount: 5000,
+  depth: 32
+});
+
+const STRAY_SUFFIXES = ['~', '.swp', '.swo', '.bak', '.orig', '.rej', '.tmp'];
+
+export class CapError extends Error {
+  constructor(cap: string, relPath: string) {
+    super(`collection exceeds ${cap} at: ${relPath}`);
+  }
+}
+
+const isStray = (name: string): boolean =>
+  name.startsWith('.')
+  || name === 'node_modules'
+  || STRAY_SUFFIXES.some((suffix) => name.endsWith(suffix))
+  || (name.startsWith('#') && name.endsWith('#'));
+
+const isYaml = (name: string): boolean => name.endsWith('.yml') || name.endsWith('.yaml');
+
+const utf8Strict = new TextDecoder('utf-8', { fatal: true });
+
+export function walkCollection(rootDir: string): WalkResult {
+  const rootReal = fs.realpathSync(rootDir);
+  const files: WalkedFile[] = [];
+  const skipped: SkippedFile[] = [];
+  let totalBytes = 0;
+
+  const isInsideRoot = (absPath: string): boolean => {
+    const real = fs.realpathSync(absPath);
+    return real === rootReal || real.startsWith(rootReal + path.sep);
+  };
+
+  const visit = (dir: string, rel: string, depth: number): void => {
+    if (depth > CAPS.depth) throw new CapError('max directory depth', rel);
+
+    // sorted so every language core serves the same bytes and the same ETag
+    const entries = fs.readdirSync(dir, { withFileTypes: true }).sort((a, b) => a.name.localeCompare(b.name));
+
+    for (const entry of entries) {
+      const name = entry.name;
+      const relPath = rel ? `${rel}/${name}` : name;
+      const absPath = path.join(dir, name);
+
+      if (isStray(name)) {
+        skipped.push({ path: relPath, rule: 'stray/dot/ignored name' });
+        continue;
+      }
+      if (entry.isSymbolicLink()) {
+        skipped.push({ path: relPath, rule: 'symlink (never followed)' });
+        continue;
+      }
+      if (entry.isDirectory()) {
+        visit(absPath, relPath, depth + 1);
+        continue;
+      }
+      if (!entry.isFile()) {
+        skipped.push({ path: relPath, rule: 'not a regular file' });
+        continue;
+      }
+      if (!isYaml(name)) {
+        skipped.push({ path: relPath, rule: 'not .yml' });
+        continue;
+      }
+      if (!isInsideRoot(absPath)) {
+        skipped.push({ path: relPath, rule: 'resolves outside collection root' });
+        continue;
+      }
+
+      const size = fs.statSync(absPath).size;
+      if (size > CAPS.fileBytes) throw new CapError('per-file size cap (1MB)', relPath);
+      totalBytes += size;
+      if (totalBytes > CAPS.totalBytes) throw new CapError('total size cap (5MB)', relPath);
+      if (files.length >= CAPS.fileCount) throw new CapError('file count cap', relPath);
+
+      let text: string;
+      try {
+        text = utf8Strict.decode(fs.readFileSync(absPath));
+      } catch {
+        skipped.push({ path: relPath, rule: 'not valid UTF-8' });
+        continue;
+      }
+
+      files.push({ path: relPath, text });
+    }
+  };
+
+  visit(rootReal, '', 0);
+  return { files, skipped };
+}
diff --git a/integrations/nodejs/core/src/options.ts b/integrations/nodejs/core/src/options.ts
new file mode 100644
index 00000000..6dae5a76
--- /dev/null
+++ b/integrations/nodejs/core/src/options.ts
@@ -0,0 +1,47 @@
+export interface EnvironmentsOption {
+  all?: true;
+  include?: string[];
+  exclude?: string[];
+}
+
+export interface TagsOption {
+  include?: string[];
+  exclude?: string[];
+}
+
+export interface CollectionOptions {
+  /** A collection directory or one bundled .yml. Relative to the app's entry file, not the cwd. */
+  collection: string;
+  /** Environments to publish. Absent means none, as in the app and the CLI. Directory mode only. */
+  environments?: EnvironmentsOption;
+  tags?: TagsOption;
+}
+
+export interface RendererOptions {
+  theme?: 'light' | 'dark';
+  pageTitle?: string;
+  logo?: string;
+  gitCollectionUrl?: string;
+}
+
+export interface ApiDocsOptions extends CollectionOptions, RendererOptions {}
+
+export class ConfigError extends Error {}
+
+export function validateOptions(options: CollectionOptions): void {
+  if (!options.collection) {
+    throw new ConfigError('apiDocs: `collection` is required');
+  }
+
+  const env = options.environments;
+  if (!env) return;
+
+  const hasInclude = Boolean(env.include?.length);
+  const hasExclude = Boolean(env.exclude?.length);
+  if (env.all && hasInclude) {
+    throw new ConfigError('apiDocs: `environments.all` and `environments.include` cannot be combined');
+  }
+  if (!env.all && !hasInclude && hasExclude) {
+    throw new ConfigError('apiDocs: `environments.exclude` needs a base: set `all: true` or an `include` list');
+  }
+}
diff --git a/integrations/nodejs/core/test/walk.test.mjs b/integrations/nodejs/core/test/walk.test.mjs
new file mode 100644
index 00000000..87cd4d0f
--- /dev/null
+++ b/integrations/nodejs/core/test/walk.test.mjs
@@ -0,0 +1,41 @@
+// The walk is the security surface. Every language port must produce these
+// exact outcomes on the two fixtures. Run: npm run test:walk
+import { fileURLToPath } from 'node:url';
+import path from 'node:path';
+import assert from 'node:assert/strict';
+import { createRequire } from 'node:module';
+
+const here = path.dirname(fileURLToPath(import.meta.url));
+const require = createRequire(import.meta.url);
+const { walkCollection, CapError } = require(path.join(here, '..', 'dist', 'collection', 'walk.js'));
+const fixture = (name) => path.join(here, '..', '..', '..', 'contract-tests', 'fixtures', name);
+
+// --- walk-safety: symlink to /etc/passwd, dotfiles, editor strays, non-yml, nested dirs
+{
+  const { files, skipped } = walkCollection(fixture('walk-safety'));
+  const served = files.map((f) => f.path);
+
+  assert.ok(served.includes('opencollection.yml'), 'manifest is served');
+  assert.ok(!served.some((p) => p.endsWith('secret.yml')), 'symlink target is never served');
+  assert.ok(skipped.some((s) => s.path === 'secret.yml' && /symlink/.test(s.rule)), 'symlink is skipped as a symlink, not as some other kind of file');
+  assert.ok(!served.some((p) => p.startsWith('.') || p.includes('/.')), 'no dotfiles');
+  assert.ok(!served.some((p) => /(~|\.swp|\.bak|\.orig)$/.test(p)), 'no editor strays');
+  assert.ok(served.every((p) => /\.ya?ml$/.test(p)), 'only yml served');
+  for (const f of files) assert.ok(!f.text.includes('root:x:0:0'), '/etc/passwd content never served');
+  assert.ok(skipped.some((s) => s.path === 'control/not-utf8.yml' && /UTF-8/.test(s.rule)), 'invalid UTF-8 file is skipped, not served');
+  assert.deepEqual(served, ['control/ping.yml', 'environments/Local.yml', 'opencollection.yml'], 'exactly these files, in this order');
+  console.log(`walk-safety: ${served.length} served, ${skipped.length} skipped`);
+  for (const s of skipped) console.log(`  skipped ${s.path} (${s.rule})`);
+}
+
+// --- walk-oversize: a single file above the 1 MB cap -> CapError, nothing served
+{
+  assert.throws(() => walkCollection(fixture('walk-oversize')), (err) => {
+    assert.ok(err instanceof CapError, 'throws CapError');
+    assert.match(err.message, /per-file size cap/);
+    return true;
+  });
+  console.log('walk-oversize: CapError raised before reading the file');
+}
+
+console.log('walk-test: all assertions passed');
diff --git a/integrations/nodejs/core/tsconfig.json b/integrations/nodejs/core/tsconfig.json
new file mode 100644
index 00000000..5285d28a
--- /dev/null
+++ b/integrations/nodejs/core/tsconfig.json
@@ -0,0 +1,8 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "rootDir": "src",
+    "outDir": "dist"
+  },
+  "include": ["src"]
+}
diff --git a/integrations/package-lock.json b/integrations/package-lock.json
index 0ad9cef9..f4630088 100644
--- a/integrations/package-lock.json
+++ b/integrations/package-lock.json
@@ -12,6 +12,7 @@
       "devDependencies": {
         "@eslint/js": "^9.39.5",
         "@stylistic/eslint-plugin": "^5.3.1",
+        "@types/node": "^22.10.0",
         "@typescript-eslint/eslint-plugin": "^8.65.0",
         "@typescript-eslint/parser": "^8.39.0",
         "eslint": "^9.21.0",
@@ -349,6 +350,16 @@
       "dev": true,
       "license": "MIT"
     },
+    "node_modules/@types/node": {
+      "version": "22.20.2",
+      "resolved": "https://registry.npmjs.org/@types/node/-/node-22.20.2.tgz",
+      "integrity": "sha512-xlvWf4Vs9n1PEVYwP1n4vvG07M6y8WgvJ2t0vbrWTmijsIHp1cS+uJ2kMIRdY3nHZK0nCYKrPeD171+SzF4/zw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "undici-types": "~6.21.0"
+      }
+    },
     "node_modules/@typescript-eslint/eslint-plugin": {
       "version": "8.70.0",
       "resolved": "https://registry.npmjs.org/@typescript-eslint/eslint-plugin/-/eslint-plugin-8.70.0.tgz",
@@ -582,6 +593,10 @@
         "url": "https://opencollective.com/eslint"
       }
     },
+    "node_modules/@usebruno/api-docs-core": {
+      "resolved": "nodejs/core",
+      "link": true
+    },
     "node_modules/acorn": {
       "version": "8.18.0",
       "resolved": "https://registry.npmjs.org/acorn/-/acorn-8.18.0.tgz",
@@ -1530,6 +1545,13 @@
         "node": ">=14.17"
       }
     },
+    "node_modules/undici-types": {
+      "version": "6.21.0",
+      "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-6.21.0.tgz",
+      "integrity": "sha512-iwDZqg0QAGrg9Rav5H4n0M64c3mkR59cJ6wQp+7C4nI0gsmExaedaYLNO44eT4AtBBwjbTiGPMlt2Md0T9H9JQ==",
+      "dev": true,
+      "license": "MIT"
+    },
     "node_modules/uri-js": {
       "version": "4.4.1",
       "resolved": "https://registry.npmjs.org/uri-js/-/uri-js-4.4.1.tgz",
@@ -1578,6 +1600,14 @@
       "funding": {
         "url": "https://github.com/sponsors/sindresorhus"
       }
+    },
+    "nodejs/core": {
+      "name": "@usebruno/api-docs-core",
+      "version": "0.1.0-beta.1",
+      "license": "MIT",
+      "engines": {
+        "node": ">=20"
+      }
     }
   }
 }
diff --git a/integrations/package.json b/integrations/package.json
index 0e21347e..ac8df7fb 100644
--- a/integrations/package.json
+++ b/integrations/package.json
@@ -7,12 +7,15 @@
     "nodejs/*"
   ],
   "scripts": {
+    "build:core": "tsc -p nodejs/core/tsconfig.json",
     "lint": "eslint",
-    "lint:fix": "eslint --fix"
+    "lint:fix": "eslint --fix",
+    "test:walk": "npm run build:core && node nodejs/core/test/walk.test.mjs"
   },
   "devDependencies": {
     "@eslint/js": "^9.39.5",
     "@stylistic/eslint-plugin": "^5.3.1",
+    "@types/node": "^22.10.0",
     "@typescript-eslint/eslint-plugin": "^8.65.0",
     "@typescript-eslint/parser": "^8.39.0",
     "eslint": "^9.21.0",

From b516c2b3bf6e3d1dcf1cf4c58e50ed353babcef7 Mon Sep 17 00:00:00 2001
From: Arpit Bruno <arpit@usebruno.com>
Date: Mon, 14 Sep 2026 23:11:38 +0530
Subject: [PATCH 03/21] collection filters: environments by name, requests by
 tag

---
 integrations/nodejs/core/package.json         |   3 +
 .../nodejs/core/src/collection/filter.ts      | 157 ++++++++++++++++++
 integrations/nodejs/core/test/filter.test.mjs | 115 +++++++++++++
 integrations/package-lock.json                |  13 +-
 integrations/package.json                     |   2 +
 5 files changed, 288 insertions(+), 2 deletions(-)
 create mode 100644 integrations/nodejs/core/src/collection/filter.ts
 create mode 100644 integrations/nodejs/core/test/filter.test.mjs

diff --git a/integrations/nodejs/core/package.json b/integrations/nodejs/core/package.json
index 8371f5c1..c419eaaa 100644
--- a/integrations/nodejs/core/package.json
+++ b/integrations/nodejs/core/package.json
@@ -13,5 +13,8 @@
   ],
   "engines": {
     "node": ">=20"
+  },
+  "dependencies": {
+    "js-yaml": "^4.1.0"
   }
 }
diff --git a/integrations/nodejs/core/src/collection/filter.ts b/integrations/nodejs/core/src/collection/filter.ts
new file mode 100644
index 00000000..f3fee319
--- /dev/null
+++ b/integrations/nodejs/core/src/collection/filter.ts
@@ -0,0 +1,157 @@
+import yaml from 'js-yaml';
+import { ConfigError, type CollectionOptions, type EnvironmentsOption, type TagsOption } from '../options';
+import type { WalkedFile, SkippedFile } from './walk';
+
+interface FilterStage {
+  files: WalkedFile[];
+  skipped: SkippedFile[];
+}
+
+export interface FilterResult extends FilterStage {
+  unknownEnvironments: string[];
+}
+
+/** The reason this file is not published, or `null` to publish it. */
+type SkipReason = (file: WalkedFile) => string | null;
+
+const MANIFEST_FILE = /^opencollection\.ya?ml$/;
+const ROOT_ENV_FILE = /^environments\/[^/]+\.ya?ml$/;
+const ENV_DIR = /(^|\/)environments\//;
+const FOLDER_FILE = /(^|\/)folder\.ya?ml$/;
+
+export const isManifest = (p: string): boolean => MANIFEST_FILE.test(p);
+
+const isRequestFile = (p: string): boolean => !isManifest(p) && !FOLDER_FILE.test(p) && !ENV_DIR.test(p);
+
+const safeLoad = (text: string): Record<string, unknown> | null => {
+  try {
+    const doc = yaml.load(text);
+    return doc && typeof doc === 'object' ? (doc as Record<string, unknown>) : null;
+  } catch {
+    return null;
+  }
+};
+
+export function environmentName(text: string): string | null {
+  const doc = safeLoad(text);
+  if (!doc || typeof doc.name !== 'string') return null;
+
+  return doc.name;
+}
+
+/** `null` means the tags could not be read, which is not the same as carrying none. */
+export function requestTags(text: string): string[] | null {
+  const doc = safeLoad(text);
+  if (!doc) return null;
+
+  const info = doc.info as Record<string, unknown> | undefined;
+  const tags = info?.tags;
+  if (tags === undefined || tags === null) return [];
+  if (!Array.isArray(tags) || !tags.every((tag) => typeof tag === 'string')) return null;
+
+  return tags as string[];
+}
+
+/** Ported from bruno-common so the docs hide exactly what the app and the CLI hide. */
+export function isRequestTagsIncluded(tags: string[], includeTags: string[], excludeTags: string[]): boolean {
+  const shouldInclude = includeTags.length === 0 || tags.some((tag) => includeTags.includes(tag));
+  const shouldExclude = excludeTags.length > 0 && tags.some((tag) => excludeTags.includes(tag));
+
+  return shouldInclude && !shouldExclude;
+}
+
+function partitionFiles(files: WalkedFile[], skipReason: SkipReason): FilterStage {
+  const kept: WalkedFile[] = [];
+  const skipped: SkippedFile[] = [];
+
+  for (const file of files) {
+    const rule = skipReason(file);
+    if (rule === null) {
+      kept.push(file);
+    } else {
+      skipped.push({ path: file.path, rule });
+    }
+  }
+
+  return { files: kept, skipped };
+}
+
+export function applyFilters(files: WalkedFile[], filters: Omit<CollectionOptions, 'collection'>): FilterResult {
+  const environments = filterEnvironments(files, filters.environments);
+  const tags = filterTags(environments.files, filters.tags);
+
+  return {
+    files: tags.files,
+    skipped: [...environments.skipped, ...tags.skipped],
+    unknownEnvironments: environments.unknownEnvironments
+  };
+}
+
+function filterEnvironments(files: WalkedFile[], option: EnvironmentsOption | undefined): FilterResult {
+  const publishAll = option?.all === true;
+  const include = new Set(option?.include ?? []);
+  const exclude = new Set(option?.exclude ?? []);
+  const seen = new Set<string>();
+
+  const environments = partitionFiles(files, (file) => {
+    if (!ROOT_ENV_FILE.test(file.path)) {
+      if (ENV_DIR.test(file.path)) return 'nested environments directory';
+      return null;
+    }
+
+    // dropping unread is what keeps the server from parsing any YAML unless a filter is configured
+    if (!option) return 'environments not published by default';
+
+    const name = environmentName(file.text);
+    if (name === null) return 'environment file without a name';
+    seen.add(name);
+
+    if (!publishAll && !include.has(name)) return 'environment not included';
+    if (exclude.has(name)) return 'environment excluded';
+
+    return null;
+  });
+
+  const missing = [...include].filter((name) => !seen.has(name));
+  if (missing.length > 0) {
+    throw new ConfigError(`apiDocs: environments.include names not found in the collection: ${missing.join(', ')}`);
+  }
+
+  return { ...environments, unknownEnvironments: [...exclude].filter((name) => !seen.has(name)) };
+}
+
+function filterTags(files: WalkedFile[], option: TagsOption | undefined): FilterStage {
+  const includeTags = option?.include ?? [];
+  const excludeTags = option?.exclude ?? [];
+  if (includeTags.length === 0 && excludeTags.length === 0) {
+    return { files, skipped: [] };
+  }
+
+  const requests = partitionFiles(files, (file) => {
+    if (!isRequestFile(file.path)) return null;
+
+    const tags = requestTags(file.text);
+    // fail closed: a request we cannot read the tags of might be one the filter was meant to hide
+    if (tags === null) return 'request file unreadable while filtering by tags';
+    if (!isRequestTagsIncluded(tags, includeTags, excludeTags)) return 'request excluded by tags';
+
+    return null;
+  });
+
+  const survivingPaths = requests.files.filter((file) => isRequestFile(file.path)).map((file) => file.path);
+  const hasRequestBelow = (folderPath: string): boolean => {
+    // the trailing slash is load bearing: 'admin/' must not match 'admin2/ping.yml'
+    const dir = folderPath.slice(0, folderPath.lastIndexOf('/') + 1);
+
+    return survivingPaths.some((p) => p.startsWith(dir));
+  };
+
+  const folders = partitionFiles(requests.files, (file) => {
+    if (!FOLDER_FILE.test(file.path)) return null;
+    if (hasRequestBelow(file.path)) return null;
+
+    return 'folder with no surviving request';
+  });
+
+  return { files: folders.files, skipped: [...requests.skipped, ...folders.skipped] };
+}
diff --git a/integrations/nodejs/core/test/filter.test.mjs b/integrations/nodejs/core/test/filter.test.mjs
new file mode 100644
index 00000000..195db80e
--- /dev/null
+++ b/integrations/nodejs/core/test/filter.test.mjs
@@ -0,0 +1,115 @@
+// Which files leave the server. The environments table mirrors the CLI's resolveEnvironments,
+// the tags predicate is bruno-common's. Run: npm run test:filter
+import { fileURLToPath } from 'node:url';
+import path from 'node:path';
+import assert from 'node:assert/strict';
+import { createRequire } from 'node:module';
+
+const here = path.dirname(fileURLToPath(import.meta.url));
+const require = createRequire(import.meta.url);
+const { applyFilters, isManifest, environmentName, requestTags, isRequestTagsIncluded } = require(path.join(here, '..', 'dist', 'collection', 'filter.js'));
+const { ConfigError, validateOptions } = require(path.join(here, '..', 'dist', 'options.js'));
+
+const file = (p, text) => ({ path: p, text });
+const request = (name, tags) => `info:\n  name: ${name}\n${tags ? `  tags:\n${tags.map((t) => `    - ${t}\n`).join('')}` : ''}`;
+
+const collection = [
+  file('opencollection.yml', 'opencollection: 1.0.0\n'),
+  file('environments/Local.yml', 'name: Local\nvariables: []\n'),
+  file('environments/Prod.yml', 'name: Prod\nvariables: []\n'),
+  file('control/folder.yml', request('control')),
+  file('control/ping.yml', request('ping')),
+  file('control/health.yml', request('health', ['internal'])),
+  file('control/environments/Sneaky.yml', 'name: Sneaky\n'),
+  file('admin/folder.yml', request('admin')),
+  file('admin/purge.yml', request('purge', ['internal'])),
+  file('admin2/folder.yml', request('admin2')),
+  file('admin2/hello.yml', request('hello2')),
+  file('public/folder.yml', request('public')),
+  file('public/hello.yml', request('hello')),
+  file('control/broken.yml', 'info:\n  tags: [unclosed\n'),
+  file('control/numeric-tags.yml', 'info:\n  name: numeric\n  tags:\n    - 1\n')
+];
+
+const served = (filters) => applyFilters(collection, filters).files.map((f) => f.path).sort();
+const envs = (filters) => served(filters).filter((p) => p.startsWith('environments/'));
+const ruleFor = (filters, p) => applyFilters(collection, filters).skipped.find((s) => s.path === p)?.rule;
+
+// --- environments: the table
+assert.deepEqual(envs({}), [], 'absent -> none');
+assert.deepEqual(envs({ environments: { include: ['Local'] } }), ['environments/Local.yml'], 'include -> those');
+assert.deepEqual(envs({ environments: { all: true } }), ['environments/Local.yml', 'environments/Prod.yml'], 'all -> all');
+assert.deepEqual(envs({ environments: { all: true, exclude: ['Prod'] } }), ['environments/Local.yml'], 'all minus exclude');
+assert.deepEqual(envs({ environments: { include: ['Local', 'Prod'], exclude: ['Prod'] } }), ['environments/Local.yml'], 'include minus exclude');
+
+assert.throws(() => served({ environments: { include: ['Nope'] } }), ConfigError, 'unknown include is a startup error');
+assert.deepEqual(applyFilters(collection, { environments: { all: true, exclude: ['Nope'] } }).unknownEnvironments, ['Nope'], 'unknown exclude warns, does not throw');
+
+assert.equal(ruleFor({ environments: { all: true } }, 'control/environments/Sneaky.yml'), 'nested environments directory', 'a nested environments dir is never published');
+assert.equal(ruleFor({}, 'environments/Local.yml'), 'environments not published by default');
+
+// --- tags: whole request files, folders pruned behind them
+assert.deepEqual(served({}).filter((p) => p.startsWith('control/') || p.startsWith('admin/')), [
+  'control/broken.yml', 'control/folder.yml', 'control/health.yml', 'control/numeric-tags.yml', 'control/ping.yml',
+  'admin/folder.yml', 'admin/purge.yml'
+].sort(), 'no tags option -> every request ships, nothing is parsed');
+
+{
+  const kept = served({ tags: { exclude: ['internal'] } });
+  assert.ok(!kept.includes('control/health.yml') && !kept.includes('admin/purge.yml'), 'exclude drops the tagged requests');
+  assert.ok(kept.includes('control/ping.yml'), 'the untagged sibling stays');
+  assert.ok(kept.includes('control/folder.yml'), 'its folder stays, a request survived below it');
+  assert.ok(!kept.includes('admin/folder.yml'), 'a folder whose only request went is pruned');
+  assert.ok(kept.includes('opencollection.yml'), 'the manifest always ships');
+}
+
+{
+  const kept = served({ tags: { include: ['internal'] } });
+  assert.deepEqual(kept.filter((p) => !p.endsWith('folder.yml') && p !== 'opencollection.yml'), ['admin/purge.yml', 'control/health.yml'], 'include keeps exactly the tagged requests');
+  assert.ok(!kept.includes('public/folder.yml'), 'the untagged folder is pruned');
+}
+
+assert.deepEqual(served({ tags: { include: ['internal'], exclude: ['internal'] } }).filter((p) => !p.endsWith('folder.yml') && p !== 'opencollection.yml'), [], 'exclude wins over include');
+
+// --- fail closed: a request whose tags cannot be read is not published while a filter is set
+for (const unreadable of ['control/broken.yml', 'control/numeric-tags.yml']) {
+  assert.ok(served({}).includes(unreadable), `${unreadable} ships when no tag filter is set`);
+  assert.ok(!served({ tags: { exclude: ['internal'] } }).includes(unreadable), `${unreadable} is dropped rather than guessed at`);
+}
+assert.deepEqual(requestTags('info:\n  name: x\n'), [], 'no tags key means no tags, not unreadable');
+assert.equal(requestTags('['), null, 'malformed yaml is unreadable');
+
+assert.equal(environmentName('name: Local\nvariables: []\n'), 'Local', 'the name field is what an environment is matched on');
+assert.equal(environmentName('variables: []\n'), null, 'no name field, no match');
+assert.equal(environmentName('name: 7\n'), null, 'a non-string name is not a name');
+assert.equal(environmentName('['), null, 'malformed yaml is not a name');
+
+// --- both filters at once, which is what a real mount configures
+{
+  const kept = served({ environments: { include: ['Local'] }, tags: { exclude: ['internal'] } });
+  assert.deepEqual(kept.filter((p) => p.startsWith('environments/')), ['environments/Local.yml'], 'the environment filter still applies');
+  assert.ok(!kept.includes('control/health.yml'), 'and the tag filter still applies');
+}
+
+// --- the manifest is not a request, whichever extension it uses
+for (const name of ['opencollection.yml', 'opencollection.yaml']) {
+  const only = [{ path: name, text: 'opencollection: 1.0.0\ninfo:\n  name: X\n' }];
+  assert.ok(isManifest(name), `${name} is the manifest`);
+  assert.deepEqual(applyFilters(only, { tags: { include: ['public'] } }).files.map((f) => f.path), [name], `${name} survives a tag include filter`);
+}
+assert.equal(isManifest('control/opencollection.yml'), false, 'only at the root');
+
+// --- the predicate itself, as bruno-common defines it
+assert.equal(isRequestTagsIncluded([], [], []), true, 'no filter, no tags');
+assert.equal(isRequestTagsIncluded([], ['a'], []), false, 'include set, request has none');
+assert.equal(isRequestTagsIncluded(['a'], ['a', 'b'], []), true, 'any one include tag is enough');
+assert.equal(isRequestTagsIncluded(['a', 'b'], [], ['b']), false, 'any one exclude tag is fatal');
+
+// --- startup validation of the same options
+assert.throws(() => validateOptions({ collection: './c', environments: { exclude: ['Prod'] } }), /needs a base/);
+assert.throws(() => validateOptions({ collection: './c', environments: { all: true, include: ['Local'] } }), /cannot be combined/);
+assert.throws(() => validateOptions({}), /`collection` is required/);
+validateOptions({ collection: './c' });
+validateOptions({ collection: './c', environments: { all: true, exclude: ['Prod'] } });
+
+console.log('filter-test: all assertions passed');
diff --git a/integrations/package-lock.json b/integrations/package-lock.json
index f4630088..90032027 100644
--- a/integrations/package-lock.json
+++ b/integrations/package-lock.json
@@ -12,6 +12,7 @@
       "devDependencies": {
         "@eslint/js": "^9.39.5",
         "@stylistic/eslint-plugin": "^5.3.1",
+        "@types/js-yaml": "^4.0.9",
         "@types/node": "^22.10.0",
         "@typescript-eslint/eslint-plugin": "^8.65.0",
         "@typescript-eslint/parser": "^8.39.0",
@@ -343,6 +344,13 @@
       "dev": true,
       "license": "MIT"
     },
+    "node_modules/@types/js-yaml": {
+      "version": "4.0.9",
+      "resolved": "https://registry.npmjs.org/@types/js-yaml/-/js-yaml-4.0.9.tgz",
+      "integrity": "sha512-k4MGaQl5TGo/iipqb2UDG2UwjXziSWkh0uysQelTlJpX1qGlpUZYm8PnO4DxG1qBomtJUdYJ6qR6xdIah10JLg==",
+      "dev": true,
+      "license": "MIT"
+    },
     "node_modules/@types/json-schema": {
       "version": "7.0.15",
       "resolved": "https://registry.npmjs.org/@types/json-schema/-/json-schema-7.0.15.tgz",
@@ -657,7 +665,6 @@
       "version": "2.0.1",
       "resolved": "https://registry.npmjs.org/argparse/-/argparse-2.0.1.tgz",
       "integrity": "sha512-8+9WqebbFzpX9OR+Wa6O29asIogeRMzcGtAINdpMHHyAg10f05aSFVBbcEqGf/PXw1EjAZ+q2/bEBg3DvurK3Q==",
-      "dev": true,
       "license": "Python-2.0"
     },
     "node_modules/balanced-match": {
@@ -1183,7 +1190,6 @@
       "version": "4.3.2",
       "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-4.3.2.tgz",
       "integrity": "sha512-SFNOvSJ+Dgf/9An904Yx+CgSlIPCkIpao4qo51lpee25TIRejdH3rhR4EZMGoNx3/TP3O+wzWuiTFl4sqbltzA==",
-      "dev": true,
       "funding": [
         {
           "type": "github",
@@ -1605,6 +1611,9 @@
       "name": "@usebruno/api-docs-core",
       "version": "0.1.0-beta.1",
       "license": "MIT",
+      "dependencies": {
+        "js-yaml": "^4.1.0"
+      },
       "engines": {
         "node": ">=20"
       }
diff --git a/integrations/package.json b/integrations/package.json
index ac8df7fb..35d47c87 100644
--- a/integrations/package.json
+++ b/integrations/package.json
@@ -10,11 +10,13 @@
     "build:core": "tsc -p nodejs/core/tsconfig.json",
     "lint": "eslint",
     "lint:fix": "eslint --fix",
+    "test:filter": "npm run build:core && node nodejs/core/test/filter.test.mjs",
     "test:walk": "npm run build:core && node nodejs/core/test/walk.test.mjs"
   },
   "devDependencies": {
     "@eslint/js": "^9.39.5",
     "@stylistic/eslint-plugin": "^5.3.1",
+    "@types/js-yaml": "^4.0.9",
     "@types/node": "^22.10.0",
     "@typescript-eslint/eslint-plugin": "^8.65.0",
     "@typescript-eslint/parser": "^8.39.0",

From c50ce91fa5f97be92d4703fa3274699200df956e Mon Sep 17 00:00:00 2001
From: Arpit Bruno <arpit@usebruno.com>
Date: Mon, 14 Sep 2026 23:47:06 +0530
Subject: [PATCH 04/21] resolve the source, build once, serve from memory

---
 .../nodejs/core/src/collection/filter.ts      |  11 +-
 .../nodejs/core/src/collection/index.ts       |  58 +++++++
 .../nodejs/core/src/collection/providers.ts   |  83 +++++++++
 .../nodejs/core/src/collection/source.ts      |  41 +++++
 .../nodejs/core/src/collection/yaml.ts        |  11 ++
 integrations/nodejs/core/src/http.ts          |   9 +
 .../nodejs/core/test/collection.test.mjs      | 164 ++++++++++++++++++
 integrations/package.json                     |   1 +
 8 files changed, 368 insertions(+), 10 deletions(-)
 create mode 100644 integrations/nodejs/core/src/collection/index.ts
 create mode 100644 integrations/nodejs/core/src/collection/providers.ts
 create mode 100644 integrations/nodejs/core/src/collection/source.ts
 create mode 100644 integrations/nodejs/core/src/collection/yaml.ts
 create mode 100644 integrations/nodejs/core/src/http.ts
 create mode 100644 integrations/nodejs/core/test/collection.test.mjs

diff --git a/integrations/nodejs/core/src/collection/filter.ts b/integrations/nodejs/core/src/collection/filter.ts
index f3fee319..d805b677 100644
--- a/integrations/nodejs/core/src/collection/filter.ts
+++ b/integrations/nodejs/core/src/collection/filter.ts
@@ -1,6 +1,6 @@
-import yaml from 'js-yaml';
 import { ConfigError, type CollectionOptions, type EnvironmentsOption, type TagsOption } from '../options';
 import type { WalkedFile, SkippedFile } from './walk';
+import { safeLoad } from './yaml';
 
 interface FilterStage {
   files: WalkedFile[];
@@ -23,15 +23,6 @@ export const isManifest = (p: string): boolean => MANIFEST_FILE.test(p);
 
 const isRequestFile = (p: string): boolean => !isManifest(p) && !FOLDER_FILE.test(p) && !ENV_DIR.test(p);
 
-const safeLoad = (text: string): Record<string, unknown> | null => {
-  try {
-    const doc = yaml.load(text);
-    return doc && typeof doc === 'object' ? (doc as Record<string, unknown>) : null;
-  } catch {
-    return null;
-  }
-};
-
 export function environmentName(text: string): string | null {
   const doc = safeLoad(text);
   if (!doc || typeof doc.name !== 'string') return null;
diff --git a/integrations/nodejs/core/src/collection/index.ts b/integrations/nodejs/core/src/collection/index.ts
new file mode 100644
index 00000000..9e648d2d
--- /dev/null
+++ b/integrations/nodejs/core/src/collection/index.ts
@@ -0,0 +1,58 @@
+// The collection layer's one entry point: where the document comes from is decided here, at startup.
+
+import { ConfigError, type CollectionOptions } from '../options';
+import type { SkippedFile } from './walk';
+import { resolveCollectionSource } from './source';
+import { fileProvider, dirProvider, type Provider, type BuiltProvider } from './providers';
+
+const log = {
+  info: (line: string) => console.log(`[bruno-docs] ${line}`),
+  warn: (line: string) => console.warn(`[bruno-docs] ${line}`)
+};
+
+export function providerFor(options: CollectionOptions): Provider {
+  const source = resolveCollectionSource(options.collection);
+  const filters = { environments: options.environments, tags: options.tags };
+
+  if (source.mode === 'file' && (filters.environments || filters.tags)) {
+    throw new ConfigError('apiDocs: `environments` / `tags` filtering needs a collection directory');
+  }
+
+  const built = source.mode === 'file' ? fileProvider(source.path) : dirProvider(source.path, filters);
+  report(source.path, built);
+
+  return built.serve;
+}
+
+/**
+ * Grouped by rule, because a collection folder with forty strays would otherwise print forty
+ * lines. A group of one still shows its path, which is the case that matters: one unreadable file.
+ */
+function report(sourcePath: string, built: BuiltProvider): void {
+  log.info(`serving ${built.fileCount} files from ${sourcePath}`);
+
+  for (const [rule, paths] of groupByRule(built.skipped)) {
+    const shown = paths.slice(0, 3).join(', ');
+    const more = paths.length > 3 ? `, and ${paths.length - 3} more` : '';
+    log.info(`  ${paths.length} skipped (${rule}): ${shown}${more}`);
+  }
+
+  for (const name of built.unknownEnvironments) {
+    log.warn(`environments.exclude: no environment named "${name}"`);
+  }
+}
+
+function groupByRule(skipped: SkippedFile[]): Map<string, string[]> {
+  const groups = new Map<string, string[]>();
+
+  for (const file of skipped) {
+    const paths = groups.get(file.rule);
+    if (paths) {
+      paths.push(file.path);
+    } else {
+      groups.set(file.rule, [file.path]);
+    }
+  }
+
+  return groups;
+}
diff --git a/integrations/nodejs/core/src/collection/providers.ts b/integrations/nodejs/core/src/collection/providers.ts
new file mode 100644
index 00000000..655616aa
--- /dev/null
+++ b/integrations/nodejs/core/src/collection/providers.ts
@@ -0,0 +1,83 @@
+import fs from 'node:fs';
+import crypto from 'node:crypto';
+import { ConfigError, type CollectionOptions } from '../options';
+import type { HttpResponse, Conditional } from '../http';
+import type { SkippedFile } from './walk';
+import { walkCollection, CAPS, CapError } from './walk';
+import { applyFilters, isManifest } from './filter';
+
+export type Provider = (conditional: Conditional) => HttpResponse;
+
+export interface BuiltProvider {
+  serve: Provider;
+  fileCount: number;
+  skipped: SkippedFile[];
+  unknownEnvironments: string[];
+}
+
+export class ManifestError extends Error {}
+
+export const etagOf = (data: string | Buffer): string =>
+  '"' + crypto.createHash('sha256').update(data).digest('hex').slice(0, 32) + '"';
+
+const DOCUMENT_HEADERS: Record<string, string> = {
+  'Cache-Control': 'private, no-store',
+  'X-Content-Type-Options': 'nosniff'
+};
+
+const NOT_MODIFIED: HttpResponse = { status: 304, headers: {}, body: null };
+
+const errorResponse = (status: number, message: string): HttpResponse => ({
+  status,
+  headers: { 'Content-Type': 'text/plain; charset=utf-8' },
+  body: message + '\n'
+});
+
+/** The document is built once, so serving it is an ETag comparison and nothing else. */
+function serveFromMemory(body: string | Buffer, contentType: string): Provider {
+  const etag = etagOf(body);
+  const headers = { ...DOCUMENT_HEADERS, 'Content-Type': contentType, 'ETag': etag };
+
+  return ({ ifNoneMatch }) => {
+    if (ifNoneMatch === etag) return NOT_MODIFIED;
+    return { status: 200, headers, body };
+  };
+}
+
+export function fileProvider(filePath: string): BuiltProvider {
+  const size = fs.statSync(filePath).size;
+  if (size > CAPS.totalBytes) throw new CapError('total size cap (5MB)', filePath);
+
+  const body = fs.readFileSync(filePath);
+
+  return { serve: serveFromMemory(body, 'text/yaml; charset=utf-8'), fileCount: 1, skipped: [], unknownEnvironments: [] };
+}
+
+export function dirProvider(rootDir: string, filters: Omit<CollectionOptions, 'collection'>): BuiltProvider {
+  const walked = walkCollection(rootDir);
+  if (!walked.files.some((file) => isManifest(file.path))) {
+    throw new ManifestError('no opencollection.yml manifest at the collection root');
+  }
+
+  const filtered = applyFilters(walked.files, filters);
+  const envelope: Record<string, string> = {};
+  for (const file of filtered.files) envelope[file.path] = file.text;
+  const body = JSON.stringify({ 'opencollection-fragments': '1', 'files': envelope });
+
+  return {
+    serve: serveFromMemory(body, 'application/json; charset=utf-8'),
+    fileCount: filtered.files.length,
+    skipped: [...walked.skipped, ...filtered.skipped],
+    unknownEnvironments: filtered.unknownEnvironments
+  };
+}
+
+/** What the mount serves when the collection could not be built. The app still starts. */
+export function errorProvider(err: unknown): Provider {
+  if (err instanceof CapError) return () => errorResponse(413, err.message);
+  if (err instanceof ManifestError) return () => errorResponse(404, err.message);
+  if (err instanceof ConfigError) return () => errorResponse(500, err.message);
+  if ((err as NodeJS.ErrnoException)?.code === 'ENOENT') return () => errorResponse(404, 'Collection not found.');
+
+  return () => errorResponse(500, 'Collection could not be read.');
+}
diff --git a/integrations/nodejs/core/src/collection/source.ts b/integrations/nodejs/core/src/collection/source.ts
new file mode 100644
index 00000000..0230ebee
--- /dev/null
+++ b/integrations/nodejs/core/src/collection/source.ts
@@ -0,0 +1,41 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { isManifest } from './filter';
+import { safeLoad } from './yaml';
+
+export interface CollectionSource {
+  mode: 'dir' | 'file';
+  path: string;
+}
+
+/**
+ * npm start, Docker and systemd all start the same entry file from different working
+ * directories, so the cwd is not a stable base. `require.main` is undefined under ESM,
+ * where `process.argv[1]` is the entry instead.
+ */
+export function resolveCollectionPath(collectionOption: string): string {
+  const entryDir = require.main?.path
+    ?? (process.argv[1] ? path.dirname(process.argv[1]) : undefined)
+    ?? process.cwd();
+
+  return path.resolve(entryDir, collectionOption);
+}
+
+export function resolveCollectionSource(collectionOption: string): CollectionSource {
+  const resolved = resolveCollectionPath(collectionOption);
+
+  try {
+    if (fs.statSync(resolved).isDirectory()) return { mode: 'dir', path: resolved };
+
+    // pointing at the manifest of an unbundled collection means the directory around it
+    if (isManifest(path.basename(resolved))) {
+      const manifest = safeLoad(fs.readFileSync(resolved, 'utf8'));
+      if (manifest?.bundled === false) return { mode: 'dir', path: path.dirname(resolved) };
+    }
+  } catch {
+    // failing to inspect it is the answer, not an error: treat it as a file and let the
+    // provider report it, with a status, at the mount. collection.test.mjs pins that.
+  }
+
+  return { mode: 'file', path: resolved };
+}
diff --git a/integrations/nodejs/core/src/collection/yaml.ts b/integrations/nodejs/core/src/collection/yaml.ts
new file mode 100644
index 00000000..3ff9174f
--- /dev/null
+++ b/integrations/nodejs/core/src/collection/yaml.ts
@@ -0,0 +1,11 @@
+import yaml from 'js-yaml';
+
+/** A collection file is untrusted input: unparseable is a `null`, never a throw. */
+export function safeLoad(text: string): Record<string, unknown> | null {
+  try {
+    const doc = yaml.load(text);
+    return doc && typeof doc === 'object' ? (doc as Record<string, unknown>) : null;
+  } catch {
+    return null;
+  }
+}
diff --git a/integrations/nodejs/core/src/http.ts b/integrations/nodejs/core/src/http.ts
new file mode 100644
index 00000000..09c694af
--- /dev/null
+++ b/integrations/nodejs/core/src/http.ts
@@ -0,0 +1,9 @@
+export interface HttpResponse {
+  status: number;
+  headers: Record<string, string>;
+  body: string | Buffer | null;
+}
+
+export interface Conditional {
+  ifNoneMatch?: string;
+}
diff --git a/integrations/nodejs/core/test/collection.test.mjs b/integrations/nodejs/core/test/collection.test.mjs
new file mode 100644
index 00000000..fbe4a59d
--- /dev/null
+++ b/integrations/nodejs/core/test/collection.test.mjs
@@ -0,0 +1,164 @@
+// The collection layer end to end: where the document comes from, how it is built, what the
+// mount answers when it cannot be. Run: npm run test:collection
+import { fileURLToPath } from 'node:url';
+import path from 'node:path';
+import fs from 'node:fs';
+import os from 'node:os';
+import assert from 'node:assert/strict';
+import { execFileSync } from 'node:child_process';
+import { createRequire } from 'node:module';
+
+const here = path.dirname(fileURLToPath(import.meta.url));
+const require = createRequire(import.meta.url);
+const dist = path.join(here, '..', 'dist');
+const { providerFor } = require(path.join(dist, 'collection', 'index.js'));
+const { fileProvider, dirProvider, errorProvider, ManifestError } = require(path.join(dist, 'collection', 'providers.js'));
+const { resolveCollectionSource, resolveCollectionPath } = require(path.join(dist, 'collection', 'source.js'));
+const { CapError, CAPS } = require(path.join(dist, 'collection', 'walk.js'));
+const { ConfigError } = require(path.join(dist, 'options.js'));
+
+const fixture = (name) => path.join(here, '..', '..', '..', 'contract-tests', 'fixtures', name);
+const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'bruno-docs-'));
+const write = (rel, text) => {
+  const full = path.join(tmp, rel);
+  fs.mkdirSync(path.dirname(full), { recursive: true });
+  fs.writeFileSync(full, text);
+  return full;
+};
+const thrownBy = (fn) => {
+  try {
+    quiet(fn);
+    return null;
+  } catch (err) {
+    return err;
+  }
+};
+const quiet = (fn) => {
+  const { log, warn } = console;
+  console.log = console.warn = () => {};
+  try {
+    return fn();
+  } finally {
+    Object.assign(console, { log, warn });
+  }
+};
+
+// --- directory mode: one envelope, built once, served by ETag
+{
+  const built = dirProvider(fixture('walk-safety'), {});
+  const first = built.serve({});
+  assert.equal(first.status, 200);
+  assert.equal(first.headers['Content-Type'], 'application/json; charset=utf-8');
+  assert.equal(first.headers['Cache-Control'], 'private, no-store');
+  assert.equal(first.headers['X-Content-Type-Options'], 'nosniff');
+
+  const envelope = JSON.parse(first.body);
+  assert.equal(envelope['opencollection-fragments'], '1');
+  assert.deepEqual(Object.keys(envelope.files).sort(), ['control/ping.yml', 'opencollection.yml'], 'no environments by default');
+
+  const second = built.serve({ ifNoneMatch: first.headers.ETag });
+  assert.equal(second.status, 304, 'a matching ETag is a 304');
+  assert.equal(second.body, null, 'and carries no body');
+  assert.equal(built.serve({ ifNoneMatch: '"stale"' }).status, 200, 'a stale ETag is served again');
+  assert.equal(built.serve({}).headers.ETag, first.headers.ETag, 'the ETag is stable across requests');
+}
+
+// --- file mode: same contract, a different content type
+{
+  const single = write('bundled/opencollection.yml', 'opencollection: 1.0.0\nbundled: true\ninfo:\n  name: Bundled\n');
+  const built = fileProvider(single);
+  const first = built.serve({});
+  assert.equal(first.status, 200);
+  assert.equal(first.headers['Content-Type'], 'text/yaml; charset=utf-8');
+  assert.ok(first.headers.ETag, 'file mode validates with an ETag, not Last-Modified');
+  assert.equal(first.headers['Last-Modified'], undefined, 'nothing re-reads the file, so there is no modification time to report');
+  assert.equal(built.serve({ ifNoneMatch: first.headers.ETag }).status, 304);
+}
+
+// --- the failures, each mapped to what the mount answers
+{
+  const oversize = thrownBy(() => dirProvider(fixture('walk-oversize'), {}));
+  assert.ok(oversize instanceof CapError, 'a collection over the caps fails to build');
+  assert.equal(errorProvider(oversize)({}).status, 413);
+
+  fs.mkdirSync(path.join(tmp, 'no-manifest'), { recursive: true });
+  write('no-manifest/ping.yml', 'info:\n  name: ping\n');
+  const missing = thrownBy(() => dirProvider(path.join(tmp, 'no-manifest'), {}));
+  assert.ok(missing instanceof ManifestError, 'a directory without a manifest fails to build');
+  assert.equal(errorProvider(missing)({}).status, 404);
+
+  const absent = thrownBy(() => fileProvider(path.join(tmp, 'nope.yml')));
+  assert.equal(errorProvider(absent)({}).status, 404, 'a missing file is a 404');
+
+  const huge = write('huge/opencollection.yml', '');
+  fs.writeFileSync(huge, Buffer.alloc(CAPS.totalBytes + 1, 0x20));
+  const overCap = thrownBy(() => fileProvider(huge));
+  assert.ok(overCap instanceof CapError, 'a bundled file over the caps fails to build, same as a directory');
+  assert.equal(errorProvider(overCap)({}).status, 413);
+
+  assert.equal(errorProvider(new ConfigError('bad option'))({}).status, 500);
+  assert.equal(errorProvider(new Error('disk on fire'))({}).status, 500);
+  assert.match(String(errorProvider(new Error('disk on fire'))({}).body), /could not be read/);
+}
+
+// --- whatever sends resolveCollectionSource into its catch still reaches the mount with a status
+{
+  const gone = path.join(tmp, 'not-here.yml');
+  assert.equal(resolveCollectionSource(gone).mode, 'file', 'an unstattable path falls through to file mode');
+  assert.throws(() => quiet(() => providerFor({ collection: gone })), { code: 'ENOENT' });
+  assert.equal(errorProvider(thrownBy(() => providerFor({ collection: gone })))({}).status, 404);
+
+  if (process.getuid?.() !== 0) {
+    const locked = write('locked/opencollection.yml', 'opencollection: 1.0.0\nbundled: false\n');
+    fs.chmodSync(locked, 0o000);
+    assert.equal(resolveCollectionSource(locked).mode, 'file', 'an unreadable manifest falls through to file mode');
+    assert.equal(errorProvider(thrownBy(() => providerFor({ collection: locked })))({}).status, 500);
+    fs.chmodSync(locked, 0o644);
+  }
+}
+
+// --- filters need a directory, and that is a startup failure
+{
+  const single = write('solo/opencollection.yml', 'opencollection: 1.0.0\nbundled: true\n');
+  assert.throws(() => quiet(() => providerFor({ collection: single, tags: { exclude: ['internal'] } })), ConfigError);
+  assert.throws(() => quiet(() => providerFor({ collection: single, environments: { all: true } })), ConfigError);
+  assert.equal(quiet(() => providerFor({ collection: single }))({}).status, 200, 'without filters it serves');
+}
+
+// --- pointing at the manifest of an unbundled collection means the directory around it
+{
+  const manifest = write('unbundled/opencollection.yml', 'opencollection: 1.0.0\nbundled: false\n');
+  assert.deepEqual(resolveCollectionSource(manifest), { mode: 'dir', path: path.join(tmp, 'unbundled') });
+
+  const bundled = write('is-bundled/opencollection.yml', 'opencollection: 1.0.0\nbundled: true\n');
+  assert.equal(resolveCollectionSource(bundled).mode, 'file');
+
+  const broken = write('broken/opencollection.yml', 'opencollection: [unclosed\n');
+  assert.equal(resolveCollectionSource(broken).mode, 'file', 'an unreadable manifest is not treated as a directory');
+
+  assert.equal(resolveCollectionPath('/already/absolute'), '/already/absolute', 'path.resolve leaves an absolute path alone');
+}
+
+// --- a relative path resolves against the app's entry file, in CJS and in ESM
+{
+  const appDir = path.join(tmp, 'app');
+  const body = 'console.log(require(process.env.CORE).resolveCollectionPath("./api-collection"));';
+  fs.mkdirSync(appDir, { recursive: true });
+  fs.writeFileSync(path.join(appDir, 'entry.cjs'), body);
+  fs.writeFileSync(path.join(appDir, 'entry.mjs'), `import { createRequire } from 'node:module';\nconst require = createRequire(import.meta.url);\n${body}`);
+
+  // realpath both sides: require.main.path resolves symlinks (/var -> /private/var on macOS)
+  // and process.argv[1] does not, so the two entry points spell the same directory differently.
+  const expected = fs.realpathSync(appDir);
+  for (const entry of ['entry.cjs', 'entry.mjs']) {
+    const out = execFileSync(process.execPath, [path.join(appDir, entry)], {
+      cwd: os.tmpdir(),
+      env: { ...process.env, CORE: path.join(dist, 'collection', 'source.js') }
+    }).toString().trim();
+    assert.equal(fs.realpathSync(path.dirname(out)), expected, `${entry}: resolves against the entry file, not the cwd`);
+    assert.equal(path.basename(out), 'api-collection');
+  }
+}
+
+fs.rmSync(tmp, { recursive: true, force: true });
+console.log('collection-test: all assertions passed');
diff --git a/integrations/package.json b/integrations/package.json
index 35d47c87..e19a1908 100644
--- a/integrations/package.json
+++ b/integrations/package.json
@@ -10,6 +10,7 @@
     "build:core": "tsc -p nodejs/core/tsconfig.json",
     "lint": "eslint",
     "lint:fix": "eslint --fix",
+    "test:collection": "npm run build:core && node nodejs/core/test/collection.test.mjs",
     "test:filter": "npm run build:core && node nodejs/core/test/filter.test.mjs",
     "test:walk": "npm run build:core && node nodejs/core/test/walk.test.mjs"
   },

From fcad8821d5c1ea1f10a0ba8a355570ede65a2c8b Mon Sep 17 00:00:00 2001
From: Arpit Bruno <arpit@usebruno.com>
Date: Tue, 15 Sep 2026 09:55:13 +0530
Subject: [PATCH 05/21] shell: one browser half for every language core

---
 integrations/.gitignore                       |   3 +
 integrations/eslint.config.mjs                |  20 +
 .../nodejs/core/src/collection/filter.ts      |  28 +-
 .../nodejs/core/src/collection/providers.ts   |  24 +-
 .../nodejs/core/src/collection/source.ts      |   8 +-
 .../nodejs/core/src/collection/walk.ts        |  16 +-
 integrations/nodejs/core/src/options.ts       |   8 +-
 integrations/nodejs/core/src/shell.ts         |  98 ++++
 integrations/nodejs/core/test/shell.test.mjs  | 129 +++++
 integrations/nodejs/core/test/walk.test.mjs   |   8 +-
 integrations/package-lock.json                | 467 ++++++++++++++++++
 integrations/package.json                     |   5 +
 integrations/shell/assemble.mjs               | 110 +++++
 integrations/shell/shell.html                 |  19 +
 integrations/shell/shell.src.mjs              |  83 ++++
 integrations/shell/test/assemble.test.mjs     |  92 ++++
 16 files changed, 1094 insertions(+), 24 deletions(-)
 create mode 100644 integrations/.gitignore
 create mode 100644 integrations/nodejs/core/src/shell.ts
 create mode 100644 integrations/nodejs/core/test/shell.test.mjs
 create mode 100644 integrations/shell/assemble.mjs
 create mode 100644 integrations/shell/shell.html
 create mode 100644 integrations/shell/shell.src.mjs
 create mode 100644 integrations/shell/test/assemble.test.mjs

diff --git a/integrations/.gitignore b/integrations/.gitignore
new file mode 100644
index 00000000..1936eda1
--- /dev/null
+++ b/integrations/.gitignore
@@ -0,0 +1,3 @@
+# build output, and the copy of it that each language core publishes
+shell/shell.js
+*/*/shell/
diff --git a/integrations/eslint.config.mjs b/integrations/eslint.config.mjs
index 21c89160..8baa5d49 100644
--- a/integrations/eslint.config.mjs
+++ b/integrations/eslint.config.mjs
@@ -69,6 +69,26 @@ export default [
       'no-console': ['error', { allow: ['log', 'warn', 'error'] }]
     }
   },
+  {
+    files: ['shell/*.mjs'],
+    plugins: { '@stylistic': stylistic },
+    languageOptions: {
+      parserOptions: { ecmaVersion: 'latest', sourceType: 'module' },
+      globals: { ...globals.browser }
+    },
+    rules: {
+      ...js.configs.recommended.rules,
+      ...stylistic.configs.customize({ indent: 2, quotes: 'single', semi: true, jsx: false }).rules,
+      '@stylistic/comma-dangle': ['error', 'never'],
+      '@stylistic/arrow-parens': ['error', 'always'],
+      '@stylistic/max-len': ['error', { code: 120, ignoreStrings: true, ignoreTemplateLiterals: true }],
+      'curly': ['error', 'multi-line'],
+      'eqeqeq': ['error', 'always', { null: 'ignore' }],
+      'no-var': 'error',
+      'prefer-const': 'error',
+      'no-console': ['error', { allow: ['info', 'warn', 'error'] }]
+    }
+  },
   {
     files: ['**/example/**/*.{js,mjs,cjs}'],
     languageOptions: {
diff --git a/integrations/nodejs/core/src/collection/filter.ts b/integrations/nodejs/core/src/collection/filter.ts
index d805b677..16e49712 100644
--- a/integrations/nodejs/core/src/collection/filter.ts
+++ b/integrations/nodejs/core/src/collection/filter.ts
@@ -86,19 +86,29 @@ function filterEnvironments(files: WalkedFile[], option: EnvironmentsOption | un
 
   const environments = partitionFiles(files, (file) => {
     if (!ROOT_ENV_FILE.test(file.path)) {
-      if (ENV_DIR.test(file.path)) return 'nested environments directory';
+      if (ENV_DIR.test(file.path)) {
+        return 'nested environments directory';
+      }
       return null;
     }
 
     // dropping unread is what keeps the server from parsing any YAML unless a filter is configured
-    if (!option) return 'environments not published by default';
+    if (!option) {
+      return 'environments not published by default';
+    }
 
     const name = environmentName(file.text);
-    if (name === null) return 'environment file without a name';
+    if (name === null) {
+      return 'environment file without a name';
+    }
     seen.add(name);
 
-    if (!publishAll && !include.has(name)) return 'environment not included';
-    if (exclude.has(name)) return 'environment excluded';
+    if (!publishAll && !include.has(name)) {
+      return 'environment not included';
+    }
+    if (exclude.has(name)) {
+      return 'environment excluded';
+    }
 
     return null;
   });
@@ -123,8 +133,12 @@ function filterTags(files: WalkedFile[], option: TagsOption | undefined): Filter
 
     const tags = requestTags(file.text);
     // fail closed: a request we cannot read the tags of might be one the filter was meant to hide
-    if (tags === null) return 'request file unreadable while filtering by tags';
-    if (!isRequestTagsIncluded(tags, includeTags, excludeTags)) return 'request excluded by tags';
+    if (tags === null) {
+      return 'request file unreadable while filtering by tags';
+    }
+    if (!isRequestTagsIncluded(tags, includeTags, excludeTags)) {
+      return 'request excluded by tags';
+    }
 
     return null;
   });
diff --git a/integrations/nodejs/core/src/collection/providers.ts b/integrations/nodejs/core/src/collection/providers.ts
index 655616aa..13cec435 100644
--- a/integrations/nodejs/core/src/collection/providers.ts
+++ b/integrations/nodejs/core/src/collection/providers.ts
@@ -46,7 +46,9 @@ function serveFromMemory(body: string | Buffer, contentType: string): Provider {
 
 export function fileProvider(filePath: string): BuiltProvider {
   const size = fs.statSync(filePath).size;
-  if (size > CAPS.totalBytes) throw new CapError('total size cap (5MB)', filePath);
+  if (size > CAPS.totalBytes) {
+    throw new CapError('total size cap (5MB)', filePath);
+  }
 
   const body = fs.readFileSync(filePath);
 
@@ -61,7 +63,9 @@ export function dirProvider(rootDir: string, filters: Omit<CollectionOptions, 'c
 
   const filtered = applyFilters(walked.files, filters);
   const envelope: Record<string, string> = {};
-  for (const file of filtered.files) envelope[file.path] = file.text;
+  for (const file of filtered.files) {
+    envelope[file.path] = file.text;
+  }
   const body = JSON.stringify({ 'opencollection-fragments': '1', 'files': envelope });
 
   return {
@@ -74,10 +78,18 @@ export function dirProvider(rootDir: string, filters: Omit<CollectionOptions, 'c
 
 /** What the mount serves when the collection could not be built. The app still starts. */
 export function errorProvider(err: unknown): Provider {
-  if (err instanceof CapError) return () => errorResponse(413, err.message);
-  if (err instanceof ManifestError) return () => errorResponse(404, err.message);
-  if (err instanceof ConfigError) return () => errorResponse(500, err.message);
-  if ((err as NodeJS.ErrnoException)?.code === 'ENOENT') return () => errorResponse(404, 'Collection not found.');
+  if (err instanceof CapError) {
+    return () => errorResponse(413, err.message);
+  }
+  if (err instanceof ManifestError) {
+    return () => errorResponse(404, err.message);
+  }
+  if (err instanceof ConfigError) {
+    return () => errorResponse(500, err.message);
+  }
+  if ((err as NodeJS.ErrnoException)?.code === 'ENOENT') {
+    return () => errorResponse(404, 'Collection not found.');
+  }
 
   return () => errorResponse(500, 'Collection could not be read.');
 }
diff --git a/integrations/nodejs/core/src/collection/source.ts b/integrations/nodejs/core/src/collection/source.ts
index 0230ebee..66ffd24f 100644
--- a/integrations/nodejs/core/src/collection/source.ts
+++ b/integrations/nodejs/core/src/collection/source.ts
@@ -25,12 +25,16 @@ export function resolveCollectionSource(collectionOption: string): CollectionSou
   const resolved = resolveCollectionPath(collectionOption);
 
   try {
-    if (fs.statSync(resolved).isDirectory()) return { mode: 'dir', path: resolved };
+    if (fs.statSync(resolved).isDirectory()) {
+      return { mode: 'dir', path: resolved };
+    }
 
     // pointing at the manifest of an unbundled collection means the directory around it
     if (isManifest(path.basename(resolved))) {
       const manifest = safeLoad(fs.readFileSync(resolved, 'utf8'));
-      if (manifest?.bundled === false) return { mode: 'dir', path: path.dirname(resolved) };
+      if (manifest?.bundled === false) {
+        return { mode: 'dir', path: path.dirname(resolved) };
+      }
     }
   } catch {
     // failing to inspect it is the answer, not an error: treat it as a file and let the
diff --git a/integrations/nodejs/core/src/collection/walk.ts b/integrations/nodejs/core/src/collection/walk.ts
index 2084338f..e19db23d 100644
--- a/integrations/nodejs/core/src/collection/walk.ts
+++ b/integrations/nodejs/core/src/collection/walk.ts
@@ -53,7 +53,9 @@ export function walkCollection(rootDir: string): WalkResult {
   };
 
   const visit = (dir: string, rel: string, depth: number): void => {
-    if (depth > CAPS.depth) throw new CapError('max directory depth', rel);
+    if (depth > CAPS.depth) {
+      throw new CapError('max directory depth', rel);
+    }
 
     // sorted so every language core serves the same bytes and the same ETag
     const entries = fs.readdirSync(dir, { withFileTypes: true }).sort((a, b) => a.name.localeCompare(b.name));
@@ -89,10 +91,16 @@ export function walkCollection(rootDir: string): WalkResult {
       }
 
       const size = fs.statSync(absPath).size;
-      if (size > CAPS.fileBytes) throw new CapError('per-file size cap (1MB)', relPath);
+      if (size > CAPS.fileBytes) {
+        throw new CapError('per-file size cap (1MB)', relPath);
+      }
       totalBytes += size;
-      if (totalBytes > CAPS.totalBytes) throw new CapError('total size cap (5MB)', relPath);
-      if (files.length >= CAPS.fileCount) throw new CapError('file count cap', relPath);
+      if (totalBytes > CAPS.totalBytes) {
+        throw new CapError('total size cap (5MB)', relPath);
+      }
+      if (files.length >= CAPS.fileCount) {
+        throw new CapError('file count cap', relPath);
+      }
 
       let text: string;
       try {
diff --git a/integrations/nodejs/core/src/options.ts b/integrations/nodejs/core/src/options.ts
index 6dae5a76..564a96f0 100644
--- a/integrations/nodejs/core/src/options.ts
+++ b/integrations/nodejs/core/src/options.ts
@@ -17,14 +17,16 @@ export interface CollectionOptions {
   tags?: TagsOption;
 }
 
+/** What is handed to the renderer. Only what it reads: an option it ignores does nothing. */
 export interface RendererOptions {
-  theme?: 'light' | 'dark';
-  pageTitle?: string;
   logo?: string;
   gitCollectionUrl?: string;
 }
 
-export interface ApiDocsOptions extends CollectionOptions, RendererOptions {}
+export interface ApiDocsOptions extends CollectionOptions, RendererOptions {
+  /** The `<title>` of the page we serve. Not sent to the renderer; it has no use for it. */
+  pageTitle?: string;
+}
 
 export class ConfigError extends Error {}
 
diff --git a/integrations/nodejs/core/src/shell.ts b/integrations/nodejs/core/src/shell.ts
new file mode 100644
index 00000000..a68e3114
--- /dev/null
+++ b/integrations/nodejs/core/src/shell.ts
@@ -0,0 +1,98 @@
+// The browser half as the core serves it: shell.html stamped per mount, shell.js static, embed() body-only.
+
+import fs from 'node:fs';
+import path from 'node:path';
+import type { RendererOptions, ApiDocsOptions } from './options';
+import type { HttpResponse, Conditional } from './http';
+import { etagOf } from './collection/providers';
+
+/** Hardcoded for the beta */
+export const CDN = 'https://cdn.usebruno.com/api-docs';
+
+const SHELL_DIR = path.join(__dirname, '..', 'shell');
+const EMBED_START = '<!-- embed:start -->';
+const EMBED_END = '<!-- embed:end -->';
+const DEFAULT_TITLE = 'API Documentation';
+
+const escapeHtml = (s: string): string =>
+  s.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;');
+
+export const stripGitCredentials = (url: string): string => {
+  try {
+    const parsed = new URL(url);
+    if ((parsed.protocol !== 'http:' && parsed.protocol !== 'https:') || (!parsed.username && !parsed.password)) {
+      return url;
+    }
+    parsed.username = '';
+    parsed.password = '';
+    return parsed.toString();
+  } catch {
+    return url;
+  }
+};
+
+/** What the browser is allowed to see. Built from named fields, never copied from the input. */
+export function rendererConfig(options: RendererOptions): RendererOptions {
+  const config: RendererOptions = {};
+  if (options.logo) {
+    config.logo = options.logo;
+  }
+  if (options.gitCollectionUrl) {
+    config.gitCollectionUrl = stripGitCredentials(options.gitCollectionUrl);
+  }
+
+  return config;
+}
+
+export interface Shell {
+  html(base: string): HttpResponse;
+  js(conditional: Conditional): HttpResponse;
+  embed(base: string): string;
+}
+
+export function loadShell(options: ApiDocsOptions): Shell {
+  const template = fs.readFileSync(path.join(SHELL_DIR, 'shell.html'), 'utf8');
+  const script = fs.readFileSync(path.join(SHELL_DIR, 'shell.js'), 'utf8');
+  const scriptEtag = etagOf(script);
+  const config = escapeHtml(JSON.stringify(rendererConfig(options)));
+  const title = escapeHtml(options.pageTitle ?? DEFAULT_TITLE);
+
+  const stamp = (base: string): string =>
+    template
+      .replaceAll('{{CDN}}', CDN)
+      .replaceAll('{{TITLE}}', title)
+      .replaceAll('{{BASE}}', escapeHtml(base))
+      .replaceAll('{{CONFIG}}', config);
+
+  return {
+    html(base): HttpResponse {
+      return {
+        status: 200,
+        headers: { 'Content-Type': 'text/html; charset=utf-8', 'Cache-Control': 'no-cache' },
+        body: stamp(base)
+      };
+    },
+
+    js({ ifNoneMatch }): HttpResponse {
+      if (ifNoneMatch === scriptEtag) {
+        return { status: 304, headers: {}, body: null };
+      }
+
+      return {
+        status: 200,
+        headers: {
+          'Content-Type': 'application/javascript; charset=utf-8',
+          'Cache-Control': 'public, max-age=3600',
+          'X-Content-Type-Options': 'nosniff',
+          'ETag': scriptEtag
+        },
+        body: script
+      };
+    },
+
+    embed(base): string {
+      const stamped = stamp(base);
+      return stamped.slice(stamped.indexOf(EMBED_START), stamped.indexOf(EMBED_END) + EMBED_END.length);
+    }
+  };
+}
diff --git a/integrations/nodejs/core/test/shell.test.mjs b/integrations/nodejs/core/test/shell.test.mjs
new file mode 100644
index 00000000..ec5128bc
--- /dev/null
+++ b/integrations/nodejs/core/test/shell.test.mjs
@@ -0,0 +1,129 @@
+// The page the mount serves, and what it is allowed to tell the browser.
+// Run: npm run test:shell
+import { fileURLToPath } from 'node:url';
+import path from 'node:path';
+import fs from 'node:fs';
+import assert from 'node:assert/strict';
+import { createRequire } from 'node:module';
+
+const here = path.dirname(fileURLToPath(import.meta.url));
+const require = createRequire(import.meta.url);
+const dist = path.join(here, '..', 'dist');
+const { loadShell, rendererConfig, stripGitCredentials, CDN } = require(path.join(dist, 'shell.js'));
+
+// --- stamping: every placeholder is filled, at any mount
+{
+  const shell = loadShell({ collection: './c', pageTitle: 'Acme API' });
+  const html = shell.html('/docs/').body;
+
+  assert.ok(!html.includes('{{'), 'no placeholder survives stamping');
+  assert.ok(html.includes('<title>Acme API</title>'), 'pageTitle becomes the page title');
+  assert.ok(html.includes('data-base="/docs/"'), 'the mount base is stamped in');
+  assert.ok(html.includes(`data-cdn="${CDN}"`));
+  assert.ok(html.includes('src="/docs/shell.js"'), 'shell.js is loaded from the mount, same origin');
+  assert.ok(html.includes(`src="${CDN}/api-docs.js"`), 'the renderer comes from the CDN');
+
+  assert.equal(loadShell({ collection: './c' }).html('/x/').body.match(/<title>(.*)<\/title>/)[1], 'API Documentation');
+  assert.ok(loadShell({ collection: './c' }).html('/a/b/c/').body.includes('data-base="/a/b/c/"'), 'any depth');
+}
+
+// --- the CSP promise: nothing inline
+{
+  const html = loadShell({ collection: './c' }).html('/docs/').body;
+  assert.ok(!/<style/i.test(html), 'no inline style');
+  assert.ok(!/<script(?![^>]*\bsrc=)/i.test(html), 'every script tag has a src, none has a body');
+}
+
+// --- escaping, because pageTitle and the config are adopter input
+{
+  const nasty = loadShell({
+    collection: './c',
+    pageTitle: '</title><script>alert(1)</script>',
+    logo: 'https://x.test/a"onerror="alert(1)'
+  }).html('/docs/').body;
+
+  assert.ok(!nasty.includes('<script>alert(1)</script>'), 'a title cannot close the tag and inject');
+  assert.ok(nasty.includes('&lt;/title&gt;'), 'it is escaped instead');
+  assert.ok(!/data-config="[^"]*"onerror=/.test(nasty), 'a config value cannot break out of the attribute');
+}
+
+// --- only renderer options reach the browser, and credentials never do
+{
+  const config = rendererConfig({
+    collection: './secret-path',
+    environments: { all: true },
+    tags: { exclude: ['internal'] },
+    pageTitle: 'Docs',
+    logo: 'https://x.test/l.svg',
+    gitCollectionUrl: 'https://user:tok@github.com/acme/api-collection'
+  });
+
+  assert.deepEqual(Object.keys(config).sort(), ['gitCollectionUrl', 'logo'],
+    'only what the renderer reads is forwarded');
+  assert.equal(config.gitCollectionUrl, 'https://github.com/acme/api-collection', 'credentials stripped');
+  assert.deepEqual(rendererConfig({}), {}, 'nothing set means nothing forwarded');
+
+  const html = loadShell({
+    collection: './secret-path',
+    tags: { exclude: ['internal'] },
+    environments: { include: ['Prod'] },
+    pageTitle: 'Acme API'
+  }).html('/docs/').body;
+  for (const leak of ['secret-path', 'internal', 'Prod', 'tags', 'environments']) {
+    assert.ok(!html.includes(leak), `the page never mentions ${leak}`);
+  }
+
+  const sentToRenderer = html.match(/data-config="([^"]*)"/)[1];
+  assert.ok(!sentToRenderer.includes('pageTitle'), 'pageTitle titles the page, it is not sent to the renderer');
+  assert.ok(html.includes('<title>Acme API</title>'), 'it is used for the title tag');
+}
+
+// --- stripGitCredentials on its own
+{
+  assert.equal(stripGitCredentials('https://u:p@host/r.git'), 'https://host/r.git');
+  assert.equal(stripGitCredentials('https://u@host/r.git'), 'https://host/r.git');
+  assert.equal(stripGitCredentials('https://host/r.git'), 'https://host/r.git', 'untouched when there is nothing to strip');
+  assert.equal(stripGitCredentials('git@github.com:acme/r.git'), 'git@github.com:acme/r.git', 'scp-style is not a URL, left alone');
+  assert.equal(stripGitCredentials('not a url'), 'not a url');
+}
+
+// --- shell.js: static, cacheable, revalidates
+{
+  const shell = loadShell({ collection: './c' });
+  const res = shell.js({});
+  assert.equal(res.status, 200);
+  assert.equal(res.headers['Content-Type'], 'application/javascript; charset=utf-8');
+  assert.equal(res.headers['Cache-Control'], 'public, max-age=3600');
+  assert.equal(res.headers['X-Content-Type-Options'], 'nosniff');
+  assert.equal(shell.js({ ifNoneMatch: res.headers.ETag }).status, 304);
+  assert.equal(shell.js({ ifNoneMatch: '"stale"' }).status, 200);
+
+  assert.equal(loadShell({ collection: './c', pageTitle: 'Other' }).js({}).headers.ETag, res.headers.ETag,
+    'shell.js is identical whatever the options, so it caches across mounts');
+}
+
+// --- the page itself must never be cached: it carries the per-mount base
+{
+  assert.equal(loadShell({ collection: './c' }).html('/docs/').headers['Cache-Control'], 'no-cache');
+}
+
+// --- embed(): the body block only, for an adopter's own page
+{
+  const embed = loadShell({ collection: './c' }).embed('/docs/');
+  assert.ok(!embed.includes('<html'), 'no document wrapper');
+  assert.ok(!embed.includes('<title'), 'the host page owns the title');
+  assert.ok(embed.includes('id="bruno-docs"') && embed.includes('src="/docs/shell.js"'));
+  assert.ok(embed.startsWith('<!-- embed:start -->') && embed.endsWith('<!-- embed:end -->'));
+}
+
+// --- the built bundle the core ships
+{
+  const bundle = fs.readFileSync(path.join(here, '..', 'shell', 'shell.js'), 'utf8');
+  assert.ok(bundle.includes('opencollection-fragments'), 'the fragments format is understood in the browser');
+  assert.ok(bundle.length > 20000, 'js-yaml is bundled in, not fetched');
+  assert.deepEqual(bundle.match(/https?:\/\/[A-Za-z0-9./_-]+/g), null,
+    'no origin is hardcoded in the bundle: the CDN arrives as data-cdn');
+  assert.ok(fs.existsSync(path.join(here, '..', 'shell', 'shell.html')), 'the template ships beside it');
+}
+
+console.log('shell-test: all assertions passed');
diff --git a/integrations/nodejs/core/test/walk.test.mjs b/integrations/nodejs/core/test/walk.test.mjs
index 87cd4d0f..eb648176 100644
--- a/integrations/nodejs/core/test/walk.test.mjs
+++ b/integrations/nodejs/core/test/walk.test.mjs
@@ -21,11 +21,15 @@ const fixture = (name) => path.join(here, '..', '..', '..', 'contract-tests', 'f
   assert.ok(!served.some((p) => p.startsWith('.') || p.includes('/.')), 'no dotfiles');
   assert.ok(!served.some((p) => /(~|\.swp|\.bak|\.orig)$/.test(p)), 'no editor strays');
   assert.ok(served.every((p) => /\.ya?ml$/.test(p)), 'only yml served');
-  for (const f of files) assert.ok(!f.text.includes('root:x:0:0'), '/etc/passwd content never served');
+  for (const f of files) {
+    assert.ok(!f.text.includes('root:x:0:0'), '/etc/passwd content never served');
+  }
   assert.ok(skipped.some((s) => s.path === 'control/not-utf8.yml' && /UTF-8/.test(s.rule)), 'invalid UTF-8 file is skipped, not served');
   assert.deepEqual(served, ['control/ping.yml', 'environments/Local.yml', 'opencollection.yml'], 'exactly these files, in this order');
   console.log(`walk-safety: ${served.length} served, ${skipped.length} skipped`);
-  for (const s of skipped) console.log(`  skipped ${s.path} (${s.rule})`);
+  for (const s of skipped) {
+    console.log(`  skipped ${s.path} (${s.rule})`);
+  }
 }
 
 // --- walk-oversize: a single file above the 1 MB cap -> CapError, nothing served
diff --git a/integrations/package-lock.json b/integrations/package-lock.json
index 90032027..aa5e449c 100644
--- a/integrations/package-lock.json
+++ b/integrations/package-lock.json
@@ -16,11 +16,437 @@
         "@types/node": "^22.10.0",
         "@typescript-eslint/eslint-plugin": "^8.65.0",
         "@typescript-eslint/parser": "^8.39.0",
+        "esbuild": "^0.24.0",
         "eslint": "^9.21.0",
         "globals": "^16.0.0",
         "typescript": "^5.7.0"
       }
     },
+    "node_modules/@esbuild/aix-ppc64": {
+      "version": "0.24.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/aix-ppc64/-/aix-ppc64-0.24.2.tgz",
+      "integrity": "sha512-thpVCb/rhxE/BnMLQ7GReQLLN8q9qbHmI55F4489/ByVg2aQaQ6kbcLb6FHkocZzQhxc4gx0sCk0tJkKBFzDhA==",
+      "cpu": [
+        "ppc64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "aix"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/android-arm": {
+      "version": "0.24.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-arm/-/android-arm-0.24.2.tgz",
+      "integrity": "sha512-tmwl4hJkCfNHwFB3nBa8z1Uy3ypZpxqxfTQOcHX+xRByyYgunVbZ9MzUUfb0RxaHIMnbHagwAxuTL+tnNM+1/Q==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/android-arm64": {
+      "version": "0.24.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-arm64/-/android-arm64-0.24.2.tgz",
+      "integrity": "sha512-cNLgeqCqV8WxfcTIOeL4OAtSmL8JjcN6m09XIgro1Wi7cF4t/THaWEa7eL5CMoMBdjoHOTh/vwTO/o2TRXIyzg==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/android-x64": {
+      "version": "0.24.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-x64/-/android-x64-0.24.2.tgz",
+      "integrity": "sha512-B6Q0YQDqMx9D7rvIcsXfmJfvUYLoP722bgfBlO5cGvNVb5V/+Y7nhBE3mHV9OpxBf4eAS2S68KZztiPaWq4XYw==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/darwin-arm64": {
+      "version": "0.24.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/darwin-arm64/-/darwin-arm64-0.24.2.tgz",
+      "integrity": "sha512-kj3AnYWc+CekmZnS5IPu9D+HWtUI49hbnyqk0FLEJDbzCIQt7hg7ucF1SQAilhtYpIujfaHr6O0UHlzzSPdOeA==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/darwin-x64": {
+      "version": "0.24.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/darwin-x64/-/darwin-x64-0.24.2.tgz",
+      "integrity": "sha512-WeSrmwwHaPkNR5H3yYfowhZcbriGqooyu3zI/3GGpF8AyUdsrrP0X6KumITGA9WOyiJavnGZUwPGvxvwfWPHIA==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/freebsd-arm64": {
+      "version": "0.24.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/freebsd-arm64/-/freebsd-arm64-0.24.2.tgz",
+      "integrity": "sha512-UN8HXjtJ0k/Mj6a9+5u6+2eZ2ERD7Edt1Q9IZiB5UZAIdPnVKDoG7mdTVGhHJIeEml60JteamR3qhsr1r8gXvg==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "freebsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/freebsd-x64": {
+      "version": "0.24.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/freebsd-x64/-/freebsd-x64-0.24.2.tgz",
+      "integrity": "sha512-TvW7wE/89PYW+IevEJXZ5sF6gJRDY/14hyIGFXdIucxCsbRmLUcjseQu1SyTko+2idmCw94TgyaEZi9HUSOe3Q==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "freebsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-arm": {
+      "version": "0.24.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-arm/-/linux-arm-0.24.2.tgz",
+      "integrity": "sha512-n0WRM/gWIdU29J57hJyUdIsk0WarGd6To0s+Y+LwvlC55wt+GT/OgkwoXCXvIue1i1sSNWblHEig00GBWiJgfA==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-arm64": {
+      "version": "0.24.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-arm64/-/linux-arm64-0.24.2.tgz",
+      "integrity": "sha512-7HnAD6074BW43YvvUmE/35Id9/NB7BeX5EoNkK9obndmZBUk8xmJJeU7DwmUeN7tkysslb2eSl6CTrYz6oEMQg==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-ia32": {
+      "version": "0.24.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-ia32/-/linux-ia32-0.24.2.tgz",
+      "integrity": "sha512-sfv0tGPQhcZOgTKO3oBE9xpHuUqguHvSo4jl+wjnKwFpapx+vUDcawbwPNuBIAYdRAvIDBfZVvXprIj3HA+Ugw==",
+      "cpu": [
+        "ia32"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-loong64": {
+      "version": "0.24.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-loong64/-/linux-loong64-0.24.2.tgz",
+      "integrity": "sha512-CN9AZr8kEndGooS35ntToZLTQLHEjtVB5n7dl8ZcTZMonJ7CCfStrYhrzF97eAecqVbVJ7APOEe18RPI4KLhwQ==",
+      "cpu": [
+        "loong64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-mips64el": {
+      "version": "0.24.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-mips64el/-/linux-mips64el-0.24.2.tgz",
+      "integrity": "sha512-iMkk7qr/wl3exJATwkISxI7kTcmHKE+BlymIAbHO8xanq/TjHaaVThFF6ipWzPHryoFsesNQJPE/3wFJw4+huw==",
+      "cpu": [
+        "mips64el"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-ppc64": {
+      "version": "0.24.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-ppc64/-/linux-ppc64-0.24.2.tgz",
+      "integrity": "sha512-shsVrgCZ57Vr2L8mm39kO5PPIb+843FStGt7sGGoqiiWYconSxwTiuswC1VJZLCjNiMLAMh34jg4VSEQb+iEbw==",
+      "cpu": [
+        "ppc64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-riscv64": {
+      "version": "0.24.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-riscv64/-/linux-riscv64-0.24.2.tgz",
+      "integrity": "sha512-4eSFWnU9Hhd68fW16GD0TINewo1L6dRrB+oLNNbYyMUAeOD2yCK5KXGK1GH4qD/kT+bTEXjsyTCiJGHPZ3eM9Q==",
+      "cpu": [
+        "riscv64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-s390x": {
+      "version": "0.24.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-s390x/-/linux-s390x-0.24.2.tgz",
+      "integrity": "sha512-S0Bh0A53b0YHL2XEXC20bHLuGMOhFDO6GN4b3YjRLK//Ep3ql3erpNcPlEFed93hsQAjAQDNsvcK+hV90FubSw==",
+      "cpu": [
+        "s390x"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-x64": {
+      "version": "0.24.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-x64/-/linux-x64-0.24.2.tgz",
+      "integrity": "sha512-8Qi4nQcCTbLnK9WoMjdC9NiTG6/E38RNICU6sUNqK0QFxCYgoARqVqxdFmWkdonVsvGqWhmm7MO0jyTqLqwj0Q==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/netbsd-arm64": {
+      "version": "0.24.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/netbsd-arm64/-/netbsd-arm64-0.24.2.tgz",
+      "integrity": "sha512-wuLK/VztRRpMt9zyHSazyCVdCXlpHkKm34WUyinD2lzK07FAHTq0KQvZZlXikNWkDGoT6x3TD51jKQ7gMVpopw==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "netbsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/netbsd-x64": {
+      "version": "0.24.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/netbsd-x64/-/netbsd-x64-0.24.2.tgz",
+      "integrity": "sha512-VefFaQUc4FMmJuAxmIHgUmfNiLXY438XrL4GDNV1Y1H/RW3qow68xTwjZKfj/+Plp9NANmzbH5R40Meudu8mmw==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "netbsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/openbsd-arm64": {
+      "version": "0.24.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/openbsd-arm64/-/openbsd-arm64-0.24.2.tgz",
+      "integrity": "sha512-YQbi46SBct6iKnszhSvdluqDmxCJA+Pu280Av9WICNwQmMxV7nLRHZfjQzwbPs3jeWnuAhE9Jy0NrnJ12Oz+0A==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openbsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/openbsd-x64": {
+      "version": "0.24.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/openbsd-x64/-/openbsd-x64-0.24.2.tgz",
+      "integrity": "sha512-+iDS6zpNM6EnJyWv0bMGLWSWeXGN/HTaF/LXHXHwejGsVi+ooqDfMCCTerNFxEkM3wYVcExkeGXNqshc9iMaOA==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openbsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/sunos-x64": {
+      "version": "0.24.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/sunos-x64/-/sunos-x64-0.24.2.tgz",
+      "integrity": "sha512-hTdsW27jcktEvpwNHJU4ZwWFGkz2zRJUz8pvddmXPtXDzVKTTINmlmga3ZzwcuMpUvLw7JkLy9QLKyGpD2Yxig==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "sunos"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/win32-arm64": {
+      "version": "0.24.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-arm64/-/win32-arm64-0.24.2.tgz",
+      "integrity": "sha512-LihEQ2BBKVFLOC9ZItT9iFprsE9tqjDjnbulhHoFxYQtQfai7qfluVODIYxt1PgdoyQkz23+01rzwNwYfutxUQ==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/win32-ia32": {
+      "version": "0.24.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-ia32/-/win32-ia32-0.24.2.tgz",
+      "integrity": "sha512-q+iGUwfs8tncmFC9pcnD5IvRHAzmbwQ3GPS5/ceCyHdjXubwQWI12MKWSNSMYLJMq23/IUCvJMS76PDqXe1fxA==",
+      "cpu": [
+        "ia32"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/win32-x64": {
+      "version": "0.24.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-x64/-/win32-x64-0.24.2.tgz",
+      "integrity": "sha512-7VTgWzgMGvup6aSqDPLiW5zHaxYJGTO4OokMjIlrCtf+VpEL+cXKtCvg723iguPYI5oaUNdS+/V7OU2gvXVWEg==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
     "node_modules/@eslint-community/eslint-utils": {
       "version": "4.10.1",
       "resolved": "https://registry.npmjs.org/@eslint-community/eslint-utils/-/eslint-utils-4.10.1.tgz",
@@ -784,6 +1210,47 @@
       "dev": true,
       "license": "MIT"
     },
+    "node_modules/esbuild": {
+      "version": "0.24.2",
+      "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.24.2.tgz",
+      "integrity": "sha512-+9egpBW8I3CD5XPe0n6BfT5fxLzxrlDzqydF3aviG+9ni1lDC/OvMHcxqEFV0+LANZG5R1bFMWfUrjVsdwxJvA==",
+      "dev": true,
+      "hasInstallScript": true,
+      "license": "MIT",
+      "bin": {
+        "esbuild": "bin/esbuild"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "optionalDependencies": {
+        "@esbuild/aix-ppc64": "0.24.2",
+        "@esbuild/android-arm": "0.24.2",
+        "@esbuild/android-arm64": "0.24.2",
+        "@esbuild/android-x64": "0.24.2",
+        "@esbuild/darwin-arm64": "0.24.2",
+        "@esbuild/darwin-x64": "0.24.2",
+        "@esbuild/freebsd-arm64": "0.24.2",
+        "@esbuild/freebsd-x64": "0.24.2",
+        "@esbuild/linux-arm": "0.24.2",
+        "@esbuild/linux-arm64": "0.24.2",
+        "@esbuild/linux-ia32": "0.24.2",
+        "@esbuild/linux-loong64": "0.24.2",
+        "@esbuild/linux-mips64el": "0.24.2",
+        "@esbuild/linux-ppc64": "0.24.2",
+        "@esbuild/linux-riscv64": "0.24.2",
+        "@esbuild/linux-s390x": "0.24.2",
+        "@esbuild/linux-x64": "0.24.2",
+        "@esbuild/netbsd-arm64": "0.24.2",
+        "@esbuild/netbsd-x64": "0.24.2",
+        "@esbuild/openbsd-arm64": "0.24.2",
+        "@esbuild/openbsd-x64": "0.24.2",
+        "@esbuild/sunos-x64": "0.24.2",
+        "@esbuild/win32-arm64": "0.24.2",
+        "@esbuild/win32-ia32": "0.24.2",
+        "@esbuild/win32-x64": "0.24.2"
+      }
+    },
     "node_modules/escape-string-regexp": {
       "version": "4.0.0",
       "resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-4.0.0.tgz",
diff --git a/integrations/package.json b/integrations/package.json
index e19a1908..a21b6196 100644
--- a/integrations/package.json
+++ b/integrations/package.json
@@ -7,11 +7,15 @@
     "nodejs/*"
   ],
   "scripts": {
+    "build": "npm run build:shell && npm run build:core",
     "build:core": "tsc -p nodejs/core/tsconfig.json",
+    "build:shell": "esbuild shell/shell.src.mjs --bundle --minify --format=iife --platform=browser --target=es2020 --outfile=shell/shell.js --log-level=warning && mkdir -p nodejs/core/shell && cp shell/shell.html shell/shell.js nodejs/core/shell/",
     "lint": "eslint",
     "lint:fix": "eslint --fix",
+    "test:assemble": "node shell/test/assemble.test.mjs",
     "test:collection": "npm run build:core && node nodejs/core/test/collection.test.mjs",
     "test:filter": "npm run build:core && node nodejs/core/test/filter.test.mjs",
+    "test:shell": "npm run build && node nodejs/core/test/shell.test.mjs",
     "test:walk": "npm run build:core && node nodejs/core/test/walk.test.mjs"
   },
   "devDependencies": {
@@ -21,6 +25,7 @@
     "@types/node": "^22.10.0",
     "@typescript-eslint/eslint-plugin": "^8.65.0",
     "@typescript-eslint/parser": "^8.39.0",
+    "esbuild": "^0.24.0",
     "eslint": "^9.21.0",
     "globals": "^16.0.0",
     "typescript": "^5.7.0"
diff --git a/integrations/shell/assemble.mjs b/integrations/shell/assemble.mjs
new file mode 100644
index 00000000..8301d45f
--- /dev/null
+++ b/integrations/shell/assemble.mjs
@@ -0,0 +1,110 @@
+// One flat map of path -> raw text becomes one OpenCollection document. Pure, so it can be
+// tested without a browser, and so it can move into the renderer bundle later without moving
+// anything else with it.
+
+import { load as yamlLoad } from 'js-yaml';
+
+const MANIFEST_FILE = /^opencollection\.ya?ml$/;
+const FOLDER_FILE = /^folder\.ya?ml$/;
+
+export function toOpenCollection(text) {
+  const json = parseJsonOrNull(text);
+  if (json === null) {
+    return yamlLoad(text);
+  }
+  if (json['opencollection-fragments'] && json.files) {
+    return assembleFragments(json.files);
+  }
+
+  return json;
+}
+
+function parseJsonOrNull(text) {
+  try {
+    const value = JSON.parse(text);
+    return value && typeof value === 'object' ? value : null;
+  }
+  catch {
+    return null;
+  }
+}
+
+export function assembleFragments(files) {
+  const manifestPath = Object.keys(files).find((p) => MANIFEST_FILE.test(p));
+  if (!manifestPath) {
+    throw new Error('fragments payload has no opencollection.yml manifest');
+  }
+
+  const parse = (filePath) => {
+    try {
+      return yamlLoad(files[filePath]);
+    }
+    catch {
+      throw new Error('invalid YAML in ' + filePath);
+    }
+  };
+  const parentOf = (dir) => (dir.includes('/') ? dir.slice(0, dir.lastIndexOf('/')) : '');
+
+  const doc = parse(manifestPath) || {};
+  const environments = [];
+  const dirs = new Map([['', newDir()]]);
+
+  // set before recursing, so ensuring a parent cannot recreate the child it was reached from
+  const ensureDir = (dir) => {
+    if (!dirs.has(dir)) {
+      dirs.set(dir, newDir());
+      ensureDir(parentOf(dir)).children.push(dir);
+    }
+
+    return dirs.get(dir);
+  };
+
+  for (const filePath of Object.keys(files)) {
+    if (filePath === manifestPath) continue;
+    if (filePath.startsWith('environments/')) {
+      environments.push(parse(filePath));
+      continue;
+    }
+
+    const slash = filePath.lastIndexOf('/');
+    const node = ensureDir(slash === -1 ? '' : filePath.slice(0, slash));
+    if (FOLDER_FILE.test(filePath.slice(slash + 1))) {
+      node.meta = parse(filePath);
+    }
+    else {
+      node.requests.push(parse(filePath));
+    }
+  }
+
+  doc.items = materialize('', dirs);
+  if (environments.length) {
+    doc.config = doc.config || {};
+    doc.config.environments = environments;
+  }
+  doc.bundled = true;
+
+  return doc;
+}
+
+const newDir = () => ({ meta: null, requests: [], children: [] });
+
+const seqOf = (item) => {
+  const seq = item && item.info && item.info.seq;
+  return typeof seq === 'number' ? seq : Number.MAX_SAFE_INTEGER;
+};
+const nameOf = (item) => (item && item.info && item.info.name) || '';
+const bySeqThenName = (a, b) => seqOf(a) - seqOf(b) || nameOf(a).localeCompare(nameOf(b));
+
+function materialize(dir, dirs) {
+  const node = dirs.get(dir);
+  const folders = node.children.map((childDir) => {
+    const child = dirs.get(childDir);
+    const name = childDir.slice(childDir.lastIndexOf('/') + 1);
+    const folder = child.meta || { info: { name, type: 'folder' } };
+    folder.items = materialize(childDir, dirs);
+
+    return folder;
+  });
+
+  return [...folders.sort(bySeqThenName), ...node.requests.sort(bySeqThenName)];
+}
diff --git a/integrations/shell/shell.html b/integrations/shell/shell.html
new file mode 100644
index 00000000..06a64392
--- /dev/null
+++ b/integrations/shell/shell.html
@@ -0,0 +1,19 @@
+<!doctype html>
+<html lang="en">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <title>{{TITLE}}</title>
+</head>
+<body>
+<!-- embed:start -->
+  <link rel="stylesheet" href="{{CDN}}/api-docs.css">
+  <script src="{{CDN}}/api-docs.js"></script>
+
+  <div id="bruno-docs" data-base="{{BASE}}" data-cdn="{{CDN}}" data-config="{{CONFIG}}"></div>
+  <pre id="bruno-docs-error" hidden></pre>
+
+  <script src="{{BASE}}shell.js"></script>
+<!-- embed:end -->
+</body>
+</html>
diff --git a/integrations/shell/shell.src.mjs b/integrations/shell/shell.src.mjs
new file mode 100644
index 00000000..3307365a
--- /dev/null
+++ b/integrations/shell/shell.src.mjs
@@ -0,0 +1,83 @@
+// The browser half, identical for every language core: fetch collection.yml, assemble, boot.
+
+import { toOpenCollection } from './assemble.mjs';
+
+(async function main() {
+  const mount = document.getElementById('bruno-docs');
+  const errorBox = document.getElementById('bruno-docs-error');
+  const base = mount.dataset.base;
+  const cdn = mount.dataset.cdn;
+  const config = JSON.parse(mount.dataset.config || '{}');
+  const version = (window.Bruno && window.Bruno.version) || 'version unknown';
+
+  // via CSSOM: an inline <style> is blocked under a strict style-src
+  document.body.style.margin = '0';
+  mount.style.width = '100vw';
+  mount.style.height = '100vh';
+
+  function fail(message) {
+    mount.style.display = 'none';
+    errorBox.hidden = false;
+    Object.assign(errorBox.style, {
+      padding: '2rem',
+      margin: '0',
+      font: '14px/1.7 ui-monospace, SFMono-Regular, monospace',
+      whiteSpace: 'pre-wrap',
+      color: '#b3261e'
+    });
+    errorBox.textContent = 'Bruno API Docs failed to start.\n\n' + message + '\n\napi-docs: ' + version;
+  }
+
+  const boot = resolveBoot();
+  if (!boot) {
+    return fail(
+      'The renderer bundle did not load or did not execute.\n'
+      + 'Check that ' + cdn + '/api-docs.js is reachable. It is loaded from a CDN, so this\n'
+      + 'also fails on an air-gapped network or under a Content-Security-Policy that does not\n'
+      + 'allow that origin in script-src and style-src.'
+    );
+  }
+
+  const collectionUrl = new URL(base + 'collection.yml', location.origin).href;
+  let res;
+  let text;
+  try {
+    res = await fetch(collectionUrl);
+    text = await res.text();
+  }
+  catch (err) {
+    return fail('GET ' + collectionUrl + '\n  -> ' + err.message);
+  }
+  if (!res.ok) {
+    const detail = text ? '\n\n' + text : '';
+    return fail('GET ' + collectionUrl + '\n  -> HTTP ' + res.status + ' ' + res.statusText + detail);
+  }
+
+  let doc;
+  try {
+    doc = toOpenCollection(text);
+  }
+  catch (err) {
+    return fail('Could not read the collection:\n  ' + err.message);
+  }
+
+  try {
+    // both names on purpose: the renderer reads `opencollection` today and is moving to
+    // `content`. Passing both means neither side has to land first. Do not clean this up.
+    boot(mount, { ...config, opencollection: doc, content: doc });
+  }
+  catch (err) {
+    return fail('The renderer threw while mounting:\n  ' + err.message);
+  }
+  console.info('[bruno-docs] api-docs ' + version + ', collection from ' + collectionUrl);
+})();
+
+function resolveBoot() {
+  if (window.Bruno && typeof window.Bruno.apiDocs === 'function') {
+    return (target, config) => window.Bruno.apiDocs(target, config);
+  }
+  if (typeof window.OpenCollection === 'function') {
+    return (target, config) => new window.OpenCollection({ target, ...config });
+  }
+  return null;
+}
diff --git a/integrations/shell/test/assemble.test.mjs b/integrations/shell/test/assemble.test.mjs
new file mode 100644
index 00000000..f360f5e9
--- /dev/null
+++ b/integrations/shell/test/assemble.test.mjs
@@ -0,0 +1,92 @@
+// Flat files in, one ordered document out. Run: npm run test:assemble
+import assert from 'node:assert/strict';
+import { toOpenCollection, assembleFragments } from '../assemble.mjs';
+
+const request = (name, seq) => `info:\n  name: ${name}\n  type: http\n${seq === undefined ? '' : `  seq: ${seq}\n`}`;
+const envelope = (files) => JSON.stringify({ 'opencollection-fragments': '1', files });
+const names = (items) => items.map((i) => i.info.name);
+
+// --- a flat collection
+{
+  const doc = assembleFragments({
+    'opencollection.yml': 'opencollection: 1.0.0\ninfo:\n  name: Acme\n',
+    'ping.yml': request('ping'),
+    'health.yml': request('health')
+  });
+
+  assert.equal(doc.info.name, 'Acme', 'the manifest is the document');
+  assert.equal(doc.bundled, true, 'the assembled document is bundled');
+  assert.deepEqual(names(doc.items), ['health', 'ping'], 'no seq means alphabetical');
+}
+
+// --- folders before requests, then seq, then name
+{
+  const doc = assembleFragments({
+    'opencollection.yml': 'opencollection: 1.0.0\n',
+    'zeta.yml': request('zeta', 1),
+    'alpha.yml': request('alpha', 2),
+    'beta.yml': request('beta'),
+    'admin/folder.yml': 'info:\n  name: Admin\n  seq: 9\n',
+    'admin/purge.yml': request('purge'),
+    'public/folder.yml': 'info:\n  name: Public\n  seq: 1\n',
+    'public/hello.yml': request('hello')
+  });
+
+  assert.deepEqual(names(doc.items), ['Public', 'Admin', 'zeta', 'alpha', 'beta'],
+    'folders first by seq, then requests by seq, then the unsequenced by name');
+  assert.deepEqual(names(doc.items[0].items), ['hello'], 'a folder carries its own requests');
+}
+
+// --- a folder with no folder.yml still becomes a folder, named after the directory
+{
+  const doc = assembleFragments({
+    'opencollection.yml': 'opencollection: 1.0.0\n',
+    'orphan/ping.yml': request('ping')
+  });
+
+  assert.deepEqual(names(doc.items), ['orphan']);
+  assert.equal(doc.items[0].info.type, 'folder');
+  assert.deepEqual(names(doc.items[0].items), ['ping']);
+}
+
+// --- nesting several deep, with no folder.yml at any level
+{
+  const doc = assembleFragments({
+    'opencollection.yml': 'opencollection: 1.0.0\n',
+    'a/b/c/deep.yml': request('deep')
+  });
+
+  assert.deepEqual(names(doc.items), ['a']);
+  assert.deepEqual(names(doc.items[0].items), ['b']);
+  assert.deepEqual(names(doc.items[0].items[0].items), ['c']);
+  assert.deepEqual(names(doc.items[0].items[0].items[0].items), ['deep']);
+}
+
+// --- environments land on config, not in the tree
+{
+  const doc = assembleFragments({
+    'opencollection.yml': 'opencollection: 1.0.0\n',
+    'environments/Local.yml': 'name: Local\nvariables: []\n',
+    'ping.yml': request('ping')
+  });
+
+  assert.deepEqual(doc.config.environments.map((e) => e.name), ['Local']);
+  assert.deepEqual(names(doc.items), ['ping'], 'an environment is not an item');
+}
+
+// --- the failures
+{
+  assert.throws(() => assembleFragments({ 'ping.yml': request('ping') }), /no opencollection.yml manifest/);
+  assert.throws(() => assembleFragments({ 'opencollection.yaml': 'opencollection: 1.0.0\n', 'x.yml': '[' }), /invalid YAML in x.yml/);
+  assert.doesNotThrow(() => assembleFragments({ 'opencollection.yaml': 'opencollection: 1.0.0\n' }), 'a .yaml manifest counts');
+}
+
+// --- toOpenCollection: three payload shapes
+{
+  assert.equal(toOpenCollection('info:\n  name: Yaml\n').info.name, 'Yaml', 'raw yaml passes through');
+  assert.equal(toOpenCollection('{"info":{"name":"Json"}}').info.name, 'Json', 'plain json passes through');
+  assert.equal(toOpenCollection(envelope({ 'opencollection.yml': 'info:\n  name: Env\n' })).info.name, 'Env', 'an envelope is assembled');
+  assert.equal(toOpenCollection(envelope({ 'opencollection.yml': 'info:\n  name: Env\n' })).bundled, true);
+}
+
+console.log('assemble-test: all assertions passed');

From a0a0b52afa14a81e2b163c331c5a93135424c6c0 Mon Sep 17 00:00:00 2001
From: Arpit Bruno <arpit@usebruno.com>
Date: Tue, 15 Sep 2026 10:15:37 +0530
Subject: [PATCH 06/21] core: request handler, createDocs, and the routes
 directory

---
 .../nodejs/core/src/collection/index.ts       |   6 +-
 .../nodejs/core/src/collection/providers.ts   |   6 +-
 .../nodejs/core/src/collection/source.ts      |   7 +
 integrations/nodejs/core/src/create-docs.ts   |  58 +++++++
 integrations/nodejs/core/src/http.ts          |   6 +
 integrations/nodejs/core/src/index.ts         |   7 +
 integrations/nodejs/core/src/log.ts           |   7 +
 integrations/nodejs/core/src/options.ts       |   4 -
 .../nodejs/core/src/routes/handler.ts         |  66 ++++++++
 .../nodejs/core/src/{ => routes}/shell.ts     |   7 +-
 .../nodejs/core/test/collection.test.mjs      |   7 +
 integrations/nodejs/core/test/docs.test.mjs   | 156 ++++++++++++++++++
 integrations/nodejs/core/test/filter.test.mjs |   9 +-
 integrations/nodejs/core/test/shell.test.mjs  |   2 +-
 integrations/package.json                     |   1 +
 15 files changed, 325 insertions(+), 24 deletions(-)
 create mode 100644 integrations/nodejs/core/src/create-docs.ts
 create mode 100644 integrations/nodejs/core/src/index.ts
 create mode 100644 integrations/nodejs/core/src/log.ts
 create mode 100644 integrations/nodejs/core/src/routes/handler.ts
 rename integrations/nodejs/core/src/{ => routes}/shell.ts (92%)
 create mode 100644 integrations/nodejs/core/test/docs.test.mjs

diff --git a/integrations/nodejs/core/src/collection/index.ts b/integrations/nodejs/core/src/collection/index.ts
index 9e648d2d..25a5ff83 100644
--- a/integrations/nodejs/core/src/collection/index.ts
+++ b/integrations/nodejs/core/src/collection/index.ts
@@ -1,15 +1,11 @@
 // The collection layer's one entry point: where the document comes from is decided here, at startup.
 
 import { ConfigError, type CollectionOptions } from '../options';
+import { log } from '../log';
 import type { SkippedFile } from './walk';
 import { resolveCollectionSource } from './source';
 import { fileProvider, dirProvider, type Provider, type BuiltProvider } from './providers';
 
-const log = {
-  info: (line: string) => console.log(`[bruno-docs] ${line}`),
-  warn: (line: string) => console.warn(`[bruno-docs] ${line}`)
-};
-
 export function providerFor(options: CollectionOptions): Provider {
   const source = resolveCollectionSource(options.collection);
   const filters = { environments: options.environments, tags: options.tags };
diff --git a/integrations/nodejs/core/src/collection/providers.ts b/integrations/nodejs/core/src/collection/providers.ts
index 13cec435..198a505b 100644
--- a/integrations/nodejs/core/src/collection/providers.ts
+++ b/integrations/nodejs/core/src/collection/providers.ts
@@ -1,7 +1,6 @@
 import fs from 'node:fs';
-import crypto from 'node:crypto';
 import { ConfigError, type CollectionOptions } from '../options';
-import type { HttpResponse, Conditional } from '../http';
+import { etagOf, type HttpResponse, type Conditional } from '../http';
 import type { SkippedFile } from './walk';
 import { walkCollection, CAPS, CapError } from './walk';
 import { applyFilters, isManifest } from './filter';
@@ -17,9 +16,6 @@ export interface BuiltProvider {
 
 export class ManifestError extends Error {}
 
-export const etagOf = (data: string | Buffer): string =>
-  '"' + crypto.createHash('sha256').update(data).digest('hex').slice(0, 32) + '"';
-
 const DOCUMENT_HEADERS: Record<string, string> = {
   'Cache-Control': 'private, no-store',
   'X-Content-Type-Options': 'nosniff'
diff --git a/integrations/nodejs/core/src/collection/source.ts b/integrations/nodejs/core/src/collection/source.ts
index 66ffd24f..3c8fac1c 100644
--- a/integrations/nodejs/core/src/collection/source.ts
+++ b/integrations/nodejs/core/src/collection/source.ts
@@ -1,5 +1,6 @@
 import fs from 'node:fs';
 import path from 'node:path';
+import { ConfigError } from '../options';
 import { isManifest } from './filter';
 import { safeLoad } from './yaml';
 
@@ -14,6 +15,12 @@ export interface CollectionSource {
  * where `process.argv[1]` is the entry instead.
  */
 export function resolveCollectionPath(collectionOption: string): string {
+  // guarded here rather than in validateOptions: an empty path resolves to the app's own
+  // directory, and walking that would serve whatever yml the adopter happens to keep there
+  if (!collectionOption) {
+    throw new ConfigError('apiDocs: `collection` is required');
+  }
+
   const entryDir = require.main?.path
     ?? (process.argv[1] ? path.dirname(process.argv[1]) : undefined)
     ?? process.cwd();
diff --git a/integrations/nodejs/core/src/create-docs.ts b/integrations/nodejs/core/src/create-docs.ts
new file mode 100644
index 00000000..cfbfff4a
--- /dev/null
+++ b/integrations/nodejs/core/src/create-docs.ts
@@ -0,0 +1,58 @@
+import { validateOptions, ConfigError, type ApiDocsOptions } from './options';
+import type { HttpResponse, Conditional } from './http';
+import { log } from './log';
+import { providerFor } from './collection';
+import { errorProvider, type Provider } from './collection/providers';
+import { loadShell, type Shell } from './routes/shell';
+import { createHandler, type Handler } from './routes/handler';
+
+export interface Docs {
+  handler(): Handler;
+  shell(base: string): HttpResponse;
+  shellJs(conditional?: Conditional): HttpResponse;
+  collection(conditional?: Conditional): HttpResponse;
+  embed(opts: { base: string }): string;
+}
+
+export function createDocs(options: ApiDocsOptions): Docs {
+  try {
+    validateOptions(options);
+
+    return liveDocs(loadShell(options), providerFor(options));
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    log.error(`${message} — the app will start and the docs mount will serve this`);
+
+    return failedDocs(errorProvider(err));
+  }
+}
+
+function liveDocs(shell: Shell, provider: Provider): Docs {
+  const docs: Docs = {
+    shell: (base) => shell.html(base),
+    shellJs: (conditional = {}) => shell.js(conditional),
+    collection: (conditional = {}) => provider(conditional),
+    embed: ({ base }) => {
+      if (!base) {
+        throw new ConfigError('embed: `base` (the docs mount, e.g. "/docs") is required');
+      }
+
+      return shell.embed(base.endsWith('/') ? base : base + '/');
+    },
+    handler: () => createHandler(docs)
+  };
+
+  return docs;
+}
+
+function failedDocs(serve: Provider): Docs {
+  const docs: Docs = {
+    shell: () => serve({}),
+    shellJs: () => serve({}),
+    collection: () => serve({}),
+    embed: () => `<!-- bruno api docs: ${String(serve({}).body).trim()} -->`,
+    handler: () => createHandler(docs)
+  };
+
+  return docs;
+}
diff --git a/integrations/nodejs/core/src/http.ts b/integrations/nodejs/core/src/http.ts
index 09c694af..c2c5c225 100644
--- a/integrations/nodejs/core/src/http.ts
+++ b/integrations/nodejs/core/src/http.ts
@@ -1,3 +1,5 @@
+import crypto from 'node:crypto';
+
 export interface HttpResponse {
   status: number;
   headers: Record<string, string>;
@@ -7,3 +9,7 @@ export interface HttpResponse {
 export interface Conditional {
   ifNoneMatch?: string;
 }
+
+/** Both halves validate the same way: hash what will be served, compare it next time. */
+export const etagOf = (data: string | Buffer): string =>
+  '"' + crypto.createHash('sha256').update(data).digest('hex').slice(0, 32) + '"';
diff --git a/integrations/nodejs/core/src/index.ts b/integrations/nodejs/core/src/index.ts
new file mode 100644
index 00000000..64cbcf0d
--- /dev/null
+++ b/integrations/nodejs/core/src/index.ts
@@ -0,0 +1,7 @@
+export { createDocs } from './create-docs';
+export { ConfigError } from './options';
+
+export type { Docs } from './create-docs';
+export type { ApiDocsOptions, CollectionOptions, RendererOptions, EnvironmentsOption, TagsOption } from './options';
+export type { Handler, Request } from './routes/handler';
+export type { HttpResponse, Conditional } from './http';
diff --git a/integrations/nodejs/core/src/log.ts b/integrations/nodejs/core/src/log.ts
new file mode 100644
index 00000000..f5639581
--- /dev/null
+++ b/integrations/nodejs/core/src/log.ts
@@ -0,0 +1,7 @@
+const line = (message: string): string => `[bruno-docs] ${message}`;
+
+export const log = {
+  info: (message: string): void => console.log(line(message)),
+  warn: (message: string): void => console.warn(line(message)),
+  error: (message: string): void => console.error(line(message))
+};
diff --git a/integrations/nodejs/core/src/options.ts b/integrations/nodejs/core/src/options.ts
index 564a96f0..f0291af0 100644
--- a/integrations/nodejs/core/src/options.ts
+++ b/integrations/nodejs/core/src/options.ts
@@ -31,10 +31,6 @@ export interface ApiDocsOptions extends CollectionOptions, RendererOptions {
 export class ConfigError extends Error {}
 
 export function validateOptions(options: CollectionOptions): void {
-  if (!options.collection) {
-    throw new ConfigError('apiDocs: `collection` is required');
-  }
-
   const env = options.environments;
   if (!env) return;
 
diff --git a/integrations/nodejs/core/src/routes/handler.ts b/integrations/nodejs/core/src/routes/handler.ts
new file mode 100644
index 00000000..9eaadf3d
--- /dev/null
+++ b/integrations/nodejs/core/src/routes/handler.ts
@@ -0,0 +1,66 @@
+import type { IncomingMessage, ServerResponse } from 'node:http';
+import type { HttpResponse, Conditional } from '../http';
+
+export interface Routes {
+  shell(base: string): HttpResponse;
+  shellJs(conditional: Conditional): HttpResponse;
+  collection(conditional: Conditional): HttpResponse;
+}
+
+/**
+ * `url` is the path within the mount and `originalUrl`, when the framework sets it, is the
+ * full path. Express gives both. A framework that gives neither has to strip the mount itself
+ * before calling this, which is what `mountPath` is for in the NestJS package.
+ */
+export type Request = IncomingMessage & { originalUrl?: string };
+
+export type Handler = (req: Request, res: ServerResponse) => void;
+
+const header = (req: Request, name: string): string | undefined => req.headers[name] as string | undefined;
+
+const pathOnly = (url: string): string => url.split('?')[0];
+
+export function createHandler(routes: Routes): Handler {
+  return (req, res) => {
+    const method = (req.method ?? 'GET').toUpperCase();
+    if (method !== 'GET' && method !== 'HEAD') {
+      res.writeHead(405, { Allow: 'GET, HEAD' });
+      res.end();
+
+      return;
+    }
+
+    const original = pathOnly(req.originalUrl || req.url || '/');
+    const sub = pathOnly(req.url || '/');
+
+    const write = (response: HttpResponse): void => {
+      res.writeHead(response.status, response.headers);
+      res.end(method === 'HEAD' ? undefined : response.body ?? undefined);
+    };
+
+    if (sub === '/shell.js') {
+      write(routes.shellJs({ ifNoneMatch: header(req, 'if-none-match') }));
+
+      return;
+    }
+
+    if (sub === '/collection.yml') {
+      write(routes.collection({ ifNoneMatch: header(req, 'if-none-match') }));
+
+      return;
+    }
+
+    // a relative Location survives a reverse proxy that rewrites the prefix
+    if (!original.endsWith('/')) {
+      const lastSegment = original.split('/').filter(Boolean).pop();
+      res.writeHead(301, { Location: lastSegment + '/' });
+      res.end();
+
+      return;
+    }
+
+    // only meaningful once we know `original` ends in '/', so `sub` is its tail
+    const mount = original.slice(0, original.length - sub.length);
+    write(routes.shell(mount + '/'));
+  };
+}
diff --git a/integrations/nodejs/core/src/shell.ts b/integrations/nodejs/core/src/routes/shell.ts
similarity index 92%
rename from integrations/nodejs/core/src/shell.ts
rename to integrations/nodejs/core/src/routes/shell.ts
index a68e3114..ae4a92e9 100644
--- a/integrations/nodejs/core/src/shell.ts
+++ b/integrations/nodejs/core/src/routes/shell.ts
@@ -2,14 +2,13 @@
 
 import fs from 'node:fs';
 import path from 'node:path';
-import type { RendererOptions, ApiDocsOptions } from './options';
-import type { HttpResponse, Conditional } from './http';
-import { etagOf } from './collection/providers';
+import type { RendererOptions, ApiDocsOptions } from '../options';
+import { etagOf, type HttpResponse, type Conditional } from '../http';
 
 /** Hardcoded for the beta */
 export const CDN = 'https://cdn.usebruno.com/api-docs';
 
-const SHELL_DIR = path.join(__dirname, '..', 'shell');
+const SHELL_DIR = path.join(__dirname, '..', '..', 'shell');
 const EMBED_START = '<!-- embed:start -->';
 const EMBED_END = '<!-- embed:end -->';
 const DEFAULT_TITLE = 'API Documentation';
diff --git a/integrations/nodejs/core/test/collection.test.mjs b/integrations/nodejs/core/test/collection.test.mjs
index fbe4a59d..9d644861 100644
--- a/integrations/nodejs/core/test/collection.test.mjs
+++ b/integrations/nodejs/core/test/collection.test.mjs
@@ -137,6 +137,13 @@ const quiet = (fn) => {
   assert.equal(resolveCollectionSource(broken).mode, 'file', 'an unreadable manifest is not treated as a directory');
 
   assert.equal(resolveCollectionPath('/already/absolute'), '/already/absolute', 'path.resolve leaves an absolute path alone');
+
+  // guarded here, not in validateOptions: an empty path resolves to the app's own directory,
+  // so any caller that skipped the validator would walk it and serve whatever yml lives there
+  for (const empty of ['', undefined, null]) {
+    assert.throws(() => resolveCollectionPath(empty), ConfigError, `${JSON.stringify(empty)} is refused`);
+    assert.throws(() => quiet(() => providerFor({ collection: empty })), ConfigError, 'and refused through providerFor');
+  }
 }
 
 // --- a relative path resolves against the app's entry file, in CJS and in ESM
diff --git a/integrations/nodejs/core/test/docs.test.mjs b/integrations/nodejs/core/test/docs.test.mjs
new file mode 100644
index 00000000..6a3945d1
--- /dev/null
+++ b/integrations/nodejs/core/test/docs.test.mjs
@@ -0,0 +1,156 @@
+// createDocs end to end: the routes every framework hosts, and what the mount answers
+// when the setup is broken. Run: npm run test:docs
+import { fileURLToPath } from 'node:url';
+import path from 'node:path';
+import fs from 'node:fs';
+import os from 'node:os';
+import assert from 'node:assert/strict';
+import { createRequire } from 'node:module';
+
+const here = path.dirname(fileURLToPath(import.meta.url));
+const require = createRequire(import.meta.url);
+const { createDocs } = require(path.join(here, '..', 'dist', 'index.js'));
+
+const collection = path.join(here, '..', '..', '..', 'contract-tests', 'fixtures', 'walk-safety');
+const quiet = (fn) => {
+  const { log, warn, error } = console;
+  console.log = console.warn = console.error = () => {};
+  try {
+    return fn();
+  } finally {
+    Object.assign(console, { log, warn, error });
+  }
+};
+
+// a request as Express hands it over: url is mount-relative, originalUrl is the whole path
+const call = (handler, method, mount, sub, headers = {}) => {
+  const res = { status: 0, headers: {}, body: undefined, ended: false };
+  handler(
+    { method, url: sub, originalUrl: mount + sub, headers },
+    {
+      writeHead(status, h) {
+        res.status = status;
+        res.headers = h ?? {};
+      },
+      end(body) {
+        res.body = body;
+        res.ended = true;
+      }
+    }
+  );
+
+  return res;
+};
+
+const docs = quiet(() => createDocs({ collection, pageTitle: 'Fixture API' }));
+const handler = docs.handler();
+
+// --- the routes, as the contract states them
+{
+  const redirect = call(handler, 'GET', '/docs', '');
+  assert.equal(redirect.status, 301);
+  assert.equal(redirect.headers.Location, 'docs/', 'relative, so a proxy that rewrites the prefix survives it');
+
+  const page = call(handler, 'GET', '/docs', '/');
+  assert.equal(page.status, 200);
+  assert.equal(page.headers['Content-Type'], 'text/html; charset=utf-8');
+  assert.ok(page.body.includes('data-base="/docs/"'));
+  assert.ok(page.body.includes('<title>Fixture API</title>'));
+
+  const deep = call(handler, 'GET', '/docs', '/requests/ping/');
+  assert.equal(deep.status, 200, 'any depth serves the page, for renderer deep links');
+  assert.ok(deep.body.includes('data-base="/docs/"'), 'stamped with the mount, not the deep path');
+
+  const js = call(handler, 'GET', '/docs', '/shell.js');
+  assert.equal(js.status, 200);
+  assert.equal(js.headers['Content-Type'], 'application/javascript; charset=utf-8');
+  assert.equal(call(handler, 'GET', '/docs', '/shell.js', { 'if-none-match': js.headers.ETag }).status, 304);
+
+  const yml = call(handler, 'GET', '/docs', '/collection.yml');
+  assert.equal(yml.status, 200);
+  assert.equal(yml.headers['Cache-Control'], 'private, no-store');
+  assert.equal(call(handler, 'GET', '/docs', '/collection.yml', { 'if-none-match': yml.headers.ETag }).status, 304);
+
+  const head = call(handler, 'HEAD', '/docs', '/');
+  assert.equal(head.status, 200);
+  assert.equal(head.body, undefined, 'HEAD answers like GET with no body');
+
+  for (const method of ['POST', 'PUT', 'DELETE', 'PATCH']) {
+    const res = call(handler, method, '/docs', '/');
+    assert.equal(res.status, 405, `${method} is refused`);
+    assert.equal(res.headers.Allow, 'GET, HEAD');
+  }
+}
+
+// --- the same handler at a different mount, with no query-string confusion
+{
+  assert.ok(call(handler, 'GET', '/api/v2/docs', '/').body.includes('data-base="/api/v2/docs/"'),
+    'the base comes from the mount the request arrived on');
+  assert.equal(call(handler, 'GET', '/docs', '/shell.js?v=2').status, 200, 'a query string is not part of the route');
+}
+
+// --- a framework that does not set originalUrl still works when mounted at the root
+{
+  const res = { status: 0, headers: {}, body: undefined };
+  handler({ method: 'GET', url: '/shell.js', headers: {} }, {
+    writeHead(s, h) {
+      res.status = s;
+      res.headers = h ?? {};
+    },
+    end(b) {
+      res.body = b;
+    }
+  });
+  assert.equal(res.status, 200);
+}
+
+// --- a framework that hands over an empty url is treated as the mount root, not a bad redirect
+{
+  const res = { status: 0, headers: {} };
+  handler({ method: 'GET', url: '', originalUrl: '', headers: {} }, {
+    writeHead(s, h) {
+      res.status = s;
+      res.headers = h ?? {};
+    },
+    end() {}
+  });
+  assert.equal(res.status, 200, 'an empty url serves the page rather than redirecting to nowhere');
+  assert.equal(res.headers.Location, undefined);
+}
+
+// --- a broken setup starts the app and explains itself at the mount
+{
+  const missing = path.join(os.tmpdir(), 'bruno-docs-absent-' + Date.now());
+  let broken;
+  assert.doesNotThrow(() => {
+    broken = quiet(() => createDocs({ collection: missing }));
+  }, 'createDocs never throws: a docs page cannot take down the API it documents');
+
+  const brokenHandler = broken.handler();
+  for (const route of ['/', '/shell.js', '/collection.yml', '/deep/path/']) {
+    const res = call(brokenHandler, 'GET', '/docs', route);
+    assert.equal(res.status, 404, `${route} answers with the reason`);
+    assert.match(String(res.body), /Collection not found/);
+  }
+
+  assert.match(broken.embed({ base: '/docs' }), /<!-- bruno api docs: Collection not found/);
+
+  const overCap = quiet(() => createDocs({
+    collection: path.join(here, '..', '..', '..', 'contract-tests', 'fixtures', 'walk-oversize')
+  }));
+  assert.equal(overCap.collection().status, 413, 'a collection over the caps is a 413 at the mount');
+
+  const badOptions = quiet(() => createDocs({ collection, environments: { exclude: ['Prod'] } }));
+  assert.equal(badOptions.collection().status, 500, 'a config error reaches the mount too, not the boot');
+}
+
+// --- embed(): the block only, with the mount stamped in
+{
+  const embed = docs.embed({ base: '/docs' });
+  assert.ok(embed.includes('src="/docs/shell.js"'), 'a base without a trailing slash still works');
+  assert.equal(docs.embed({ base: '/docs/' }), embed, 'with or without, the same block');
+  assert.throws(() => docs.embed({ base: '' }), /`base`/);
+}
+
+fs.rmSync(path.join(os.tmpdir(), 'x-not-there'), { force: true });
+console.log('docs-test: all assertions passed');
diff --git a/integrations/nodejs/core/test/filter.test.mjs b/integrations/nodejs/core/test/filter.test.mjs
index 195db80e..0ec754b7 100644
--- a/integrations/nodejs/core/test/filter.test.mjs
+++ b/integrations/nodejs/core/test/filter.test.mjs
@@ -106,10 +106,9 @@ assert.equal(isRequestTagsIncluded(['a'], ['a', 'b'], []), true, 'any one includ
 assert.equal(isRequestTagsIncluded(['a', 'b'], [], ['b']), false, 'any one exclude tag is fatal');
 
 // --- startup validation of the same options
-assert.throws(() => validateOptions({ collection: './c', environments: { exclude: ['Prod'] } }), /needs a base/);
-assert.throws(() => validateOptions({ collection: './c', environments: { all: true, include: ['Local'] } }), /cannot be combined/);
-assert.throws(() => validateOptions({}), /`collection` is required/);
-validateOptions({ collection: './c' });
-validateOptions({ collection: './c', environments: { all: true, exclude: ['Prod'] } });
+assert.throws(() => validateOptions({ environments: { exclude: ['Prod'] } }), /needs a base/);
+assert.throws(() => validateOptions({ environments: { all: true, include: ['Local'] } }), /cannot be combined/);
+validateOptions({ environments: { all: true, exclude: ['Prod'] } });
+validateOptions({});
 
 console.log('filter-test: all assertions passed');
diff --git a/integrations/nodejs/core/test/shell.test.mjs b/integrations/nodejs/core/test/shell.test.mjs
index ec5128bc..d980ebd4 100644
--- a/integrations/nodejs/core/test/shell.test.mjs
+++ b/integrations/nodejs/core/test/shell.test.mjs
@@ -9,7 +9,7 @@ import { createRequire } from 'node:module';
 const here = path.dirname(fileURLToPath(import.meta.url));
 const require = createRequire(import.meta.url);
 const dist = path.join(here, '..', 'dist');
-const { loadShell, rendererConfig, stripGitCredentials, CDN } = require(path.join(dist, 'shell.js'));
+const { loadShell, rendererConfig, stripGitCredentials, CDN } = require(path.join(dist, 'routes', 'shell.js'));
 
 // --- stamping: every placeholder is filled, at any mount
 {
diff --git a/integrations/package.json b/integrations/package.json
index a21b6196..aac45988 100644
--- a/integrations/package.json
+++ b/integrations/package.json
@@ -14,6 +14,7 @@
     "lint:fix": "eslint --fix",
     "test:assemble": "node shell/test/assemble.test.mjs",
     "test:collection": "npm run build:core && node nodejs/core/test/collection.test.mjs",
+    "test:docs": "npm run build && node nodejs/core/test/docs.test.mjs",
     "test:filter": "npm run build:core && node nodejs/core/test/filter.test.mjs",
     "test:shell": "npm run build && node nodejs/core/test/shell.test.mjs",
     "test:walk": "npm run build:core && node nodejs/core/test/walk.test.mjs"

From fa7ff0b0287115d715854d7116c51d83e1fbead4 Mon Sep 17 00:00:00 2001
From: Arpit Bruno <arpit@usebruno.com>
Date: Thu, 17 Sep 2026 10:35:45 +0530
Subject: [PATCH 07/21] adds: express framework integratiins and  the shared
 fixture and a contract suite built for the test matrix

---
 integrations/contract-tests/check.sh          | 186 ++++
 .../api-collection/catalog/folder.yml         |   3 +
 .../api-collection/catalog/get product.yml    |   7 +
 .../api-collection/catalog/list products.yml  |   7 +
 .../catalog/reindex catalog.yml               |   9 +
 .../api-collection/environments/Local.yml     |   6 +
 .../api-collection/environments/Prod.yml      |   6 +
 .../api-collection/internal/folder.yml        |   3 +
 .../api-collection/internal/purge cache.yml   |  12 +
 .../api-collection/mixed/drain node.yml       |  10 +
 .../fixtures/api-collection/mixed/folder.yml  |   3 +
 .../fixtures/api-collection/mixed/health.yml  |   7 +
 .../api-collection/opencollection.yml         |   9 +
 .../contract-tests/fixtures/bundled.yml       |  13 +
 integrations/nodejs/express/example/server.js |  57 +
 integrations/nodejs/express/package.json      |  21 +
 integrations/nodejs/express/src/index.ts      |  13 +
 integrations/nodejs/express/tsconfig.json     |  10 +
 integrations/package-lock.json                | 971 +++++++++++++++++-
 integrations/package.json                     |   8 +-
 20 files changed, 1358 insertions(+), 3 deletions(-)
 create mode 100755 integrations/contract-tests/check.sh
 create mode 100644 integrations/contract-tests/fixtures/api-collection/catalog/folder.yml
 create mode 100644 integrations/contract-tests/fixtures/api-collection/catalog/get product.yml
 create mode 100644 integrations/contract-tests/fixtures/api-collection/catalog/list products.yml
 create mode 100644 integrations/contract-tests/fixtures/api-collection/catalog/reindex catalog.yml
 create mode 100644 integrations/contract-tests/fixtures/api-collection/environments/Local.yml
 create mode 100644 integrations/contract-tests/fixtures/api-collection/environments/Prod.yml
 create mode 100644 integrations/contract-tests/fixtures/api-collection/internal/folder.yml
 create mode 100644 integrations/contract-tests/fixtures/api-collection/internal/purge cache.yml
 create mode 100644 integrations/contract-tests/fixtures/api-collection/mixed/drain node.yml
 create mode 100644 integrations/contract-tests/fixtures/api-collection/mixed/folder.yml
 create mode 100644 integrations/contract-tests/fixtures/api-collection/mixed/health.yml
 create mode 100644 integrations/contract-tests/fixtures/api-collection/opencollection.yml
 create mode 100644 integrations/contract-tests/fixtures/bundled.yml
 create mode 100644 integrations/nodejs/express/example/server.js
 create mode 100644 integrations/nodejs/express/package.json
 create mode 100644 integrations/nodejs/express/src/index.ts
 create mode 100644 integrations/nodejs/express/tsconfig.json

diff --git a/integrations/contract-tests/check.sh b/integrations/contract-tests/check.sh
new file mode 100755
index 00000000..de691768
--- /dev/null
+++ b/integrations/contract-tests/check.sh
@@ -0,0 +1,186 @@
+#!/usr/bin/env bash
+# The HTTP contract every wrapper, in every framework, in every language must satisfy.
+# Boots one example, asserts from outside it, exits non-zero on any miss.
+#
+#   bash contract-tests/check.sh --example nodejs/express/example/server.js --port 5456
+#   bash contract-tests/check.sh --example ... --save /tmp/express      keep the served bodies
+#   bash contract-tests/check.sh --example ... --compare /tmp/express   diff bodies against a run
+#
+# Every example serves the same five mounts over the same fixture. That convention is what makes
+# one script cover the whole matrix: a cell is an invocation, not an edit.
+#
+#   /docs          environments include Local, tags exclude internal, pageTitle, gitCollectionUrl
+#   /api/v2/docs   environments all minus Prod
+#   /internal/docs no options
+#   /bundled/docs  a single bundled yml
+#   /broken/docs   a collection that is not there
+set -euo pipefail
+
+ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+EXAMPLE=""
+PORT=5456
+SAVE=""
+COMPARE=""
+
+while [ $# -gt 0 ]; do
+  case "$1" in
+    --example) EXAMPLE="$2"; shift 2 ;;
+    --port) PORT="$2"; shift 2 ;;
+    --save) SAVE="$2"; shift 2 ;;
+    --compare) COMPARE="$2"; shift 2 ;;
+    *) echo "unknown argument: $1" >&2; exit 2 ;;
+  esac
+done
+[ -n "$EXAMPLE" ] || { echo "--example is required" >&2; exit 2; }
+case "$EXAMPLE" in /*) ;; *) EXAMPLE="$ROOT/$EXAMPLE" ;; esac
+[ -f "$EXAMPLE" ] || { echo "no example at $EXAMPLE" >&2; exit 2; }
+
+BASE="http://localhost:$PORT"
+TMP="$(mktemp -d)"
+# stderr goes first: the shell announces a killed background job, and that reads like a failure
+trap 'exec 2>/dev/null; pkill -P "${SERVER_PID:-0}" || true; kill "${SERVER_PID:-0}" || true; rm -rf "$TMP"' EXIT
+
+pass=0
+fail=0
+check() {
+  local name=$1
+  shift
+  if "$@"; then
+    pass=$((pass + 1))
+    printf '  ok   %s\n' "$name"
+  else
+    fail=$((fail + 1))
+    printf '  FAIL %s\n' "$name"
+  fi
+}
+
+# ---- helpers: each asserts exactly one fact ---------------------------------
+
+status_is() { [ "$(curl -s -o /dev/null -w '%{http_code}' "${@:2}")" = "$1" ]; }
+header_of() { curl -s -D - -o /dev/null "${@:2}" | tr -d '\r' | awk -v k="$1" 'tolower($1)==tolower(k":"){sub(/^[^:]*: */,"");print}'; }
+header_has() { local name=$1 want=$2; shift 2; header_of "$name" "$@" | grep -q "$want"; }
+header_absent() { local name=$1; shift; [ -z "$(header_of "$name" "$@")" ]; }
+body_has() { curl -s "$1" | grep -q "$2"; }
+body_lacks() { ! curl -s "$1" | grep -Eq "$2"; }
+file_has() { grep -q "$2" "$1"; }
+file_lacks() { ! grep -q "$2" "$1"; }
+revalidates() { status_is 304 -H "If-None-Match: $(header_of ETag "$1")" "$1"; }
+redirects_to() { status_is 301 "$1" && [ "$(header_of Location "$1")" = "$2" ]; }
+paths_in() { node -e 'const d=JSON.parse(require("fs").readFileSync(process.argv[1],"utf8"));console.log(Object.keys(d.files).sort().join(","))' "$1"; }
+paths_are() { [ "$(paths_in "$1")" = "$2" ]; }
+none_mention() { ! grep -q "$1" "${@:2}"; }
+no_origins() { ! grep -oE 'https?://[A-Za-z0-9./_-]+' "$1" | grep -q .; }
+config_of() { curl -s "$1" | grep -o 'data-config="[^"]*"'; }
+config_lacks() { ! config_of "$1" | grep -Eq "&quot;($2)&quot;:"; }
+
+# ---- boot, from a different cwd on purpose ---------------------------------
+
+# a leftover server on this port would answer every assertion, and the suite would be grading
+# the wrong process. Say so once, instead of failing fifty times.
+if curl -s -o /dev/null --max-time 1 "$BASE/control"; then
+  echo "port $PORT is already serving something. Stop it, or pass --port." >&2
+  exit 2
+fi
+
+( cd "$TMP" && PORT="$PORT" node "$EXAMPLE" >"$TMP/server.log" 2>&1 ) &
+SERVER_PID=$!
+for _ in $(seq 1 60); do curl -s -o /dev/null "$BASE/control" && break; sleep 0.1; done
+curl -s -o /dev/null "$BASE/control" || { echo "server did not start"; cat "$TMP/server.log"; exit 1; }
+echo "booted $(basename "$(dirname "$(dirname "$EXAMPLE")")")/$(basename "$EXAMPLE") on :$PORT from $TMP"
+
+# ---- the routes, identical at every mount ----------------------------------
+
+for MOUNT in /docs /api/v2/docs /internal/docs; do
+  echo "== $MOUNT"
+  url="$BASE$MOUNT"
+  last="${MOUNT##*/}"
+  saved="${MOUNT//\//_}"
+
+  check "$MOUNT -> 301 to relative '$last/'"                  redirects_to "$url" "$last/"
+  check "$MOUNT/ -> text/html"                                 header_has Content-Type text/html "$url/"
+  check "$MOUNT/ -> no-cache, it carries the mount base"       header_has Cache-Control no-cache "$url/"
+  check "$MOUNT/ no inline script"                             body_lacks "$url/" '<script>|<script[^>]*>[^<]'
+  check "$MOUNT/ no inline style"                              body_lacks "$url/" '<style'
+  check "$MOUNT/ loads shell.js from the mount, same origin"   body_has "$url/" "src=\"$MOUNT/shell.js\""
+  check "$MOUNT/<deep>/ serves the shell with the mount base"  body_has "$url/catalog/list-products/" "data-base=\"$MOUNT/\""
+  check "$MOUNT/shell.js -> javascript"                        header_has Content-Type javascript "$url/shell.js"
+  check "$MOUNT/shell.js -> public, max-age=3600"              header_has Cache-Control 'public, max-age=3600' "$url/shell.js"
+  check "$MOUNT/shell.js -> 304 on If-None-Match"              revalidates "$url/shell.js"
+  check "$MOUNT/collection.yml -> no-store"                    header_has Cache-Control no-store "$url/collection.yml"
+  check "$MOUNT/collection.yml -> nosniff"                     header_has X-Content-Type-Options nosniff "$url/collection.yml"
+  check "$MOUNT/collection.yml -> 304 on If-None-Match"        revalidates "$url/collection.yml"
+  check "$MOUNT/collection.yml -> no Last-Modified"            header_absent Last-Modified "$url/collection.yml"
+  check "$MOUNT/ POST -> 405"                                  status_is 405 -X POST "$url/"
+  check "$MOUNT/ POST -> Allow: GET, HEAD"                     header_has Allow 'GET, HEAD' "$url/" -X POST
+  check "$MOUNT/ HEAD -> 200"                                  status_is 200 -I "$url/"
+
+  curl -s "$url/collection.yml" >"$TMP/coll$saved.json"
+  curl -s "$url/shell.js" >"$TMP/shell$saved.js"
+done
+
+echo "== shell.js is one file, whatever the mount"
+check "byte-identical across mounts"            cmp -s "$TMP/shell_docs.js" "$TMP/shell_api_v2_docs.js"
+check "byte-identical across mounts (2)"        cmp -s "$TMP/shell_docs.js" "$TMP/shell_internal_docs.js"
+check "no origin is baked into the bundle"      no_origins "$TMP/shell_docs.js"
+check "it understands the fragments envelope"   file_has "$TMP/shell_docs.js" 'opencollection-fragments'
+
+echo "== environments: server side, by whole file"
+check "/docs include Local -> exactly Local"    file_has "$TMP/coll_docs.json" 'environments/Local.yml'
+check "/docs -> no other environment"           file_lacks "$TMP/coll_docs.json" 'environments/Prod.yml'
+check "/api/v2 all minus Prod -> Local only"    file_has "$TMP/coll_api_v2_docs.json" 'environments/Local.yml'
+check "/api/v2 -> Prod file absent"             file_lacks "$TMP/coll_api_v2_docs.json" 'environments/Prod.yml'
+check "/internal default -> no environments"    file_lacks "$TMP/coll_internal_docs.json" 'environments/'
+check "Prod's token appears in no served byte"  none_mention 'prod-token-must-never-be-served' "$TMP"/coll_*.json "$TMP"/shell_docs.js
+
+echo "== tags: server side, by whole file, folders pruned behind them"
+check "/docs -> the tagged request is gone"     file_lacks "$TMP/coll_docs.json" 'reindex catalog'
+check "/docs -> its URL literal is gone too"    file_lacks "$TMP/coll_docs.json" 'admin/reindex-catalog'
+check "/docs -> a folder with no survivor goes" file_lacks "$TMP/coll_docs.json" 'internal/folder.yml'
+check "/docs -> a folder with one survives"     file_has "$TMP/coll_docs.json" 'mixed/folder.yml'
+check "/docs -> and keeps its survivor"         file_has "$TMP/coll_docs.json" 'mixed/health.yml'
+check "/docs -> collection auth always ships"   file_has "$TMP/coll_docs.json" 'apiToken'
+check "/internal no tags -> tagged request served" file_has "$TMP/coll_internal_docs.json" 'reindex catalog'
+check "/docs serves exactly these seven files" paths_are "$TMP/coll_docs.json" \
+  'catalog/folder.yml,catalog/get product.yml,catalog/list products.yml,environments/Local.yml,mixed/folder.yml,mixed/health.yml,opencollection.yml'
+
+echo "== what reaches the browser"
+check "/docs title comes from pageTitle"        body_has "$BASE/docs/" '<title>Acme API</title>'
+check "/docs data-config has no pageTitle"      config_lacks "$BASE/docs/" 'pageTitle'
+check "/docs data-config has no server option"  config_lacks "$BASE/docs/" 'tags|environments|collection'
+check "/docs git url is forwarded"              body_has "$BASE/docs/" 'acme/api-collection'
+check "/docs git credentials are stripped"      body_lacks "$BASE/docs/" 'token:secret'
+
+echo "== a single bundled file"
+check "/bundled/docs/ -> the page"              status_is 200 "$BASE/bundled/docs/"
+check "/bundled/docs/collection.yml -> yaml"    header_has Content-Type yaml "$BASE/bundled/docs/collection.yml"
+check "/bundled/docs/collection.yml -> ETag"    revalidates "$BASE/bundled/docs/collection.yml"
+check "/bundled/docs -> served as written"      body_has "$BASE/bundled/docs/collection.yml" 'Acme API (bundled)'
+
+echo "== a broken setup does not stop the app"
+check "the app's own route still answers"       body_has "$BASE/control" 'the app itself'
+check "/broken/docs/ -> 404, not a crash"       status_is 404 "$BASE/broken/docs/"
+check "/broken/docs/ says what is wrong"        body_has "$BASE/broken/docs/" 'Collection not found'
+check "/broken/docs/collection.yml -> 404 too"  status_is 404 "$BASE/broken/docs/collection.yml"
+
+echo "== the adopter's CSP holds"
+check "helmet's CSP header is intact"           header_has Content-Security-Policy "script-src 'self' https://cdn.usebruno.com" "$BASE/docs/"
+
+# ---- bodies, for comparing one framework against another -------------------
+
+if [ -n "$SAVE" ]; then
+  mkdir -p "$SAVE"
+  cp "$TMP"/coll_*.json "$TMP"/shell_docs.js "$SAVE/"
+  echo "saved served bodies to $SAVE"
+fi
+
+if [ -n "$COMPARE" ]; then
+  echo "== byte-identical to $COMPARE"
+  for f in "$TMP"/coll_*.json "$TMP"/shell_docs.js; do
+    name="$(basename "$f")"
+    check "$name matches" cmp -s "$f" "$COMPARE/$name"
+  done
+fi
+
+echo
+echo "$pass passed, $fail failed"
+[ "$fail" -eq 0 ]
diff --git a/integrations/contract-tests/fixtures/api-collection/catalog/folder.yml b/integrations/contract-tests/fixtures/api-collection/catalog/folder.yml
new file mode 100644
index 00000000..11250ef1
--- /dev/null
+++ b/integrations/contract-tests/fixtures/api-collection/catalog/folder.yml
@@ -0,0 +1,3 @@
+info:
+  name: Catalog
+  seq: 1
diff --git a/integrations/contract-tests/fixtures/api-collection/catalog/get product.yml b/integrations/contract-tests/fixtures/api-collection/catalog/get product.yml
new file mode 100644
index 00000000..e7800b3d
--- /dev/null
+++ b/integrations/contract-tests/fixtures/api-collection/catalog/get product.yml	
@@ -0,0 +1,7 @@
+info:
+  name: Get product
+  type: http
+  seq: 2
+http:
+  method: GET
+  url: "{{baseUrl}}/products/:id"
diff --git a/integrations/contract-tests/fixtures/api-collection/catalog/list products.yml b/integrations/contract-tests/fixtures/api-collection/catalog/list products.yml
new file mode 100644
index 00000000..6aceaf3d
--- /dev/null
+++ b/integrations/contract-tests/fixtures/api-collection/catalog/list products.yml	
@@ -0,0 +1,7 @@
+info:
+  name: List products
+  type: http
+  seq: 1
+http:
+  method: GET
+  url: "{{baseUrl}}/products"
diff --git a/integrations/contract-tests/fixtures/api-collection/catalog/reindex catalog.yml b/integrations/contract-tests/fixtures/api-collection/catalog/reindex catalog.yml
new file mode 100644
index 00000000..fc96dfc5
--- /dev/null
+++ b/integrations/contract-tests/fixtures/api-collection/catalog/reindex catalog.yml	
@@ -0,0 +1,9 @@
+info:
+  name: Reindex catalog
+  type: http
+  seq: 3
+  tags:
+    - internal
+http:
+  method: POST
+  url: "{{baseUrl}}/admin/reindex-catalog"
diff --git a/integrations/contract-tests/fixtures/api-collection/environments/Local.yml b/integrations/contract-tests/fixtures/api-collection/environments/Local.yml
new file mode 100644
index 00000000..dd6595d0
--- /dev/null
+++ b/integrations/contract-tests/fixtures/api-collection/environments/Local.yml
@@ -0,0 +1,6 @@
+name: Local
+variables:
+  - name: baseUrl
+    value: http://localhost:5456
+  - name: apiToken
+    value: local-token-safe-to-publish
diff --git a/integrations/contract-tests/fixtures/api-collection/environments/Prod.yml b/integrations/contract-tests/fixtures/api-collection/environments/Prod.yml
new file mode 100644
index 00000000..8e1c0f3c
--- /dev/null
+++ b/integrations/contract-tests/fixtures/api-collection/environments/Prod.yml
@@ -0,0 +1,6 @@
+name: Prod
+variables:
+  - name: baseUrl
+    value: https://api.acme.test
+  - name: apiToken
+    value: prod-token-must-never-be-served
diff --git a/integrations/contract-tests/fixtures/api-collection/internal/folder.yml b/integrations/contract-tests/fixtures/api-collection/internal/folder.yml
new file mode 100644
index 00000000..30c588aa
--- /dev/null
+++ b/integrations/contract-tests/fixtures/api-collection/internal/folder.yml
@@ -0,0 +1,3 @@
+info:
+  name: Internal
+  seq: 2
diff --git a/integrations/contract-tests/fixtures/api-collection/internal/purge cache.yml b/integrations/contract-tests/fixtures/api-collection/internal/purge cache.yml
new file mode 100644
index 00000000..9ef927f8
--- /dev/null
+++ b/integrations/contract-tests/fixtures/api-collection/internal/purge cache.yml	
@@ -0,0 +1,12 @@
+info:
+  name: Purge cache
+  type: http
+  seq: 1
+  tags:
+    - internal
+http:
+  method: POST
+  url: "{{baseUrl}}/admin/purge-cache"
+  headers:
+    - name: X-Admin-Key
+      value: "{{adminKey}}"
diff --git a/integrations/contract-tests/fixtures/api-collection/mixed/drain node.yml b/integrations/contract-tests/fixtures/api-collection/mixed/drain node.yml
new file mode 100644
index 00000000..a87b8c6f
--- /dev/null
+++ b/integrations/contract-tests/fixtures/api-collection/mixed/drain node.yml	
@@ -0,0 +1,10 @@
+info:
+  name: Drain node
+  type: http
+  seq: 2
+  tags:
+    - internal
+    - dangerous
+http:
+  method: POST
+  url: "{{baseUrl}}/admin/drain-node"
diff --git a/integrations/contract-tests/fixtures/api-collection/mixed/folder.yml b/integrations/contract-tests/fixtures/api-collection/mixed/folder.yml
new file mode 100644
index 00000000..7bd91d15
--- /dev/null
+++ b/integrations/contract-tests/fixtures/api-collection/mixed/folder.yml
@@ -0,0 +1,3 @@
+info:
+  name: Mixed
+  seq: 3
diff --git a/integrations/contract-tests/fixtures/api-collection/mixed/health.yml b/integrations/contract-tests/fixtures/api-collection/mixed/health.yml
new file mode 100644
index 00000000..dd0e2134
--- /dev/null
+++ b/integrations/contract-tests/fixtures/api-collection/mixed/health.yml
@@ -0,0 +1,7 @@
+info:
+  name: Health
+  type: http
+  seq: 1
+http:
+  method: GET
+  url: "{{baseUrl}}/health"
diff --git a/integrations/contract-tests/fixtures/api-collection/opencollection.yml b/integrations/contract-tests/fixtures/api-collection/opencollection.yml
new file mode 100644
index 00000000..725513ec
--- /dev/null
+++ b/integrations/contract-tests/fixtures/api-collection/opencollection.yml
@@ -0,0 +1,9 @@
+opencollection: 1.0.0
+info:
+  name: Acme API
+  version: 1.0.0
+  summary: The fixture every example serves and every contract run asserts against.
+bundled: false
+auth:
+  type: bearer
+  token: "{{apiToken}}"
diff --git a/integrations/contract-tests/fixtures/bundled.yml b/integrations/contract-tests/fixtures/bundled.yml
new file mode 100644
index 00000000..a64280e3
--- /dev/null
+++ b/integrations/contract-tests/fixtures/bundled.yml
@@ -0,0 +1,13 @@
+opencollection: 1.0.0
+info:
+  name: Acme API (bundled)
+  version: 1.0.0
+bundled: true
+items:
+  - type: folder
+    name: Catalog
+    items:
+      - type: http
+        name: List products
+        method: GET
+        url: https://api.acme.test/products
diff --git a/integrations/nodejs/express/example/server.js b/integrations/nodejs/express/example/server.js
new file mode 100644
index 00000000..4be0b359
--- /dev/null
+++ b/integrations/nodejs/express/example/server.js
@@ -0,0 +1,57 @@
+'use strict';
+
+const path = require('node:path');
+const express = require('express');
+const helmet = require('helmet');
+const { apiDocs } = require('@usebruno/api-docs-express');
+
+const PORT = Number(process.env.PORT || 5456);
+// relative on purpose: the core resolves it against this file, not the cwd, and check.sh
+// boots from a different directory to prove it. COLLECTION overrides it for pack-and-install,
+// which runs this example from a temp dir with the packages installed from tarballs.
+const COLLECTION = process.env.COLLECTION || '../../../contract-tests/fixtures/api-collection';
+const BUNDLED = process.env.BUNDLED || '../../../contract-tests/fixtures/bundled.yml';
+
+const app = express();
+
+// a strict CSP. scripts: 'self' covers shell.js, the CDN serves the renderer.
+// styles still need 'unsafe-inline' and Google Fonts until the renderer stops injecting its own.
+app.use(
+  helmet({
+    contentSecurityPolicy: {
+      directives: {
+        scriptSrc: ["'self'", 'https://cdn.usebruno.com'],
+        styleSrc: ["'self'", "'unsafe-inline'", 'https://cdn.usebruno.com', 'https://fonts.googleapis.com'],
+        fontSrc: ["'self'", 'https://fonts.gstatic.com'],
+        connectSrc: ["'self'"]
+      }
+    }
+  })
+);
+
+app.get('/control', (req, res) => res.json({ ok: true, from: 'the app itself' }));
+
+app.use('/docs', apiDocs({
+  collection: COLLECTION,
+  environments: { include: ['Local'] },
+  tags: { exclude: ['internal'] },
+  pageTitle: 'Acme API',
+  gitCollectionUrl: 'https://token:secret@github.com/acme/api-collection'
+}));
+
+app.use('/api/v2/docs', apiDocs({ collection: COLLECTION, environments: { all: true, exclude: ['Prod'] } }));
+
+app.use('/internal/docs', apiDocs({ collection: COLLECTION }));
+
+app.use('/bundled/docs', apiDocs({ collection: BUNDLED }));
+
+app.use('/broken/docs', apiDocs({ collection: './there-is-no-collection-here' }));
+
+app.listen(PORT, () => {
+  console.log(`express example on http://localhost:${PORT}`);
+  console.log('  /docs/           Local only, internal-tagged requests hidden');
+  console.log('  /api/v2/docs/    every environment except Prod');
+  console.log('  /internal/docs/  defaults: no environments, every request');
+  console.log('  /bundled/docs/   a single bundled yml');
+  console.log('  /broken/docs/    a collection that is not there, to prove the app still starts');
+});
diff --git a/integrations/nodejs/express/package.json b/integrations/nodejs/express/package.json
new file mode 100644
index 00000000..c9c6b36a
--- /dev/null
+++ b/integrations/nodejs/express/package.json
@@ -0,0 +1,21 @@
+{
+  "name": "@usebruno/api-docs-express",
+  "version": "0.1.0-beta.1",
+  "private": true,
+  "description": "Serve a Bruno collection as API docs from inside your own Express app, behind your own auth.",
+  "license": "MIT",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "peerDependencies": {
+    "express": "^4.0.0 || ^5.0.0"
+  },
+  "dependencies": {
+    "@usebruno/api-docs-core": "0.1.0-beta.1"
+  }
+}
diff --git a/integrations/nodejs/express/src/index.ts b/integrations/nodejs/express/src/index.ts
new file mode 100644
index 00000000..003e26aa
--- /dev/null
+++ b/integrations/nodejs/express/src/index.ts
@@ -0,0 +1,13 @@
+import type { RequestHandler } from 'express';
+import { createDocs, type ApiDocsOptions } from '@usebruno/api-docs-core';
+
+export type { ApiDocsOptions, CollectionOptions, RendererOptions, EnvironmentsOption, TagsOption }
+  from '@usebruno/api-docs-core';
+
+/**
+ * `app.use('/docs', apiDocs({ collection: './api-collection' }))`. Express decides the mount and
+ * strips it before the handler sees the request, so there is no `mountPath` here.
+ */
+export function apiDocs(options: ApiDocsOptions): RequestHandler {
+  return createDocs(options).handler();
+}
diff --git a/integrations/nodejs/express/tsconfig.json b/integrations/nodejs/express/tsconfig.json
new file mode 100644
index 00000000..3493e6ba
--- /dev/null
+++ b/integrations/nodejs/express/tsconfig.json
@@ -0,0 +1,10 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "rootDir": "src",
+    "outDir": "dist"
+  },
+  "include": [
+    "src"
+  ]
+}
diff --git a/integrations/package-lock.json b/integrations/package-lock.json
index aa5e449c..8dc7ab6e 100644
--- a/integrations/package-lock.json
+++ b/integrations/package-lock.json
@@ -12,13 +12,16 @@
       "devDependencies": {
         "@eslint/js": "^9.39.5",
         "@stylistic/eslint-plugin": "^5.3.1",
+        "@types/express": "^5.0.0",
         "@types/js-yaml": "^4.0.9",
         "@types/node": "^22.10.0",
         "@typescript-eslint/eslint-plugin": "^8.65.0",
         "@typescript-eslint/parser": "^8.39.0",
         "esbuild": "^0.24.0",
         "eslint": "^9.21.0",
+        "express": "^5.0.0",
         "globals": "^16.0.0",
+        "helmet": "^8.0.0",
         "typescript": "^5.7.0"
       }
     },
@@ -763,6 +766,27 @@
         "eslint": "^9.0.0 || ^10.0.0"
       }
     },
+    "node_modules/@types/body-parser": {
+      "version": "1.19.6",
+      "resolved": "https://registry.npmjs.org/@types/body-parser/-/body-parser-1.19.6.tgz",
+      "integrity": "sha512-HLFeCYgz89uk22N5Qg3dvGvsv46B8GLvKKo1zKG4NybA8U2DiEO3w9lqGg29t/tfLRJpJ6iQxnVw4OnB7MoM9g==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@types/connect": "*",
+        "@types/node": "*"
+      }
+    },
+    "node_modules/@types/connect": {
+      "version": "3.4.38",
+      "resolved": "https://registry.npmjs.org/@types/connect/-/connect-3.4.38.tgz",
+      "integrity": "sha512-K6uROf1LD88uDQqJCktA4yzL1YYAK6NgfsI0v/mTgyPKWsX1CnJ0XPSDhViejru1GcRkLWb8RlzFYJRqGUbaug==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@types/node": "*"
+      }
+    },
     "node_modules/@types/estree": {
       "version": "1.0.9",
       "resolved": "https://registry.npmjs.org/@types/estree/-/estree-1.0.9.tgz",
@@ -770,6 +794,38 @@
       "dev": true,
       "license": "MIT"
     },
+    "node_modules/@types/express": {
+      "version": "5.0.6",
+      "resolved": "https://registry.npmjs.org/@types/express/-/express-5.0.6.tgz",
+      "integrity": "sha512-sKYVuV7Sv9fbPIt/442koC7+IIwK5olP1KWeD88e/idgoJqDm3JV/YUiPwkoKK92ylff2MGxSz1CSjsXelx0YA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@types/body-parser": "*",
+        "@types/express-serve-static-core": "^5.0.0",
+        "@types/serve-static": "^2"
+      }
+    },
+    "node_modules/@types/express-serve-static-core": {
+      "version": "5.1.3",
+      "resolved": "https://registry.npmjs.org/@types/express-serve-static-core/-/express-serve-static-core-5.1.3.tgz",
+      "integrity": "sha512-dPfW8NFiOF4wOHc7+N/QSxlY9cfSsenewGbAz8C8U/MULPd/YZ27LvJUIlzaXie7e6Ove9YunJGgC9tbHD2cKw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@types/node": "*",
+        "@types/qs": "*",
+        "@types/range-parser": "*",
+        "@types/send": "*"
+      }
+    },
+    "node_modules/@types/http-errors": {
+      "version": "2.0.5",
+      "resolved": "https://registry.npmjs.org/@types/http-errors/-/http-errors-2.0.5.tgz",
+      "integrity": "sha512-r8Tayk8HJnX0FztbZN7oVqGccWgw98T/0neJphO91KkmOzug1KkofZURD4UaD5uH8AqcFLfdPErnBod0u71/qg==",
+      "dev": true,
+      "license": "MIT"
+    },
     "node_modules/@types/js-yaml": {
       "version": "4.0.9",
       "resolved": "https://registry.npmjs.org/@types/js-yaml/-/js-yaml-4.0.9.tgz",
@@ -794,6 +850,41 @@
         "undici-types": "~6.21.0"
       }
     },
+    "node_modules/@types/qs": {
+      "version": "6.15.1",
+      "resolved": "https://registry.npmjs.org/@types/qs/-/qs-6.15.1.tgz",
+      "integrity": "sha512-GZHUBZR9hckSUhrxmp1nG6NwdpM9fCunJwyThLW1X3AyHgd9IlHb6VANpQQqDr2o/qQp6McZ3y/IA2rVzKzSbw==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/@types/range-parser": {
+      "version": "1.2.7",
+      "resolved": "https://registry.npmjs.org/@types/range-parser/-/range-parser-1.2.7.tgz",
+      "integrity": "sha512-hKormJbkJqzQGhziax5PItDUTMAM9uE2XXQmM37dyd4hVM+5aVl7oVxMVUiVQn2oCQFN/LKCZdvSM0pFRqbSmQ==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/@types/send": {
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/@types/send/-/send-1.2.1.tgz",
+      "integrity": "sha512-arsCikDvlU99zl1g69TcAB3mzZPpxgw0UQnaHeC1Nwb015xp8bknZv5rIfri9xTOcMuaVgvabfIRA7PSZVuZIQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@types/node": "*"
+      }
+    },
+    "node_modules/@types/serve-static": {
+      "version": "2.2.0",
+      "resolved": "https://registry.npmjs.org/@types/serve-static/-/serve-static-2.2.0.tgz",
+      "integrity": "sha512-8mam4H1NHLtu7nmtalF7eyBH14QyOASmcxHhSfEoRyr0nP/YdoesEtU+uSRvMe96TW/HPTtkoKqQLl53N7UXMQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@types/http-errors": "*",
+        "@types/node": "*"
+      }
+    },
     "node_modules/@typescript-eslint/eslint-plugin": {
       "version": "8.70.0",
       "resolved": "https://registry.npmjs.org/@typescript-eslint/eslint-plugin/-/eslint-plugin-8.70.0.tgz",
@@ -1031,6 +1122,23 @@
       "resolved": "nodejs/core",
       "link": true
     },
+    "node_modules/@usebruno/api-docs-express": {
+      "resolved": "nodejs/express",
+      "link": true
+    },
+    "node_modules/accepts": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/accepts/-/accepts-2.0.0.tgz",
+      "integrity": "sha512-5cvg6CtKwfgdmVqY1WIiXKc3Q1bkRqGLi+2W/6ao+6Y7gu/RCwRuAhGEzh5B4KlszSuTLgZYuqFqo5bImjNKng==",
+      "license": "MIT",
+      "dependencies": {
+        "mime-types": "^3.0.0",
+        "negotiator": "^1.0.0"
+      },
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
     "node_modules/acorn": {
       "version": "8.18.0",
       "resolved": "https://registry.npmjs.org/acorn/-/acorn-8.18.0.tgz",
@@ -1103,6 +1211,43 @@
         "node": "18 || 20 || >=22"
       }
     },
+    "node_modules/body-parser": {
+      "version": "2.3.0",
+      "resolved": "https://registry.npmjs.org/body-parser/-/body-parser-2.3.0.tgz",
+      "integrity": "sha512-2cGmJupaNgg+QUwVLAucDuWuoMZ6EX9iHDRswZ5lsNYEmwPaRknMPCLZz07yTzVq/83p4o/wzbDZbBrTvGGTIw==",
+      "license": "MIT",
+      "dependencies": {
+        "bytes": "^3.1.2",
+        "content-type": "^2.0.0",
+        "debug": "^4.4.3",
+        "http-errors": "^2.0.1",
+        "iconv-lite": "^0.7.2",
+        "on-finished": "^2.4.1",
+        "qs": "^6.15.2",
+        "raw-body": "^3.0.2",
+        "type-is": "^2.1.0"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
+      }
+    },
+    "node_modules/body-parser/node_modules/content-type": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/content-type/-/content-type-2.1.0.tgz",
+      "integrity": "sha512-mj7UPXE0jaqaOsukNZRUEfEi2AcL7C/vwmwcHV0O97eO1E1pxBZuyjlZrx5seTaNBg1U6+o35wpa35Qfcc+7ag==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
+      }
+    },
     "node_modules/brace-expansion": {
       "version": "5.0.9",
       "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-5.0.9.tgz",
@@ -1116,6 +1261,44 @@
         "node": "20 || >=22"
       }
     },
+    "node_modules/bytes": {
+      "version": "3.1.2",
+      "resolved": "https://registry.npmjs.org/bytes/-/bytes-3.1.2.tgz",
+      "integrity": "sha512-/Nf7TyzTx6S3yRJObOAV7956r8cr2+Oj8AC5dt8wSP3BQAoeX58NoHyCU8P8zGkNXStjTSi6fzO6F0pBdcYbEg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/call-bind-apply-helpers": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/call-bind-apply-helpers/-/call-bind-apply-helpers-1.0.2.tgz",
+      "integrity": "sha512-Sp1ablJ0ivDkSzjcaJdxEunN5/XvksFJ2sMBFfq6x0ryhQV/2b/KwFe21cMpmHtPOSij8K99/wSfoEuTObmuMQ==",
+      "license": "MIT",
+      "dependencies": {
+        "es-errors": "^1.3.0",
+        "function-bind": "^1.1.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/call-bound": {
+      "version": "1.0.4",
+      "resolved": "https://registry.npmjs.org/call-bound/-/call-bound-1.0.4.tgz",
+      "integrity": "sha512-+ys997U96po4Kx/ABpBCqhA9EuxJaQWDQg7295H4hBphv3IZg0boBKuwYpt4YXp6MZ5AmZQnU/tyMTlRpaSejg==",
+      "license": "MIT",
+      "dependencies": {
+        "call-bind-apply-helpers": "^1.0.2",
+        "get-intrinsic": "^1.3.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
     "node_modules/callsites": {
       "version": "3.1.0",
       "resolved": "https://registry.npmjs.org/callsites/-/callsites-3.1.0.tgz",
@@ -1170,6 +1353,46 @@
       "dev": true,
       "license": "MIT"
     },
+    "node_modules/content-disposition": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/content-disposition/-/content-disposition-1.1.0.tgz",
+      "integrity": "sha512-5jRCH9Z/+DRP7rkvY83B+yGIGX96OYdJmzngqnw2SBSxqCFPd0w2km3s5iawpGX8krnwSGmF0FW5Nhr0Hfai3g==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
+      }
+    },
+    "node_modules/content-type": {
+      "version": "1.0.5",
+      "resolved": "https://registry.npmjs.org/content-type/-/content-type-1.0.5.tgz",
+      "integrity": "sha512-nTjqfcBFEipKdXCv4YDQWCfmcLZKm81ldF0pAopTvyrFGVbcR6P/VAAd5G7N+0tTr8QqiU0tFadD6FK4NtJwOA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/cookie": {
+      "version": "0.7.2",
+      "resolved": "https://registry.npmjs.org/cookie/-/cookie-0.7.2.tgz",
+      "integrity": "sha512-yki5XnKuf750l50uGTllt6kKILY4nQ1eNIQatoXEByZ5dWgnKqbnqmTrBE5B4N7lrMJKQ2ytWMiTO2o0v6Ew/w==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/cookie-signature": {
+      "version": "1.2.2",
+      "resolved": "https://registry.npmjs.org/cookie-signature/-/cookie-signature-1.2.2.tgz",
+      "integrity": "sha512-D76uU73ulSXrD1UXF4KE2TMxVVwhsnCgfAyTg9k8P6KGZjlXKrOLe4dJQKI3Bxi5wjesZoFXJWElNWBjPZMbhg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=6.6.0"
+      }
+    },
     "node_modules/cross-spawn": {
       "version": "7.0.6",
       "resolved": "https://registry.npmjs.org/cross-spawn/-/cross-spawn-7.0.6.tgz",
@@ -1189,7 +1412,6 @@
       "version": "4.4.3",
       "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.3.tgz",
       "integrity": "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==",
-      "dev": true,
       "license": "MIT",
       "dependencies": {
         "ms": "^2.1.3"
@@ -1210,6 +1432,74 @@
       "dev": true,
       "license": "MIT"
     },
+    "node_modules/depd": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/depd/-/depd-2.0.0.tgz",
+      "integrity": "sha512-g7nH6P6dyDioJogAAGprGpCtVImJhpPk/roCzdb3fIh61/s/nPsfR6onyMwkCAR/OlC3yBC0lESvUoQEAssIrw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/dunder-proto": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/dunder-proto/-/dunder-proto-1.0.1.tgz",
+      "integrity": "sha512-KIN/nDJBQRcXw0MLVhZE9iQHmG68qAVIBg9CqmUYjmQIhgij9U5MFvrqkUL5FbtyyzZuOeOt0zdeRe4UY7ct+A==",
+      "license": "MIT",
+      "dependencies": {
+        "call-bind-apply-helpers": "^1.0.1",
+        "es-errors": "^1.3.0",
+        "gopd": "^1.2.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/ee-first": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/ee-first/-/ee-first-1.1.1.tgz",
+      "integrity": "sha512-WMwm9LhRUo+WUaRN+vRuETqG89IgZphVSNkdFgeb6sS/E4OrDIN7t48CAewSHXc6C8lefD8KKfr5vY61brQlow==",
+      "license": "MIT"
+    },
+    "node_modules/encodeurl": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/encodeurl/-/encodeurl-2.0.0.tgz",
+      "integrity": "sha512-Q0n9HRi4m6JuGIV1eFlmvJB7ZEVxu93IrMyiMsGC0lrMJMWzRgx6WGquyfQgZVb31vhGgXnfmPNNXmxnOkRBrg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/es-define-property": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/es-define-property/-/es-define-property-1.0.1.tgz",
+      "integrity": "sha512-e3nRfgfUZ4rNGL232gUgX06QNyyez04KdjFrF+LTRoOXmrOgFKDg4BCdsjW8EnT69eqdYGmRpJwiPVYNrCaW3g==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/es-errors": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/es-errors/-/es-errors-1.3.0.tgz",
+      "integrity": "sha512-Zf5H2Kxt2xjTvbJvP2ZWLEICxA6j+hAmMzIlypy4xcBg1vKVnx89Wy0GbS+kf5cwCVFFzdCFh2XSCFNULS6csw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/es-object-atoms": {
+      "version": "1.1.2",
+      "resolved": "https://registry.npmjs.org/es-object-atoms/-/es-object-atoms-1.1.2.tgz",
+      "integrity": "sha512-HWcBoN6NileqtSydK2FqHbS/LoDd2pqrnQHLyJzBj4kOp/ky2MWMN694xOfkK8/SnUsW2DH7EfyVlydKCsm1Zw==",
+      "license": "MIT",
+      "dependencies": {
+        "es-errors": "^1.3.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
     "node_modules/esbuild": {
       "version": "0.24.2",
       "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.24.2.tgz",
@@ -1251,6 +1541,12 @@
         "@esbuild/win32-x64": "0.24.2"
       }
     },
+    "node_modules/escape-html": {
+      "version": "1.0.3",
+      "resolved": "https://registry.npmjs.org/escape-html/-/escape-html-1.0.3.tgz",
+      "integrity": "sha512-NiSupZ4OeuGwr68lGIeym/ksIZMJodUGOSCZ/FSnTxcrekbvqrgdUxlJOMpijaKZVjAJrWrGs/6Jy8OMuyj9ow==",
+      "license": "MIT"
+    },
     "node_modules/escape-string-regexp": {
       "version": "4.0.0",
       "resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-4.0.0.tgz",
@@ -1460,6 +1756,58 @@
         "node": ">=0.10.0"
       }
     },
+    "node_modules/etag": {
+      "version": "1.8.1",
+      "resolved": "https://registry.npmjs.org/etag/-/etag-1.8.1.tgz",
+      "integrity": "sha512-aIL5Fx7mawVa300al2BnEE4iNvo1qETxLrPI/o05L7z6go7fCw1J6EQmbK4FmJ2AS7kgVF/KEZWufBfdClMcPg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/express": {
+      "version": "5.2.1",
+      "resolved": "https://registry.npmjs.org/express/-/express-5.2.1.tgz",
+      "integrity": "sha512-hIS4idWWai69NezIdRt2xFVofaF4j+6INOpJlVOLDO8zXGpUVEVzIYk12UUi2JzjEzWL3IOAxcTubgz9Po0yXw==",
+      "license": "MIT",
+      "dependencies": {
+        "accepts": "^2.0.0",
+        "body-parser": "^2.2.1",
+        "content-disposition": "^1.0.0",
+        "content-type": "^1.0.5",
+        "cookie": "^0.7.1",
+        "cookie-signature": "^1.2.1",
+        "debug": "^4.4.0",
+        "depd": "^2.0.0",
+        "encodeurl": "^2.0.0",
+        "escape-html": "^1.0.3",
+        "etag": "^1.8.1",
+        "finalhandler": "^2.1.0",
+        "fresh": "^2.0.0",
+        "http-errors": "^2.0.0",
+        "merge-descriptors": "^2.0.0",
+        "mime-types": "^3.0.0",
+        "on-finished": "^2.4.1",
+        "once": "^1.4.0",
+        "parseurl": "^1.3.3",
+        "proxy-addr": "^2.0.7",
+        "qs": "^6.14.0",
+        "range-parser": "^1.2.1",
+        "router": "^2.2.0",
+        "send": "^1.1.0",
+        "serve-static": "^2.2.0",
+        "statuses": "^2.0.1",
+        "type-is": "^2.0.1",
+        "vary": "^1.1.2"
+      },
+      "engines": {
+        "node": ">= 18"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
+      }
+    },
     "node_modules/fast-deep-equal": {
       "version": "3.1.3",
       "resolved": "https://registry.npmjs.org/fast-deep-equal/-/fast-deep-equal-3.1.3.tgz",
@@ -1512,6 +1860,27 @@
         "node": ">=16.0.0"
       }
     },
+    "node_modules/finalhandler": {
+      "version": "2.1.1",
+      "resolved": "https://registry.npmjs.org/finalhandler/-/finalhandler-2.1.1.tgz",
+      "integrity": "sha512-S8KoZgRZN+a5rNwqTxlZZePjT/4cnm0ROV70LedRHZ0p8u9fRID0hJUZQpkKLzro8LfmC8sx23bY6tVNxv8pQA==",
+      "license": "MIT",
+      "dependencies": {
+        "debug": "^4.4.0",
+        "encodeurl": "^2.0.0",
+        "escape-html": "^1.0.3",
+        "on-finished": "^2.4.1",
+        "parseurl": "^1.3.3",
+        "statuses": "^2.0.1"
+      },
+      "engines": {
+        "node": ">= 18.0.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
+      }
+    },
     "node_modules/find-up": {
       "version": "5.0.0",
       "resolved": "https://registry.npmjs.org/find-up/-/find-up-5.0.0.tgz",
@@ -1550,6 +1919,70 @@
       "dev": true,
       "license": "ISC"
     },
+    "node_modules/forwarded": {
+      "version": "0.2.0",
+      "resolved": "https://registry.npmjs.org/forwarded/-/forwarded-0.2.0.tgz",
+      "integrity": "sha512-buRG0fpBtRHSTCOASe6hD258tEubFoRLb4ZNA6NxMVHNw2gOcwHo9wyablzMzOA5z9xA9L1KNjk/Nt6MT9aYow==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/fresh": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/fresh/-/fresh-2.0.0.tgz",
+      "integrity": "sha512-Rx/WycZ60HOaqLKAi6cHRKKI7zxWbJ31MhntmtwMoaTeF7XFH9hhBp8vITaMidfljRQ6eYWCKkaTK+ykVJHP2A==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/function-bind": {
+      "version": "1.1.2",
+      "resolved": "https://registry.npmjs.org/function-bind/-/function-bind-1.1.2.tgz",
+      "integrity": "sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA==",
+      "license": "MIT",
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/get-intrinsic": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/get-intrinsic/-/get-intrinsic-1.3.0.tgz",
+      "integrity": "sha512-9fSjSaos/fRIVIp+xSJlE6lfwhES7LNtKaCBIamHsjr2na1BiABJPo0mOjjz8GJDURarmCPGqaiVg5mfjb98CQ==",
+      "license": "MIT",
+      "dependencies": {
+        "call-bind-apply-helpers": "^1.0.2",
+        "es-define-property": "^1.0.1",
+        "es-errors": "^1.3.0",
+        "es-object-atoms": "^1.1.1",
+        "function-bind": "^1.1.2",
+        "get-proto": "^1.0.1",
+        "gopd": "^1.2.0",
+        "has-symbols": "^1.1.0",
+        "hasown": "^2.0.2",
+        "math-intrinsics": "^1.1.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/get-proto": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/get-proto/-/get-proto-1.0.1.tgz",
+      "integrity": "sha512-sTSfBjoXBp89JvIKIefqw7U2CCebsc74kiY6awiGogKtoSGbgjYE/G/+l9sF3MWFPNc9IcoOC4ODfKHfxFmp0g==",
+      "license": "MIT",
+      "dependencies": {
+        "dunder-proto": "^1.0.1",
+        "es-object-atoms": "^1.0.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
     "node_modules/glob-parent": {
       "version": "6.0.2",
       "resolved": "https://registry.npmjs.org/glob-parent/-/glob-parent-6.0.2.tgz",
@@ -1576,6 +2009,18 @@
         "url": "https://github.com/sponsors/sindresorhus"
       }
     },
+    "node_modules/gopd": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/gopd/-/gopd-1.2.0.tgz",
+      "integrity": "sha512-ZUKRh6/kUFoAiTAtTYPZJ3hw9wNxx+BIBOijnlG9PnrJsCcSjs1wyyD6vJpaYtgnzDrKYRSqf3OO6Rfa93xsRg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
     "node_modules/has-flag": {
       "version": "4.0.0",
       "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz",
@@ -1586,6 +2031,79 @@
         "node": ">=8"
       }
     },
+    "node_modules/has-symbols": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/has-symbols/-/has-symbols-1.1.0.tgz",
+      "integrity": "sha512-1cDNdwJ2Jaohmb3sg4OmKaMBwuC48sYni5HUw2DvsC8LjGTLK9h+eb1X6RyuOHe4hT0ULCW68iomhjUoKUqlPQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/hasown": {
+      "version": "2.0.4",
+      "resolved": "https://registry.npmjs.org/hasown/-/hasown-2.0.4.tgz",
+      "integrity": "sha512-T2UbfbBEF32wiepXIsMlTW9+dDYC6wMh/t/vYA4tuOMKqWz/n3vr1NFSxQiyP+zk2mXsoMA/i/7qV6LKut1t1A==",
+      "license": "MIT",
+      "dependencies": {
+        "function-bind": "^1.1.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/helmet": {
+      "version": "8.3.0",
+      "resolved": "https://registry.npmjs.org/helmet/-/helmet-8.3.0.tgz",
+      "integrity": "sha512-Qgpiaws3Sm30Av8Eah6sjMCZZwjlBu+E68rhpCWBshY1lb09HtLwj5GviX0OyQIn+ulUS0iX0AxN5n3tLZzz1w==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=18.0.0"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/EvanHahn"
+      }
+    },
+    "node_modules/http-errors": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/http-errors/-/http-errors-2.0.1.tgz",
+      "integrity": "sha512-4FbRdAX+bSdmo4AUFuS0WNiPz8NgFt+r8ThgNWmlrjQjt1Q7ZR9+zTlce2859x4KSXrwIsaeTqDoKQmtP8pLmQ==",
+      "license": "MIT",
+      "dependencies": {
+        "depd": "~2.0.0",
+        "inherits": "~2.0.4",
+        "setprototypeof": "~1.2.0",
+        "statuses": "~2.0.2",
+        "toidentifier": "~1.0.1"
+      },
+      "engines": {
+        "node": ">= 0.8"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
+      }
+    },
+    "node_modules/iconv-lite": {
+      "version": "0.7.3",
+      "resolved": "https://registry.npmjs.org/iconv-lite/-/iconv-lite-0.7.3.tgz",
+      "integrity": "sha512-IKXpvIzjnC9XTAUbVBcMfGS0EPaIXtW6v+zr+RRp+hqULEpo0owZax6wyRwPOJbWbzjYspQwusTsfVr0ifh4uQ==",
+      "license": "MIT",
+      "dependencies": {
+        "safer-buffer": ">= 2.1.2 < 3.0.0"
+      },
+      "engines": {
+        "node": ">=0.10.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
+      }
+    },
     "node_modules/ignore": {
       "version": "7.0.9",
       "resolved": "https://registry.npmjs.org/ignore/-/ignore-7.0.9.tgz",
@@ -1623,6 +2141,21 @@
         "node": ">=0.8.19"
       }
     },
+    "node_modules/inherits": {
+      "version": "2.0.4",
+      "resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.4.tgz",
+      "integrity": "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ==",
+      "license": "ISC"
+    },
+    "node_modules/ipaddr.js": {
+      "version": "1.9.1",
+      "resolved": "https://registry.npmjs.org/ipaddr.js/-/ipaddr.js-1.9.1.tgz",
+      "integrity": "sha512-0KI/607xoxSToH7GjN1FfSbLoU0+btTicjsQSWQlh/hZykN8KpmMf7uYwPW3R+akZ6R/w18ZlXSHBYXiYUPO3g==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.10"
+      }
+    },
     "node_modules/is-extglob": {
       "version": "2.1.1",
       "resolved": "https://registry.npmjs.org/is-extglob/-/is-extglob-2.1.1.tgz",
@@ -1646,6 +2179,12 @@
         "node": ">=0.10.0"
       }
     },
+    "node_modules/is-promise": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/is-promise/-/is-promise-4.0.0.tgz",
+      "integrity": "sha512-hvpoI6korhJMnej285dSg6nu1+e6uxs7zG3BYAm5byqDsgJNWwxzM6z6iZiAgQR4TJ30JmBTOwqZUw3WlyH3AQ==",
+      "license": "MIT"
+    },
     "node_modules/isexe": {
       "version": "2.0.0",
       "resolved": "https://registry.npmjs.org/isexe/-/isexe-2.0.0.tgz",
@@ -1743,6 +2282,65 @@
       "dev": true,
       "license": "MIT"
     },
+    "node_modules/math-intrinsics": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/math-intrinsics/-/math-intrinsics-1.1.0.tgz",
+      "integrity": "sha512-/IXtbwEk5HTPyEwyKX6hGkYXxM9nbj64B+ilVJnC/R6B0pH5G4V3b0pVbL7DBj4tkhBAppbQUlf6F6Xl9LHu1g==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/media-typer": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/media-typer/-/media-typer-1.1.1.tgz",
+      "integrity": "sha512-yz3xRaG20c6/BOzvYoDaGtPmGscs7YivItZEEqe6GbwNfHuxu9YNmvnEkMzKldAGY4/80pRcQRZSEnhquk9XuQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.8"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
+      }
+    },
+    "node_modules/merge-descriptors": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/merge-descriptors/-/merge-descriptors-2.0.0.tgz",
+      "integrity": "sha512-Snk314V5ayFLhp3fkUREub6WtjBfPdCPY1Ln8/8munuLuiYhsABgBVWsozAG+MWMbVEvcdcpbi9R7ww22l9Q3g==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/mime-db": {
+      "version": "1.54.0",
+      "resolved": "https://registry.npmjs.org/mime-db/-/mime-db-1.54.0.tgz",
+      "integrity": "sha512-aU5EJuIN2WDemCcAp2vFBfp/m4EAhWJnUNSSw0ixs7/kXbd6Pg64EmwJkNdFhB8aWt1sH2CTXrLxo/iAGV3oPQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/mime-types": {
+      "version": "3.0.2",
+      "resolved": "https://registry.npmjs.org/mime-types/-/mime-types-3.0.2.tgz",
+      "integrity": "sha512-Lbgzdk0h4juoQ9fCKXW4by0UJqj+nOOrI9MJ1sSj4nI8aI2eo1qmvQEie4VD1glsS250n15LsWsYtCugiStS5A==",
+      "license": "MIT",
+      "dependencies": {
+        "mime-db": "^1.54.0"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
+      }
+    },
     "node_modules/minimatch": {
       "version": "10.2.6",
       "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-10.2.6.tgz",
@@ -1763,7 +2361,6 @@
       "version": "2.1.3",
       "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz",
       "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==",
-      "dev": true,
       "license": "MIT"
     },
     "node_modules/natural-compare": {
@@ -1773,6 +2370,68 @@
       "dev": true,
       "license": "MIT"
     },
+    "node_modules/negotiator": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/negotiator/-/negotiator-1.1.0.tgz",
+      "integrity": "sha512-NMPBRMJgiQHjbd8phG3Vebdx4kZ1H121rbl5IkMqeOsahptB9BKo/d7oJ3zTXqTgagn2bWlNSXkh0QUGM31RYg==",
+      "license": "MIT",
+      "dependencies": {
+        "content-type": "^2.1.0"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
+      }
+    },
+    "node_modules/negotiator/node_modules/content-type": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/content-type/-/content-type-2.1.0.tgz",
+      "integrity": "sha512-mj7UPXE0jaqaOsukNZRUEfEi2AcL7C/vwmwcHV0O97eO1E1pxBZuyjlZrx5seTaNBg1U6+o35wpa35Qfcc+7ag==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
+      }
+    },
+    "node_modules/object-inspect": {
+      "version": "1.13.4",
+      "resolved": "https://registry.npmjs.org/object-inspect/-/object-inspect-1.13.4.tgz",
+      "integrity": "sha512-W67iLl4J2EXEGTbfeHCffrjDfitvLANg0UlX3wFUUSTx92KXRFegMHUVgSqE+wvhAbi4WqjGg9czysTV2Epbew==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/on-finished": {
+      "version": "2.4.1",
+      "resolved": "https://registry.npmjs.org/on-finished/-/on-finished-2.4.1.tgz",
+      "integrity": "sha512-oVlzkg3ENAhCk2zdv7IJwd/QUD4z2RxRwpkcGY8psCVcCYZNq4wYnVWALHM+brtuJjePWiYF/ClmuDr8Ch5+kg==",
+      "license": "MIT",
+      "dependencies": {
+        "ee-first": "1.1.1"
+      },
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/once": {
+      "version": "1.4.0",
+      "resolved": "https://registry.npmjs.org/once/-/once-1.4.0.tgz",
+      "integrity": "sha512-lNaJgI+2Q5URQBkccEKHTQOPaXdUxnZZElQTZY0MFUAuaEqe1E+Nyvgdz/aIyNi6Z9MzO5dv1H8n58/GELp3+w==",
+      "license": "ISC",
+      "dependencies": {
+        "wrappy": "1"
+      }
+    },
     "node_modules/optionator": {
       "version": "0.9.4",
       "resolved": "https://registry.npmjs.org/optionator/-/optionator-0.9.4.tgz",
@@ -1836,6 +2495,15 @@
         "node": ">=6"
       }
     },
+    "node_modules/parseurl": {
+      "version": "1.3.3",
+      "resolved": "https://registry.npmjs.org/parseurl/-/parseurl-1.3.3.tgz",
+      "integrity": "sha512-CiyeOxFT/JZyN5m0z9PfXw4SCBJ6Sygz1Dpl0wqjlhDEGGBP1GnsUVEL0p63hoG1fcj3fHynXi9NYO4nWOL+qQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
     "node_modules/path-exists": {
       "version": "4.0.0",
       "resolved": "https://registry.npmjs.org/path-exists/-/path-exists-4.0.0.tgz",
@@ -1856,6 +2524,16 @@
         "node": ">=8"
       }
     },
+    "node_modules/path-to-regexp": {
+      "version": "8.4.2",
+      "resolved": "https://registry.npmjs.org/path-to-regexp/-/path-to-regexp-8.4.2.tgz",
+      "integrity": "sha512-qRcuIdP69NPm4qbACK+aDogI5CBDMi1jKe0ry5rSQJz8JVLsC7jV8XpiJjGRLLol3N+R5ihGYcrPLTno6pAdBA==",
+      "license": "MIT",
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
+      }
+    },
     "node_modules/picomatch": {
       "version": "4.0.7",
       "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-4.0.7.tgz",
@@ -1879,6 +2557,19 @@
         "node": ">= 0.8.0"
       }
     },
+    "node_modules/proxy-addr": {
+      "version": "2.0.7",
+      "resolved": "https://registry.npmjs.org/proxy-addr/-/proxy-addr-2.0.7.tgz",
+      "integrity": "sha512-llQsMLSUDUPT44jdrU/O37qlnifitDP+ZwrmmZcoSKyLKvtZxpyV0n2/bD/N4tBAAZ/gJEdZU7KMraoK1+XYAg==",
+      "license": "MIT",
+      "dependencies": {
+        "forwarded": "0.2.0",
+        "ipaddr.js": "1.9.1"
+      },
+      "engines": {
+        "node": ">= 0.10"
+      }
+    },
     "node_modules/punycode": {
       "version": "2.3.1",
       "resolved": "https://registry.npmjs.org/punycode/-/punycode-2.3.1.tgz",
@@ -1889,6 +2580,50 @@
         "node": ">=6"
       }
     },
+    "node_modules/qs": {
+      "version": "6.16.0",
+      "resolved": "https://registry.npmjs.org/qs/-/qs-6.16.0.tgz",
+      "integrity": "sha512-h6fhOIaRrID2CbEY2fqs+7t+UXZo+MLAnU5gRIq85uFtdiUPCdsApMlHhXogKVM4HM2DVbIjGNTTYH2OcmP1vA==",
+      "license": "BSD-3-Clause",
+      "dependencies": {
+        "es-define-property": "^1.0.1",
+        "side-channel": "^1.1.1"
+      },
+      "engines": {
+        "node": ">=0.6"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/range-parser": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/range-parser/-/range-parser-1.3.0.tgz",
+      "integrity": "sha512-hek2mFQpPuI4E1BBKrSto+BU3e3x4xuarsbiwr3+lf7p44juvFMV0XFWQAP3xUyqXA4RrXLIoaSUGbSt056ZMw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
+      }
+    },
+    "node_modules/raw-body": {
+      "version": "3.0.2",
+      "resolved": "https://registry.npmjs.org/raw-body/-/raw-body-3.0.2.tgz",
+      "integrity": "sha512-K5zQjDllxWkf7Z5xJdV0/B0WTNqx6vxG70zJE4N0kBs4LovmEYWJzQGxC9bS9RAKu3bgM40lrd5zoLJ12MQ5BA==",
+      "license": "MIT",
+      "dependencies": {
+        "bytes": "~3.1.2",
+        "http-errors": "~2.0.1",
+        "iconv-lite": "~0.7.0",
+        "unpipe": "~1.0.0"
+      },
+      "engines": {
+        "node": ">= 0.10"
+      }
+    },
     "node_modules/resolve-from": {
       "version": "4.0.0",
       "resolved": "https://registry.npmjs.org/resolve-from/-/resolve-from-4.0.0.tgz",
@@ -1899,6 +2634,28 @@
         "node": ">=4"
       }
     },
+    "node_modules/router": {
+      "version": "2.2.0",
+      "resolved": "https://registry.npmjs.org/router/-/router-2.2.0.tgz",
+      "integrity": "sha512-nLTrUKm2UyiL7rlhapu/Zl45FwNgkZGaCpZbIHajDYgwlJCOzLSk+cIPAnsEqV955GjILJnKbdQC1nVPz+gAYQ==",
+      "license": "MIT",
+      "dependencies": {
+        "debug": "^4.4.0",
+        "depd": "^2.0.0",
+        "is-promise": "^4.0.0",
+        "parseurl": "^1.3.3",
+        "path-to-regexp": "^8.0.0"
+      },
+      "engines": {
+        "node": ">= 18"
+      }
+    },
+    "node_modules/safer-buffer": {
+      "version": "2.1.2",
+      "resolved": "https://registry.npmjs.org/safer-buffer/-/safer-buffer-2.1.2.tgz",
+      "integrity": "sha512-YZo3K82SD7Riyi0E1EQPojLz7kpepnSQI9IyPbHHg1XXXevb5dJI7tpyN2ADxGcQbHG7vcyRHk0cbwqcQriUtg==",
+      "license": "MIT"
+    },
     "node_modules/semver": {
       "version": "7.8.5",
       "resolved": "https://registry.npmjs.org/semver/-/semver-7.8.5.tgz",
@@ -1912,6 +2669,57 @@
         "node": ">=10"
       }
     },
+    "node_modules/send": {
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/send/-/send-1.2.1.tgz",
+      "integrity": "sha512-1gnZf7DFcoIcajTjTwjwuDjzuz4PPcY2StKPlsGAQ1+YH20IRVrBaXSWmdjowTJ6u8Rc01PoYOGHXfP1mYcZNQ==",
+      "license": "MIT",
+      "dependencies": {
+        "debug": "^4.4.3",
+        "encodeurl": "^2.0.0",
+        "escape-html": "^1.0.3",
+        "etag": "^1.8.1",
+        "fresh": "^2.0.0",
+        "http-errors": "^2.0.1",
+        "mime-types": "^3.0.2",
+        "ms": "^2.1.3",
+        "on-finished": "^2.4.1",
+        "range-parser": "^1.2.1",
+        "statuses": "^2.0.2"
+      },
+      "engines": {
+        "node": ">= 18"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
+      }
+    },
+    "node_modules/serve-static": {
+      "version": "2.2.1",
+      "resolved": "https://registry.npmjs.org/serve-static/-/serve-static-2.2.1.tgz",
+      "integrity": "sha512-xRXBn0pPqQTVQiC8wyQrKs2MOlX24zQ0POGaj0kultvoOCstBQM5yvOhAVSUwOMjQtTvsPWoNCHfPGwaaQJhTw==",
+      "license": "MIT",
+      "dependencies": {
+        "encodeurl": "^2.0.0",
+        "escape-html": "^1.0.3",
+        "parseurl": "^1.3.3",
+        "send": "^1.2.0"
+      },
+      "engines": {
+        "node": ">= 18"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
+      }
+    },
+    "node_modules/setprototypeof": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/setprototypeof/-/setprototypeof-1.2.0.tgz",
+      "integrity": "sha512-E5LDX7Wrp85Kil5bhZv46j8jOeboKq5JMmYM3gVGdGH8xFpPWXUMsNrlODCrkoxMEeNi/XZIwuRvY4XNwYMJpw==",
+      "license": "ISC"
+    },
     "node_modules/shebang-command": {
       "version": "2.0.0",
       "resolved": "https://registry.npmjs.org/shebang-command/-/shebang-command-2.0.0.tgz",
@@ -1935,6 +2743,87 @@
         "node": ">=8"
       }
     },
+    "node_modules/side-channel": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/side-channel/-/side-channel-1.1.1.tgz",
+      "integrity": "sha512-6x6dK6zJdpTzF4sQeNYxwtvBzf6Eg4GtlesS94HOvTudUeyK2WXAaIfmDgsyslYrRBeFIlsi54AYsFGUuhmvrQ==",
+      "license": "MIT",
+      "dependencies": {
+        "es-errors": "^1.3.0",
+        "object-inspect": "^1.13.4",
+        "side-channel-list": "^1.0.1",
+        "side-channel-map": "^1.0.1",
+        "side-channel-weakmap": "^1.0.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/side-channel-list": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/side-channel-list/-/side-channel-list-1.0.1.tgz",
+      "integrity": "sha512-mjn/0bi/oUURjc5Xl7IaWi/OJJJumuoJFQJfDDyO46+hBWsfaVM65TBHq2eoZBhzl9EchxOijpkbRC8SVBQU0w==",
+      "license": "MIT",
+      "dependencies": {
+        "es-errors": "^1.3.0",
+        "object-inspect": "^1.13.4"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/side-channel-map": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/side-channel-map/-/side-channel-map-1.0.1.tgz",
+      "integrity": "sha512-VCjCNfgMsby3tTdo02nbjtM/ewra6jPHmpThenkTYh8pG9ucZ/1P8So4u4FGBek/BjpOVsDCMoLA/iuBKIFXRA==",
+      "license": "MIT",
+      "dependencies": {
+        "call-bound": "^1.0.2",
+        "es-errors": "^1.3.0",
+        "get-intrinsic": "^1.2.5",
+        "object-inspect": "^1.13.3"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/side-channel-weakmap": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/side-channel-weakmap/-/side-channel-weakmap-1.0.2.tgz",
+      "integrity": "sha512-WPS/HvHQTYnHisLo9McqBHOJk2FkHO/tlpvldyrnem4aeQp4hai3gythswg6p01oSoTl58rcpiFAjF2br2Ak2A==",
+      "license": "MIT",
+      "dependencies": {
+        "call-bound": "^1.0.2",
+        "es-errors": "^1.3.0",
+        "get-intrinsic": "^1.2.5",
+        "object-inspect": "^1.13.3",
+        "side-channel-map": "^1.0.1"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/statuses": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/statuses/-/statuses-2.0.2.tgz",
+      "integrity": "sha512-DvEy55V3DB7uknRo+4iOGT5fP1slR8wQohVdknigZPMpMstaKJQWhwiYBACJE3Ul2pTnATihhBYnRhZQHGBiRw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
     "node_modules/strip-json-comments": {
       "version": "3.1.1",
       "resolved": "https://registry.npmjs.org/strip-json-comments/-/strip-json-comments-3.1.1.tgz",
@@ -1978,6 +2867,15 @@
         "url": "https://github.com/sponsors/SuperchupuDev"
       }
     },
+    "node_modules/toidentifier": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/toidentifier/-/toidentifier-1.0.1.tgz",
+      "integrity": "sha512-o5sSPKEkg/DIQNmH43V0/uerLrpzVedkUh8tGNvaeXpfpuwjKenlSox/2O/BTlZUtEe+JG7s5YhEz608PlAHRA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.6"
+      }
+    },
     "node_modules/ts-api-utils": {
       "version": "2.5.0",
       "resolved": "https://registry.npmjs.org/ts-api-utils/-/ts-api-utils-2.5.0.tgz",
@@ -2004,6 +2902,37 @@
         "node": ">= 0.8.0"
       }
     },
+    "node_modules/type-is": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/type-is/-/type-is-2.1.0.tgz",
+      "integrity": "sha512-faYHw0anBbc/kWF3zFTEnxSFOAGUX9GFbOBthvDdLsIlEoWOFOtS0zgCiQYwIskL9iGXZL3kAXD8OoZ4GmMATA==",
+      "license": "MIT",
+      "dependencies": {
+        "content-type": "^2.0.0",
+        "media-typer": "^1.1.0",
+        "mime-types": "^3.0.0"
+      },
+      "engines": {
+        "node": ">= 18"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
+      }
+    },
+    "node_modules/type-is/node_modules/content-type": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/content-type/-/content-type-2.1.0.tgz",
+      "integrity": "sha512-mj7UPXE0jaqaOsukNZRUEfEi2AcL7C/vwmwcHV0O97eO1E1pxBZuyjlZrx5seTaNBg1U6+o35wpa35Qfcc+7ag==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
+      }
+    },
     "node_modules/typescript": {
       "version": "5.9.3",
       "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.9.3.tgz",
@@ -2025,6 +2954,15 @@
       "dev": true,
       "license": "MIT"
     },
+    "node_modules/unpipe": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/unpipe/-/unpipe-1.0.0.tgz",
+      "integrity": "sha512-pjy2bYhSsufwWlKwPc+l3cN7+wuJlK6uz0YdJEOlQDbl6jo/YlPi4mb8agUkVC8BF7V8NuzeyPNqRksA3hztKQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
     "node_modules/uri-js": {
       "version": "4.4.1",
       "resolved": "https://registry.npmjs.org/uri-js/-/uri-js-4.4.1.tgz",
@@ -2035,6 +2973,15 @@
         "punycode": "^2.1.0"
       }
     },
+    "node_modules/vary": {
+      "version": "1.1.2",
+      "resolved": "https://registry.npmjs.org/vary/-/vary-1.1.2.tgz",
+      "integrity": "sha512-BNGbWLfd0eUPabhkXUVm0j8uuvREyTh5ovRa/dyow/BqAbZJyC+5fU+IzQOzmAKzYqYRAISoRhdQr3eIZ/PXqg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
     "node_modules/which": {
       "version": "2.0.2",
       "resolved": "https://registry.npmjs.org/which/-/which-2.0.2.tgz",
@@ -2061,6 +3008,12 @@
         "node": ">=0.10.0"
       }
     },
+    "node_modules/wrappy": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/wrappy/-/wrappy-1.0.2.tgz",
+      "integrity": "sha512-l4Sp/DRseor9wL6EvV2+TuQn63dMkPjZ/sp9XkghTEbV9KlPS1xUsZ3u7/IQO4wxtcFB4bgpQPRcR3QCvezPcQ==",
+      "license": "ISC"
+    },
     "node_modules/yocto-queue": {
       "version": "0.1.0",
       "resolved": "https://registry.npmjs.org/yocto-queue/-/yocto-queue-0.1.0.tgz",
@@ -2084,6 +3037,20 @@
       "engines": {
         "node": ">=20"
       }
+    },
+    "nodejs/express": {
+      "name": "@usebruno/api-docs-express",
+      "version": "0.1.0-beta.1",
+      "license": "MIT",
+      "dependencies": {
+        "@usebruno/api-docs-core": "0.1.0-beta.1"
+      },
+      "engines": {
+        "node": ">=20"
+      },
+      "peerDependencies": {
+        "express": "^4.0.0 || ^5.0.0"
+      }
     }
   }
 }
diff --git a/integrations/package.json b/integrations/package.json
index aac45988..04d1b528 100644
--- a/integrations/package.json
+++ b/integrations/package.json
@@ -7,11 +7,14 @@
     "nodejs/*"
   ],
   "scripts": {
-    "build": "npm run build:shell && npm run build:core",
+    "build": "npm run build:shell && npm run build:core && npm run build:express",
     "build:core": "tsc -p nodejs/core/tsconfig.json",
+    "build:express": "tsc -p nodejs/express/tsconfig.json",
     "build:shell": "esbuild shell/shell.src.mjs --bundle --minify --format=iife --platform=browser --target=es2020 --outfile=shell/shell.js --log-level=warning && mkdir -p nodejs/core/shell && cp shell/shell.html shell/shell.js nodejs/core/shell/",
+    "check:express": "npm run build && bash contract-tests/check.sh --example nodejs/express/example/server.js --port 5456",
     "lint": "eslint",
     "lint:fix": "eslint --fix",
+    "start:express": "node nodejs/express/example/server.js",
     "test:assemble": "node shell/test/assemble.test.mjs",
     "test:collection": "npm run build:core && node nodejs/core/test/collection.test.mjs",
     "test:docs": "npm run build && node nodejs/core/test/docs.test.mjs",
@@ -22,13 +25,16 @@
   "devDependencies": {
     "@eslint/js": "^9.39.5",
     "@stylistic/eslint-plugin": "^5.3.1",
+    "@types/express": "^5.0.0",
     "@types/js-yaml": "^4.0.9",
     "@types/node": "^22.10.0",
     "@typescript-eslint/eslint-plugin": "^8.65.0",
     "@typescript-eslint/parser": "^8.39.0",
     "esbuild": "^0.24.0",
     "eslint": "^9.21.0",
+    "express": "^5.0.0",
     "globals": "^16.0.0",
+    "helmet": "^8.0.0",
     "typescript": "^5.7.0"
   }
 }

From 87e0c4144b9487348f84685ad99c32a3da31e1ab Mon Sep 17 00:00:00 2001
From: Arpit Bruno <arpit@usebruno.com>
Date: Thu, 17 Sep 2026 10:58:35 +0530
Subject: [PATCH 08/21] fastify plugin and example, plus host-isolation
 assertions in check.sh

---
 integrations/contract-tests/check.sh          |  10 +
 integrations/nodejs/fastify/example/server.js |  60 ++
 integrations/nodejs/fastify/package.json      |  21 +
 integrations/nodejs/fastify/src/index.ts      |  47 +
 integrations/nodejs/fastify/tsconfig.json     |   8 +
 integrations/package-lock.json                | 811 +++++++++++++++++-
 integrations/package.json                     |   7 +-
 7 files changed, 961 insertions(+), 3 deletions(-)
 create mode 100644 integrations/nodejs/fastify/example/server.js
 create mode 100644 integrations/nodejs/fastify/package.json
 create mode 100644 integrations/nodejs/fastify/src/index.ts
 create mode 100644 integrations/nodejs/fastify/tsconfig.json

diff --git a/integrations/contract-tests/check.sh b/integrations/contract-tests/check.sh
index de691768..1d24ab82 100755
--- a/integrations/contract-tests/check.sh
+++ b/integrations/contract-tests/check.sh
@@ -162,6 +162,16 @@ check "/broken/docs/ -> 404, not a crash"       status_is 404 "$BASE/broken/docs
 check "/broken/docs/ says what is wrong"        body_has "$BASE/broken/docs/" 'Collection not found'
 check "/broken/docs/collection.yml -> 404 too"  status_is 404 "$BASE/broken/docs/collection.yml"
 
+echo "== the host app is left alone"
+check "its own 404 still comes from it"         status_is 404 -X POST "$BASE/control"
+
+if [ "$(curl -s -o /dev/null -w '%{http_code}' "$BASE/openapi.json")" = "200" ]; then
+  echo "== the host publishes a spec, and the docs routes are not in it"
+  curl -s "$BASE/openapi.json" >"$TMP/spec.json"
+  check "no docs route leaked into it"          file_lacks "$TMP/spec.json" '/docs'
+  check "the host's own routes are still there" file_has "$TMP/spec.json" '/control'
+fi
+
 echo "== the adopter's CSP holds"
 check "helmet's CSP header is intact"           header_has Content-Security-Policy "script-src 'self' https://cdn.usebruno.com" "$BASE/docs/"
 
diff --git a/integrations/nodejs/fastify/example/server.js b/integrations/nodejs/fastify/example/server.js
new file mode 100644
index 00000000..eb44a214
--- /dev/null
+++ b/integrations/nodejs/fastify/example/server.js
@@ -0,0 +1,60 @@
+'use strict';
+
+const Fastify = require('fastify');
+const { apiDocs } = require('@usebruno/api-docs-fastify');
+
+const PORT = Number(process.env.PORT || 5457);
+// relative on purpose: the core resolves it against this file, not the cwd
+const COLLECTION = process.env.COLLECTION || '../../../contract-tests/fixtures/api-collection';
+const BUNDLED = process.env.BUNDLED || '../../../contract-tests/fixtures/bundled.yml';
+
+const app = Fastify({ logger: false });
+
+
+// the same strict CSP the Express example sets with helmet, by hand here so the example
+// stays free of a plugin the contract does not depend on
+app.addHook('onSend', async (request, reply) => {
+  reply.header(
+    'content-security-policy',
+    "default-src 'self'; "
+    + "script-src 'self' https://cdn.usebruno.com; "
+    + "style-src 'self' 'unsafe-inline' https://cdn.usebruno.com https://fonts.googleapis.com; "
+    + "font-src 'self' https://fonts.gstatic.com; "
+    + "connect-src 'self'"
+  );
+});
+
+async function main() {
+  // swagger first and awaited: it only records routes registered after it loads, so a host that
+  // registers it late publishes an empty spec
+  await app.register(require('@fastify/swagger'), {
+    openapi: { info: { title: 'Acme API', version: '1.0.0' } }
+  });
+
+  app.get('/control', async () => ({ ok: true, from: 'the app itself' }));
+  app.get('/openapi.json', { schema: { hide: true } }, async () => app.swagger());
+
+  await app.register(apiDocs, {
+    prefix: '/docs',
+    collection: COLLECTION,
+    environments: { include: ['Local'] },
+    tags: { exclude: ['internal'] },
+    pageTitle: 'Acme API',
+    gitCollectionUrl: 'https://token:secret@github.com/acme/api-collection'
+  });
+
+  await app.register(apiDocs, {
+    prefix: '/api/v2/docs',
+    collection: COLLECTION,
+    environments: { all: true, exclude: ['Prod'] }
+  });
+
+  await app.register(apiDocs, { prefix: '/internal/docs', collection: COLLECTION });
+  await app.register(apiDocs, { prefix: '/bundled/docs', collection: BUNDLED });
+  await app.register(apiDocs, { prefix: '/broken/docs', collection: './there-is-no-collection-here' });
+
+  await app.listen({ port: PORT, host: '127.0.0.1' });
+  console.log(`fastify example on http://localhost:${PORT}`);
+}
+
+main();
diff --git a/integrations/nodejs/fastify/package.json b/integrations/nodejs/fastify/package.json
new file mode 100644
index 00000000..cb434d6f
--- /dev/null
+++ b/integrations/nodejs/fastify/package.json
@@ -0,0 +1,21 @@
+{
+  "name": "@usebruno/api-docs-fastify",
+  "version": "0.1.0-beta.1",
+  "private": true,
+  "description": "Serve a Bruno collection as API docs from inside your own Fastify app, behind your own auth.",
+  "license": "MIT",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "peerDependencies": {
+    "fastify": "^4.0.0 || ^5.0.0"
+  },
+  "dependencies": {
+    "@usebruno/api-docs-core": "0.1.0-beta.1"
+  }
+}
diff --git a/integrations/nodejs/fastify/src/index.ts b/integrations/nodejs/fastify/src/index.ts
new file mode 100644
index 00000000..dcb54077
--- /dev/null
+++ b/integrations/nodejs/fastify/src/index.ts
@@ -0,0 +1,47 @@
+import type { FastifyPluginAsync, FastifyReply } from 'fastify';
+import { createDocs, type ApiDocsOptions, type HttpResponse } from '@usebruno/api-docs-core';
+
+export type { ApiDocsOptions, CollectionOptions, RendererOptions, EnvironmentsOption, TagsOption }
+  from '@usebruno/api-docs-core';
+
+/** `hide` is @fastify/swagger's, read at runtime, and Fastify's own FastifySchema omits it. */
+declare module 'fastify' {
+  interface FastifySchema {
+    hide?: boolean;
+  }
+}
+
+const send = (reply: FastifyReply, response: HttpResponse): FastifyReply => {
+  reply.code(response.status).headers(response.headers);
+
+  return response.body === null ? reply.send() : reply.send(response.body);
+};
+
+/**
+ * `await app.register(apiDocs, { collection: './api-collection', prefix: '/docs' })`. The mount is
+ * Fastify's own `prefix`, so there is no `mountPath`. Deliberately not wrapped in `fastify-plugin`:
+ * staying encapsulated is what keeps the 405 off the host's routes and lets an adopter put auth in
+ * front with `child.addHook('onRequest', ...)`.
+ */
+export const apiDocs: FastifyPluginAsync<ApiDocsOptions> = async (fastify, options) => {
+  const docs = createDocs(options);
+  const base = `${fastify.prefix}/`;
+  const lastSegment = fastify.prefix.split('/').filter(Boolean).pop() ?? '';
+  const hide = { schema: { hide: true } };
+
+  // no-slash, or this route claims `/docs/` too and the page below never answers
+  fastify.get('/', { ...hide, prefixTrailingSlash: 'no-slash' }, (request, reply) =>
+    reply.code(301).header('location', `${lastSegment}/`).send());
+
+  fastify.get('/shell.js', hide, (request, reply) =>
+    send(reply, docs.shellJs({ ifNoneMatch: request.headers['if-none-match'] })));
+
+  fastify.get('/collection.yml', hide, (request, reply) =>
+    send(reply, docs.collection({ ifNoneMatch: request.headers['if-none-match'] })));
+
+  fastify.get('/*', hide, (request, reply) => send(reply, docs.shell(base)));
+
+  // a matched path with an unmatched method arrives here, which is where 405 belongs
+  fastify.setNotFoundHandler((request, reply) =>
+    reply.code(405).header('allow', 'GET, HEAD').send());
+};
diff --git a/integrations/nodejs/fastify/tsconfig.json b/integrations/nodejs/fastify/tsconfig.json
new file mode 100644
index 00000000..5285d28a
--- /dev/null
+++ b/integrations/nodejs/fastify/tsconfig.json
@@ -0,0 +1,8 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "rootDir": "src",
+    "outDir": "dist"
+  },
+  "include": ["src"]
+}
diff --git a/integrations/package-lock.json b/integrations/package-lock.json
index 8dc7ab6e..8216d313 100644
--- a/integrations/package-lock.json
+++ b/integrations/package-lock.json
@@ -11,6 +11,7 @@
       ],
       "devDependencies": {
         "@eslint/js": "^9.39.5",
+        "@fastify/swagger": "^9.8.1",
         "@stylistic/eslint-plugin": "^5.3.1",
         "@types/express": "^5.0.0",
         "@types/js-yaml": "^4.0.9",
@@ -20,6 +21,7 @@
         "esbuild": "^0.24.0",
         "eslint": "^9.21.0",
         "express": "^5.0.0",
+        "fastify": "^5.12.5",
         "globals": "^16.0.0",
         "helmet": "^8.0.0",
         "typescript": "^5.7.0"
@@ -679,6 +681,188 @@
         "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
       }
     },
+    "node_modules/@fastify/ajv-compiler": {
+      "version": "4.0.6",
+      "resolved": "https://registry.npmjs.org/@fastify/ajv-compiler/-/ajv-compiler-4.0.6.tgz",
+      "integrity": "sha512-NtuzM0SfaMJbGlnjr9LWQUN5LzgSrbB8tf/wRZNas+4E1O/Nmzl53e7ruT61HDZyRCJGC6FxIogmNZO1c5ETBA==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/fastify"
+        },
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/fastify"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "ajv": "^8.12.0",
+        "ajv-formats": "^3.0.1",
+        "fast-uri": "^4.0.0"
+      }
+    },
+    "node_modules/@fastify/ajv-compiler/node_modules/ajv": {
+      "version": "8.20.0",
+      "resolved": "https://registry.npmjs.org/ajv/-/ajv-8.20.0.tgz",
+      "integrity": "sha512-Thbli+OlOj+iMPYFBVBfJ3OmCAnaSyNn4M1vz9T6Gka5Jt9ba/HIR56joy65tY6kx/FCF5VXNB819Y7/GUrBGA==",
+      "license": "MIT",
+      "dependencies": {
+        "fast-deep-equal": "^3.1.3",
+        "fast-uri": "^3.0.1",
+        "json-schema-traverse": "^1.0.0",
+        "require-from-string": "^2.0.2"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/epoberezkin"
+      }
+    },
+    "node_modules/@fastify/ajv-compiler/node_modules/ajv/node_modules/fast-uri": {
+      "version": "3.1.8",
+      "resolved": "https://registry.npmjs.org/fast-uri/-/fast-uri-3.1.8.tgz",
+      "integrity": "sha512-GZMtZUTNRpOVIECoXwLNZS5xUGE+mVNbTB8h/7Rwh2TFWcBQiPzTgyZi05BF9UMZKkLJv8XBRJTlU7zg8+ZfMg==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/fastify"
+        },
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/fastify"
+        }
+      ],
+      "license": "BSD-3-Clause"
+    },
+    "node_modules/@fastify/ajv-compiler/node_modules/json-schema-traverse": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-1.0.0.tgz",
+      "integrity": "sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug==",
+      "license": "MIT"
+    },
+    "node_modules/@fastify/error": {
+      "version": "4.2.0",
+      "resolved": "https://registry.npmjs.org/@fastify/error/-/error-4.2.0.tgz",
+      "integrity": "sha512-RSo3sVDXfHskiBZKBPRgnQTtIqpi/7zhJOEmAxCiBcM7d0uwdGdxLlsCaLzGs8v8NnxIRlfG0N51p5yFaOentQ==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/fastify"
+        },
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/fastify"
+        }
+      ],
+      "license": "MIT"
+    },
+    "node_modules/@fastify/fast-json-stringify-compiler": {
+      "version": "5.1.0",
+      "resolved": "https://registry.npmjs.org/@fastify/fast-json-stringify-compiler/-/fast-json-stringify-compiler-5.1.0.tgz",
+      "integrity": "sha512-PxcYtKLbQ8Z+yApiqjK8FwxIwvEj38k2OiLc17u8dkJSlmfi2wHHPaSnaoqBPQqtvF8YVsDgDpP2snDCfFrpfw==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/fastify"
+        },
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/fastify"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "fast-json-stringify": "^7.0.0"
+      }
+    },
+    "node_modules/@fastify/forwarded": {
+      "version": "3.0.2",
+      "resolved": "https://registry.npmjs.org/@fastify/forwarded/-/forwarded-3.0.2.tgz",
+      "integrity": "sha512-NE8HgKLgYejV9lDpqkEFaDKMLYelJBVfHekhB0UKvX0ghagXRJqg68feg8er1NPXxG4N9i6vPxzt8E+3wHfcmA==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/fastify"
+        },
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/fastify"
+        }
+      ],
+      "license": "MIT"
+    },
+    "node_modules/@fastify/merge-json-schemas": {
+      "version": "0.2.1",
+      "resolved": "https://registry.npmjs.org/@fastify/merge-json-schemas/-/merge-json-schemas-0.2.1.tgz",
+      "integrity": "sha512-OA3KGBCy6KtIvLf8DINC5880o5iBlDX4SxzLQS8HorJAbqluzLRn80UXU0bxZn7UOFhFgpRJDasfwn9nG4FG4A==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/fastify"
+        },
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/fastify"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "dequal": "^2.0.3"
+      }
+    },
+    "node_modules/@fastify/proxy-addr": {
+      "version": "5.1.1",
+      "resolved": "https://registry.npmjs.org/@fastify/proxy-addr/-/proxy-addr-5.1.1.tgz",
+      "integrity": "sha512-zv07Y9GEuDsJPegZoDFd4SDWaZOW8N2pa0GSrYmKpId/tjt1Hgo3BjZBVjdVpfVrHaA+Qv5jawtS2O50J5xM9g==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/fastify"
+        },
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/fastify"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "@fastify/forwarded": "^3.0.0",
+        "ipaddr.js": "^2.1.0"
+      }
+    },
+    "node_modules/@fastify/proxy-addr/node_modules/ipaddr.js": {
+      "version": "2.5.0",
+      "resolved": "https://registry.npmjs.org/ipaddr.js/-/ipaddr.js-2.5.0.tgz",
+      "integrity": "sha512-aq+t5NAc+cS6rZQQVWC2x98CPqGtKKTMDd4Gaodv0wShnItdKg/51djkGJ1hqH+Oy0ivDftCbSLCQob8zso01w==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 10"
+      }
+    },
+    "node_modules/@fastify/swagger": {
+      "version": "9.8.1",
+      "resolved": "https://registry.npmjs.org/@fastify/swagger/-/swagger-9.8.1.tgz",
+      "integrity": "sha512-VpHMnqZTY8iBZYJE8WWkbKPrXIYWy2rDfIf5qLr6DzZSpQYZ+KxQVcJFiq/AMlvNwI4gCBd66++iUlxXXGT0IQ==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/fastify"
+        },
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/fastify"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "fastify-plugin": "^6.0.0",
+        "json-schema-resolver": "^3.0.0",
+        "openapi-types": "^12.1.3",
+        "rfdc": "^1.3.1",
+        "yaml": "^2.4.2"
+      }
+    },
     "node_modules/@humanfs/core": {
       "version": "0.19.2",
       "resolved": "https://registry.npmjs.org/@humanfs/core/-/core-0.19.2.tgz",
@@ -745,6 +929,12 @@
         "url": "https://github.com/sponsors/nzakas"
       }
     },
+    "node_modules/@pinojs/redact": {
+      "version": "0.4.0",
+      "resolved": "https://registry.npmjs.org/@pinojs/redact/-/redact-0.4.0.tgz",
+      "integrity": "sha512-k2ENnmBugE/rzQfEcdWHcCY+/FM3VLzH9cYEsbdsoqrvzAKRhUZeRNhAZvB8OitQJ1TBed3yqWtdjzS6wJKBwg==",
+      "license": "MIT"
+    },
     "node_modules/@stylistic/eslint-plugin": {
       "version": "5.10.0",
       "resolved": "https://registry.npmjs.org/@stylistic/eslint-plugin/-/eslint-plugin-5.10.0.tgz",
@@ -1126,6 +1316,16 @@
       "resolved": "nodejs/express",
       "link": true
     },
+    "node_modules/@usebruno/api-docs-fastify": {
+      "resolved": "nodejs/fastify",
+      "link": true
+    },
+    "node_modules/abstract-logging": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/abstract-logging/-/abstract-logging-2.0.1.tgz",
+      "integrity": "sha512-2BjRTZxTPvheOvGbBslFSYOUkr+SjPtOnrLP33f+VIWLzezQpZcqVg7ja3L4dBXmzzgwT+a029jRx5PCi3JuiA==",
+      "license": "MIT"
+    },
     "node_modules/accepts": {
       "version": "2.0.0",
       "resolved": "https://registry.npmjs.org/accepts/-/accepts-2.0.0.tgz",
@@ -1179,6 +1379,61 @@
         "url": "https://github.com/sponsors/epoberezkin"
       }
     },
+    "node_modules/ajv-formats": {
+      "version": "3.0.1",
+      "resolved": "https://registry.npmjs.org/ajv-formats/-/ajv-formats-3.0.1.tgz",
+      "integrity": "sha512-8iUql50EUR+uUcdRQ3HDqa6EVyo3docL8g5WJ3FNcWmu62IbkGUue/pEyLBW8VGKKucTPgqeks4fIU1DA4yowQ==",
+      "license": "MIT",
+      "dependencies": {
+        "ajv": "^8.0.0"
+      },
+      "peerDependencies": {
+        "ajv": "^8.0.0"
+      },
+      "peerDependenciesMeta": {
+        "ajv": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/ajv-formats/node_modules/ajv": {
+      "version": "8.20.0",
+      "resolved": "https://registry.npmjs.org/ajv/-/ajv-8.20.0.tgz",
+      "integrity": "sha512-Thbli+OlOj+iMPYFBVBfJ3OmCAnaSyNn4M1vz9T6Gka5Jt9ba/HIR56joy65tY6kx/FCF5VXNB819Y7/GUrBGA==",
+      "license": "MIT",
+      "dependencies": {
+        "fast-deep-equal": "^3.1.3",
+        "fast-uri": "^3.0.1",
+        "json-schema-traverse": "^1.0.0",
+        "require-from-string": "^2.0.2"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/epoberezkin"
+      }
+    },
+    "node_modules/ajv-formats/node_modules/fast-uri": {
+      "version": "3.1.8",
+      "resolved": "https://registry.npmjs.org/fast-uri/-/fast-uri-3.1.8.tgz",
+      "integrity": "sha512-GZMtZUTNRpOVIECoXwLNZS5xUGE+mVNbTB8h/7Rwh2TFWcBQiPzTgyZi05BF9UMZKkLJv8XBRJTlU7zg8+ZfMg==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/fastify"
+        },
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/fastify"
+        }
+      ],
+      "license": "BSD-3-Clause"
+    },
+    "node_modules/ajv-formats/node_modules/json-schema-traverse": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-1.0.0.tgz",
+      "integrity": "sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug==",
+      "license": "MIT"
+    },
     "node_modules/ansi-styles": {
       "version": "4.3.0",
       "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz",
@@ -1201,6 +1456,35 @@
       "integrity": "sha512-8+9WqebbFzpX9OR+Wa6O29asIogeRMzcGtAINdpMHHyAg10f05aSFVBbcEqGf/PXw1EjAZ+q2/bEBg3DvurK3Q==",
       "license": "Python-2.0"
     },
+    "node_modules/atomic-sleep": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/atomic-sleep/-/atomic-sleep-1.0.0.tgz",
+      "integrity": "sha512-kNOjDqAh7px0XWNI+4QbzoiR/nTkHAWNud2uvnJquD1/x5a7EQZMJT0AczqK0Qn67oY/TTQ1LbUKajZpp3I9tQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=8.0.0"
+      }
+    },
+    "node_modules/avvio": {
+      "version": "9.3.0",
+      "resolved": "https://registry.npmjs.org/avvio/-/avvio-9.3.0.tgz",
+      "integrity": "sha512-g2tQ7LE7oOSqDfwEm3M+ZCMTJc7KiZCdJ4UwyZJb5ckTKyYu50OYmvv0mCFXPuYXoM4zkSt8zM9XQ9KCvxA74A==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/fastify"
+        },
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/fastify"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "@fastify/error": "^4.0.0",
+        "fastq": "^1.17.1"
+      }
+    },
     "node_modules/balanced-match": {
       "version": "4.0.4",
       "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-4.0.4.tgz",
@@ -1441,6 +1725,15 @@
         "node": ">= 0.8"
       }
     },
+    "node_modules/dequal": {
+      "version": "2.0.3",
+      "resolved": "https://registry.npmjs.org/dequal/-/dequal-2.0.3.tgz",
+      "integrity": "sha512-0je+qPKHEMohvfRTCEo3CrPG6cAzAYgmzKyxRiYSSDkS6eGJdyVJm7WaYA5ECaAD9wLB2T4EEeymA5aFVcYXCA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=6"
+      }
+    },
     "node_modules/dunder-proto": {
       "version": "1.0.1",
       "resolved": "https://registry.npmjs.org/dunder-proto/-/dunder-proto-1.0.1.tgz",
@@ -1808,11 +2101,16 @@
         "url": "https://opencollective.com/express"
       }
     },
+    "node_modules/fast-decode-uri-component": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/fast-decode-uri-component/-/fast-decode-uri-component-1.0.1.tgz",
+      "integrity": "sha512-WKgKWg5eUxvRZGwW8FvfbaH7AXSh2cL+3j5fMGzUMCxWBJ3dV3a7Wz8y2f/uQ0e3B6WmodD3oS54jTQ9HVTIIg==",
+      "license": "MIT"
+    },
     "node_modules/fast-deep-equal": {
       "version": "3.1.3",
       "resolved": "https://registry.npmjs.org/fast-deep-equal/-/fast-deep-equal-3.1.3.tgz",
       "integrity": "sha512-f3qQ9oQy9j2AhBe/H9VC91wLmKBCCU/gDOnKNAYG5hswO7BLKj09Hc5HYNz9cGI++xlpDCIgDaitVs03ATR84Q==",
-      "dev": true,
       "license": "MIT"
     },
     "node_modules/fast-json-stable-stringify": {
@@ -1822,6 +2120,68 @@
       "dev": true,
       "license": "MIT"
     },
+    "node_modules/fast-json-stringify": {
+      "version": "7.0.1",
+      "resolved": "https://registry.npmjs.org/fast-json-stringify/-/fast-json-stringify-7.0.1.tgz",
+      "integrity": "sha512-eRSayARSbbwlBjpP4vnTTIRD5QPcIrmihPxDeN1DtKnHPg66UuJLx+8hlK1kaFdjvzyQ/dzALoi4vwAQ+T+iZA==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/fastify"
+        },
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/fastify"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "@fastify/merge-json-schemas": "^0.2.0",
+        "ajv": "^8.12.0",
+        "ajv-formats": "^3.0.1",
+        "fast-uri": "^4.0.0",
+        "json-schema-ref-resolver": "^3.0.0",
+        "rfdc": "^1.2.0"
+      }
+    },
+    "node_modules/fast-json-stringify/node_modules/ajv": {
+      "version": "8.20.0",
+      "resolved": "https://registry.npmjs.org/ajv/-/ajv-8.20.0.tgz",
+      "integrity": "sha512-Thbli+OlOj+iMPYFBVBfJ3OmCAnaSyNn4M1vz9T6Gka5Jt9ba/HIR56joy65tY6kx/FCF5VXNB819Y7/GUrBGA==",
+      "license": "MIT",
+      "dependencies": {
+        "fast-deep-equal": "^3.1.3",
+        "fast-uri": "^3.0.1",
+        "json-schema-traverse": "^1.0.0",
+        "require-from-string": "^2.0.2"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/epoberezkin"
+      }
+    },
+    "node_modules/fast-json-stringify/node_modules/ajv/node_modules/fast-uri": {
+      "version": "3.1.8",
+      "resolved": "https://registry.npmjs.org/fast-uri/-/fast-uri-3.1.8.tgz",
+      "integrity": "sha512-GZMtZUTNRpOVIECoXwLNZS5xUGE+mVNbTB8h/7Rwh2TFWcBQiPzTgyZi05BF9UMZKkLJv8XBRJTlU7zg8+ZfMg==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/fastify"
+        },
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/fastify"
+        }
+      ],
+      "license": "BSD-3-Clause"
+    },
+    "node_modules/fast-json-stringify/node_modules/json-schema-traverse": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-1.0.0.tgz",
+      "integrity": "sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug==",
+      "license": "MIT"
+    },
     "node_modules/fast-levenshtein": {
       "version": "2.0.6",
       "resolved": "https://registry.npmjs.org/fast-levenshtein/-/fast-levenshtein-2.0.6.tgz",
@@ -1829,6 +2189,90 @@
       "dev": true,
       "license": "MIT"
     },
+    "node_modules/fast-querystring": {
+      "version": "1.1.2",
+      "resolved": "https://registry.npmjs.org/fast-querystring/-/fast-querystring-1.1.2.tgz",
+      "integrity": "sha512-g6KuKWmFXc0fID8WWH0jit4g0AGBoJhCkJMb1RmbsSEUNvQ+ZC8D6CUZ+GtF8nMzSPXnhiePyyqqipzNNEnHjg==",
+      "license": "MIT",
+      "dependencies": {
+        "fast-decode-uri-component": "^1.0.1"
+      }
+    },
+    "node_modules/fast-uri": {
+      "version": "4.1.5",
+      "resolved": "https://registry.npmjs.org/fast-uri/-/fast-uri-4.1.5.tgz",
+      "integrity": "sha512-vZeoMRB4epNr7QfdHxel7te/RcX16CxyXI07JCCTFWZA2s4v1azGNESRj+2EoaHSaWFL/Z3GmKT2jF6A202jLg==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/fastify"
+        },
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/fastify"
+        }
+      ],
+      "license": "BSD-3-Clause"
+    },
+    "node_modules/fastify": {
+      "version": "5.12.5",
+      "resolved": "https://registry.npmjs.org/fastify/-/fastify-5.12.5.tgz",
+      "integrity": "sha512-OB2k1dlxs5/NAABqeKV2FUHkSD2BbENsCak8yULVcymn3fHIPDVa9TI3SDnJSWYSllZmSYuZXy2gTnsT+Sut1A==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/fastify"
+        },
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/fastify"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "@fastify/ajv-compiler": "^4.0.5",
+        "@fastify/error": "^4.0.0",
+        "@fastify/fast-json-stringify-compiler": "^5.0.0",
+        "@fastify/proxy-addr": "^5.0.0",
+        "abstract-logging": "^2.0.1",
+        "avvio": "^9.0.0",
+        "fast-json-stringify": "^7.0.0",
+        "find-my-way": "^9.6.0",
+        "light-my-request": "^6.0.0",
+        "pino": "^9.14.0 || ^10.1.0",
+        "process-warning": "^5.1.0",
+        "rfdc": "^1.3.1",
+        "secure-json-parse": "^4.0.0",
+        "semver": "^7.6.0",
+        "toad-cache": "^3.7.0"
+      }
+    },
+    "node_modules/fastify-plugin": {
+      "version": "6.0.0",
+      "resolved": "https://registry.npmjs.org/fastify-plugin/-/fastify-plugin-6.0.0.tgz",
+      "integrity": "sha512-fZOty7z3O7vOliF6d8bHE3wiEh1KcNnKEQensSgTk9C1DvN6nRLS++XVd86v33Hw/8u9Un8A1zDrQ8ujcQDHEg==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/fastify"
+        },
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/fastify"
+        }
+      ],
+      "license": "MIT"
+    },
+    "node_modules/fastq": {
+      "version": "1.20.3",
+      "resolved": "https://registry.npmjs.org/fastq/-/fastq-1.20.3.tgz",
+      "integrity": "sha512-XKv5nnLs6nLF71NgiKJLIZFLkPyIEuOselLG7ujZnGrRfQK8HpvY+WqKhAJUAdLomwVHErVS4LfxFlPq0/FTAw==",
+      "license": "ISC",
+      "dependencies": {
+        "reusify": "^1.0.4"
+      }
+    },
     "node_modules/fdir": {
       "version": "6.5.0",
       "resolved": "https://registry.npmjs.org/fdir/-/fdir-6.5.0.tgz",
@@ -1881,6 +2325,20 @@
         "url": "https://opencollective.com/express"
       }
     },
+    "node_modules/find-my-way": {
+      "version": "9.9.0",
+      "resolved": "https://registry.npmjs.org/find-my-way/-/find-my-way-9.9.0.tgz",
+      "integrity": "sha512-sJsgZ1sQH2UDuowPuMKg8az7Qc8F0jnj+SKkFWU/+T0xcFlgV5skgXOGUqmQzOdmW6ALA7AhJINWx3qFBkbLHA==",
+      "license": "MIT",
+      "dependencies": {
+        "fast-deep-equal": "^3.1.3",
+        "fast-querystring": "^1.0.0",
+        "safe-regex2": "^5.0.0"
+      },
+      "engines": {
+        "node": ">=20"
+      }
+    },
     "node_modules/find-up": {
       "version": "5.0.0",
       "resolved": "https://registry.npmjs.org/find-up/-/find-up-5.0.0.tgz",
@@ -2221,6 +2679,60 @@
       "dev": true,
       "license": "MIT"
     },
+    "node_modules/json-schema-ref-resolver": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/json-schema-ref-resolver/-/json-schema-ref-resolver-3.0.0.tgz",
+      "integrity": "sha512-hOrZIVL5jyYFjzk7+y7n5JDzGlU8rfWDuYyHwGa2WA8/pcmMHezp2xsVwxrebD/Q9t8Nc5DboieySDpCp4WG4A==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/fastify"
+        },
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/fastify"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "dequal": "^2.0.3"
+      }
+    },
+    "node_modules/json-schema-resolver": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/json-schema-resolver/-/json-schema-resolver-3.0.0.tgz",
+      "integrity": "sha512-HqMnbz0tz2DaEJ3ntsqtx3ezzZyDE7G56A/pPY/NGmrPu76UzsWquOpHFRAf5beTNXoH2LU5cQePVvRli1nchA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "debug": "^4.1.1",
+        "fast-uri": "^3.0.5",
+        "rfdc": "^1.1.4"
+      },
+      "engines": {
+        "node": ">=20"
+      },
+      "funding": {
+        "url": "https://github.com/Eomm/json-schema-resolver?sponsor=1"
+      }
+    },
+    "node_modules/json-schema-resolver/node_modules/fast-uri": {
+      "version": "3.1.8",
+      "resolved": "https://registry.npmjs.org/fast-uri/-/fast-uri-3.1.8.tgz",
+      "integrity": "sha512-GZMtZUTNRpOVIECoXwLNZS5xUGE+mVNbTB8h/7Rwh2TFWcBQiPzTgyZi05BF9UMZKkLJv8XBRJTlU7zg8+ZfMg==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/fastify"
+        },
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/fastify"
+        }
+      ],
+      "license": "BSD-3-Clause"
+    },
     "node_modules/json-schema-traverse": {
       "version": "0.4.1",
       "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-0.4.1.tgz",
@@ -2259,6 +2771,56 @@
         "node": ">= 0.8.0"
       }
     },
+    "node_modules/light-my-request": {
+      "version": "6.6.0",
+      "resolved": "https://registry.npmjs.org/light-my-request/-/light-my-request-6.6.0.tgz",
+      "integrity": "sha512-CHYbu8RtboSIoVsHZ6Ye4cj4Aw/yg2oAFimlF7mNvfDV192LR7nDiKtSIfCuLT7KokPSTn/9kfVLm5OGN0A28A==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/fastify"
+        },
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/fastify"
+        }
+      ],
+      "license": "BSD-3-Clause",
+      "dependencies": {
+        "cookie": "^1.0.1",
+        "process-warning": "^4.0.0",
+        "set-cookie-parser": "^2.6.0"
+      }
+    },
+    "node_modules/light-my-request/node_modules/cookie": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/cookie/-/cookie-1.1.1.tgz",
+      "integrity": "sha512-ei8Aos7ja0weRpFzJnEA9UHJ/7XQmqglbRwnf2ATjcB9Wq874VKH9kfjjirM6UhU2/E5fFYadylyhFldcqSidQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
+      }
+    },
+    "node_modules/light-my-request/node_modules/process-warning": {
+      "version": "4.0.1",
+      "resolved": "https://registry.npmjs.org/process-warning/-/process-warning-4.0.1.tgz",
+      "integrity": "sha512-3c2LzQ3rY9d0hc1emcsHhfT9Jwz0cChib/QN89oME2R451w5fy3f0afAhERFZAwrbDU43wk12d0ORBpDVME50Q==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/fastify"
+        },
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/fastify"
+        }
+      ],
+      "license": "MIT"
+    },
     "node_modules/locate-path": {
       "version": "6.0.0",
       "resolved": "https://registry.npmjs.org/locate-path/-/locate-path-6.0.0.tgz",
@@ -2411,6 +2973,15 @@
         "url": "https://github.com/sponsors/ljharb"
       }
     },
+    "node_modules/on-exit-leak-free": {
+      "version": "2.1.2",
+      "resolved": "https://registry.npmjs.org/on-exit-leak-free/-/on-exit-leak-free-2.1.2.tgz",
+      "integrity": "sha512-0eJJY6hXLGf1udHwfNftBqH+g73EU4B504nZeKpz1sYRKafAghwxEJunB2O7rDZkL4PGfsMVnTXZ2EjibbqcsA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=14.0.0"
+      }
+    },
     "node_modules/on-finished": {
       "version": "2.4.1",
       "resolved": "https://registry.npmjs.org/on-finished/-/on-finished-2.4.1.tgz",
@@ -2432,6 +3003,13 @@
         "wrappy": "1"
       }
     },
+    "node_modules/openapi-types": {
+      "version": "12.1.3",
+      "resolved": "https://registry.npmjs.org/openapi-types/-/openapi-types-12.1.3.tgz",
+      "integrity": "sha512-N4YtSYJqghVu4iek2ZUvcN/0aqH1kRDuNqzcycDxhOUpg7GdvLa2F3DgS6yBNhInhv2r/6I0Flkn7CqL8+nIcw==",
+      "dev": true,
+      "license": "MIT"
+    },
     "node_modules/optionator": {
       "version": "0.9.4",
       "resolved": "https://registry.npmjs.org/optionator/-/optionator-0.9.4.tgz",
@@ -2547,6 +3125,43 @@
         "url": "https://github.com/sponsors/jonschlinkert"
       }
     },
+    "node_modules/pino": {
+      "version": "10.3.1",
+      "resolved": "https://registry.npmjs.org/pino/-/pino-10.3.1.tgz",
+      "integrity": "sha512-r34yH/GlQpKZbU1BvFFqOjhISRo1MNx1tWYsYvmj6KIRHSPMT2+yHOEb1SG6NMvRoHRF0a07kCOox/9yakl1vg==",
+      "license": "MIT",
+      "dependencies": {
+        "@pinojs/redact": "^0.4.0",
+        "atomic-sleep": "^1.0.0",
+        "on-exit-leak-free": "^2.1.0",
+        "pino-abstract-transport": "^3.0.0",
+        "pino-std-serializers": "^7.0.0",
+        "process-warning": "^5.0.0",
+        "quick-format-unescaped": "^4.0.3",
+        "real-require": "^0.2.0",
+        "safe-stable-stringify": "^2.3.1",
+        "sonic-boom": "^4.0.1",
+        "thread-stream": "^4.0.0"
+      },
+      "bin": {
+        "pino": "bin.js"
+      }
+    },
+    "node_modules/pino-abstract-transport": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/pino-abstract-transport/-/pino-abstract-transport-3.0.0.tgz",
+      "integrity": "sha512-wlfUczU+n7Hy/Ha5j9a/gZNy7We5+cXp8YL+X+PG8S0KXxw7n/JXA3c46Y0zQznIJ83URJiwy7Lh56WLokNuxg==",
+      "license": "MIT",
+      "dependencies": {
+        "split2": "^4.0.0"
+      }
+    },
+    "node_modules/pino-std-serializers": {
+      "version": "7.1.0",
+      "resolved": "https://registry.npmjs.org/pino-std-serializers/-/pino-std-serializers-7.1.0.tgz",
+      "integrity": "sha512-BndPH67/JxGExRgiX1dX0w1FvZck5Wa4aal9198SrRhZjH3GxKQUKIBnYJTdj2HDN3UQAS06HlfcSbQj2OHmaw==",
+      "license": "MIT"
+    },
     "node_modules/prelude-ls": {
       "version": "1.2.1",
       "resolved": "https://registry.npmjs.org/prelude-ls/-/prelude-ls-1.2.1.tgz",
@@ -2557,6 +3172,22 @@
         "node": ">= 0.8.0"
       }
     },
+    "node_modules/process-warning": {
+      "version": "5.1.0",
+      "resolved": "https://registry.npmjs.org/process-warning/-/process-warning-5.1.0.tgz",
+      "integrity": "sha512-jQSaVHsPgtyw60e1rQ/A+/ArPEj/S8pS/vFnyGa/gYFXrKk/6RuDkoqVDQ5NI5MmS01698ltlAk0NoDBNLujRw==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/fastify"
+        },
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/fastify"
+        }
+      ],
+      "license": "MIT"
+    },
     "node_modules/proxy-addr": {
       "version": "2.0.7",
       "resolved": "https://registry.npmjs.org/proxy-addr/-/proxy-addr-2.0.7.tgz",
@@ -2596,6 +3227,12 @@
         "url": "https://github.com/sponsors/ljharb"
       }
     },
+    "node_modules/quick-format-unescaped": {
+      "version": "4.0.4",
+      "resolved": "https://registry.npmjs.org/quick-format-unescaped/-/quick-format-unescaped-4.0.4.tgz",
+      "integrity": "sha512-tYC1Q1hgyRuHgloV/YXs2w15unPVh8qfu/qCTfhTYamaw7fyhumKa2yGpdSo87vY32rIclj+4fWYQXUMs9EHvg==",
+      "license": "MIT"
+    },
     "node_modules/range-parser": {
       "version": "1.3.0",
       "resolved": "https://registry.npmjs.org/range-parser/-/range-parser-1.3.0.tgz",
@@ -2624,6 +3261,24 @@
         "node": ">= 0.10"
       }
     },
+    "node_modules/real-require": {
+      "version": "0.2.0",
+      "resolved": "https://registry.npmjs.org/real-require/-/real-require-0.2.0.tgz",
+      "integrity": "sha512-57frrGM/OCTLqLOAh0mhVA9VBMHd+9U7Zb2THMGdBUoZVOtGbJzjxsYGDJ3A9AYYCP4hn6y1TVbaOfzWtm5GFg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 12.13.0"
+      }
+    },
+    "node_modules/require-from-string": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/require-from-string/-/require-from-string-2.0.2.tgz",
+      "integrity": "sha512-Xf0nWe6RseziFMu+Ap9biiUbmplq6S9/p+7w7YXP/JBHhrUDDUhwa+vANyubuqfZWTveU//DYVGsDG7RKL/vEw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
     "node_modules/resolve-from": {
       "version": "4.0.0",
       "resolved": "https://registry.npmjs.org/resolve-from/-/resolve-from-4.0.0.tgz",
@@ -2634,6 +3289,31 @@
         "node": ">=4"
       }
     },
+    "node_modules/ret": {
+      "version": "0.5.0",
+      "resolved": "https://registry.npmjs.org/ret/-/ret-0.5.0.tgz",
+      "integrity": "sha512-I1XxrZSQ+oErkRR4jYbAyEEu2I0avBvvMM5JN+6EBprOGRCs63ENqZ3vjavq8fBw2+62G5LF5XelKwuJpcvcxw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/reusify": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/reusify/-/reusify-1.1.0.tgz",
+      "integrity": "sha512-g6QUff04oZpHs0eG5p83rFLhHeV00ug/Yf9nZM6fLeUrPguBTkTQOdpAWWspMh55TZfVQDPaN3NQJfbVRAxdIw==",
+      "license": "MIT",
+      "engines": {
+        "iojs": ">=1.0.0",
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/rfdc": {
+      "version": "1.4.1",
+      "resolved": "https://registry.npmjs.org/rfdc/-/rfdc-1.4.1.tgz",
+      "integrity": "sha512-q1b3N5QkRUWUl7iyylaaj3kOpIT0N2i9MqIEQXP73GVsN9cw3fdx8X63cEmWhJGi2PPCF23Ijp7ktmd39rawIA==",
+      "license": "MIT"
+    },
     "node_modules/router": {
       "version": "2.2.0",
       "resolved": "https://registry.npmjs.org/router/-/router-2.2.0.tgz",
@@ -2650,17 +3330,63 @@
         "node": ">= 18"
       }
     },
+    "node_modules/safe-regex2": {
+      "version": "5.1.1",
+      "resolved": "https://registry.npmjs.org/safe-regex2/-/safe-regex2-5.1.1.tgz",
+      "integrity": "sha512-mOSBvHGDZMuIEZMdOz/aCEYDCv0E7nfcNsIhUF+/P+xC7Hyf3FkvymqgPbg9D1EdSGu+uKbJgy09K/RKKc7kJA==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/fastify"
+        },
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/fastify"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "ret": "~0.5.0"
+      },
+      "bin": {
+        "safe-regex2": "bin/safe-regex2.js"
+      }
+    },
+    "node_modules/safe-stable-stringify": {
+      "version": "2.5.0",
+      "resolved": "https://registry.npmjs.org/safe-stable-stringify/-/safe-stable-stringify-2.5.0.tgz",
+      "integrity": "sha512-b3rppTKm9T+PsVCBEOUR46GWI7fdOs00VKZ1+9c1EWDaDMvjQc6tUwuFyIprgGgTcWoVHSKrU8H31ZHA2e0RHA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=10"
+      }
+    },
     "node_modules/safer-buffer": {
       "version": "2.1.2",
       "resolved": "https://registry.npmjs.org/safer-buffer/-/safer-buffer-2.1.2.tgz",
       "integrity": "sha512-YZo3K82SD7Riyi0E1EQPojLz7kpepnSQI9IyPbHHg1XXXevb5dJI7tpyN2ADxGcQbHG7vcyRHk0cbwqcQriUtg==",
       "license": "MIT"
     },
+    "node_modules/secure-json-parse": {
+      "version": "4.1.0",
+      "resolved": "https://registry.npmjs.org/secure-json-parse/-/secure-json-parse-4.1.0.tgz",
+      "integrity": "sha512-l4KnYfEyqYJxDwlNVyRfO2E4NTHfMKAWdUuA8J0yve2Dz/E/PdBepY03RvyJpssIpRFwJoCD55wA+mEDs6ByWA==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/fastify"
+        },
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/fastify"
+        }
+      ],
+      "license": "BSD-3-Clause"
+    },
     "node_modules/semver": {
       "version": "7.8.5",
       "resolved": "https://registry.npmjs.org/semver/-/semver-7.8.5.tgz",
       "integrity": "sha512-Y7/KDsb8LjooZpwaqGyulO6DQlksgCncchHGk+sZIY4SBvUocMBEFH5Ur1fI4dV+Jvl0w6cjvucaIi40puRioA==",
-      "dev": true,
       "license": "ISC",
       "bin": {
         "semver": "bin/semver.js"
@@ -2714,6 +3440,12 @@
         "url": "https://opencollective.com/express"
       }
     },
+    "node_modules/set-cookie-parser": {
+      "version": "2.7.2",
+      "resolved": "https://registry.npmjs.org/set-cookie-parser/-/set-cookie-parser-2.7.2.tgz",
+      "integrity": "sha512-oeM1lpU/UvhTxw+g3cIfxXHyJRc/uidd3yK1P242gzHds0udQBYzs3y8j4gCCW+ZJ7ad0yctld8RYO+bdurlvw==",
+      "license": "MIT"
+    },
     "node_modules/setprototypeof": {
       "version": "1.2.0",
       "resolved": "https://registry.npmjs.org/setprototypeof/-/setprototypeof-1.2.0.tgz",
@@ -2815,6 +3547,24 @@
         "url": "https://github.com/sponsors/ljharb"
       }
     },
+    "node_modules/sonic-boom": {
+      "version": "4.2.1",
+      "resolved": "https://registry.npmjs.org/sonic-boom/-/sonic-boom-4.2.1.tgz",
+      "integrity": "sha512-w6AxtubXa2wTXAUsZMMWERrsIRAdrK0Sc+FUytWvYAhBJLyuI4llrMIC1DtlNSdI99EI86KZum2MMq3EAZlF9Q==",
+      "license": "MIT",
+      "dependencies": {
+        "atomic-sleep": "^1.0.0"
+      }
+    },
+    "node_modules/split2": {
+      "version": "4.2.0",
+      "resolved": "https://registry.npmjs.org/split2/-/split2-4.2.0.tgz",
+      "integrity": "sha512-UcjcJOWknrNkF6PLX83qcHM6KHgVKNkV62Y8a5uYDVv9ydGQVwAHMKqHdJje1VTWpljG0WYpCDhrCdAOYH4TWg==",
+      "license": "ISC",
+      "engines": {
+        "node": ">= 10.x"
+      }
+    },
     "node_modules/statuses": {
       "version": "2.0.2",
       "resolved": "https://registry.npmjs.org/statuses/-/statuses-2.0.2.tgz",
@@ -2850,6 +3600,24 @@
         "node": ">=8"
       }
     },
+    "node_modules/thread-stream": {
+      "version": "4.2.0",
+      "resolved": "https://registry.npmjs.org/thread-stream/-/thread-stream-4.2.0.tgz",
+      "integrity": "sha512-e2zZ96wSChazBsbENf/Pcm/4swHt2cEKQ92rhUjkL9GCKiTDJIaTBenjE/m9DXi0QBmTMDkFDdOomUy20A1tDQ==",
+      "license": "MIT",
+      "dependencies": {
+        "real-require": "^1.0.0"
+      },
+      "engines": {
+        "node": ">=20"
+      }
+    },
+    "node_modules/thread-stream/node_modules/real-require": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/real-require/-/real-require-1.0.0.tgz",
+      "integrity": "sha512-P4nbQYQfePJxRSmY+v/KINxVucm4NF3p3s7pJveMTtom52FR4YGltUQLB8idDXwDDWW+eYrWDFbuzUnjoWHF7g==",
+      "license": "MIT"
+    },
     "node_modules/tinyglobby": {
       "version": "0.2.17",
       "resolved": "https://registry.npmjs.org/tinyglobby/-/tinyglobby-0.2.17.tgz",
@@ -2867,6 +3635,15 @@
         "url": "https://github.com/sponsors/SuperchupuDev"
       }
     },
+    "node_modules/toad-cache": {
+      "version": "3.7.4",
+      "resolved": "https://registry.npmjs.org/toad-cache/-/toad-cache-3.7.4.tgz",
+      "integrity": "sha512-m1TdR/rvT7kgGJZhspNtXdsdYk0fddFpJJFlG5s+UkPFo6lkLoZ3YLOaovPYjq1R75NP5JfeTlSHaOsE09peCg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=20"
+      }
+    },
     "node_modules/toidentifier": {
       "version": "1.0.1",
       "resolved": "https://registry.npmjs.org/toidentifier/-/toidentifier-1.0.1.tgz",
@@ -3014,6 +3791,22 @@
       "integrity": "sha512-l4Sp/DRseor9wL6EvV2+TuQn63dMkPjZ/sp9XkghTEbV9KlPS1xUsZ3u7/IQO4wxtcFB4bgpQPRcR3QCvezPcQ==",
       "license": "ISC"
     },
+    "node_modules/yaml": {
+      "version": "2.9.1",
+      "resolved": "https://registry.npmjs.org/yaml/-/yaml-2.9.1.tgz",
+      "integrity": "sha512-3NxN8+78OdzbT7C/WjGsyfPAtJaN3FNDsWxv7Y7mcDsT/oOmgW8BpyQQFFBnvZE3j9Y2Sdz1ULFLezL7Eb2yFw==",
+      "dev": true,
+      "license": "ISC",
+      "bin": {
+        "yaml": "bin.mjs"
+      },
+      "engines": {
+        "node": ">= 14.6"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/eemeli"
+      }
+    },
     "node_modules/yocto-queue": {
       "version": "0.1.0",
       "resolved": "https://registry.npmjs.org/yocto-queue/-/yocto-queue-0.1.0.tgz",
@@ -3051,6 +3844,20 @@
       "peerDependencies": {
         "express": "^4.0.0 || ^5.0.0"
       }
+    },
+    "nodejs/fastify": {
+      "name": "@usebruno/api-docs-fastify",
+      "version": "0.1.0-beta.1",
+      "license": "MIT",
+      "dependencies": {
+        "@usebruno/api-docs-core": "0.1.0-beta.1"
+      },
+      "engines": {
+        "node": ">=20"
+      },
+      "peerDependencies": {
+        "fastify": "^4.0.0 || ^5.0.0"
+      }
     }
   }
 }
diff --git a/integrations/package.json b/integrations/package.json
index 04d1b528..2481541b 100644
--- a/integrations/package.json
+++ b/integrations/package.json
@@ -7,14 +7,17 @@
     "nodejs/*"
   ],
   "scripts": {
-    "build": "npm run build:shell && npm run build:core && npm run build:express",
+    "build": "npm run build:shell && npm run build:core && npm run build:express && npm run build:fastify",
     "build:core": "tsc -p nodejs/core/tsconfig.json",
     "build:express": "tsc -p nodejs/express/tsconfig.json",
+    "build:fastify": "tsc -p nodejs/fastify/tsconfig.json",
     "build:shell": "esbuild shell/shell.src.mjs --bundle --minify --format=iife --platform=browser --target=es2020 --outfile=shell/shell.js --log-level=warning && mkdir -p nodejs/core/shell && cp shell/shell.html shell/shell.js nodejs/core/shell/",
     "check:express": "npm run build && bash contract-tests/check.sh --example nodejs/express/example/server.js --port 5456",
+    "check:fastify": "npm run build && bash contract-tests/check.sh --example nodejs/fastify/example/server.js --port 5457",
     "lint": "eslint",
     "lint:fix": "eslint --fix",
     "start:express": "node nodejs/express/example/server.js",
+    "start:fastify": "node nodejs/fastify/example/server.js",
     "test:assemble": "node shell/test/assemble.test.mjs",
     "test:collection": "npm run build:core && node nodejs/core/test/collection.test.mjs",
     "test:docs": "npm run build && node nodejs/core/test/docs.test.mjs",
@@ -24,6 +27,7 @@
   },
   "devDependencies": {
     "@eslint/js": "^9.39.5",
+    "@fastify/swagger": "^9.8.1",
     "@stylistic/eslint-plugin": "^5.3.1",
     "@types/express": "^5.0.0",
     "@types/js-yaml": "^4.0.9",
@@ -33,6 +37,7 @@
     "esbuild": "^0.24.0",
     "eslint": "^9.21.0",
     "express": "^5.0.0",
+    "fastify": "^5.12.5",
     "globals": "^16.0.0",
     "helmet": "^8.0.0",
     "typescript": "^5.7.0"

From 2914735f10356eaae9bbb41c1024459f78003fcc Mon Sep 17 00:00:00 2001
From: Arpit Bruno <arpit@usebruno.com>
Date: Thu, 17 Sep 2026 11:16:50 +0530
Subject: [PATCH 09/21] nestjs module and example, running on both adapters

---
 .../nodejs/core/src/routes/handler.ts         |  17 +-
 integrations/nodejs/nestjs/example/server.js  |  85 +++
 integrations/nodejs/nestjs/package.json       |  22 +
 integrations/nodejs/nestjs/src/index.ts       |  49 ++
 .../nodejs/nestjs/test/sub-path.test.mjs      |  31 +
 integrations/nodejs/nestjs/tsconfig.json      |  10 +
 integrations/package-lock.json                | 684 ++++++++++++++++++
 integrations/package.json                     |  12 +-
 8 files changed, 904 insertions(+), 6 deletions(-)
 create mode 100644 integrations/nodejs/nestjs/example/server.js
 create mode 100644 integrations/nodejs/nestjs/package.json
 create mode 100644 integrations/nodejs/nestjs/src/index.ts
 create mode 100644 integrations/nodejs/nestjs/test/sub-path.test.mjs
 create mode 100644 integrations/nodejs/nestjs/tsconfig.json

diff --git a/integrations/nodejs/core/src/routes/handler.ts b/integrations/nodejs/core/src/routes/handler.ts
index 9eaadf3d..052ac3aa 100644
--- a/integrations/nodejs/core/src/routes/handler.ts
+++ b/integrations/nodejs/core/src/routes/handler.ts
@@ -1,4 +1,4 @@
-import type { IncomingMessage, ServerResponse } from 'node:http';
+import type { IncomingHttpHeaders, ServerResponse } from 'node:http';
 import type { HttpResponse, Conditional } from '../http';
 
 export interface Routes {
@@ -8,11 +8,18 @@ export interface Routes {
 }
 
 /**
- * `url` is the path within the mount and `originalUrl`, when the framework sets it, is the
- * full path. Express gives both. A framework that gives neither has to strip the mount itself
- * before calling this, which is what `mountPath` is for in the NestJS package.
+ * Everything the handler reads, and nothing else. An `IncomingMessage` satisfies it, and so does
+ * an object a wrapper builds: NestJS on platform-fastify has to, because middie leaves `url` as
+ * `/` and only `originalUrl` carries the path.
+ *
+ * `url` is the path within the mount; `originalUrl`, where the framework sets it, is the whole one.
  */
-export type Request = IncomingMessage & { originalUrl?: string };
+export interface Request {
+  method?: string;
+  url?: string;
+  originalUrl?: string;
+  headers: IncomingHttpHeaders;
+}
 
 export type Handler = (req: Request, res: ServerResponse) => void;
 
diff --git a/integrations/nodejs/nestjs/example/server.js b/integrations/nodejs/nestjs/example/server.js
new file mode 100644
index 00000000..63e8d09b
--- /dev/null
+++ b/integrations/nodejs/nestjs/example/server.js
@@ -0,0 +1,85 @@
+'use strict';
+
+require('reflect-metadata');
+const { Module } = require('@nestjs/common');
+const { NestFactory } = require('@nestjs/core');
+const helmet = require('helmet');
+const { ApiDocsModule } = require('@usebruno/api-docs-nestjs');
+
+const PORT = Number(process.env.PORT || 5458);
+// ADAPTER=fastify runs the same app on platform-fastify. The wrapper is unchanged between them;
+// what differs is that middie leaves req.url as '/', which is why the mount path is an option.
+const ADAPTER = process.env.ADAPTER || 'express';
+// relative on purpose: the core resolves it against this file, not the cwd
+const COLLECTION = process.env.COLLECTION || '../../../contract-tests/fixtures/api-collection';
+const BUNDLED = process.env.BUNDLED || '../../../contract-tests/fixtures/bundled.yml';
+
+class ControlController {
+  control() {
+    return { ok: true, from: 'the app itself' };
+  }
+}
+class AppModule {}
+
+function defineApp() {
+  const { Controller, Get } = require('@nestjs/common');
+
+  // the decorators, applied by hand: this example is plain JS so that it runs with no build step
+  Get('control')(
+    ControlController.prototype,
+    'control',
+    Object.getOwnPropertyDescriptor(ControlController.prototype, 'control')
+  );
+  Controller()(ControlController);
+
+  Module({
+    controllers: [ControlController],
+    imports: [
+      ApiDocsModule.forRoot({
+        mountPath: '/docs',
+        collection: COLLECTION,
+        environments: { include: ['Local'] },
+        tags: { exclude: ['internal'] },
+        pageTitle: 'Acme API',
+        gitCollectionUrl: 'https://token:secret@github.com/acme/api-collection'
+      }),
+      ApiDocsModule.forRoot({
+        mountPath: '/api/v2/docs',
+        collection: COLLECTION,
+        environments: { all: true, exclude: ['Prod'] }
+      }),
+      ApiDocsModule.forRoot({ mountPath: '/internal/docs', collection: COLLECTION }),
+      ApiDocsModule.forRoot({ mountPath: '/bundled/docs', collection: BUNDLED }),
+      ApiDocsModule.forRoot({ mountPath: '/broken/docs', collection: './there-is-no-collection-here' })
+    ]
+  })(AppModule);
+}
+
+async function main() {
+  defineApp();
+
+  let app;
+  if (ADAPTER === 'fastify') {
+    const { FastifyAdapter } = require('@nestjs/platform-fastify');
+    app = await NestFactory.create(AppModule, new FastifyAdapter(), { logger: false });
+  } else {
+    app = await NestFactory.create(AppModule, { logger: false });
+  }
+
+  // the same strict CSP the other examples set, so the contract suite asserts it everywhere
+  app.use(helmet({
+    contentSecurityPolicy: {
+      directives: {
+        scriptSrc: ["'self'", 'https://cdn.usebruno.com'],
+        styleSrc: ["'self'", "'unsafe-inline'", 'https://cdn.usebruno.com', 'https://fonts.googleapis.com'],
+        fontSrc: ["'self'", 'https://fonts.gstatic.com'],
+        connectSrc: ["'self'"]
+      }
+    }
+  }));
+
+  await app.listen(PORT, '127.0.0.1');
+  console.log(`nestjs example on http://localhost:${PORT} (platform-${ADAPTER})`);
+}
+
+main();
diff --git a/integrations/nodejs/nestjs/package.json b/integrations/nodejs/nestjs/package.json
new file mode 100644
index 00000000..cc99619a
--- /dev/null
+++ b/integrations/nodejs/nestjs/package.json
@@ -0,0 +1,22 @@
+{
+  "name": "@usebruno/api-docs-nestjs",
+  "version": "0.1.0-beta.1",
+  "private": true,
+  "description": "Serve a Bruno collection as API docs from inside your own NestJS app, behind your own auth.",
+  "license": "MIT",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "peerDependencies": {
+    "@nestjs/common": "^10.0.0 || ^11.0.0",
+    "@nestjs/core": "^10.0.0 || ^11.0.0"
+  },
+  "dependencies": {
+    "@usebruno/api-docs-core": "0.1.0-beta.1"
+  }
+}
diff --git a/integrations/nodejs/nestjs/src/index.ts b/integrations/nodejs/nestjs/src/index.ts
new file mode 100644
index 00000000..f4442753
--- /dev/null
+++ b/integrations/nodejs/nestjs/src/index.ts
@@ -0,0 +1,49 @@
+import type { ServerResponse } from 'node:http';
+import { Module, type DynamicModule, type MiddlewareConsumer, type NestModule } from '@nestjs/common';
+import { createDocs, type ApiDocsOptions, type Request } from '@usebruno/api-docs-core';
+
+export type { ApiDocsOptions, CollectionOptions, RendererOptions, EnvironmentsOption, TagsOption }
+  from '@usebruno/api-docs-core';
+
+export interface ApiDocsModuleOptions extends ApiDocsOptions {
+  /** Where the docs mount. Nest gives no way to mount a module from outside, so it is an option. */
+  mountPath?: string;
+}
+
+const DEFAULT_MOUNT_PATH = '/docs';
+
+/** Searched for, not stripped: `setGlobalPrefix('api')` moves a `/docs` mount to `/api/docs`. */
+export function subPathOf(fullUrl: string, mountPath: string): string {
+  const at = fullUrl.indexOf(mountPath);
+  if (at === -1) {
+    return fullUrl;
+  }
+
+  return fullUrl.slice(at + mountPath.length) || '/';
+}
+
+/** `ApiDocsModule.forRoot({ collection: './api-collection', mountPath: '/docs' })`. */
+export class ApiDocsModule {
+  static forRoot(options: ApiDocsModuleOptions): DynamicModule {
+    const mountPath = (options.mountPath ?? DEFAULT_MOUNT_PATH).replace(/\/+$/, '');
+    const handler = createDocs(options).handler();
+
+    @Module({})
+    class ApiDocsHostModule implements NestModule {
+      configure(consumer: MiddlewareConsumer): void {
+        consumer
+          .apply((req: Request, res: ServerResponse) => {
+            const originalUrl = req.originalUrl ?? req.url ?? '/';
+            const url = subPathOf(originalUrl, mountPath);
+            handler({ method: req.method, url, originalUrl, headers: req.headers }, res);
+          })
+          // the mount alone is enough on platform-express, which matches by prefix. On
+          // platform-fastify it matches only the mount itself, so the wildcard is what serves
+          // shell.js and every deep link. `*` is understood by Nest 10 and 11 alike.
+          .forRoutes(mountPath, `${mountPath}/*`);
+      }
+    }
+
+    return { module: ApiDocsHostModule };
+  }
+}
diff --git a/integrations/nodejs/nestjs/test/sub-path.test.mjs b/integrations/nodejs/nestjs/test/sub-path.test.mjs
new file mode 100644
index 00000000..935646ba
--- /dev/null
+++ b/integrations/nodejs/nestjs/test/sub-path.test.mjs
@@ -0,0 +1,31 @@
+// Nest is the only wrapper that has to work out the path itself: on platform-fastify the
+// middleware is handed `/` whatever was requested. Run: npm run test:nestjs
+import { fileURLToPath } from 'node:url';
+import path from 'node:path';
+import assert from 'node:assert/strict';
+import { createRequire } from 'node:module';
+
+const here = path.dirname(fileURLToPath(import.meta.url));
+const require = createRequire(import.meta.url);
+const { subPathOf } = require(path.join(here, '..', 'dist', 'index.js'));
+
+// --- the ordinary mount
+assert.equal(subPathOf('/docs', '/docs'), '/', 'the mount itself is the root of the docs');
+assert.equal(subPathOf('/docs/', '/docs'), '/');
+assert.equal(subPathOf('/docs/shell.js', '/docs'), '/shell.js');
+assert.equal(subPathOf('/docs/collection.yml', '/docs'), '/collection.yml');
+assert.equal(subPathOf('/docs/catalog/list/', '/docs'), '/catalog/list/', 'any depth, for deep links');
+assert.equal(subPathOf('/docs/shell.js?v=2', '/docs'), '/shell.js?v=2', 'the query survives, the handler strips it');
+
+// --- a mount several segments deep
+assert.equal(subPathOf('/api/v2/docs/shell.js', '/api/v2/docs'), '/shell.js');
+
+// --- setGlobalPrefix: Nest applies it to middleware routes, so a /docs mount answers at /api/docs
+assert.equal(subPathOf('/api/docs/shell.js', '/docs'), '/shell.js', 'the prefix in front of the mount is skipped');
+assert.equal(subPathOf('/api/docs/', '/docs'), '/');
+assert.equal(subPathOf('/api/docs', '/docs'), '/');
+
+// --- nothing to match
+assert.equal(subPathOf('/somewhere-else', '/docs'), '/somewhere-else', 'left alone rather than guessed at');
+
+console.log('sub-path-test: all assertions passed');
diff --git a/integrations/nodejs/nestjs/tsconfig.json b/integrations/nodejs/nestjs/tsconfig.json
new file mode 100644
index 00000000..0a787d37
--- /dev/null
+++ b/integrations/nodejs/nestjs/tsconfig.json
@@ -0,0 +1,10 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "rootDir": "src",
+    "outDir": "dist",
+    "experimentalDecorators": true,
+    "emitDecoratorMetadata": true
+  },
+  "include": ["src"]
+}
diff --git a/integrations/package-lock.json b/integrations/package-lock.json
index 8216d313..084d701b 100644
--- a/integrations/package-lock.json
+++ b/integrations/package-lock.json
@@ -12,6 +12,10 @@
       "devDependencies": {
         "@eslint/js": "^9.39.5",
         "@fastify/swagger": "^9.8.1",
+        "@nestjs/common": "^11.2.5",
+        "@nestjs/core": "^11.2.5",
+        "@nestjs/platform-express": "^11.2.5",
+        "@nestjs/platform-fastify": "^11.2.5",
         "@stylistic/eslint-plugin": "^5.3.1",
         "@types/express": "^5.0.0",
         "@types/js-yaml": "^4.0.9",
@@ -24,9 +28,21 @@
         "fastify": "^5.12.5",
         "globals": "^16.0.0",
         "helmet": "^8.0.0",
+        "reflect-metadata": "^0.2.2",
+        "rxjs": "^7.8.2",
         "typescript": "^5.7.0"
       }
     },
+    "node_modules/@borewit/text-codec": {
+      "version": "0.2.2",
+      "resolved": "https://registry.npmjs.org/@borewit/text-codec/-/text-codec-0.2.2.tgz",
+      "integrity": "sha512-DDaRehssg1aNrH4+2hnj1B7vnUGEjU6OIlyRdkMd0aUdIUvKXrJfXsy8LVtXAy7DRvYVluWbMspsRhz2lcW0mQ==",
+      "license": "MIT",
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/Borewit"
+      }
+    },
     "node_modules/@esbuild/aix-ppc64": {
       "version": "0.24.2",
       "resolved": "https://registry.npmjs.org/@esbuild/aix-ppc64/-/aix-ppc64-0.24.2.tgz",
@@ -740,6 +756,27 @@
       "integrity": "sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug==",
       "license": "MIT"
     },
+    "node_modules/@fastify/cors": {
+      "version": "11.3.0",
+      "resolved": "https://registry.npmjs.org/@fastify/cors/-/cors-11.3.0.tgz",
+      "integrity": "sha512-ggQGua+xHv1MvePbPr0v//xLYEsCXbWspquXCJS9Ot5YoRXq8J8ZWzHnxDBVnbtXosvistXo6LtNzOJswf64Fw==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/fastify"
+        },
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/fastify"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "fastify-plugin": "^6.0.0",
+        "toad-cache": "^3.7.0"
+      }
+    },
     "node_modules/@fastify/error": {
       "version": "4.2.0",
       "resolved": "https://registry.npmjs.org/@fastify/error/-/error-4.2.0.tgz",
@@ -775,6 +812,44 @@
         "fast-json-stringify": "^7.0.0"
       }
     },
+    "node_modules/@fastify/formbody": {
+      "version": "8.0.2",
+      "resolved": "https://registry.npmjs.org/@fastify/formbody/-/formbody-8.0.2.tgz",
+      "integrity": "sha512-84v5J2KrkXzjgBpYnaNRPqwgMsmY7ZDjuj0YVuMR3NXCJRCgKEZy/taSP1wUYGn0onfxJpLyRGDLa+NMaDJtnA==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/fastify"
+        },
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/fastify"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "fast-querystring": "^1.1.2",
+        "fastify-plugin": "^5.0.0"
+      }
+    },
+    "node_modules/@fastify/formbody/node_modules/fastify-plugin": {
+      "version": "5.1.0",
+      "resolved": "https://registry.npmjs.org/fastify-plugin/-/fastify-plugin-5.1.0.tgz",
+      "integrity": "sha512-FAIDA8eovSt5qcDgcBvDuX/v0Cjz0ohGhENZ/wpc3y+oZCY2afZ9Baqql3g/lC+OHRnciQol4ww7tuthOb9idw==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/fastify"
+        },
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/fastify"
+        }
+      ],
+      "license": "MIT"
+    },
     "node_modules/@fastify/forwarded": {
       "version": "3.0.2",
       "resolved": "https://registry.npmjs.org/@fastify/forwarded/-/forwarded-3.0.2.tgz",
@@ -810,6 +885,30 @@
         "dequal": "^2.0.3"
       }
     },
+    "node_modules/@fastify/middie": {
+      "version": "9.3.4",
+      "resolved": "https://registry.npmjs.org/@fastify/middie/-/middie-9.3.4.tgz",
+      "integrity": "sha512-dd8phTnVWzx3iKPBKSvtRUT8+Igvy/MP+P5HcY2tjejEyeVbyjkD4HgzKessUObue5RRM5J6PZdxtAqgbn84yw==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/fastify"
+        },
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/fastify"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "@fastify/error": "^4.0.0",
+        "fastify-plugin": "^6.0.0",
+        "find-my-way": "^9.5.0",
+        "path-to-regexp": "^8.1.0",
+        "reusify": "^1.0.4"
+      }
+    },
     "node_modules/@fastify/proxy-addr": {
       "version": "5.1.1",
       "resolved": "https://registry.npmjs.org/@fastify/proxy-addr/-/proxy-addr-5.1.1.tgz",
@@ -929,6 +1028,192 @@
         "url": "https://github.com/sponsors/nzakas"
       }
     },
+    "node_modules/@lukeed/csprng": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/@lukeed/csprng/-/csprng-1.1.0.tgz",
+      "integrity": "sha512-Z7C/xXCiGWsg0KuKsHTKJxbWhpI3Vs5GwLfOean7MGyVFGqdRgBbAjOCh6u4bbjPc/8MJ2pZmK/0DLdCbivLDA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/@nestjs/common": {
+      "version": "11.2.5",
+      "resolved": "https://registry.npmjs.org/@nestjs/common/-/common-11.2.5.tgz",
+      "integrity": "sha512-x3LYEZnbGZMIeu9m60ws2+ZWzFAok9zGwjXZjcmdAeCLw6BYEjp9lreimuEpDIsLXK9bi6iYcJsYQGat9wq/rQ==",
+      "license": "MIT",
+      "dependencies": {
+        "file-type": "21.3.4",
+        "iterare": "1.2.1",
+        "load-esm": "1.0.3",
+        "tslib": "2.8.1",
+        "uid": "2.0.2"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/nest"
+      },
+      "peerDependencies": {
+        "class-transformer": ">=0.4.1",
+        "class-validator": ">=0.13.2",
+        "reflect-metadata": "^0.1.12 || ^0.2.0",
+        "rxjs": "^7.1.0"
+      },
+      "peerDependenciesMeta": {
+        "class-transformer": {
+          "optional": true
+        },
+        "class-validator": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/@nestjs/core": {
+      "version": "11.2.5",
+      "resolved": "https://registry.npmjs.org/@nestjs/core/-/core-11.2.5.tgz",
+      "integrity": "sha512-ZgF8aitL7h8VPyVQ+vlUDrSVzbR7AojCv9Je9JqJVfHw3TtD3OOQ82RsCKrxfx09xpoveRr7UBHPA/d24bu2lA==",
+      "license": "MIT",
+      "dependencies": {
+        "fast-safe-stringify": "2.1.1",
+        "iterare": "1.2.1",
+        "path-to-regexp": "8.4.2",
+        "tslib": "2.8.1",
+        "uid": "2.0.2"
+      },
+      "engines": {
+        "node": ">= 20"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/nest"
+      },
+      "peerDependencies": {
+        "@nestjs/common": "^11.0.0",
+        "@nestjs/microservices": "^11.0.0",
+        "@nestjs/platform-express": "^11.0.0",
+        "@nestjs/websockets": "^11.0.0",
+        "reflect-metadata": "^0.1.12 || ^0.2.0",
+        "rxjs": "^7.1.0"
+      },
+      "peerDependenciesMeta": {
+        "@nestjs/microservices": {
+          "optional": true
+        },
+        "@nestjs/platform-express": {
+          "optional": true
+        },
+        "@nestjs/websockets": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/@nestjs/platform-express": {
+      "version": "11.2.5",
+      "resolved": "https://registry.npmjs.org/@nestjs/platform-express/-/platform-express-11.2.5.tgz",
+      "integrity": "sha512-R3LSHqgPQo7ZTdYqA39lvdHS2RBnVJUePKIpL+cr1oB3HtYj9qPdhdmS307eLDc1VeTPFXAnSuVfcG9lMDEFSw==",
+      "devOptional": true,
+      "license": "MIT",
+      "dependencies": {
+        "cors": "2.8.6",
+        "express": "5.2.1",
+        "multer": "2.2.0",
+        "path-to-regexp": "8.4.2",
+        "tslib": "2.8.1"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/nest"
+      },
+      "peerDependencies": {
+        "@nestjs/common": "^11.0.0",
+        "@nestjs/core": "^11.0.0"
+      }
+    },
+    "node_modules/@nestjs/platform-fastify": {
+      "version": "11.2.5",
+      "resolved": "https://registry.npmjs.org/@nestjs/platform-fastify/-/platform-fastify-11.2.5.tgz",
+      "integrity": "sha512-uD40kttwSn2UpLmLXeD46JISJxpNvYfnIjrjjKqQIuQHXceTKClZavRMVey0XwkKPOczXEPmOQn79/CcFuZtgw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@fastify/cors": "11.3.0",
+        "@fastify/formbody": "8.0.2",
+        "@fastify/middie": "9.3.4",
+        "fast-querystring": "1.1.2",
+        "fastify": "5.11.3",
+        "find-my-way": "9.7.0",
+        "light-my-request": "6.6.0",
+        "path-to-regexp": "8.4.2",
+        "tslib": "2.8.1"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/nest"
+      },
+      "peerDependencies": {
+        "@fastify/static": "^10.1.2",
+        "@fastify/view": "^10.0.0 || ^11.0.0 || ^12.0.0",
+        "@nestjs/common": "^11.0.0",
+        "@nestjs/core": "^11.0.0"
+      },
+      "peerDependenciesMeta": {
+        "@fastify/static": {
+          "optional": true
+        },
+        "@fastify/view": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/@nestjs/platform-fastify/node_modules/fastify": {
+      "version": "5.11.3",
+      "resolved": "https://registry.npmjs.org/fastify/-/fastify-5.11.3.tgz",
+      "integrity": "sha512-W6hzDP8s0iSeL7LGwY6Oc/ZxuXWOvFEMs6p2L0Si415YRo27W5pBKdOTXxhemBDeSTAcpYf5evRA9onF2OYhPA==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/fastify"
+        },
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/fastify"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "@fastify/ajv-compiler": "^4.0.5",
+        "@fastify/error": "^4.0.0",
+        "@fastify/fast-json-stringify-compiler": "^5.0.0",
+        "@fastify/proxy-addr": "^5.0.0",
+        "abstract-logging": "^2.0.1",
+        "avvio": "^9.0.0",
+        "fast-json-stringify": "^7.0.0",
+        "find-my-way": "^9.6.0",
+        "light-my-request": "^6.0.0",
+        "pino": "^9.14.0 || ^10.1.0",
+        "process-warning": "^5.0.0",
+        "rfdc": "^1.3.1",
+        "secure-json-parse": "^4.0.0",
+        "semver": "^7.6.0",
+        "toad-cache": "^3.7.0"
+      }
+    },
+    "node_modules/@nestjs/platform-fastify/node_modules/find-my-way": {
+      "version": "9.7.0",
+      "resolved": "https://registry.npmjs.org/find-my-way/-/find-my-way-9.7.0.tgz",
+      "integrity": "sha512-f2JHn75x2JlwUwLenZypgczR7YWMb/uO9BvUXtus+JMgkbIkLADd38cI4EiV+OQqrGo1Zlq6V8wnqMJ8e62wUQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "fast-deep-equal": "^3.1.3",
+        "fast-querystring": "^1.0.0",
+        "safe-regex2": "^5.0.0"
+      },
+      "engines": {
+        "node": ">=20"
+      }
+    },
     "node_modules/@pinojs/redact": {
       "version": "0.4.0",
       "resolved": "https://registry.npmjs.org/@pinojs/redact/-/redact-0.4.0.tgz",
@@ -956,6 +1241,29 @@
         "eslint": "^9.0.0 || ^10.0.0"
       }
     },
+    "node_modules/@tokenizer/inflate": {
+      "version": "0.4.1",
+      "resolved": "https://registry.npmjs.org/@tokenizer/inflate/-/inflate-0.4.1.tgz",
+      "integrity": "sha512-2mAv+8pkG6GIZiF1kNg1jAjh27IDxEPKwdGul3snfztFerfPGI1LjDezZp3i7BElXompqEtPmoPx6c2wgtWsOA==",
+      "license": "MIT",
+      "dependencies": {
+        "debug": "^4.4.3",
+        "token-types": "^6.1.1"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/Borewit"
+      }
+    },
+    "node_modules/@tokenizer/token": {
+      "version": "0.3.0",
+      "resolved": "https://registry.npmjs.org/@tokenizer/token/-/token-0.3.0.tgz",
+      "integrity": "sha512-OvjF+z51L3ov0OyAU0duzsYuvO01PH7x4t6DJx+guahgTnBHkhJdG7soQeTSFLWN3efnHyibZ4Z8l2EuWwJN3A==",
+      "license": "MIT"
+    },
     "node_modules/@types/body-parser": {
       "version": "1.19.6",
       "resolved": "https://registry.npmjs.org/@types/body-parser/-/body-parser-1.19.6.tgz",
@@ -1320,6 +1628,10 @@
       "resolved": "nodejs/fastify",
       "link": true
     },
+    "node_modules/@usebruno/api-docs-nestjs": {
+      "resolved": "nodejs/nestjs",
+      "link": true
+    },
     "node_modules/abstract-logging": {
       "version": "2.0.1",
       "resolved": "https://registry.npmjs.org/abstract-logging/-/abstract-logging-2.0.1.tgz",
@@ -1450,6 +1762,13 @@
         "url": "https://github.com/chalk/ansi-styles?sponsor=1"
       }
     },
+    "node_modules/append-field": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/append-field/-/append-field-1.0.0.tgz",
+      "integrity": "sha512-klpgFSWLW1ZEs8svjfb7g4qWY0YS5imI82dTg+QahUvJ8YqAY0P10Uk8tTyh9ZGuYEZEMaeJYCF5BFuX552hsw==",
+      "devOptional": true,
+      "license": "MIT"
+    },
     "node_modules/argparse": {
       "version": "2.0.1",
       "resolved": "https://registry.npmjs.org/argparse/-/argparse-2.0.1.tgz",
@@ -1545,6 +1864,25 @@
         "node": "20 || >=22"
       }
     },
+    "node_modules/buffer-from": {
+      "version": "1.1.2",
+      "resolved": "https://registry.npmjs.org/buffer-from/-/buffer-from-1.1.2.tgz",
+      "integrity": "sha512-E+XQCRwSbaaiChtv6k6Dwgc+bx+Bs6vuKJHHl5kox/BaKbhiXzqQOwK4cO22yElGp2OCmjwVhT3HmxgyPGnJfQ==",
+      "devOptional": true,
+      "license": "MIT"
+    },
+    "node_modules/busboy": {
+      "version": "1.6.0",
+      "resolved": "https://registry.npmjs.org/busboy/-/busboy-1.6.0.tgz",
+      "integrity": "sha512-8SFQbg/0hQ9xy3UNTB0YEnsNBbWfhf7RtnzpL7TkBiTBRfrQ9Fxcnz7VJsleJpyp6rVLvXiuORqjlHi5q+PYuA==",
+      "devOptional": true,
+      "dependencies": {
+        "streamsearch": "^1.1.0"
+      },
+      "engines": {
+        "node": ">=10.16.0"
+      }
+    },
     "node_modules/bytes": {
       "version": "3.1.2",
       "resolved": "https://registry.npmjs.org/bytes/-/bytes-3.1.2.tgz",
@@ -1637,6 +1975,22 @@
       "dev": true,
       "license": "MIT"
     },
+    "node_modules/concat-stream": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/concat-stream/-/concat-stream-2.0.0.tgz",
+      "integrity": "sha512-MWufYdFw53ccGjCA+Ol7XJYpAlW6/prSMzuPOTRnJGcGzuhLn4Scrz7qf6o8bROZ514ltazcIFJZevcfbo0x7A==",
+      "devOptional": true,
+      "engines": [
+        "node >= 6.0"
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "buffer-from": "^1.0.0",
+        "inherits": "^2.0.3",
+        "readable-stream": "^3.0.2",
+        "typedarray": "^0.0.6"
+      }
+    },
     "node_modules/content-disposition": {
       "version": "1.1.0",
       "resolved": "https://registry.npmjs.org/content-disposition/-/content-disposition-1.1.0.tgz",
@@ -1677,6 +2031,24 @@
         "node": ">=6.6.0"
       }
     },
+    "node_modules/cors": {
+      "version": "2.8.6",
+      "resolved": "https://registry.npmjs.org/cors/-/cors-2.8.6.tgz",
+      "integrity": "sha512-tJtZBBHA6vjIAaF6EnIaq6laBBP9aq/Y3ouVJjEfoHbRBcHBAHYcMh/w8LDrk2PvIMMq8gmopa5D4V8RmbrxGw==",
+      "devOptional": true,
+      "license": "MIT",
+      "dependencies": {
+        "object-assign": "^4",
+        "vary": "^1"
+      },
+      "engines": {
+        "node": ">= 0.10"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
+      }
+    },
     "node_modules/cross-spawn": {
       "version": "7.0.6",
       "resolved": "https://registry.npmjs.org/cross-spawn/-/cross-spawn-7.0.6.tgz",
@@ -2198,6 +2570,12 @@
         "fast-decode-uri-component": "^1.0.1"
       }
     },
+    "node_modules/fast-safe-stringify": {
+      "version": "2.1.1",
+      "resolved": "https://registry.npmjs.org/fast-safe-stringify/-/fast-safe-stringify-2.1.1.tgz",
+      "integrity": "sha512-W+KJc2dmILlPplD/H4K9l9LcAHAfPtP6BY84uVLXQ6Evcz9Lcg33Y2z1IVblT6xdY54PXYVHEv+0Wpq8Io6zkA==",
+      "license": "MIT"
+    },
     "node_modules/fast-uri": {
       "version": "4.1.5",
       "resolved": "https://registry.npmjs.org/fast-uri/-/fast-uri-4.1.5.tgz",
@@ -2304,6 +2682,24 @@
         "node": ">=16.0.0"
       }
     },
+    "node_modules/file-type": {
+      "version": "21.3.4",
+      "resolved": "https://registry.npmjs.org/file-type/-/file-type-21.3.4.tgz",
+      "integrity": "sha512-Ievi/yy8DS3ygGvT47PjSfdFoX+2isQueoYP1cntFW1JLYAuS4GD7NUPGg4zv2iZfV52uDyk5w5Z0TdpRS6Q1g==",
+      "license": "MIT",
+      "dependencies": {
+        "@tokenizer/inflate": "^0.4.1",
+        "strtok3": "^10.3.4",
+        "token-types": "^6.1.1",
+        "uint8array-extras": "^1.4.0"
+      },
+      "engines": {
+        "node": ">=20"
+      },
+      "funding": {
+        "url": "https://github.com/sindresorhus/file-type?sponsor=1"
+      }
+    },
     "node_modules/finalhandler": {
       "version": "2.1.1",
       "resolved": "https://registry.npmjs.org/finalhandler/-/finalhandler-2.1.1.tgz",
@@ -2562,6 +2958,26 @@
         "url": "https://opencollective.com/express"
       }
     },
+    "node_modules/ieee754": {
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/ieee754/-/ieee754-1.2.1.tgz",
+      "integrity": "sha512-dcyqhDvX1C46lXZcVqCpK+FtMRQVdIMN6/Df5js2zouUsqG7I6sFxitIC+7KYK29KdXOLHdu9zL4sFnoVQnqaA==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/feross"
+        },
+        {
+          "type": "patreon",
+          "url": "https://www.patreon.com/feross"
+        },
+        {
+          "type": "consulting",
+          "url": "https://feross.org/support"
+        }
+      ],
+      "license": "BSD-3-Clause"
+    },
     "node_modules/ignore": {
       "version": "7.0.9",
       "resolved": "https://registry.npmjs.org/ignore/-/ignore-7.0.9.tgz",
@@ -2650,6 +3066,15 @@
       "dev": true,
       "license": "ISC"
     },
+    "node_modules/iterare": {
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/iterare/-/iterare-1.2.1.tgz",
+      "integrity": "sha512-RKYVTCjAnRthyJes037NX/IiqeidgN1xc3j1RjFfECFp28A1GVwK9nA+i0rJPaHqSZwygLzRnFlzUuHFoWWy+Q==",
+      "license": "ISC",
+      "engines": {
+        "node": ">=6"
+      }
+    },
     "node_modules/js-yaml": {
       "version": "4.3.2",
       "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-4.3.2.tgz",
@@ -2821,6 +3246,25 @@
       ],
       "license": "MIT"
     },
+    "node_modules/load-esm": {
+      "version": "1.0.3",
+      "resolved": "https://registry.npmjs.org/load-esm/-/load-esm-1.0.3.tgz",
+      "integrity": "sha512-v5xlu8eHD1+6r8EHTg6hfmO97LN8ugKtiXcy5e6oN72iD2r6u0RPfLl6fxM+7Wnh2ZRq15o0russMst44WauPA==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/Borewit"
+        },
+        {
+          "type": "buymeacoffee",
+          "url": "https://buymeacoffee.com/borewit"
+        }
+      ],
+      "license": "MIT",
+      "engines": {
+        "node": ">=13.2.0"
+      }
+    },
     "node_modules/locate-path": {
       "version": "6.0.0",
       "resolved": "https://registry.npmjs.org/locate-path/-/locate-path-6.0.0.tgz",
@@ -2925,6 +3369,73 @@
       "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==",
       "license": "MIT"
     },
+    "node_modules/multer": {
+      "version": "2.2.0",
+      "resolved": "https://registry.npmjs.org/multer/-/multer-2.2.0.tgz",
+      "integrity": "sha512-6rdyFg2kLrMh9Jee7/BMPuV9lEAd7lLW2YUpF9/YxR7njyoUwwQ0ZPh3TaIY50Sw6vlyD2HW3wGOkTS4P79xrQ==",
+      "devOptional": true,
+      "license": "MIT",
+      "dependencies": {
+        "append-field": "^1.0.0",
+        "busboy": "^1.6.0",
+        "concat-stream": "^2.0.0",
+        "type-is": "^1.6.18"
+      },
+      "engines": {
+        "node": ">= 10.16.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
+      }
+    },
+    "node_modules/multer/node_modules/media-typer": {
+      "version": "0.3.0",
+      "resolved": "https://registry.npmjs.org/media-typer/-/media-typer-0.3.0.tgz",
+      "integrity": "sha512-dq+qelQ9akHpcOl/gUVRTxVIOkAJ1wR3QAvb4RsVjS8oVoFjDGTc679wJYmUmknUF5HwMLOgb5O+a3KxfWapPQ==",
+      "devOptional": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/multer/node_modules/mime-db": {
+      "version": "1.52.0",
+      "resolved": "https://registry.npmjs.org/mime-db/-/mime-db-1.52.0.tgz",
+      "integrity": "sha512-sPU4uV7dYlvtWJxwwxHD0PuihVNiE7TyAbQ5SWxDCB9mUYvOgroQOwYQQOKPJ8CIbE+1ETVlOoK1UC2nU3gYvg==",
+      "devOptional": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/multer/node_modules/mime-types": {
+      "version": "2.1.35",
+      "resolved": "https://registry.npmjs.org/mime-types/-/mime-types-2.1.35.tgz",
+      "integrity": "sha512-ZDY+bPm5zTTF+YpCrAU9nK0UgICYPT0QtT1NZWFv4s++TNkcgVaT0g6+4R2uI4MjQjzysHB1zxuWL50hzaeXiw==",
+      "devOptional": true,
+      "license": "MIT",
+      "dependencies": {
+        "mime-db": "1.52.0"
+      },
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/multer/node_modules/type-is": {
+      "version": "1.6.18",
+      "resolved": "https://registry.npmjs.org/type-is/-/type-is-1.6.18.tgz",
+      "integrity": "sha512-TkRKr9sUTxEH8MdfuCSP7VizJyzRNMjj2J2do2Jr3Kym598JVdEksuzPQCnlFPW4ky9Q+iA+ma9BGm06XQBy8g==",
+      "devOptional": true,
+      "license": "MIT",
+      "dependencies": {
+        "media-typer": "0.3.0",
+        "mime-types": "~2.1.24"
+      },
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
     "node_modules/natural-compare": {
       "version": "1.4.0",
       "resolved": "https://registry.npmjs.org/natural-compare/-/natural-compare-1.4.0.tgz",
@@ -2961,6 +3472,16 @@
         "url": "https://opencollective.com/express"
       }
     },
+    "node_modules/object-assign": {
+      "version": "4.1.1",
+      "resolved": "https://registry.npmjs.org/object-assign/-/object-assign-4.1.1.tgz",
+      "integrity": "sha512-rJgTQnkUnH1sFw8yT6VSU3zD3sWmu6sZhIseY8VX+GRu3P6F7Fu+JNDoXfklElbLJSnc3FUQHVe4cU5hj+BcUg==",
+      "devOptional": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
     "node_modules/object-inspect": {
       "version": "1.13.4",
       "resolved": "https://registry.npmjs.org/object-inspect/-/object-inspect-1.13.4.tgz",
@@ -3261,6 +3782,21 @@
         "node": ">= 0.10"
       }
     },
+    "node_modules/readable-stream": {
+      "version": "3.6.2",
+      "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-3.6.2.tgz",
+      "integrity": "sha512-9u/sniCrY3D5WdsERHzHE4G2YCXqoG5FTHUiCC4SIbr6XcLZBY05ya9EKjYek9O5xOAwjGq+1JdGBAS7Q9ScoA==",
+      "devOptional": true,
+      "license": "MIT",
+      "dependencies": {
+        "inherits": "^2.0.3",
+        "string_decoder": "^1.1.1",
+        "util-deprecate": "^1.0.1"
+      },
+      "engines": {
+        "node": ">= 6"
+      }
+    },
     "node_modules/real-require": {
       "version": "0.2.0",
       "resolved": "https://registry.npmjs.org/real-require/-/real-require-0.2.0.tgz",
@@ -3270,6 +3806,12 @@
         "node": ">= 12.13.0"
       }
     },
+    "node_modules/reflect-metadata": {
+      "version": "0.2.2",
+      "resolved": "https://registry.npmjs.org/reflect-metadata/-/reflect-metadata-0.2.2.tgz",
+      "integrity": "sha512-urBwgfrvVP/eAyXx4hluJivBKzuEbSQs9rKWCrCkbSxNv8mxPcUZKeuoF3Uy4mJl3Lwprp6yy5/39VWigZ4K6Q==",
+      "license": "Apache-2.0"
+    },
     "node_modules/require-from-string": {
       "version": "2.0.2",
       "resolved": "https://registry.npmjs.org/require-from-string/-/require-from-string-2.0.2.tgz",
@@ -3330,6 +3872,36 @@
         "node": ">= 18"
       }
     },
+    "node_modules/rxjs": {
+      "version": "7.8.2",
+      "resolved": "https://registry.npmjs.org/rxjs/-/rxjs-7.8.2.tgz",
+      "integrity": "sha512-dhKf903U/PQZY6boNNtAGdWbG85WAbjT/1xYoZIC7FAY0yWapOBQVsVrDl58W86//e1VpMNBtRV4MaXfdMySFA==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "tslib": "^2.1.0"
+      }
+    },
+    "node_modules/safe-buffer": {
+      "version": "5.2.1",
+      "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.2.1.tgz",
+      "integrity": "sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ==",
+      "devOptional": true,
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/feross"
+        },
+        {
+          "type": "patreon",
+          "url": "https://www.patreon.com/feross"
+        },
+        {
+          "type": "consulting",
+          "url": "https://feross.org/support"
+        }
+      ],
+      "license": "MIT"
+    },
     "node_modules/safe-regex2": {
       "version": "5.1.1",
       "resolved": "https://registry.npmjs.org/safe-regex2/-/safe-regex2-5.1.1.tgz",
@@ -3574,6 +4146,25 @@
         "node": ">= 0.8"
       }
     },
+    "node_modules/streamsearch": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/streamsearch/-/streamsearch-1.1.0.tgz",
+      "integrity": "sha512-Mcc5wHehp9aXz1ax6bZUyY5afg9u2rv5cqQI3mRrYkGC8rW2hM02jWuwjtL++LS5qinSyhj2QfLyNsuc+VsExg==",
+      "devOptional": true,
+      "engines": {
+        "node": ">=10.0.0"
+      }
+    },
+    "node_modules/string_decoder": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-1.3.0.tgz",
+      "integrity": "sha512-hkRX8U1WjJFd8LsDJ2yQ/wWWxaopEsABU1XfkM8A+j0+85JAGppt16cr1Whg6KIbb4okU6Mql6BOj+uup/wKeA==",
+      "devOptional": true,
+      "license": "MIT",
+      "dependencies": {
+        "safe-buffer": "~5.2.0"
+      }
+    },
     "node_modules/strip-json-comments": {
       "version": "3.1.1",
       "resolved": "https://registry.npmjs.org/strip-json-comments/-/strip-json-comments-3.1.1.tgz",
@@ -3587,6 +4178,22 @@
         "url": "https://github.com/sponsors/sindresorhus"
       }
     },
+    "node_modules/strtok3": {
+      "version": "10.3.5",
+      "resolved": "https://registry.npmjs.org/strtok3/-/strtok3-10.3.5.tgz",
+      "integrity": "sha512-ki4hZQfh5rX0QDLLkOCj+h+CVNkqmp/CMf8v8kZpkNVK6jGQooMytqzLZYUVYIZcFZ6yDB70EfD8POcFXiF5oA==",
+      "license": "MIT",
+      "dependencies": {
+        "@tokenizer/token": "^0.3.0"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/Borewit"
+      }
+    },
     "node_modules/supports-color": {
       "version": "7.2.0",
       "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz",
@@ -3653,6 +4260,24 @@
         "node": ">=0.6"
       }
     },
+    "node_modules/token-types": {
+      "version": "6.1.2",
+      "resolved": "https://registry.npmjs.org/token-types/-/token-types-6.1.2.tgz",
+      "integrity": "sha512-dRXchy+C0IgK8WPC6xvCHFRIWYUbqqdEIKPaKo/AcTUNzwLTK6AH7RjdLWsEZcAN/TBdtfUw3PYEgPr5VPr6ww==",
+      "license": "MIT",
+      "dependencies": {
+        "@borewit/text-codec": "^0.2.1",
+        "@tokenizer/token": "^0.3.0",
+        "ieee754": "^1.2.1"
+      },
+      "engines": {
+        "node": ">=14.16"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/Borewit"
+      }
+    },
     "node_modules/ts-api-utils": {
       "version": "2.5.0",
       "resolved": "https://registry.npmjs.org/ts-api-utils/-/ts-api-utils-2.5.0.tgz",
@@ -3666,6 +4291,12 @@
         "typescript": ">=4.8.4"
       }
     },
+    "node_modules/tslib": {
+      "version": "2.8.1",
+      "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.8.1.tgz",
+      "integrity": "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w==",
+      "license": "0BSD"
+    },
     "node_modules/type-check": {
       "version": "0.4.0",
       "resolved": "https://registry.npmjs.org/type-check/-/type-check-0.4.0.tgz",
@@ -3710,6 +4341,13 @@
         "url": "https://opencollective.com/express"
       }
     },
+    "node_modules/typedarray": {
+      "version": "0.0.6",
+      "resolved": "https://registry.npmjs.org/typedarray/-/typedarray-0.0.6.tgz",
+      "integrity": "sha512-/aCDEGatGvZ2BIk+HmLf4ifCJFwvKFNb9/JeZPMulfgFracn9QFcAf5GO8B/mweUjSoblS5In0cWhqpfs/5PQA==",
+      "devOptional": true,
+      "license": "MIT"
+    },
     "node_modules/typescript": {
       "version": "5.9.3",
       "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.9.3.tgz",
@@ -3724,6 +4362,30 @@
         "node": ">=14.17"
       }
     },
+    "node_modules/uid": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/uid/-/uid-2.0.2.tgz",
+      "integrity": "sha512-u3xV3X7uzvi5b1MncmZo3i2Aw222Zk1keqLA1YkHldREkAhAqi65wuPfe7lHx8H/Wzy+8CE7S7uS3jekIM5s8g==",
+      "license": "MIT",
+      "dependencies": {
+        "@lukeed/csprng": "^1.0.0"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/uint8array-extras": {
+      "version": "1.5.0",
+      "resolved": "https://registry.npmjs.org/uint8array-extras/-/uint8array-extras-1.5.0.tgz",
+      "integrity": "sha512-rvKSBiC5zqCCiDZ9kAOszZcDvdAHwwIKJG33Ykj43OKcWsnmcBRL09YTU4nOeHZ8Y2a7l1MgTd08SBe9A8Qj6A==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
     "node_modules/undici-types": {
       "version": "6.21.0",
       "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-6.21.0.tgz",
@@ -3750,6 +4412,13 @@
         "punycode": "^2.1.0"
       }
     },
+    "node_modules/util-deprecate": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/util-deprecate/-/util-deprecate-1.0.2.tgz",
+      "integrity": "sha512-EPD5q1uXyFxJpCrLnCc1nHnq3gOa6DZBocAIiI2TaSCA7VCJ1UJDMagCzIkXNsUYfD1daK//LTEQ8xiIbrHtcw==",
+      "devOptional": true,
+      "license": "MIT"
+    },
     "node_modules/vary": {
       "version": "1.1.2",
       "resolved": "https://registry.npmjs.org/vary/-/vary-1.1.2.tgz",
@@ -3858,6 +4527,21 @@
       "peerDependencies": {
         "fastify": "^4.0.0 || ^5.0.0"
       }
+    },
+    "nodejs/nestjs": {
+      "name": "@usebruno/api-docs-nestjs",
+      "version": "0.1.0-beta.1",
+      "license": "MIT",
+      "dependencies": {
+        "@usebruno/api-docs-core": "0.1.0-beta.1"
+      },
+      "engines": {
+        "node": ">=20"
+      },
+      "peerDependencies": {
+        "@nestjs/common": "^10.0.0 || ^11.0.0",
+        "@nestjs/core": "^10.0.0 || ^11.0.0"
+      }
     }
   }
 }
diff --git a/integrations/package.json b/integrations/package.json
index 2481541b..7f14969e 100644
--- a/integrations/package.json
+++ b/integrations/package.json
@@ -7,13 +7,16 @@
     "nodejs/*"
   ],
   "scripts": {
-    "build": "npm run build:shell && npm run build:core && npm run build:express && npm run build:fastify",
+    "build": "npm run build:shell && npm run build:core && npm run build:express && npm run build:fastify && npm run build:nestjs",
     "build:core": "tsc -p nodejs/core/tsconfig.json",
     "build:express": "tsc -p nodejs/express/tsconfig.json",
     "build:fastify": "tsc -p nodejs/fastify/tsconfig.json",
+    "build:nestjs": "tsc -p nodejs/nestjs/tsconfig.json",
     "build:shell": "esbuild shell/shell.src.mjs --bundle --minify --format=iife --platform=browser --target=es2020 --outfile=shell/shell.js --log-level=warning && mkdir -p nodejs/core/shell && cp shell/shell.html shell/shell.js nodejs/core/shell/",
     "check:express": "npm run build && bash contract-tests/check.sh --example nodejs/express/example/server.js --port 5456",
     "check:fastify": "npm run build && bash contract-tests/check.sh --example nodejs/fastify/example/server.js --port 5457",
+    "check:nestjs": "npm run build && bash contract-tests/check.sh --example nodejs/nestjs/example/server.js --port 5458",
+    "check:nestjs-fastify": "npm run build && ADAPTER=fastify bash contract-tests/check.sh --example nodejs/nestjs/example/server.js --port 5459",
     "lint": "eslint",
     "lint:fix": "eslint --fix",
     "start:express": "node nodejs/express/example/server.js",
@@ -22,12 +25,17 @@
     "test:collection": "npm run build:core && node nodejs/core/test/collection.test.mjs",
     "test:docs": "npm run build && node nodejs/core/test/docs.test.mjs",
     "test:filter": "npm run build:core && node nodejs/core/test/filter.test.mjs",
+    "test:nestjs": "npm run build && node nodejs/nestjs/test/sub-path.test.mjs",
     "test:shell": "npm run build && node nodejs/core/test/shell.test.mjs",
     "test:walk": "npm run build:core && node nodejs/core/test/walk.test.mjs"
   },
   "devDependencies": {
     "@eslint/js": "^9.39.5",
     "@fastify/swagger": "^9.8.1",
+    "@nestjs/common": "^11.2.5",
+    "@nestjs/core": "^11.2.5",
+    "@nestjs/platform-express": "^11.2.5",
+    "@nestjs/platform-fastify": "^11.2.5",
     "@stylistic/eslint-plugin": "^5.3.1",
     "@types/express": "^5.0.0",
     "@types/js-yaml": "^4.0.9",
@@ -40,6 +48,8 @@
     "fastify": "^5.12.5",
     "globals": "^16.0.0",
     "helmet": "^8.0.0",
+    "reflect-metadata": "^0.2.2",
+    "rxjs": "^7.8.2",
     "typescript": "^5.7.0"
   }
 }

From 9189ec0f0bed74eee8f8d1ad330dfe6d93f31287 Mon Sep 17 00:00:00 2001
From: Arpit Bruno <arpit@usebruno.com>
Date: Thu, 17 Sep 2026 11:33:53 +0530
Subject: [PATCH 10/21] one command for lint, build, seven suites for four
 frameworks

---
 integrations/contract-tests/check.sh          |  2 +
 .../nodejs/core/src/collection/walk.ts        | 20 ++++--
 integrations/nodejs/core/test/walk.test.mjs   | 18 ++++++
 integrations/nodejs/scripts/check-all.sh      | 25 ++++++++
 .../nodejs/scripts/pack-and-install.sh        | 62 +++++++++++++++++++
 integrations/package.json                     |  7 ++-
 6 files changed, 127 insertions(+), 7 deletions(-)
 create mode 100755 integrations/nodejs/scripts/check-all.sh
 create mode 100755 integrations/nodejs/scripts/pack-and-install.sh

diff --git a/integrations/contract-tests/check.sh b/integrations/contract-tests/check.sh
index 1d24ab82..91de5ca7 100755
--- a/integrations/contract-tests/check.sh
+++ b/integrations/contract-tests/check.sh
@@ -113,6 +113,8 @@ for MOUNT in /docs /api/v2/docs /internal/docs; do
   check "$MOUNT/ POST -> 405"                                  status_is 405 -X POST "$url/"
   check "$MOUNT/ POST -> Allow: GET, HEAD"                     header_has Allow 'GET, HEAD' "$url/" -X POST
   check "$MOUNT/ HEAD -> 200"                                  status_is 200 -I "$url/"
+  check "$MOUNT/shell.js HEAD -> 200"                          status_is 200 -I "$url/shell.js"
+  check "$MOUNT/collection.yml HEAD -> 200"                    status_is 200 -I "$url/collection.yml"
 
   curl -s "$url/collection.yml" >"$TMP/coll$saved.json"
   curl -s "$url/shell.js" >"$TMP/shell$saved.js"
diff --git a/integrations/nodejs/core/src/collection/walk.ts b/integrations/nodejs/core/src/collection/walk.ts
index e19db23d..22e25709 100644
--- a/integrations/nodejs/core/src/collection/walk.ts
+++ b/integrations/nodejs/core/src/collection/walk.ts
@@ -16,7 +16,14 @@ export interface WalkResult {
   skipped: SkippedFile[];
 }
 
-export const CAPS = Object.freeze({
+export interface Caps {
+  fileBytes: number;
+  totalBytes: number;
+  fileCount: number;
+  depth: number;
+}
+
+export const CAPS: Caps = Object.freeze({
   fileBytes: 1024 * 1024,
   totalBytes: 5 * 1024 * 1024,
   fileCount: 5000,
@@ -41,7 +48,8 @@ const isYaml = (name: string): boolean => name.endsWith('.yml') || name.endsWith
 
 const utf8Strict = new TextDecoder('utf-8', { fatal: true });
 
-export function walkCollection(rootDir: string): WalkResult {
+/** `caps` is a parameter so the limits can be tested without a 5 MB, 5000-file, 32-deep fixture. */
+export function walkCollection(rootDir: string, caps: Caps = CAPS): WalkResult {
   const rootReal = fs.realpathSync(rootDir);
   const files: WalkedFile[] = [];
   const skipped: SkippedFile[] = [];
@@ -53,7 +61,7 @@ export function walkCollection(rootDir: string): WalkResult {
   };
 
   const visit = (dir: string, rel: string, depth: number): void => {
-    if (depth > CAPS.depth) {
+    if (depth > caps.depth) {
       throw new CapError('max directory depth', rel);
     }
 
@@ -91,14 +99,14 @@ export function walkCollection(rootDir: string): WalkResult {
       }
 
       const size = fs.statSync(absPath).size;
-      if (size > CAPS.fileBytes) {
+      if (size > caps.fileBytes) {
         throw new CapError('per-file size cap (1MB)', relPath);
       }
       totalBytes += size;
-      if (totalBytes > CAPS.totalBytes) {
+      if (totalBytes > caps.totalBytes) {
         throw new CapError('total size cap (5MB)', relPath);
       }
-      if (files.length >= CAPS.fileCount) {
+      if (files.length >= caps.fileCount) {
         throw new CapError('file count cap', relPath);
       }
 
diff --git a/integrations/nodejs/core/test/walk.test.mjs b/integrations/nodejs/core/test/walk.test.mjs
index eb648176..ba6fc0b3 100644
--- a/integrations/nodejs/core/test/walk.test.mjs
+++ b/integrations/nodejs/core/test/walk.test.mjs
@@ -42,4 +42,22 @@ const fixture = (name) => path.join(here, '..', '..', '..', 'contract-tests', 'f
   console.log('walk-oversize: CapError raised before reading the file');
 }
 
+// --- the other three caps, with the limits lowered instead of a 5 MB, 5000-file, 32-deep fixture
+{
+  const safety = fixture('walk-safety');
+  const generous = { fileBytes: 1e9, totalBytes: 1e9, fileCount: 1e9, depth: 1e9 };
+  assert.equal(walkCollection(safety, generous).files.length, 3, 'nothing is refused when the caps are wide');
+
+  assert.throws(() => walkCollection(safety, { ...generous, totalBytes: 100 }),
+    (err) => err instanceof CapError && /total size cap/.test(err.message), 'the total size cap');
+
+  assert.throws(() => walkCollection(safety, { ...generous, fileCount: 2 }),
+    (err) => err instanceof CapError && /file count cap/.test(err.message), 'the file count cap');
+
+  assert.throws(() => walkCollection(safety, { ...generous, depth: 0 }),
+    (err) => err instanceof CapError && /max directory depth/.test(err.message), 'the directory depth cap');
+
+  assert.equal(walkCollection(safety).files.length, 3, 'and the real caps are the default');
+}
+
 console.log('walk-test: all assertions passed');
diff --git a/integrations/nodejs/scripts/check-all.sh b/integrations/nodejs/scripts/check-all.sh
new file mode 100755
index 00000000..596b2105
--- /dev/null
+++ b/integrations/nodejs/scripts/check-all.sh
@@ -0,0 +1,25 @@
+#!/usr/bin/env bash
+# Every Node framework against the one contract suite, and every one of them byte for byte against
+# the first. Different ports rather than one reused, so a server still shutting down cannot look
+# like a port already in use.
+set -euo pipefail
+
+ROOT="$(cd "$(dirname "$0")/../.." && pwd)"
+BODIES="$(mktemp -d)"
+trap 'rm -rf "$BODIES"' EXIT
+
+run() {
+  local name=$1 example=$2 port=$3 adapter=${4:-express}
+  echo
+  echo "### $name"
+  ADAPTER="$adapter" bash "$ROOT/contract-tests/check.sh" --example "$example" --port "$port" "${@:5}"
+}
+
+# the first run is the baseline every other one is compared against
+run "express"        nodejs/express/example/server.js 5456 express --save "$BODIES"
+run "fastify"        nodejs/fastify/example/server.js 5457 express --compare "$BODIES"
+run "nestjs/express" nodejs/nestjs/example/server.js  5458 express --compare "$BODIES"
+run "nestjs/fastify" nodejs/nestjs/example/server.js  5459 fastify --compare "$BODIES"
+
+echo
+echo "every framework agrees, byte for byte"
diff --git a/integrations/nodejs/scripts/pack-and-install.sh b/integrations/nodejs/scripts/pack-and-install.sh
new file mode 100755
index 00000000..c1192192
--- /dev/null
+++ b/integrations/nodejs/scripts/pack-and-install.sh
@@ -0,0 +1,62 @@
+#!/usr/bin/env bash
+# Publish shape, without a registry. Packs every package, installs the tarballs into a clean
+# directory next to a copy of an example, and runs the contract suite there. This is what catches
+# a missing `files` entry, a runtime dependency declared as a dev one, or shell.js left out of the
+# tarball, before a publish does.
+#
+#   bash nodejs/scripts/pack-and-install.sh [--port 5460]
+set -euo pipefail
+
+ROOT="$(cd "$(dirname "$0")/../.." && pwd)"
+PORT=5460
+while [ $# -gt 0 ]; do
+  case "$1" in
+    --port) PORT="$2"; shift 2 ;;
+    *) echo "unknown argument: $1" >&2; exit 2 ;;
+  esac
+done
+
+TMP="$(mktemp -d)"
+trap 'rm -rf "$TMP"' EXIT
+
+echo "== pack"
+mkdir -p "$TMP/tarballs"
+for pkg in core express fastify nestjs; do
+  ( cd "$ROOT/nodejs/$pkg" && npm pack --silent --pack-destination "$TMP/tarballs" >/dev/null )
+done
+ls "$TMP/tarballs" | sed 's/^/  /'
+
+echo "== the core ships the shell, or nothing can boot"
+tar -tzf "$TMP"/tarballs/*api-docs-core*.tgz | grep -q 'package/shell/shell.js' || { echo "  shell.js is NOT in the core tarball" >&2; exit 1; }
+tar -tzf "$TMP"/tarballs/*api-docs-core*.tgz | grep -q 'package/shell/shell.html' || { echo "  shell.html is NOT in the core tarball" >&2; exit 1; }
+echo "  both present"
+
+echo "== install the tarballs into a clean directory"
+APP="$TMP/app"
+mkdir -p "$APP"
+cat >"$APP/package.json" <<JSON
+{
+  "name": "pack-check",
+  "private": true,
+  "version": "0.0.0"
+}
+JSON
+# the frameworks come from the registry on purpose: a runtime dependency we forgot to declare
+# fails here and nowhere else, because the workspace would have hoisted it
+( cd "$APP" && npm install --silent --no-audit --no-fund \
+    "$TMP"/tarballs/*api-docs-core*.tgz \
+    "$TMP"/tarballs/*api-docs-express*.tgz \
+    express helmet >/dev/null )
+echo "  installed from tarballs, with express and helmet from the registry"
+
+echo "== the installed core carries its shell"
+test -f "$APP/node_modules/@usebruno/api-docs-core/shell/shell.js" || { echo "  shell.js missing after install" >&2; exit 1; }
+echo "  node_modules/@usebruno/api-docs-core/shell/shell.js"
+
+echo "== run the example against the installed packages"
+mkdir -p "$APP/example"
+cp "$ROOT/nodejs/express/example/server.js" "$APP/example/server.js"
+cp -R "$ROOT/contract-tests/fixtures" "$APP/fixtures"
+
+COLLECTION="../fixtures/api-collection" BUNDLED="../fixtures/bundled.yml" \
+  bash "$ROOT/contract-tests/check.sh" --example "$APP/example/server.js" --port "$PORT"
diff --git a/integrations/package.json b/integrations/package.json
index 7f14969e..ca154ddf 100644
--- a/integrations/package.json
+++ b/integrations/package.json
@@ -13,21 +13,26 @@
     "build:fastify": "tsc -p nodejs/fastify/tsconfig.json",
     "build:nestjs": "tsc -p nodejs/nestjs/tsconfig.json",
     "build:shell": "esbuild shell/shell.src.mjs --bundle --minify --format=iife --platform=browser --target=es2020 --outfile=shell/shell.js --log-level=warning && mkdir -p nodejs/core/shell && cp shell/shell.html shell/shell.js nodejs/core/shell/",
+    "check:all": "npm run build && bash nodejs/scripts/check-all.sh",
     "check:express": "npm run build && bash contract-tests/check.sh --example nodejs/express/example/server.js --port 5456",
     "check:fastify": "npm run build && bash contract-tests/check.sh --example nodejs/fastify/example/server.js --port 5457",
     "check:nestjs": "npm run build && bash contract-tests/check.sh --example nodejs/nestjs/example/server.js --port 5458",
     "check:nestjs-fastify": "npm run build && ADAPTER=fastify bash contract-tests/check.sh --example nodejs/nestjs/example/server.js --port 5459",
     "lint": "eslint",
     "lint:fix": "eslint --fix",
+    "pack-check": "npm run build && bash nodejs/scripts/pack-and-install.sh",
     "start:express": "node nodejs/express/example/server.js",
     "start:fastify": "node nodejs/fastify/example/server.js",
+    "start:nestjs": "node nodejs/nestjs/example/server.js",
     "test:assemble": "node shell/test/assemble.test.mjs",
     "test:collection": "npm run build:core && node nodejs/core/test/collection.test.mjs",
     "test:docs": "npm run build && node nodejs/core/test/docs.test.mjs",
     "test:filter": "npm run build:core && node nodejs/core/test/filter.test.mjs",
     "test:nestjs": "npm run build && node nodejs/nestjs/test/sub-path.test.mjs",
     "test:shell": "npm run build && node nodejs/core/test/shell.test.mjs",
-    "test:walk": "npm run build:core && node nodejs/core/test/walk.test.mjs"
+    "test:unit": "npm run build && node nodejs/core/test/walk.test.mjs && node nodejs/core/test/filter.test.mjs && node nodejs/core/test/collection.test.mjs && node nodejs/core/test/shell.test.mjs && node nodejs/core/test/docs.test.mjs && node nodejs/nestjs/test/sub-path.test.mjs && node shell/test/assemble.test.mjs",
+    "test:walk": "npm run build:core && node nodejs/core/test/walk.test.mjs",
+    "verify": "npm run lint && npm run test:unit && bash nodejs/scripts/check-all.sh && bash nodejs/scripts/pack-and-install.sh"
   },
   "devDependencies": {
     "@eslint/js": "^9.39.5",

From 0375c6c24a82fef40230bcec343d02650349d069 Mon Sep 17 00:00:00 2001
From: Arpit Bruno <arpit@usebruno.com>
Date: Thu, 17 Sep 2026 15:51:25 +0530
Subject: [PATCH 11/21] browser specs, the CSP directives the renderer's wasm
 needs

---
 .../contract-tests/browser/docs.spec.mjs      | 78 +++++++++++++++++++
 .../browser/playwright.config.mjs             | 31 ++++++++
 integrations/contract-tests/check.sh          | 14 +++-
 integrations/nodejs/express/example/server.js | 20 ++++-
 integrations/nodejs/fastify/example/server.js |  5 +-
 integrations/nodejs/nestjs/example/server.js  |  6 +-
 integrations/package-lock.json                | 64 +++++++++++++++
 integrations/package.json                     |  4 +-
 integrations/test-results/.last-run.json      |  4 +
 9 files changed, 218 insertions(+), 8 deletions(-)
 create mode 100644 integrations/contract-tests/browser/docs.spec.mjs
 create mode 100644 integrations/contract-tests/browser/playwright.config.mjs
 create mode 100644 integrations/test-results/.last-run.json

diff --git a/integrations/contract-tests/browser/docs.spec.mjs b/integrations/contract-tests/browser/docs.spec.mjs
new file mode 100644
index 00000000..f2bbdd29
--- /dev/null
+++ b/integrations/contract-tests/browser/docs.spec.mjs
@@ -0,0 +1,78 @@
+import { test, expect } from '@playwright/test';
+
+// What a reader actually gets. check.sh proves the bytes; this proves the page built from them.
+
+const consoleErrorsOn = (page) => {
+  const errors = [];
+  page.on('console', (m) => {
+    if (m.type() === 'error') {
+      errors.push(m.text());
+    }
+  });
+  page.on('pageerror', (e) => errors.push(String(e)));
+
+  return errors;
+};
+
+test('the docs render, and nothing in the console complains', async ({ page }) => {
+  const errors = consoleErrorsOn(page);
+  await page.goto('/docs/', { waitUntil: 'networkidle' });
+
+  await expect(page).toHaveTitle('Acme API');
+  await expect(page.getByText('Catalog', { exact: true }).first()).toBeVisible();
+  await expect(page.locator('#bruno-docs-error')).toBeHidden();
+  expect(errors, 'the adopter CSP we document must not break the renderer').toEqual([]);
+});
+
+test('the renderer booted, from the CDN, with our shell from our own origin', async ({ page }) => {
+  const sources = [];
+  page.on('request', (r) => sources.push(r.url()));
+  await page.goto('/docs/', { waitUntil: 'networkidle' });
+
+  expect(sources.some((u) => u.endsWith('/docs/shell.js')), 'shell.js is same-origin').toBe(true);
+  expect(sources.some((u) => u.startsWith('https://cdn.usebruno.com/')), 'the renderer is the CDN bundle').toBe(true);
+  expect(await page.evaluate(() => typeof window.OpenCollection)).toBe('function');
+});
+
+test('the filters hold all the way to the page', async ({ page }) => {
+  await page.goto('/docs/', { waitUntil: 'networkidle' });
+  const text = await page.evaluate(() => document.body.innerText);
+
+  await expect(page.getByText('Mixed', { exact: true }).first()).toBeVisible();
+  expect(text, 'a folder whose only request was tagged is pruned').not.toContain('Internal');
+
+  for (const hidden of ['Reindex catalog', 'Purge cache', 'Drain node']) {
+    expect(text, `${hidden} is tagged internal and must not reach a reader`).not.toContain(hidden);
+  }
+
+  expect(text, 'only the published environment is offered').toContain('Local');
+  expect(text, 'an unpublished environment is not named').not.toContain('Prod');
+  expect(text, 'and its values never left the server').not.toContain('prod-token-must-never-be-served');
+});
+
+test('a deep link renders on its own, after a reload', async ({ page }) => {
+  const errors = consoleErrorsOn(page);
+  await page.goto('/docs/catalog/list-products/', { waitUntil: 'networkidle' });
+  await expect(page.getByText('Catalog', { exact: true }).first()).toBeVisible();
+
+  await page.reload({ waitUntil: 'networkidle' });
+  await expect(page.getByText('Catalog', { exact: true }).first()).toBeVisible();
+  expect(errors).toEqual([]);
+});
+
+test('a bundled single file renders the same way', async ({ page }) => {
+  await page.goto('/bundled/docs/', { waitUntil: 'networkidle' });
+  await expect(page).toHaveTitle('API Documentation');
+  await expect(page.getByText('Catalog', { exact: true }).first()).toBeVisible();
+});
+
+test('a broken mount explains itself in the page, and the app is still up', async ({ page, request }) => {
+  const response = await page.goto('/broken/docs/', { waitUntil: 'networkidle' });
+
+  // every route of a failed mount serves the reason directly, so there is no shell to fail inside
+  expect(response.status()).toBe(404);
+  await expect(page.getByText('Collection not found')).toBeVisible();
+  expect(await page.locator('#bruno-docs').count(), 'no half-built page is served').toBe(0);
+
+  expect((await request.get('/control')).status(), 'the host app is unaffected').toBe(200);
+});
diff --git a/integrations/contract-tests/browser/playwright.config.mjs b/integrations/contract-tests/browser/playwright.config.mjs
new file mode 100644
index 00000000..9e4c0397
--- /dev/null
+++ b/integrations/contract-tests/browser/playwright.config.mjs
@@ -0,0 +1,31 @@
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { defineConfig } from '@playwright/test';
+
+const ROOT = path.join(path.dirname(fileURLToPath(import.meta.url)), '..', '..');
+
+// EXAMPLE and PORT are how another language core points this at its own server. The spec itself
+// asserts only what the contract promises, so it does not care which one booted.
+const EXAMPLE = process.env.EXAMPLE || 'nodejs/express/example/server.js';
+const PORT = process.env.PORT || '5462';
+
+export default defineConfig({
+  testDir: '.',
+  timeout: 60_000,
+  fullyParallel: false,
+  reporter: [['list']],
+  use: {
+    baseURL: `http://localhost:${PORT}`,
+    // the renderer comes from the CDN, and there is no `cdn` option to point elsewhere, so this
+    // layer needs the network. That is the trade for not shipping a self-hosted bundle yet.
+    trace: 'retain-on-failure'
+  },
+  webServer: {
+    command: `node ${EXAMPLE}`,
+    cwd: ROOT,
+    env: { ...process.env, PORT },
+    port: Number(PORT),
+    reuseExistingServer: false,
+    timeout: 30_000
+  }
+});
diff --git a/integrations/contract-tests/check.sh b/integrations/contract-tests/check.sh
index 91de5ca7..7605f8ba 100755
--- a/integrations/contract-tests/check.sh
+++ b/integrations/contract-tests/check.sh
@@ -70,6 +70,7 @@ paths_in() { node -e 'const d=JSON.parse(require("fs").readFileSync(process.argv
 paths_are() { [ "$(paths_in "$1")" = "$2" ]; }
 none_mention() { ! grep -q "$1" "${@:2}"; }
 no_origins() { ! grep -oE 'https?://[A-Za-z0-9./_-]+' "$1" | grep -q .; }
+occurs_once() { [ "$(curl -s "$1" | grep -c "$2")" = "1" ]; }
 config_of() { curl -s "$1" | grep -o 'data-config="[^"]*"'; }
 config_lacks() { ! config_of "$1" | grep -Eq "&quot;($2)&quot;:"; }
 
@@ -164,6 +165,15 @@ check "/broken/docs/ -> 404, not a crash"       status_is 404 "$BASE/broken/docs
 check "/broken/docs/ says what is wrong"        body_has "$BASE/broken/docs/" 'Collection not found'
 check "/broken/docs/collection.yml -> 404 too"  status_is 404 "$BASE/broken/docs/collection.yml"
 
+if [ "$(curl -s -o /dev/null -w '%{http_code}' "$BASE/portal")" = "200" ]; then
+  echo "== embed(): the docs block inside the host's own page"
+  check "the host's own page is what is served"  body_has "$BASE/portal" 'Acme Developer Portal'
+  check "the block is in it"                     body_has "$BASE/portal" 'id="bruno-docs"'
+  check "pointing at the mount it belongs to"    body_has "$BASE/portal" 'src="/portal/docs/shell.js"'
+  check "one html document, not two"             occurs_once "$BASE/portal" '<html'
+  check "and the host page keeps its own title"  occurs_once "$BASE/portal" '<title'
+fi
+
 echo "== the host app is left alone"
 check "its own 404 still comes from it"         status_is 404 -X POST "$BASE/control"
 
@@ -175,7 +185,9 @@ if [ "$(curl -s -o /dev/null -w '%{http_code}' "$BASE/openapi.json")" = "200" ];
 fi
 
 echo "== the adopter's CSP holds"
-check "helmet's CSP header is intact"           header_has Content-Security-Policy "script-src 'self' https://cdn.usebruno.com" "$BASE/docs/"
+check "the CSP allows the renderer's origin"    header_has Content-Security-Policy "script-src 'self' https://cdn.usebruno.com" "$BASE/docs/"
+check "and the data: uri its wasm comes from"  header_has Content-Security-Policy "connect-src 'self' data:" "$BASE/docs/"
+check "and instantiating that wasm"            header_has Content-Security-Policy "wasm-unsafe-eval" "$BASE/docs/"
 
 # ---- bodies, for comparing one framework against another -------------------
 
diff --git a/integrations/nodejs/express/example/server.js b/integrations/nodejs/express/example/server.js
index 4be0b359..e397ddab 100644
--- a/integrations/nodejs/express/example/server.js
+++ b/integrations/nodejs/express/example/server.js
@@ -4,6 +4,7 @@ const path = require('node:path');
 const express = require('express');
 const helmet = require('helmet');
 const { apiDocs } = require('@usebruno/api-docs-express');
+const { createDocs } = require('@usebruno/api-docs-core');
 
 const PORT = Number(process.env.PORT || 5456);
 // relative on purpose: the core resolves it against this file, not the cwd, and check.sh
@@ -20,10 +21,12 @@ app.use(
   helmet({
     contentSecurityPolicy: {
       directives: {
-        scriptSrc: ["'self'", 'https://cdn.usebruno.com'],
+        // wasm-unsafe-eval, narrowly, because the renderer instantiates a wasm sandbox
+        scriptSrc: ["'self'", 'https://cdn.usebruno.com', "'wasm-unsafe-eval'"],
         styleSrc: ["'self'", "'unsafe-inline'", 'https://cdn.usebruno.com', 'https://fonts.googleapis.com'],
         fontSrc: ["'self'", 'https://fonts.gstatic.com'],
-        connectSrc: ["'self'"]
+        // data: because the renderer fetches its wasm sandbox from a data URI
+        connectSrc: ["'self'", 'data:']
       }
     }
   })
@@ -47,6 +50,19 @@ app.use('/bundled/docs', apiDocs({ collection: BUNDLED }));
 
 app.use('/broken/docs', apiDocs({ collection: './there-is-no-collection-here' }));
 
+// an adopter who wants the docs inside their own page asks the core for the block and puts it
+// where they like. The mount still has to exist: the block loads shell.js and collection.yml from it.
+const embedded = createDocs({ collection: COLLECTION, environments: { include: ['Local'] } });
+app.use('/portal/docs', apiDocs({ collection: COLLECTION, environments: { include: ['Local'] } }));
+app.get('/portal', (req, res) => {
+  res.type('html').send(`<!doctype html>
+<html lang="en"><head><meta charset="utf-8"><title>Acme Developer Portal</title></head>
+<body>
+  <h1>Acme Developer Portal</h1>
+  ${embedded.embed({ base: '/portal/docs' })}
+</body></html>`);
+});
+
 app.listen(PORT, () => {
   console.log(`express example on http://localhost:${PORT}`);
   console.log('  /docs/           Local only, internal-tagged requests hidden');
diff --git a/integrations/nodejs/fastify/example/server.js b/integrations/nodejs/fastify/example/server.js
index eb44a214..3ce6f632 100644
--- a/integrations/nodejs/fastify/example/server.js
+++ b/integrations/nodejs/fastify/example/server.js
@@ -17,10 +17,11 @@ app.addHook('onSend', async (request, reply) => {
   reply.header(
     'content-security-policy',
     "default-src 'self'; "
-    + "script-src 'self' https://cdn.usebruno.com; "
+    + "script-src 'self' https://cdn.usebruno.com 'wasm-unsafe-eval'; "
     + "style-src 'self' 'unsafe-inline' https://cdn.usebruno.com https://fonts.googleapis.com; "
     + "font-src 'self' https://fonts.gstatic.com; "
-    + "connect-src 'self'"
+    // data: because the renderer fetches its wasm sandbox from a data URI
+    + "connect-src 'self' data:"
   );
 });
 
diff --git a/integrations/nodejs/nestjs/example/server.js b/integrations/nodejs/nestjs/example/server.js
index 63e8d09b..eba9d321 100644
--- a/integrations/nodejs/nestjs/example/server.js
+++ b/integrations/nodejs/nestjs/example/server.js
@@ -70,10 +70,12 @@ async function main() {
   app.use(helmet({
     contentSecurityPolicy: {
       directives: {
-        scriptSrc: ["'self'", 'https://cdn.usebruno.com'],
+        // wasm-unsafe-eval, narrowly, because the renderer instantiates a wasm sandbox
+        scriptSrc: ["'self'", 'https://cdn.usebruno.com', "'wasm-unsafe-eval'"],
         styleSrc: ["'self'", "'unsafe-inline'", 'https://cdn.usebruno.com', 'https://fonts.googleapis.com'],
         fontSrc: ["'self'", 'https://fonts.gstatic.com'],
-        connectSrc: ["'self'"]
+        // data: because the renderer fetches its wasm sandbox from a data URI
+        connectSrc: ["'self'", 'data:']
       }
     }
   }));
diff --git a/integrations/package-lock.json b/integrations/package-lock.json
index 084d701b..93ac6f94 100644
--- a/integrations/package-lock.json
+++ b/integrations/package-lock.json
@@ -16,6 +16,7 @@
         "@nestjs/core": "^11.2.5",
         "@nestjs/platform-express": "^11.2.5",
         "@nestjs/platform-fastify": "^11.2.5",
+        "@playwright/test": "^1.61.1",
         "@stylistic/eslint-plugin": "^5.3.1",
         "@types/express": "^5.0.0",
         "@types/js-yaml": "^4.0.9",
@@ -1220,6 +1221,22 @@
       "integrity": "sha512-k2ENnmBugE/rzQfEcdWHcCY+/FM3VLzH9cYEsbdsoqrvzAKRhUZeRNhAZvB8OitQJ1TBed3yqWtdjzS6wJKBwg==",
       "license": "MIT"
     },
+    "node_modules/@playwright/test": {
+      "version": "1.61.1",
+      "resolved": "https://registry.npmjs.org/@playwright/test/-/test-1.61.1.tgz",
+      "integrity": "sha512-8nKv6+0RJSL9FE4jYOEGXnPeM/Hg12qZpmqzZjRh3qM0Y7c3z1mrOTfFLids72RDQYVh9WpLEfR5WdpNX4fkig==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "playwright": "1.61.1"
+      },
+      "bin": {
+        "playwright": "cli.js"
+      },
+      "engines": {
+        "node": ">=18"
+      }
+    },
     "node_modules/@stylistic/eslint-plugin": {
       "version": "5.10.0",
       "resolved": "https://registry.npmjs.org/@stylistic/eslint-plugin/-/eslint-plugin-5.10.0.tgz",
@@ -2791,6 +2808,21 @@
         "node": ">= 0.8"
       }
     },
+    "node_modules/fsevents": {
+      "version": "2.3.2",
+      "resolved": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.2.tgz",
+      "integrity": "sha512-xiqMQR4xAeHTuB9uWm+fFRcIOgKBMiOBP+eXiyT7jsgVCq1bkVygt00oASowB7EdtpOHaaPgKt812P9ab+DDKA==",
+      "dev": true,
+      "hasInstallScript": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": "^8.16.0 || ^10.6.0 || >=11.0.0"
+      }
+    },
     "node_modules/function-bind": {
       "version": "1.1.2",
       "resolved": "https://registry.npmjs.org/function-bind/-/function-bind-1.1.2.tgz",
@@ -3683,6 +3715,38 @@
       "integrity": "sha512-BndPH67/JxGExRgiX1dX0w1FvZck5Wa4aal9198SrRhZjH3GxKQUKIBnYJTdj2HDN3UQAS06HlfcSbQj2OHmaw==",
       "license": "MIT"
     },
+    "node_modules/playwright": {
+      "version": "1.61.1",
+      "resolved": "https://registry.npmjs.org/playwright/-/playwright-1.61.1.tgz",
+      "integrity": "sha512-DWnY5o3YbLWK4GovuAVwpqL+1VwGNdUGrRr++8j8PtQQzvAVZUIMjKQ90fY689sEJZJBbZVw1rXaOKSTitkzPQ==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "playwright-core": "1.61.1"
+      },
+      "bin": {
+        "playwright": "cli.js"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "optionalDependencies": {
+        "fsevents": "2.3.2"
+      }
+    },
+    "node_modules/playwright-core": {
+      "version": "1.61.1",
+      "resolved": "https://registry.npmjs.org/playwright-core/-/playwright-core-1.61.1.tgz",
+      "integrity": "sha512-h7Qlt6m4REp25qvIdvbDtVmD4LqVXfpRxhORv9L0jzETM05p4fuPJ3dKyuSXQxDSbXnmS79HAgi9589lGSpLkg==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "bin": {
+        "playwright-core": "cli.js"
+      },
+      "engines": {
+        "node": ">=18"
+      }
+    },
     "node_modules/prelude-ls": {
       "version": "1.2.1",
       "resolved": "https://registry.npmjs.org/prelude-ls/-/prelude-ls-1.2.1.tgz",
diff --git a/integrations/package.json b/integrations/package.json
index ca154ddf..48c7f721 100644
--- a/integrations/package.json
+++ b/integrations/package.json
@@ -25,6 +25,7 @@
     "start:fastify": "node nodejs/fastify/example/server.js",
     "start:nestjs": "node nodejs/nestjs/example/server.js",
     "test:assemble": "node shell/test/assemble.test.mjs",
+    "test:browser": "npm run build && playwright test --config contract-tests/browser/playwright.config.mjs",
     "test:collection": "npm run build:core && node nodejs/core/test/collection.test.mjs",
     "test:docs": "npm run build && node nodejs/core/test/docs.test.mjs",
     "test:filter": "npm run build:core && node nodejs/core/test/filter.test.mjs",
@@ -32,7 +33,7 @@
     "test:shell": "npm run build && node nodejs/core/test/shell.test.mjs",
     "test:unit": "npm run build && node nodejs/core/test/walk.test.mjs && node nodejs/core/test/filter.test.mjs && node nodejs/core/test/collection.test.mjs && node nodejs/core/test/shell.test.mjs && node nodejs/core/test/docs.test.mjs && node nodejs/nestjs/test/sub-path.test.mjs && node shell/test/assemble.test.mjs",
     "test:walk": "npm run build:core && node nodejs/core/test/walk.test.mjs",
-    "verify": "npm run lint && npm run test:unit && bash nodejs/scripts/check-all.sh && bash nodejs/scripts/pack-and-install.sh"
+    "verify": "npm run lint && npm run test:unit && bash nodejs/scripts/check-all.sh && bash nodejs/scripts/pack-and-install.sh && npm run test:browser"
   },
   "devDependencies": {
     "@eslint/js": "^9.39.5",
@@ -41,6 +42,7 @@
     "@nestjs/core": "^11.2.5",
     "@nestjs/platform-express": "^11.2.5",
     "@nestjs/platform-fastify": "^11.2.5",
+    "@playwright/test": "^1.61.1",
     "@stylistic/eslint-plugin": "^5.3.1",
     "@types/express": "^5.0.0",
     "@types/js-yaml": "^4.0.9",
diff --git a/integrations/test-results/.last-run.json b/integrations/test-results/.last-run.json
new file mode 100644
index 00000000..cbcc1fba
--- /dev/null
+++ b/integrations/test-results/.last-run.json
@@ -0,0 +1,4 @@
+{
+  "status": "passed",
+  "failedTests": []
+}
\ No newline at end of file

From 88d926bbbbee42737bd772e3a2fd9a30232c79c4 Mon Sep 17 00:00:00 2001
From: Arpit Bruno <arpit@usebruno.com>
Date: Thu, 17 Sep 2026 22:48:14 +0530
Subject: [PATCH 12/21] path-gated ci jobs, a framework matrix with docker mode
 and nest 12 support

---
 .github/workflows/ci.yml                      |  60 ++-
 .github/workflows/integrations-matrix.yml     |  53 +++
 integrations/.dockerignore                    |   7 +
 integrations/contract-tests/check.sh          |   4 +-
 integrations/nodejs/nestjs/package.json       |   4 +-
 integrations/nodejs/scripts/matrix.Dockerfile |  23 +
 integrations/nodejs/scripts/matrix.sh         | 152 ++++++
 .../nodejs/scripts/pack-and-install.sh        |  62 ---
 integrations/package-lock.json                | 447 +++++++-----------
 integrations/package.json                     |  19 +-
 integrations/scripts/setup.sh                 |  37 ++
 11 files changed, 522 insertions(+), 346 deletions(-)
 create mode 100644 .github/workflows/integrations-matrix.yml
 create mode 100644 integrations/.dockerignore
 create mode 100644 integrations/nodejs/scripts/matrix.Dockerfile
 create mode 100755 integrations/nodejs/scripts/matrix.sh
 delete mode 100755 integrations/nodejs/scripts/pack-and-install.sh
 create mode 100755 integrations/scripts/setup.sh

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 08b834df..a3e106b5 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -9,12 +9,18 @@ on:
 
 
 
+permissions:
+  contents: read
+  pull-requests: read
+
 concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
-  cancel-in-progress: true
+  cancel-in-progress: ${{ github.event_name == 'pull_request' }}
 
 jobs:
   lint_unit_tests_and_builds:
+    needs: changes
+    if: needs.changes.outputs.renderer == 'true'
     runs-on: ubuntu-latest
     steps:
       # eslint-plugin-diff needs the base branch present to diff against.
@@ -43,8 +49,8 @@ jobs:
         run: npm run build:standalone -w packages/bruno-api-docs
 
   e2e:
-    needs: lint_unit_tests_and_builds
-    if: github.event_name == 'push' || github.event.pull_request.draft == false
+    needs: [changes, lint_unit_tests_and_builds]
+    if: needs.changes.outputs.renderer == 'true' && (github.event_name == 'push' || github.event.pull_request.draft == false)
     runs-on: ubuntu-latest
     defaults:
       run:
@@ -70,3 +76,51 @@ jobs:
           name: playwright-report
           path: packages/bruno-api-docs/playwright-report/
           retention-days: 30
+
+  changes:
+    runs-on: ubuntu-latest
+    outputs:
+      renderer: ${{ steps.filter.outputs.renderer }}
+      integrations: ${{ steps.filter.outputs.integrations }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dorny/paths-filter@0e4a8c6effa4802afeda77dc8d303f8176d7dfad # v3
+        id: filter
+        with:
+          filters: |
+            renderer:
+              - '!integrations/**'
+            integrations:
+              - 'integrations/**'
+              - '.github/workflows/ci.yml'
+              - '.github/workflows/integrations-matrix.yml'
+
+  integrations:
+    needs: changes
+    # a job-level if, not a workflow paths filter: a skipped job still reports and satisfies the required check
+    if: needs.changes.outputs.integrations == 'true'
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: integrations
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: jdx/mise-action@v2
+        with:
+          working_directory: integrations
+
+      - uses: actions/cache@v4
+        with:
+          path: ~/.npm
+          key: npm-integrations-${{ hashFiles('integrations/package-lock.json') }}
+          restore-keys: npm-integrations-
+
+      - run: npm ci
+
+      - run: npm run test:ci
+
+      # depends on the live CDN bundle, which this repo does not control, so it cannot block a merge
+      - name: browser contract, against the CDN
+        continue-on-error: true
+        run: npx playwright install --with-deps chromium && npm run test:browser
diff --git a/.github/workflows/integrations-matrix.yml b/.github/workflows/integrations-matrix.yml
new file mode 100644
index 00000000..aa5b3ea5
--- /dev/null
+++ b/.github/workflows/integrations-matrix.yml
@@ -0,0 +1,53 @@
+name: Integrations matrix
+
+on:
+  workflow_dispatch:
+  schedule:
+    - cron: '0 6 * * 1'
+  pull_request:
+    branches: [main, 'release/**']
+    types: [labeled, synchronize]
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: ${{ github.event_name == 'pull_request' }}
+
+jobs:
+  cells:
+    if: github.event_name != 'pull_request' || contains(github.event.pull_request.labels.*.name, 'run-integrations-matrix-tests')
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        node: [22, 24]
+        family: [express, fastify, nestjs]
+    name: node ${{ matrix.node }} / ${{ matrix.family }}
+    defaults:
+      run:
+        working-directory: integrations
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node }}
+
+      - run: npm ci
+
+      - run: bash nodejs/scripts/matrix.sh --family ${{ matrix.family }}
+
+  node-20:
+    if: github.event_name != 'pull_request' || contains(github.event.pull_request.labels.*.name, 'run-integrations-matrix-tests')
+    runs-on: ubuntu-latest
+    continue-on-error: true
+    name: node 20 (end of life, courtesy)
+    defaults:
+      run:
+        working-directory: integrations
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+      - run: npm ci
+      - run: bash nodejs/scripts/matrix.sh
diff --git a/integrations/.dockerignore b/integrations/.dockerignore
new file mode 100644
index 00000000..12006333
--- /dev/null
+++ b/integrations/.dockerignore
@@ -0,0 +1,7 @@
+# the container installs its own: esbuild and playwright ship native binaries built for this host
+node_modules
+nodejs/*/node_modules
+nodejs/*/dist
+shell/shell.js
+nodejs/*/shell
+test-results
diff --git a/integrations/contract-tests/check.sh b/integrations/contract-tests/check.sh
index 7605f8ba..0265fcee 100755
--- a/integrations/contract-tests/check.sh
+++ b/integrations/contract-tests/check.sh
@@ -60,8 +60,8 @@ status_is() { [ "$(curl -s -o /dev/null -w '%{http_code}' "${@:2}")" = "$1" ]; }
 header_of() { curl -s -D - -o /dev/null "${@:2}" | tr -d '\r' | awk -v k="$1" 'tolower($1)==tolower(k":"){sub(/^[^:]*: */,"");print}'; }
 header_has() { local name=$1 want=$2; shift 2; header_of "$name" "$@" | grep -q "$want"; }
 header_absent() { local name=$1; shift; [ -z "$(header_of "$name" "$@")" ]; }
-body_has() { curl -s "$1" | grep -q "$2"; }
-body_lacks() { ! curl -s "$1" | grep -Eq "$2"; }
+body_has() { grep -q "$2" <<<"$(curl -s "$1")"; }
+body_lacks() { ! grep -Eq "$2" <<<"$(curl -s "$1")"; }
 file_has() { grep -q "$2" "$1"; }
 file_lacks() { ! grep -q "$2" "$1"; }
 revalidates() { status_is 304 -H "If-None-Match: $(header_of ETag "$1")" "$1"; }
diff --git a/integrations/nodejs/nestjs/package.json b/integrations/nodejs/nestjs/package.json
index cc99619a..2d9a0a0f 100644
--- a/integrations/nodejs/nestjs/package.json
+++ b/integrations/nodejs/nestjs/package.json
@@ -13,8 +13,8 @@
     "node": ">=20"
   },
   "peerDependencies": {
-    "@nestjs/common": "^10.0.0 || ^11.0.0",
-    "@nestjs/core": "^10.0.0 || ^11.0.0"
+    "@nestjs/common": "^10.0.0 || ^11.0.0 || ^12.0.0",
+    "@nestjs/core": "^10.0.0 || ^11.0.0 || ^12.0.0"
   },
   "dependencies": {
     "@usebruno/api-docs-core": "0.1.0-beta.1"
diff --git a/integrations/nodejs/scripts/matrix.Dockerfile b/integrations/nodejs/scripts/matrix.Dockerfile
new file mode 100644
index 00000000..45c0592c
--- /dev/null
+++ b/integrations/nodejs/scripts/matrix.Dockerfile
@@ -0,0 +1,23 @@
+# The matrix under a Node this machine does not have. Built and run by `matrix.sh --docker`.
+ARG NODE=22
+# slim: nothing we install compiles native code, esbuild ships a prebuilt binary
+FROM node:${NODE}-slim
+WORKDIR /integrations
+
+# what check.sh needs that slim leaves out: curl for every assertion, procps for the pkill in its trap
+RUN apt-get update \
+  && apt-get install -y --no-install-recommends curl procps \
+  && rm -rf /var/lib/apt/lists/*
+
+# manifests first, so the install layer caches until a dependency actually changes
+COPY package.json package-lock.json ./
+COPY nodejs/core/package.json nodejs/core/
+COPY nodejs/express/package.json nodejs/express/
+COPY nodejs/fastify/package.json nodejs/fastify/
+COPY nodejs/nestjs/package.json nodejs/nestjs/
+RUN npm ci --no-audit --no-fund
+
+COPY . .
+RUN npm run build
+
+ENTRYPOINT ["bash", "nodejs/scripts/matrix.sh"]
diff --git a/integrations/nodejs/scripts/matrix.sh b/integrations/nodejs/scripts/matrix.sh
new file mode 100755
index 00000000..a6326f8a
--- /dev/null
+++ b/integrations/nodejs/scripts/matrix.sh
@@ -0,0 +1,152 @@
+#!/usr/bin/env bash
+# The framework matrix: every major we claim in peerDependencies, each installed from our tarballs
+# into its own clean tree next to a copy of its example, with the contract suite run against it.
+# This is the evidence for the peer ranges we publish.
+#
+#   bash nodejs/scripts/matrix.sh                      every cell, under the node that is running
+#   bash nodejs/scripts/matrix.sh --family fastify     that family's majors (CI runs one job per family)
+#   bash nodejs/scripts/matrix.sh --cell nestjs@10     one cell, to reproduce a failure
+#   bash nodejs/scripts/matrix.sh --docker             every cell under node 22 and 24, in containers
+#
+# A cell is family@major. The nestjs cells run both adapters, since the adapter is what broke.
+set -euo pipefail
+
+ROOT="$(cd "$(dirname "$0")/../.." && pwd)"
+FAMILY=""
+CELL=""
+DOCKER=""
+PASSTHROUGH=()
+while [ $# -gt 0 ]; do
+  case "$1" in
+    --family) FAMILY="$2"; PASSTHROUGH+=("$1" "$2"); shift 2 ;;
+    --cell) CELL="$2"; PASSTHROUGH+=("$1" "$2"); shift 2 ;;
+    --docker) DOCKER=1; shift ;;
+    *) echo "unknown argument: $1" >&2; exit 2 ;;
+  esac
+done
+
+# --docker is a wrapper, not a second implementation: each container runs this same script natively
+if [ -n "$DOCKER" ]; then
+  docker info >/dev/null 2>&1 || { echo "docker is installed but the daemon is not running" >&2; exit 2; }
+  for node in 22 24; do
+    echo
+    echo "############ node $node, in a container"
+    docker build --quiet --build-arg "NODE=$node" -f "$ROOT/nodejs/scripts/matrix.Dockerfile" \
+      -t "api-docs-matrix:node$node" "$ROOT" >/dev/null
+    docker run --rm "api-docs-matrix:node$node" ${PASSTHROUGH[@]+"${PASSTHROUGH[@]}"}
+  done
+  exit 0
+fi
+
+ALL_CELLS="express@4 express@5 fastify@4 fastify@5 nestjs@10 nestjs@11 nestjs@12"
+if [ -n "$CELL" ]; then
+  case " $ALL_CELLS " in *" $CELL "*) ;; *) echo "unknown cell '$CELL'. one of: $ALL_CELLS" >&2; exit 2 ;; esac
+  CELLS="$CELL"
+elif [ -n "$FAMILY" ]; then
+  # no case inside $(...): bash 3.2 reads the pattern's ')' as the end of the substitution
+  CELLS=""
+  for c in $ALL_CELLS; do
+    if [[ "$c" == "$FAMILY"@* ]]; then
+      CELLS="$CELLS $c"
+    fi
+  done
+  [ -n "$CELLS" ] || { echo "no cells for family '$FAMILY'" >&2; exit 2; }
+else
+  CELLS="$ALL_CELLS"
+fi
+
+TMP="$(mktemp -d)"
+trap 'rm -rf "$TMP"' EXIT
+
+# ---- pack once, every cell installs the same tarballs ---------------------------------
+
+TARBALLS="$TMP/tarballs"
+mkdir -p "$TARBALLS"
+for pkg in core express fastify nestjs; do
+  ( cd "$ROOT/nodejs/$pkg" && npm pack --silent --pack-destination "$TARBALLS" >/dev/null )
+done
+# listed once into a variable: `tar | grep -q` under pipefail fails when grep quits before tar
+# finishes writing, which GNU tar's archive order made happen on every run
+core_files="$(tar -tzf "$TARBALLS"/*api-docs-core*.tgz)"
+grep -q 'package/shell/shell.js' <<<"$core_files" || { echo "shell.js is NOT in the core tarball" >&2; exit 1; }
+grep -q 'package/shell/shell.html' <<<"$core_files" || { echo "shell.html is NOT in the core tarball" >&2; exit 1; }
+echo "packed $(ls "$TARBALLS" | wc -l | tr -d ' ') tarballs, the core ships its shell"
+
+# ---- what each cell installs, on top of our tarballs -----------------------------------
+
+deps_for() {
+  case "$1" in
+    express@4) echo "express@^4 helmet" ;;
+    express@5) echo "express@^5 helmet" ;;
+    fastify@4) echo "fastify@^4 @fastify/swagger@^8" ;;
+    fastify@5) echo "fastify@^5 @fastify/swagger@^9" ;;
+    nestjs@10) echo "@nestjs/common@^10 @nestjs/core@^10 @nestjs/platform-express@^10 @nestjs/platform-fastify@^10 reflect-metadata rxjs helmet" ;;
+    nestjs@11) echo "@nestjs/common@^11 @nestjs/core@^11 @nestjs/platform-express@^11 @nestjs/platform-fastify@^11 reflect-metadata rxjs helmet" ;;
+    nestjs@12) echo "@nestjs/common@^12 @nestjs/core@^12 @nestjs/platform-express@^12 @nestjs/platform-fastify@^12 reflect-metadata rxjs helmet" ;;
+    *) echo "unknown cell: $1" >&2; exit 2 ;;
+  esac
+}
+
+# ---- one cell -------------------------------------------------------------------------
+
+run_cell() {
+  local cell=$1 port=$2
+  local family="${cell%@*}"
+  local app="$TMP/$cell"
+
+  mkdir -p "$app/example"
+  printf '{ "name": "matrix-%s", "private": true, "version": "0.0.0" }\n' "${cell/@/-}" >"$app/package.json"
+  cp "$ROOT/nodejs/$family/example/server.js" "$app/example/server.js"
+  cp -R "$ROOT/contract-tests/fixtures" "$app/fixtures"
+
+  # shellcheck disable=SC2046
+  ( cd "$app" && npm install --silent --no-audit --no-fund \
+      "$TARBALLS"/*api-docs-core*.tgz "$TARBALLS"/*api-docs-"$family"*.tgz $(deps_for "$cell") >/dev/null )
+
+  local installed
+  case "$family" in
+    express) installed="express $(node -p "require('$app/node_modules/express/package.json').version")" ;;
+    fastify) installed="fastify $(node -p "require('$app/node_modules/fastify/package.json').version")" ;;
+    nestjs)  installed="@nestjs/core $(node -p "require('$app/node_modules/@nestjs/core/package.json').version")" ;;
+  esac
+  echo "   installed $installed"
+
+  # suite PORT [VAR=value ...]
+  suite() {
+    local port=$1
+    shift
+    env COLLECTION=../fixtures/api-collection BUNDLED=../fixtures/bundled.yml "$@" \
+      bash "$ROOT/contract-tests/check.sh" --example "$app/example/server.js" --port "$port" | tail -1
+  }
+  if [ "$family" = "nestjs" ]; then
+    echo "   platform-express"
+    suite "$port"
+    echo "   platform-fastify"
+    suite "$((port + 1))" ADAPTER=fastify
+  else
+    suite "$port"
+  fi
+}
+
+# ---- the run ----------------------------------------------------------------------------
+
+total=$(echo $CELLS | wc -w | tr -d ' ')
+n=0
+failed=""
+for cell in $CELLS; do
+  n=$((n + 1))
+  echo
+  echo "### [$n/$total] node $(node -v)  $cell"
+  if run_cell "$cell" $((5470 + n * 2)); then
+    :
+  else
+    failed="$failed $cell"
+  fi
+done
+
+echo
+if [ -n "$failed" ]; then
+  echo "FAILED:$failed"
+  exit 1
+fi
+echo "all $total cells green on node $(node -v)"
diff --git a/integrations/nodejs/scripts/pack-and-install.sh b/integrations/nodejs/scripts/pack-and-install.sh
deleted file mode 100755
index c1192192..00000000
--- a/integrations/nodejs/scripts/pack-and-install.sh
+++ /dev/null
@@ -1,62 +0,0 @@
-#!/usr/bin/env bash
-# Publish shape, without a registry. Packs every package, installs the tarballs into a clean
-# directory next to a copy of an example, and runs the contract suite there. This is what catches
-# a missing `files` entry, a runtime dependency declared as a dev one, or shell.js left out of the
-# tarball, before a publish does.
-#
-#   bash nodejs/scripts/pack-and-install.sh [--port 5460]
-set -euo pipefail
-
-ROOT="$(cd "$(dirname "$0")/../.." && pwd)"
-PORT=5460
-while [ $# -gt 0 ]; do
-  case "$1" in
-    --port) PORT="$2"; shift 2 ;;
-    *) echo "unknown argument: $1" >&2; exit 2 ;;
-  esac
-done
-
-TMP="$(mktemp -d)"
-trap 'rm -rf "$TMP"' EXIT
-
-echo "== pack"
-mkdir -p "$TMP/tarballs"
-for pkg in core express fastify nestjs; do
-  ( cd "$ROOT/nodejs/$pkg" && npm pack --silent --pack-destination "$TMP/tarballs" >/dev/null )
-done
-ls "$TMP/tarballs" | sed 's/^/  /'
-
-echo "== the core ships the shell, or nothing can boot"
-tar -tzf "$TMP"/tarballs/*api-docs-core*.tgz | grep -q 'package/shell/shell.js' || { echo "  shell.js is NOT in the core tarball" >&2; exit 1; }
-tar -tzf "$TMP"/tarballs/*api-docs-core*.tgz | grep -q 'package/shell/shell.html' || { echo "  shell.html is NOT in the core tarball" >&2; exit 1; }
-echo "  both present"
-
-echo "== install the tarballs into a clean directory"
-APP="$TMP/app"
-mkdir -p "$APP"
-cat >"$APP/package.json" <<JSON
-{
-  "name": "pack-check",
-  "private": true,
-  "version": "0.0.0"
-}
-JSON
-# the frameworks come from the registry on purpose: a runtime dependency we forgot to declare
-# fails here and nowhere else, because the workspace would have hoisted it
-( cd "$APP" && npm install --silent --no-audit --no-fund \
-    "$TMP"/tarballs/*api-docs-core*.tgz \
-    "$TMP"/tarballs/*api-docs-express*.tgz \
-    express helmet >/dev/null )
-echo "  installed from tarballs, with express and helmet from the registry"
-
-echo "== the installed core carries its shell"
-test -f "$APP/node_modules/@usebruno/api-docs-core/shell/shell.js" || { echo "  shell.js missing after install" >&2; exit 1; }
-echo "  node_modules/@usebruno/api-docs-core/shell/shell.js"
-
-echo "== run the example against the installed packages"
-mkdir -p "$APP/example"
-cp "$ROOT/nodejs/express/example/server.js" "$APP/example/server.js"
-cp -R "$ROOT/contract-tests/fixtures" "$APP/fixtures"
-
-COLLECTION="../fixtures/api-collection" BUNDLED="../fixtures/bundled.yml" \
-  bash "$ROOT/contract-tests/check.sh" --example "$APP/example/server.js" --port "$PORT"
diff --git a/integrations/package-lock.json b/integrations/package-lock.json
index 93ac6f94..c2f2068b 100644
--- a/integrations/package-lock.json
+++ b/integrations/package-lock.json
@@ -12,10 +12,10 @@
       "devDependencies": {
         "@eslint/js": "^9.39.5",
         "@fastify/swagger": "^9.8.1",
-        "@nestjs/common": "^11.2.5",
-        "@nestjs/core": "^11.2.5",
-        "@nestjs/platform-express": "^11.2.5",
-        "@nestjs/platform-fastify": "^11.2.5",
+        "@nestjs/common": "^12.0.3",
+        "@nestjs/core": "^12.0.3",
+        "@nestjs/platform-express": "^12.0.3",
+        "@nestjs/platform-fastify": "^12.0.3",
         "@playwright/test": "^1.61.1",
         "@stylistic/eslint-plugin": "^5.3.1",
         "@types/express": "^5.0.0",
@@ -23,7 +23,7 @@
         "@types/node": "^22.10.0",
         "@typescript-eslint/eslint-plugin": "^8.65.0",
         "@typescript-eslint/parser": "^8.39.0",
-        "esbuild": "^0.24.0",
+        "esbuild": "^0.28.2",
         "eslint": "^9.21.0",
         "express": "^5.0.0",
         "fastify": "^5.12.5",
@@ -45,9 +45,9 @@
       }
     },
     "node_modules/@esbuild/aix-ppc64": {
-      "version": "0.24.2",
-      "resolved": "https://registry.npmjs.org/@esbuild/aix-ppc64/-/aix-ppc64-0.24.2.tgz",
-      "integrity": "sha512-thpVCb/rhxE/BnMLQ7GReQLLN8q9qbHmI55F4489/ByVg2aQaQ6kbcLb6FHkocZzQhxc4gx0sCk0tJkKBFzDhA==",
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/aix-ppc64/-/aix-ppc64-0.28.2.tgz",
+      "integrity": "sha512-XExcO+dvLKvVtNTibSTBej1NCAbaGhWn9Ww1ZPx80qsahhPFe/8jgWP0IchNe0F3HwkU7n8ejhH8bjonqht8mQ==",
       "cpu": [
         "ppc64"
       ],
@@ -62,9 +62,9 @@
       }
     },
     "node_modules/@esbuild/android-arm": {
-      "version": "0.24.2",
-      "resolved": "https://registry.npmjs.org/@esbuild/android-arm/-/android-arm-0.24.2.tgz",
-      "integrity": "sha512-tmwl4hJkCfNHwFB3nBa8z1Uy3ypZpxqxfTQOcHX+xRByyYgunVbZ9MzUUfb0RxaHIMnbHagwAxuTL+tnNM+1/Q==",
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-arm/-/android-arm-0.28.2.tgz",
+      "integrity": "sha512-kXXoiPVVGQcnIYGOeaovwOURpniDBpSq4A03qkQ+BMQqtGG6HYap3xne9C1O1yo4TR3qxlCX5IqqmX6fFo2Lqg==",
       "cpu": [
         "arm"
       ],
@@ -79,9 +79,9 @@
       }
     },
     "node_modules/@esbuild/android-arm64": {
-      "version": "0.24.2",
-      "resolved": "https://registry.npmjs.org/@esbuild/android-arm64/-/android-arm64-0.24.2.tgz",
-      "integrity": "sha512-cNLgeqCqV8WxfcTIOeL4OAtSmL8JjcN6m09XIgro1Wi7cF4t/THaWEa7eL5CMoMBdjoHOTh/vwTO/o2TRXIyzg==",
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-arm64/-/android-arm64-0.28.2.tgz",
+      "integrity": "sha512-5YfKeeI8qWfBZIX+u2xZC3Zlb3Os/gLS2sbEKM+I4ZOcsWmHS2WLysCcQZDAFRslDUU5Oiq44gf6PYN1vGwG5A==",
       "cpu": [
         "arm64"
       ],
@@ -96,9 +96,9 @@
       }
     },
     "node_modules/@esbuild/android-x64": {
-      "version": "0.24.2",
-      "resolved": "https://registry.npmjs.org/@esbuild/android-x64/-/android-x64-0.24.2.tgz",
-      "integrity": "sha512-B6Q0YQDqMx9D7rvIcsXfmJfvUYLoP722bgfBlO5cGvNVb5V/+Y7nhBE3mHV9OpxBf4eAS2S68KZztiPaWq4XYw==",
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-x64/-/android-x64-0.28.2.tgz",
+      "integrity": "sha512-O387ite7SzUyCcy3JQX4P4bLtEA7bLLkx+esve5JHnyYfNTxcVpXZo9jhdB0lTKN44gztELTdU7nS8Nr16Fs1Q==",
       "cpu": [
         "x64"
       ],
@@ -113,9 +113,9 @@
       }
     },
     "node_modules/@esbuild/darwin-arm64": {
-      "version": "0.24.2",
-      "resolved": "https://registry.npmjs.org/@esbuild/darwin-arm64/-/darwin-arm64-0.24.2.tgz",
-      "integrity": "sha512-kj3AnYWc+CekmZnS5IPu9D+HWtUI49hbnyqk0FLEJDbzCIQt7hg7ucF1SQAilhtYpIujfaHr6O0UHlzzSPdOeA==",
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/darwin-arm64/-/darwin-arm64-0.28.2.tgz",
+      "integrity": "sha512-n4KqkOQrraxHJcgjM1RvwbigfQKIKJVpM7xp+KsxiyUSrRdIXnt73VhrPAx0fV44hgfmIVKjxMN9J1t5jySVkw==",
       "cpu": [
         "arm64"
       ],
@@ -130,9 +130,9 @@
       }
     },
     "node_modules/@esbuild/darwin-x64": {
-      "version": "0.24.2",
-      "resolved": "https://registry.npmjs.org/@esbuild/darwin-x64/-/darwin-x64-0.24.2.tgz",
-      "integrity": "sha512-WeSrmwwHaPkNR5H3yYfowhZcbriGqooyu3zI/3GGpF8AyUdsrrP0X6KumITGA9WOyiJavnGZUwPGvxvwfWPHIA==",
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/darwin-x64/-/darwin-x64-0.28.2.tgz",
+      "integrity": "sha512-uq6suIWYP37qzGddBKPw5QEQPi6HiLGsO7UmkpfyaYNQ3D+rN6w6WfwH+nuqcGXWvawGwxOEroO4YGnFh95azw==",
       "cpu": [
         "x64"
       ],
@@ -147,9 +147,9 @@
       }
     },
     "node_modules/@esbuild/freebsd-arm64": {
-      "version": "0.24.2",
-      "resolved": "https://registry.npmjs.org/@esbuild/freebsd-arm64/-/freebsd-arm64-0.24.2.tgz",
-      "integrity": "sha512-UN8HXjtJ0k/Mj6a9+5u6+2eZ2ERD7Edt1Q9IZiB5UZAIdPnVKDoG7mdTVGhHJIeEml60JteamR3qhsr1r8gXvg==",
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/freebsd-arm64/-/freebsd-arm64-0.28.2.tgz",
+      "integrity": "sha512-n+I0BTSRIoy+d6RPKnEVwql5UwBJolytvY4mAOIEJorKlqgPII8ix6slVVrfZ5Tnj7glIZvloylbB/EJPMWEXw==",
       "cpu": [
         "arm64"
       ],
@@ -164,9 +164,9 @@
       }
     },
     "node_modules/@esbuild/freebsd-x64": {
-      "version": "0.24.2",
-      "resolved": "https://registry.npmjs.org/@esbuild/freebsd-x64/-/freebsd-x64-0.24.2.tgz",
-      "integrity": "sha512-TvW7wE/89PYW+IevEJXZ5sF6gJRDY/14hyIGFXdIucxCsbRmLUcjseQu1SyTko+2idmCw94TgyaEZi9HUSOe3Q==",
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/freebsd-x64/-/freebsd-x64-0.28.2.tgz",
+      "integrity": "sha512-78XJTJkvPs0kz2w61301PJjXl4g7q3JqiYMZ/M/yVI73EHBrCRTgkhu9oqG7vPqq+a/yadEW8aD+agKlk5xrmg==",
       "cpu": [
         "x64"
       ],
@@ -181,9 +181,9 @@
       }
     },
     "node_modules/@esbuild/linux-arm": {
-      "version": "0.24.2",
-      "resolved": "https://registry.npmjs.org/@esbuild/linux-arm/-/linux-arm-0.24.2.tgz",
-      "integrity": "sha512-n0WRM/gWIdU29J57hJyUdIsk0WarGd6To0s+Y+LwvlC55wt+GT/OgkwoXCXvIue1i1sSNWblHEig00GBWiJgfA==",
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-arm/-/linux-arm-0.28.2.tgz",
+      "integrity": "sha512-XlDnu2q5yoqems+xay6wSAcg9DDD7K9RLKZEBOMZm3ckNpJBvOX20tSfby8KfrrhINDyv9V2YVZKY/SpoGJI8w==",
       "cpu": [
         "arm"
       ],
@@ -198,9 +198,9 @@
       }
     },
     "node_modules/@esbuild/linux-arm64": {
-      "version": "0.24.2",
-      "resolved": "https://registry.npmjs.org/@esbuild/linux-arm64/-/linux-arm64-0.24.2.tgz",
-      "integrity": "sha512-7HnAD6074BW43YvvUmE/35Id9/NB7BeX5EoNkK9obndmZBUk8xmJJeU7DwmUeN7tkysslb2eSl6CTrYz6oEMQg==",
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-arm64/-/linux-arm64-0.28.2.tgz",
+      "integrity": "sha512-pW4AC0P3it8c7do9MVM4p51FzHzdM/TZrerurgRcHJ2WTa1VQ1CIq18xncfpBJw4ojkiZZrKW2yIBWBP92j6Ug==",
       "cpu": [
         "arm64"
       ],
@@ -215,9 +215,9 @@
       }
     },
     "node_modules/@esbuild/linux-ia32": {
-      "version": "0.24.2",
-      "resolved": "https://registry.npmjs.org/@esbuild/linux-ia32/-/linux-ia32-0.24.2.tgz",
-      "integrity": "sha512-sfv0tGPQhcZOgTKO3oBE9xpHuUqguHvSo4jl+wjnKwFpapx+vUDcawbwPNuBIAYdRAvIDBfZVvXprIj3HA+Ugw==",
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-ia32/-/linux-ia32-0.28.2.tgz",
+      "integrity": "sha512-CYbnj78HsIeA+DhgUKgFCfvNsTHFhMMrinUrMZpDXJXKN8T3XViTZ/+wtHeVxEWY8ewSzTFN+nRmSwO2tZaLUQ==",
       "cpu": [
         "ia32"
       ],
@@ -232,9 +232,9 @@
       }
     },
     "node_modules/@esbuild/linux-loong64": {
-      "version": "0.24.2",
-      "resolved": "https://registry.npmjs.org/@esbuild/linux-loong64/-/linux-loong64-0.24.2.tgz",
-      "integrity": "sha512-CN9AZr8kEndGooS35ntToZLTQLHEjtVB5n7dl8ZcTZMonJ7CCfStrYhrzF97eAecqVbVJ7APOEe18RPI4KLhwQ==",
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-loong64/-/linux-loong64-0.28.2.tgz",
+      "integrity": "sha512-buwkd8nsph4R+ajRvw0qM5Hja/TXQow3ptzWO2EbG/cqcIkHloRrdlBtQlshyYGTNFvfkfJ5tpPLVkY4DtsPfQ==",
       "cpu": [
         "loong64"
       ],
@@ -249,9 +249,9 @@
       }
     },
     "node_modules/@esbuild/linux-mips64el": {
-      "version": "0.24.2",
-      "resolved": "https://registry.npmjs.org/@esbuild/linux-mips64el/-/linux-mips64el-0.24.2.tgz",
-      "integrity": "sha512-iMkk7qr/wl3exJATwkISxI7kTcmHKE+BlymIAbHO8xanq/TjHaaVThFF6ipWzPHryoFsesNQJPE/3wFJw4+huw==",
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-mips64el/-/linux-mips64el-0.28.2.tgz",
+      "integrity": "sha512-ZVykbDyk7519VwiNb9Lcj9m8XM6v5V9uKPvrEMkkEedVewf+0itkhahp4HDpgERXhwLRpWFypsGbG/J8s0QjJA==",
       "cpu": [
         "mips64el"
       ],
@@ -266,9 +266,9 @@
       }
     },
     "node_modules/@esbuild/linux-ppc64": {
-      "version": "0.24.2",
-      "resolved": "https://registry.npmjs.org/@esbuild/linux-ppc64/-/linux-ppc64-0.24.2.tgz",
-      "integrity": "sha512-shsVrgCZ57Vr2L8mm39kO5PPIb+843FStGt7sGGoqiiWYconSxwTiuswC1VJZLCjNiMLAMh34jg4VSEQb+iEbw==",
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-ppc64/-/linux-ppc64-0.28.2.tgz",
+      "integrity": "sha512-CAXl+Dtd9UUuJd8pKKdwh6MLm3MUMiqMPmhZ3tTSXPqfyQ3vDl6R5hZdZ/kYojK4ofXtdfSv1tFq8XzWx3heNQ==",
       "cpu": [
         "ppc64"
       ],
@@ -283,9 +283,9 @@
       }
     },
     "node_modules/@esbuild/linux-riscv64": {
-      "version": "0.24.2",
-      "resolved": "https://registry.npmjs.org/@esbuild/linux-riscv64/-/linux-riscv64-0.24.2.tgz",
-      "integrity": "sha512-4eSFWnU9Hhd68fW16GD0TINewo1L6dRrB+oLNNbYyMUAeOD2yCK5KXGK1GH4qD/kT+bTEXjsyTCiJGHPZ3eM9Q==",
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-riscv64/-/linux-riscv64-0.28.2.tgz",
+      "integrity": "sha512-GeXCej4IQtU1B+QlDV8W/RRvbzI3O/Stss+/bCXv4lZls5WGRtu2a+3JkA3i4qIUlMXpcHebWpF8AkJhATowuA==",
       "cpu": [
         "riscv64"
       ],
@@ -300,9 +300,9 @@
       }
     },
     "node_modules/@esbuild/linux-s390x": {
-      "version": "0.24.2",
-      "resolved": "https://registry.npmjs.org/@esbuild/linux-s390x/-/linux-s390x-0.24.2.tgz",
-      "integrity": "sha512-S0Bh0A53b0YHL2XEXC20bHLuGMOhFDO6GN4b3YjRLK//Ep3ql3erpNcPlEFed93hsQAjAQDNsvcK+hV90FubSw==",
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-s390x/-/linux-s390x-0.28.2.tgz",
+      "integrity": "sha512-3H1weTYZPxt/WOhByszQZybS9w5lKzUn1FDMsgEChbHWQwHYQQRfBxgCcZvPhjHfKyJjIievvMmEUawJrdY9Dg==",
       "cpu": [
         "s390x"
       ],
@@ -317,9 +317,9 @@
       }
     },
     "node_modules/@esbuild/linux-x64": {
-      "version": "0.24.2",
-      "resolved": "https://registry.npmjs.org/@esbuild/linux-x64/-/linux-x64-0.24.2.tgz",
-      "integrity": "sha512-8Qi4nQcCTbLnK9WoMjdC9NiTG6/E38RNICU6sUNqK0QFxCYgoARqVqxdFmWkdonVsvGqWhmm7MO0jyTqLqwj0Q==",
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-x64/-/linux-x64-0.28.2.tgz",
+      "integrity": "sha512-4xTZr1FUmSoQW4XIWmit3tzQrUTZM+N3P0XV8xROKYF50XfI7xeO90+1bZvNwxIufQ9hDQVRJH5YhgPVF8A/HQ==",
       "cpu": [
         "x64"
       ],
@@ -334,9 +334,9 @@
       }
     },
     "node_modules/@esbuild/netbsd-arm64": {
-      "version": "0.24.2",
-      "resolved": "https://registry.npmjs.org/@esbuild/netbsd-arm64/-/netbsd-arm64-0.24.2.tgz",
-      "integrity": "sha512-wuLK/VztRRpMt9zyHSazyCVdCXlpHkKm34WUyinD2lzK07FAHTq0KQvZZlXikNWkDGoT6x3TD51jKQ7gMVpopw==",
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/netbsd-arm64/-/netbsd-arm64-0.28.2.tgz",
+      "integrity": "sha512-sSATRjPeDBg3pdgHoQfoYBob11Kk1FGa9lui5RIHZCoCkJa9QKlvl3/vKz2usCmYYjs7ymJR/2Nnsqe+Hjt5nw==",
       "cpu": [
         "arm64"
       ],
@@ -351,9 +351,9 @@
       }
     },
     "node_modules/@esbuild/netbsd-x64": {
-      "version": "0.24.2",
-      "resolved": "https://registry.npmjs.org/@esbuild/netbsd-x64/-/netbsd-x64-0.24.2.tgz",
-      "integrity": "sha512-VefFaQUc4FMmJuAxmIHgUmfNiLXY438XrL4GDNV1Y1H/RW3qow68xTwjZKfj/+Plp9NANmzbH5R40Meudu8mmw==",
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/netbsd-x64/-/netbsd-x64-0.28.2.tgz",
+      "integrity": "sha512-lqnzCV+mM0gIADaKihiCg6ifgfU2L3h5E33rNQBN1Y4MaVGnzryzmvvf7UHxprpQdE8hpqLolJ9Rl+SkIRDpyw==",
       "cpu": [
         "x64"
       ],
@@ -368,9 +368,9 @@
       }
     },
     "node_modules/@esbuild/openbsd-arm64": {
-      "version": "0.24.2",
-      "resolved": "https://registry.npmjs.org/@esbuild/openbsd-arm64/-/openbsd-arm64-0.24.2.tgz",
-      "integrity": "sha512-YQbi46SBct6iKnszhSvdluqDmxCJA+Pu280Av9WICNwQmMxV7nLRHZfjQzwbPs3jeWnuAhE9Jy0NrnJ12Oz+0A==",
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/openbsd-arm64/-/openbsd-arm64-0.28.2.tgz",
+      "integrity": "sha512-AL2qJILH7lNjrDmCQDvdxMfAUIv8KMNZOvrwAQ8i8//ntL9FflhOyMJ8OZSMBb8/AWXe3/5v5S20y3zCoZWKoQ==",
       "cpu": [
         "arm64"
       ],
@@ -385,9 +385,9 @@
       }
     },
     "node_modules/@esbuild/openbsd-x64": {
-      "version": "0.24.2",
-      "resolved": "https://registry.npmjs.org/@esbuild/openbsd-x64/-/openbsd-x64-0.24.2.tgz",
-      "integrity": "sha512-+iDS6zpNM6EnJyWv0bMGLWSWeXGN/HTaF/LXHXHwejGsVi+ooqDfMCCTerNFxEkM3wYVcExkeGXNqshc9iMaOA==",
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/openbsd-x64/-/openbsd-x64-0.28.2.tgz",
+      "integrity": "sha512-QtiuPytchRyC4rwUKhexJdQKvDuZ6hWloi3igqPQNUJCS1/v9EiO3UTOXR6A3FoMo4fnAKbWJdqaIwhOzh8qEw==",
       "cpu": [
         "x64"
       ],
@@ -401,10 +401,27 @@
         "node": ">=18"
       }
     },
+    "node_modules/@esbuild/openharmony-arm64": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/openharmony-arm64/-/openharmony-arm64-0.28.2.tgz",
+      "integrity": "sha512-WkhYDmpTjLvGlScA1rwjRUmhl4k8oXR3cIbtqWmELgU/dFeHHlEllxDvdWcNJV9rbzCexB5vz8gtNewWLgCT7Q==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openharmony"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
     "node_modules/@esbuild/sunos-x64": {
-      "version": "0.24.2",
-      "resolved": "https://registry.npmjs.org/@esbuild/sunos-x64/-/sunos-x64-0.24.2.tgz",
-      "integrity": "sha512-hTdsW27jcktEvpwNHJU4ZwWFGkz2zRJUz8pvddmXPtXDzVKTTINmlmga3ZzwcuMpUvLw7JkLy9QLKyGpD2Yxig==",
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/sunos-x64/-/sunos-x64-0.28.2.tgz",
+      "integrity": "sha512-GPMSkTOtMnv2U2F8gxe4Io6qmVs+YKyp832Etqqxr0hFngmXQ3rzwytelm3GIn7T4VviRUlf3sOgBOiTdvaf7g==",
       "cpu": [
         "x64"
       ],
@@ -419,9 +436,9 @@
       }
     },
     "node_modules/@esbuild/win32-arm64": {
-      "version": "0.24.2",
-      "resolved": "https://registry.npmjs.org/@esbuild/win32-arm64/-/win32-arm64-0.24.2.tgz",
-      "integrity": "sha512-LihEQ2BBKVFLOC9ZItT9iFprsE9tqjDjnbulhHoFxYQtQfai7qfluVODIYxt1PgdoyQkz23+01rzwNwYfutxUQ==",
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-arm64/-/win32-arm64-0.28.2.tgz",
+      "integrity": "sha512-PIhhEkE9uPBleRBrQEJpUn7MBnibZzbGzYWPmY3x+YoVg/95zbjB4CxPPOQ8l5tYYM4mMaCthF8/1DIfBQQyWQ==",
       "cpu": [
         "arm64"
       ],
@@ -436,9 +453,9 @@
       }
     },
     "node_modules/@esbuild/win32-ia32": {
-      "version": "0.24.2",
-      "resolved": "https://registry.npmjs.org/@esbuild/win32-ia32/-/win32-ia32-0.24.2.tgz",
-      "integrity": "sha512-q+iGUwfs8tncmFC9pcnD5IvRHAzmbwQ3GPS5/ceCyHdjXubwQWI12MKWSNSMYLJMq23/IUCvJMS76PDqXe1fxA==",
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-ia32/-/win32-ia32-0.28.2.tgz",
+      "integrity": "sha512-YmJbfTlvU7Sdn9BB+4PRES4oB6pxgS37MAONj+hBr/cpXS1aBPKXxNnDbu+QCWPj0o9dgyxeq79g6c5P8KeuYA==",
       "cpu": [
         "ia32"
       ],
@@ -453,9 +470,9 @@
       }
     },
     "node_modules/@esbuild/win32-x64": {
-      "version": "0.24.2",
-      "resolved": "https://registry.npmjs.org/@esbuild/win32-x64/-/win32-x64-0.24.2.tgz",
-      "integrity": "sha512-7VTgWzgMGvup6aSqDPLiW5zHaxYJGTO4OokMjIlrCtf+VpEL+cXKtCvg723iguPYI5oaUNdS+/V7OU2gvXVWEg==",
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-x64/-/win32-x64-0.28.2.tgz",
+      "integrity": "sha512-5ebpxr3nWMzrL/rnUI755Jkuee0bHL/Gq0WTF9lvcpv73wAp5eu8MfBUgWK9bhWvZjj7yX8etf/8tI8Ney695g==",
       "cpu": [
         "x64"
       ],
@@ -814,9 +831,9 @@
       }
     },
     "node_modules/@fastify/formbody": {
-      "version": "8.0.2",
-      "resolved": "https://registry.npmjs.org/@fastify/formbody/-/formbody-8.0.2.tgz",
-      "integrity": "sha512-84v5J2KrkXzjgBpYnaNRPqwgMsmY7ZDjuj0YVuMR3NXCJRCgKEZy/taSP1wUYGn0onfxJpLyRGDLa+NMaDJtnA==",
+      "version": "9.0.0",
+      "resolved": "https://registry.npmjs.org/@fastify/formbody/-/formbody-9.0.0.tgz",
+      "integrity": "sha512-T/af26CSrUARBCvsEmv+DJLPfZlrRKESzqironxP1j7qzuLyKcoZtj6MuTGShuKx1THXugoie2oFbUJxXfGFzA==",
       "dev": true,
       "funding": [
         {
@@ -831,26 +848,9 @@
       "license": "MIT",
       "dependencies": {
         "fast-querystring": "^1.1.2",
-        "fastify-plugin": "^5.0.0"
+        "fastify-plugin": "^6.0.0"
       }
     },
-    "node_modules/@fastify/formbody/node_modules/fastify-plugin": {
-      "version": "5.1.0",
-      "resolved": "https://registry.npmjs.org/fastify-plugin/-/fastify-plugin-5.1.0.tgz",
-      "integrity": "sha512-FAIDA8eovSt5qcDgcBvDuX/v0Cjz0ohGhENZ/wpc3y+oZCY2afZ9Baqql3g/lC+OHRnciQol4ww7tuthOb9idw==",
-      "dev": true,
-      "funding": [
-        {
-          "type": "github",
-          "url": "https://github.com/sponsors/fastify"
-        },
-        {
-          "type": "opencollective",
-          "url": "https://opencollective.com/fastify"
-        }
-      ],
-      "license": "MIT"
-    },
     "node_modules/@fastify/forwarded": {
       "version": "3.0.2",
       "resolved": "https://registry.npmjs.org/@fastify/forwarded/-/forwarded-3.0.2.tgz",
@@ -1039,12 +1039,13 @@
       }
     },
     "node_modules/@nestjs/common": {
-      "version": "11.2.5",
-      "resolved": "https://registry.npmjs.org/@nestjs/common/-/common-11.2.5.tgz",
-      "integrity": "sha512-x3LYEZnbGZMIeu9m60ws2+ZWzFAok9zGwjXZjcmdAeCLw6BYEjp9lreimuEpDIsLXK9bi6iYcJsYQGat9wq/rQ==",
+      "version": "12.0.3",
+      "resolved": "https://registry.npmjs.org/@nestjs/common/-/common-12.0.3.tgz",
+      "integrity": "sha512-Fosz6lHc9OagZNcF0LTrVHyJS8W7mtuNFBOo9RRccGwyeICBd0hiutjAi9zxnzBcP45RkYXeNB+idA/52jZhBQ==",
       "license": "MIT",
       "dependencies": {
-        "file-type": "21.3.4",
+        "@standard-schema/spec": "1.1.0",
+        "file-type": "22.1.0",
         "iterare": "1.2.1",
         "load-esm": "1.0.3",
         "tslib": "2.8.1",
@@ -1070,9 +1071,9 @@
       }
     },
     "node_modules/@nestjs/core": {
-      "version": "11.2.5",
-      "resolved": "https://registry.npmjs.org/@nestjs/core/-/core-11.2.5.tgz",
-      "integrity": "sha512-ZgF8aitL7h8VPyVQ+vlUDrSVzbR7AojCv9Je9JqJVfHw3TtD3OOQ82RsCKrxfx09xpoveRr7UBHPA/d24bu2lA==",
+      "version": "12.0.3",
+      "resolved": "https://registry.npmjs.org/@nestjs/core/-/core-12.0.3.tgz",
+      "integrity": "sha512-Ouv++gAXOL50S8K8n6AN19QGmw51rnIo6v7y9AqUYoaf0NcZlufTu5XTDeC2RtpMz8oXRr9nykBngRjflcoQKA==",
       "license": "MIT",
       "dependencies": {
         "fast-safe-stringify": "2.1.1",
@@ -1089,10 +1090,10 @@
         "url": "https://opencollective.com/nest"
       },
       "peerDependencies": {
-        "@nestjs/common": "^11.0.0",
-        "@nestjs/microservices": "^11.0.0",
-        "@nestjs/platform-express": "^11.0.0",
-        "@nestjs/websockets": "^11.0.0",
+        "@nestjs/common": "^12.0.0",
+        "@nestjs/microservices": "^12.0.0",
+        "@nestjs/platform-express": "^12.0.0",
+        "@nestjs/websockets": "^12.0.0",
         "reflect-metadata": "^0.1.12 || ^0.2.0",
         "rxjs": "^7.1.0"
       },
@@ -1109,15 +1110,15 @@
       }
     },
     "node_modules/@nestjs/platform-express": {
-      "version": "11.2.5",
-      "resolved": "https://registry.npmjs.org/@nestjs/platform-express/-/platform-express-11.2.5.tgz",
-      "integrity": "sha512-R3LSHqgPQo7ZTdYqA39lvdHS2RBnVJUePKIpL+cr1oB3HtYj9qPdhdmS307eLDc1VeTPFXAnSuVfcG9lMDEFSw==",
+      "version": "12.0.3",
+      "resolved": "https://registry.npmjs.org/@nestjs/platform-express/-/platform-express-12.0.3.tgz",
+      "integrity": "sha512-q9ImjCMjbYYgqvRHHro6sAypNwhjspIAHad0RTL2ww5wYd9gwUGWMss7Q+ACCw5Sksu7Q8S/3rjSLhB+W6B6bg==",
       "devOptional": true,
       "license": "MIT",
       "dependencies": {
         "cors": "2.8.6",
         "express": "5.2.1",
-        "multer": "2.2.0",
+        "multer": "2.4.0",
         "path-to-regexp": "8.4.2",
         "tslib": "2.8.1"
       },
@@ -1126,23 +1127,23 @@
         "url": "https://opencollective.com/nest"
       },
       "peerDependencies": {
-        "@nestjs/common": "^11.0.0",
-        "@nestjs/core": "^11.0.0"
+        "@nestjs/common": "^12.0.0",
+        "@nestjs/core": "^12.0.0"
       }
     },
     "node_modules/@nestjs/platform-fastify": {
-      "version": "11.2.5",
-      "resolved": "https://registry.npmjs.org/@nestjs/platform-fastify/-/platform-fastify-11.2.5.tgz",
-      "integrity": "sha512-uD40kttwSn2UpLmLXeD46JISJxpNvYfnIjrjjKqQIuQHXceTKClZavRMVey0XwkKPOczXEPmOQn79/CcFuZtgw==",
+      "version": "12.0.3",
+      "resolved": "https://registry.npmjs.org/@nestjs/platform-fastify/-/platform-fastify-12.0.3.tgz",
+      "integrity": "sha512-Cn8jR8jwPJBk7ftkzunplz0LHDahnq7urAO9VjOV0OWkk1YCwaFMm4CElSk3BwBiDwP177anJjJUbVxTlASk4A==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
         "@fastify/cors": "11.3.0",
-        "@fastify/formbody": "8.0.2",
+        "@fastify/formbody": "9.0.0",
         "@fastify/middie": "9.3.4",
         "fast-querystring": "1.1.2",
-        "fastify": "5.11.3",
-        "find-my-way": "9.7.0",
+        "fastify": "5.12.4",
+        "find-my-way": "9.9.0",
         "light-my-request": "6.6.0",
         "path-to-regexp": "8.4.2",
         "tslib": "2.8.1"
@@ -1154,8 +1155,8 @@
       "peerDependencies": {
         "@fastify/static": "^10.1.2",
         "@fastify/view": "^10.0.0 || ^11.0.0 || ^12.0.0",
-        "@nestjs/common": "^11.0.0",
-        "@nestjs/core": "^11.0.0"
+        "@nestjs/common": "^12.0.0",
+        "@nestjs/core": "^12.0.0"
       },
       "peerDependenciesMeta": {
         "@fastify/static": {
@@ -1167,9 +1168,9 @@
       }
     },
     "node_modules/@nestjs/platform-fastify/node_modules/fastify": {
-      "version": "5.11.3",
-      "resolved": "https://registry.npmjs.org/fastify/-/fastify-5.11.3.tgz",
-      "integrity": "sha512-W6hzDP8s0iSeL7LGwY6Oc/ZxuXWOvFEMs6p2L0Si415YRo27W5pBKdOTXxhemBDeSTAcpYf5evRA9onF2OYhPA==",
+      "version": "5.12.4",
+      "resolved": "https://registry.npmjs.org/fastify/-/fastify-5.12.4.tgz",
+      "integrity": "sha512-zATD676fP6tBMsn+jQ7Q5/cO/Qo+149TXH0dUqUKel+1/hcZxwIbnflqtPa9EjlrvpY8eCZcL3M1UYrMc31Y7g==",
       "dev": true,
       "funding": [
         {
@@ -1193,28 +1194,13 @@
         "find-my-way": "^9.6.0",
         "light-my-request": "^6.0.0",
         "pino": "^9.14.0 || ^10.1.0",
-        "process-warning": "^5.0.0",
+        "process-warning": "^5.1.0",
         "rfdc": "^1.3.1",
         "secure-json-parse": "^4.0.0",
         "semver": "^7.6.0",
         "toad-cache": "^3.7.0"
       }
     },
-    "node_modules/@nestjs/platform-fastify/node_modules/find-my-way": {
-      "version": "9.7.0",
-      "resolved": "https://registry.npmjs.org/find-my-way/-/find-my-way-9.7.0.tgz",
-      "integrity": "sha512-f2JHn75x2JlwUwLenZypgczR7YWMb/uO9BvUXtus+JMgkbIkLADd38cI4EiV+OQqrGo1Zlq6V8wnqMJ8e62wUQ==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "fast-deep-equal": "^3.1.3",
-        "fast-querystring": "^1.0.0",
-        "safe-regex2": "^5.0.0"
-      },
-      "engines": {
-        "node": ">=20"
-      }
-    },
     "node_modules/@pinojs/redact": {
       "version": "0.4.0",
       "resolved": "https://registry.npmjs.org/@pinojs/redact/-/redact-0.4.0.tgz",
@@ -1237,6 +1223,12 @@
         "node": ">=18"
       }
     },
+    "node_modules/@standard-schema/spec": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/@standard-schema/spec/-/spec-1.1.0.tgz",
+      "integrity": "sha512-l2aFy5jALhniG5HgqrD6jXLi/rUWrKvqN/qJx6yoJsgKhblVd+iqqU4RCXavm/jPityDo5TCvKMnpjKnOriy0w==",
+      "license": "MIT"
+    },
     "node_modules/@stylistic/eslint-plugin": {
       "version": "5.10.0",
       "resolved": "https://registry.npmjs.org/@stylistic/eslint-plugin/-/eslint-plugin-5.10.0.tgz",
@@ -1881,13 +1873,6 @@
         "node": "20 || >=22"
       }
     },
-    "node_modules/buffer-from": {
-      "version": "1.1.2",
-      "resolved": "https://registry.npmjs.org/buffer-from/-/buffer-from-1.1.2.tgz",
-      "integrity": "sha512-E+XQCRwSbaaiChtv6k6Dwgc+bx+Bs6vuKJHHl5kox/BaKbhiXzqQOwK4cO22yElGp2OCmjwVhT3HmxgyPGnJfQ==",
-      "devOptional": true,
-      "license": "MIT"
-    },
     "node_modules/busboy": {
       "version": "1.6.0",
       "resolved": "https://registry.npmjs.org/busboy/-/busboy-1.6.0.tgz",
@@ -1992,22 +1977,6 @@
       "dev": true,
       "license": "MIT"
     },
-    "node_modules/concat-stream": {
-      "version": "2.0.0",
-      "resolved": "https://registry.npmjs.org/concat-stream/-/concat-stream-2.0.0.tgz",
-      "integrity": "sha512-MWufYdFw53ccGjCA+Ol7XJYpAlW6/prSMzuPOTRnJGcGzuhLn4Scrz7qf6o8bROZ514ltazcIFJZevcfbo0x7A==",
-      "devOptional": true,
-      "engines": [
-        "node >= 6.0"
-      ],
-      "license": "MIT",
-      "dependencies": {
-        "buffer-from": "^1.0.0",
-        "inherits": "^2.0.3",
-        "readable-stream": "^3.0.2",
-        "typedarray": "^0.0.6"
-      }
-    },
     "node_modules/content-disposition": {
       "version": "1.1.0",
       "resolved": "https://registry.npmjs.org/content-disposition/-/content-disposition-1.1.0.tgz",
@@ -2183,9 +2152,9 @@
       }
     },
     "node_modules/esbuild": {
-      "version": "0.24.2",
-      "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.24.2.tgz",
-      "integrity": "sha512-+9egpBW8I3CD5XPe0n6BfT5fxLzxrlDzqydF3aviG+9ni1lDC/OvMHcxqEFV0+LANZG5R1bFMWfUrjVsdwxJvA==",
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.28.2.tgz",
+      "integrity": "sha512-HKVLS8dvII+xoKW9kmqxbRKrnWEXfJJr/FZhhJmiqIB0e053QNYFqOBouTMO/k5sID4MvCiUCvv8b9M4h32wIA==",
       "dev": true,
       "hasInstallScript": true,
       "license": "MIT",
@@ -2196,31 +2165,32 @@
         "node": ">=18"
       },
       "optionalDependencies": {
-        "@esbuild/aix-ppc64": "0.24.2",
-        "@esbuild/android-arm": "0.24.2",
-        "@esbuild/android-arm64": "0.24.2",
-        "@esbuild/android-x64": "0.24.2",
-        "@esbuild/darwin-arm64": "0.24.2",
-        "@esbuild/darwin-x64": "0.24.2",
-        "@esbuild/freebsd-arm64": "0.24.2",
-        "@esbuild/freebsd-x64": "0.24.2",
-        "@esbuild/linux-arm": "0.24.2",
-        "@esbuild/linux-arm64": "0.24.2",
-        "@esbuild/linux-ia32": "0.24.2",
-        "@esbuild/linux-loong64": "0.24.2",
-        "@esbuild/linux-mips64el": "0.24.2",
-        "@esbuild/linux-ppc64": "0.24.2",
-        "@esbuild/linux-riscv64": "0.24.2",
-        "@esbuild/linux-s390x": "0.24.2",
-        "@esbuild/linux-x64": "0.24.2",
-        "@esbuild/netbsd-arm64": "0.24.2",
-        "@esbuild/netbsd-x64": "0.24.2",
-        "@esbuild/openbsd-arm64": "0.24.2",
-        "@esbuild/openbsd-x64": "0.24.2",
-        "@esbuild/sunos-x64": "0.24.2",
-        "@esbuild/win32-arm64": "0.24.2",
-        "@esbuild/win32-ia32": "0.24.2",
-        "@esbuild/win32-x64": "0.24.2"
+        "@esbuild/aix-ppc64": "0.28.2",
+        "@esbuild/android-arm": "0.28.2",
+        "@esbuild/android-arm64": "0.28.2",
+        "@esbuild/android-x64": "0.28.2",
+        "@esbuild/darwin-arm64": "0.28.2",
+        "@esbuild/darwin-x64": "0.28.2",
+        "@esbuild/freebsd-arm64": "0.28.2",
+        "@esbuild/freebsd-x64": "0.28.2",
+        "@esbuild/linux-arm": "0.28.2",
+        "@esbuild/linux-arm64": "0.28.2",
+        "@esbuild/linux-ia32": "0.28.2",
+        "@esbuild/linux-loong64": "0.28.2",
+        "@esbuild/linux-mips64el": "0.28.2",
+        "@esbuild/linux-ppc64": "0.28.2",
+        "@esbuild/linux-riscv64": "0.28.2",
+        "@esbuild/linux-s390x": "0.28.2",
+        "@esbuild/linux-x64": "0.28.2",
+        "@esbuild/netbsd-arm64": "0.28.2",
+        "@esbuild/netbsd-x64": "0.28.2",
+        "@esbuild/openbsd-arm64": "0.28.2",
+        "@esbuild/openbsd-x64": "0.28.2",
+        "@esbuild/openharmony-arm64": "0.28.2",
+        "@esbuild/sunos-x64": "0.28.2",
+        "@esbuild/win32-arm64": "0.28.2",
+        "@esbuild/win32-ia32": "0.28.2",
+        "@esbuild/win32-x64": "0.28.2"
       }
     },
     "node_modules/escape-html": {
@@ -2700,18 +2670,18 @@
       }
     },
     "node_modules/file-type": {
-      "version": "21.3.4",
-      "resolved": "https://registry.npmjs.org/file-type/-/file-type-21.3.4.tgz",
-      "integrity": "sha512-Ievi/yy8DS3ygGvT47PjSfdFoX+2isQueoYP1cntFW1JLYAuS4GD7NUPGg4zv2iZfV52uDyk5w5Z0TdpRS6Q1g==",
+      "version": "22.1.0",
+      "resolved": "https://registry.npmjs.org/file-type/-/file-type-22.1.0.tgz",
+      "integrity": "sha512-fbvf9u6jnHWr1EP6V8R99E9iLMhNLXgZkUzWBiPpJ5/89UJ/Atuxjn5YXR+XaZWo2hc2/8mGfTez+NDAgOcpLA==",
       "license": "MIT",
       "dependencies": {
         "@tokenizer/inflate": "^0.4.1",
-        "strtok3": "^10.3.4",
-        "token-types": "^6.1.1",
-        "uint8array-extras": "^1.4.0"
+        "strtok3": "^10.3.5",
+        "token-types": "^6.1.2",
+        "uint8array-extras": "^1.5.0"
       },
       "engines": {
-        "node": ">=20"
+        "node": ">=22"
       },
       "funding": {
         "url": "https://github.com/sindresorhus/file-type?sponsor=1"
@@ -3402,15 +3372,14 @@
       "license": "MIT"
     },
     "node_modules/multer": {
-      "version": "2.2.0",
-      "resolved": "https://registry.npmjs.org/multer/-/multer-2.2.0.tgz",
-      "integrity": "sha512-6rdyFg2kLrMh9Jee7/BMPuV9lEAd7lLW2YUpF9/YxR7njyoUwwQ0ZPh3TaIY50Sw6vlyD2HW3wGOkTS4P79xrQ==",
+      "version": "2.4.0",
+      "resolved": "https://registry.npmjs.org/multer/-/multer-2.4.0.tgz",
+      "integrity": "sha512-7dqa0ZcFfzbefdTuIkzOSMvZWC0J7FLqBOjJUZvDCXShIURWKxAyTT1wHhnE5q19c7jOJf43IYYKjBmZVZmvhg==",
       "devOptional": true,
       "license": "MIT",
       "dependencies": {
         "append-field": "^1.0.0",
         "busboy": "^1.6.0",
-        "concat-stream": "^2.0.0",
         "type-is": "^1.6.18"
       },
       "engines": {
@@ -3846,21 +3815,6 @@
         "node": ">= 0.10"
       }
     },
-    "node_modules/readable-stream": {
-      "version": "3.6.2",
-      "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-3.6.2.tgz",
-      "integrity": "sha512-9u/sniCrY3D5WdsERHzHE4G2YCXqoG5FTHUiCC4SIbr6XcLZBY05ya9EKjYek9O5xOAwjGq+1JdGBAS7Q9ScoA==",
-      "devOptional": true,
-      "license": "MIT",
-      "dependencies": {
-        "inherits": "^2.0.3",
-        "string_decoder": "^1.1.1",
-        "util-deprecate": "^1.0.1"
-      },
-      "engines": {
-        "node": ">= 6"
-      }
-    },
     "node_modules/real-require": {
       "version": "0.2.0",
       "resolved": "https://registry.npmjs.org/real-require/-/real-require-0.2.0.tgz",
@@ -3945,27 +3899,6 @@
         "tslib": "^2.1.0"
       }
     },
-    "node_modules/safe-buffer": {
-      "version": "5.2.1",
-      "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.2.1.tgz",
-      "integrity": "sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ==",
-      "devOptional": true,
-      "funding": [
-        {
-          "type": "github",
-          "url": "https://github.com/sponsors/feross"
-        },
-        {
-          "type": "patreon",
-          "url": "https://www.patreon.com/feross"
-        },
-        {
-          "type": "consulting",
-          "url": "https://feross.org/support"
-        }
-      ],
-      "license": "MIT"
-    },
     "node_modules/safe-regex2": {
       "version": "5.1.1",
       "resolved": "https://registry.npmjs.org/safe-regex2/-/safe-regex2-5.1.1.tgz",
@@ -4219,16 +4152,6 @@
         "node": ">=10.0.0"
       }
     },
-    "node_modules/string_decoder": {
-      "version": "1.3.0",
-      "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-1.3.0.tgz",
-      "integrity": "sha512-hkRX8U1WjJFd8LsDJ2yQ/wWWxaopEsABU1XfkM8A+j0+85JAGppt16cr1Whg6KIbb4okU6Mql6BOj+uup/wKeA==",
-      "devOptional": true,
-      "license": "MIT",
-      "dependencies": {
-        "safe-buffer": "~5.2.0"
-      }
-    },
     "node_modules/strip-json-comments": {
       "version": "3.1.1",
       "resolved": "https://registry.npmjs.org/strip-json-comments/-/strip-json-comments-3.1.1.tgz",
@@ -4405,13 +4328,6 @@
         "url": "https://opencollective.com/express"
       }
     },
-    "node_modules/typedarray": {
-      "version": "0.0.6",
-      "resolved": "https://registry.npmjs.org/typedarray/-/typedarray-0.0.6.tgz",
-      "integrity": "sha512-/aCDEGatGvZ2BIk+HmLf4ifCJFwvKFNb9/JeZPMulfgFracn9QFcAf5GO8B/mweUjSoblS5In0cWhqpfs/5PQA==",
-      "devOptional": true,
-      "license": "MIT"
-    },
     "node_modules/typescript": {
       "version": "5.9.3",
       "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.9.3.tgz",
@@ -4476,13 +4392,6 @@
         "punycode": "^2.1.0"
       }
     },
-    "node_modules/util-deprecate": {
-      "version": "1.0.2",
-      "resolved": "https://registry.npmjs.org/util-deprecate/-/util-deprecate-1.0.2.tgz",
-      "integrity": "sha512-EPD5q1uXyFxJpCrLnCc1nHnq3gOa6DZBocAIiI2TaSCA7VCJ1UJDMagCzIkXNsUYfD1daK//LTEQ8xiIbrHtcw==",
-      "devOptional": true,
-      "license": "MIT"
-    },
     "node_modules/vary": {
       "version": "1.1.2",
       "resolved": "https://registry.npmjs.org/vary/-/vary-1.1.2.tgz",
@@ -4603,8 +4512,8 @@
         "node": ">=20"
       },
       "peerDependencies": {
-        "@nestjs/common": "^10.0.0 || ^11.0.0",
-        "@nestjs/core": "^10.0.0 || ^11.0.0"
+        "@nestjs/common": "^10.0.0 || ^11.0.0 || ^12.0.0",
+        "@nestjs/core": "^10.0.0 || ^11.0.0 || ^12.0.0"
       }
     }
   }
diff --git a/integrations/package.json b/integrations/package.json
index 48c7f721..3e9c1336 100644
--- a/integrations/package.json
+++ b/integrations/package.json
@@ -20,28 +20,31 @@
     "check:nestjs-fastify": "npm run build && ADAPTER=fastify bash contract-tests/check.sh --example nodejs/nestjs/example/server.js --port 5459",
     "lint": "eslint",
     "lint:fix": "eslint --fix",
-    "pack-check": "npm run build && bash nodejs/scripts/pack-and-install.sh",
+    "matrix": "npm run build && bash nodejs/scripts/matrix.sh",
+    "pack-check": "npm run build && bash nodejs/scripts/matrix.sh --cell express@5",
+    "setup": "bash scripts/setup.sh",
     "start:express": "node nodejs/express/example/server.js",
     "start:fastify": "node nodejs/fastify/example/server.js",
     "start:nestjs": "node nodejs/nestjs/example/server.js",
+    "test": "npm run test:ci && npm run test:browser",
     "test:assemble": "node shell/test/assemble.test.mjs",
     "test:browser": "npm run build && playwright test --config contract-tests/browser/playwright.config.mjs",
+    "test:ci": "npm run lint && npm run test:unit && bash nodejs/scripts/check-all.sh && bash nodejs/scripts/matrix.sh --cell express@5",
     "test:collection": "npm run build:core && node nodejs/core/test/collection.test.mjs",
     "test:docs": "npm run build && node nodejs/core/test/docs.test.mjs",
     "test:filter": "npm run build:core && node nodejs/core/test/filter.test.mjs",
     "test:nestjs": "npm run build && node nodejs/nestjs/test/sub-path.test.mjs",
     "test:shell": "npm run build && node nodejs/core/test/shell.test.mjs",
     "test:unit": "npm run build && node nodejs/core/test/walk.test.mjs && node nodejs/core/test/filter.test.mjs && node nodejs/core/test/collection.test.mjs && node nodejs/core/test/shell.test.mjs && node nodejs/core/test/docs.test.mjs && node nodejs/nestjs/test/sub-path.test.mjs && node shell/test/assemble.test.mjs",
-    "test:walk": "npm run build:core && node nodejs/core/test/walk.test.mjs",
-    "verify": "npm run lint && npm run test:unit && bash nodejs/scripts/check-all.sh && bash nodejs/scripts/pack-and-install.sh && npm run test:browser"
+    "test:walk": "npm run build:core && node nodejs/core/test/walk.test.mjs"
   },
   "devDependencies": {
     "@eslint/js": "^9.39.5",
     "@fastify/swagger": "^9.8.1",
-    "@nestjs/common": "^11.2.5",
-    "@nestjs/core": "^11.2.5",
-    "@nestjs/platform-express": "^11.2.5",
-    "@nestjs/platform-fastify": "^11.2.5",
+    "@nestjs/common": "^12.0.3",
+    "@nestjs/core": "^12.0.3",
+    "@nestjs/platform-express": "^12.0.3",
+    "@nestjs/platform-fastify": "^12.0.3",
     "@playwright/test": "^1.61.1",
     "@stylistic/eslint-plugin": "^5.3.1",
     "@types/express": "^5.0.0",
@@ -49,7 +52,7 @@
     "@types/node": "^22.10.0",
     "@typescript-eslint/eslint-plugin": "^8.65.0",
     "@typescript-eslint/parser": "^8.39.0",
-    "esbuild": "^0.24.0",
+    "esbuild": "^0.28.2",
     "eslint": "^9.21.0",
     "express": "^5.0.0",
     "fastify": "^5.12.5",
diff --git a/integrations/scripts/setup.sh b/integrations/scripts/setup.sh
new file mode 100755
index 00000000..43242063
--- /dev/null
+++ b/integrations/scripts/setup.sh
@@ -0,0 +1,37 @@
+#!/usr/bin/env bash
+# First-time setup for integrations/, safe to rerun: the pinned toolchain and a clean build.
+set -euo pipefail
+cd "$(dirname "$0")/.."
+
+if ! command -v mise >/dev/null 2>&1; then
+  echo "mise is not installed. It reads mise.toml and gives you the pinned Node."
+  if command -v brew >/dev/null 2>&1 && [ -t 0 ]; then
+    read -r -p "Install it with Homebrew now? [y/N] " answer
+    if [ "$answer" = "y" ]; then
+      brew install mise
+    fi
+  fi
+  command -v mise >/dev/null 2>&1 || { echo "Install it first: https://mise.jdx.dev/getting-started.html"; exit 1; }
+fi
+
+mise trust --quiet 2>/dev/null || mise trust
+mise install
+
+pinned="$(mise exec -- node -v)"
+current="$(node -v 2>/dev/null || echo none)"
+if [ "$pinned" != "$current" ]; then
+  echo
+  echo "mise.toml pins node $pinned; your shell runs $current."
+  echo "Activate mise for your shell and cd into this directory switches automatically:"
+  echo "  https://mise.jdx.dev/getting-started.html#activate-mise"
+  echo "Until then, prefix commands with: mise exec --"
+  echo
+fi
+
+# stale build output from another node or an older checkout is the usual source of a mystery failure
+rm -rf nodejs/*/dist nodejs/*/shell shell/shell.js
+mise exec -- npm ci
+mise exec -- npm run build
+
+echo
+echo "Ready. The whole gate: npm test"

From 0ef240386ee197867af861da60a96fe9d9b33762 Mon Sep 17 00:00:00 2001
From: Arpit Bruno <arpit@usebruno.com>
Date: Fri, 18 Sep 2026 01:12:31 +0530
Subject: [PATCH 13/21] example sets per framework

---
 integrations/.dockerignore                    |   1 +
 integrations/contract-tests/apps/express.js   |  61 ++++++++
 .../apps/fastify.js}                          |  12 +-
 integrations/contract-tests/apps/nestjs.js    |  68 ++++++++
 .../browser/playwright.config.mjs             |   6 +-
 integrations/contract-tests/check.sh          |  76 ++-------
 integrations/contract-tests/examples.sh       | 148 ++++++++++++++++++
 integrations/contract-tests/lib.sh            |  67 ++++++++
 integrations/eslint.config.mjs                |   9 +-
 integrations/nodejs/core/src/create-docs.ts   |  11 +-
 integrations/nodejs/core/src/index.ts         |   2 +
 integrations/nodejs/core/src/routes/shell.ts  |  50 +++---
 integrations/nodejs/core/test/docs.test.mjs   |  10 --
 integrations/nodejs/core/test/shell.test.mjs  |  18 ++-
 integrations/nodejs/express/example/server.js |  73 ---------
 .../api-collection/catalog/folder.yml         |   3 +
 .../api-collection/catalog/get product.yml    |   7 +
 .../api-collection/catalog/list products.yml  |   7 +
 .../api-collection/opencollection.yml         |   5 +
 integrations/nodejs/express/examples/auth.js  |  25 +++
 integrations/nodejs/express/examples/csp.js   |  28 ++++
 integrations/nodejs/express/examples/embed.js |  24 +++
 .../nodejs/express/examples/quickstart.js     |  14 ++
 integrations/nodejs/express/src/index.ts      |   5 +-
 .../api-collection/catalog/folder.yml         |   3 +
 .../api-collection/catalog/get product.yml    |   7 +
 .../api-collection/catalog/list products.yml  |   7 +
 .../api-collection/opencollection.yml         |   5 +
 integrations/nodejs/fastify/examples/auth.js  |  25 +++
 integrations/nodejs/fastify/examples/csp.js   |  27 ++++
 integrations/nodejs/fastify/examples/embed.js |  24 +++
 .../nodejs/fastify/examples/quickstart.js     |  14 ++
 integrations/nodejs/fastify/src/index.ts      |   7 +-
 integrations/nodejs/nestjs/example/server.js  |  87 ----------
 .../examples/01-quickstart/app.module.ts      |  11 ++
 .../nestjs/examples/01-quickstart/main.ts     |   9 ++
 .../nestjs/examples/02-auth/app.module.ts     |  28 ++++
 .../nodejs/nestjs/examples/02-auth/main.ts    |   9 ++
 .../examples/03-global-prefix/app.module.ts   |   7 +
 .../nestjs/examples/03-global-prefix/main.ts  |  12 ++
 .../examples/04-fastify-adapter/app.module.ts |   7 +
 .../examples/04-fastify-adapter/main.ts       |  11 ++
 .../nestjs/examples/05-csp/app.module.ts      |   7 +
 .../nodejs/nestjs/examples/05-csp/main.ts     |  25 +++
 .../nestjs/examples/06-embed/app.module.ts    |   9 ++
 .../nodejs/nestjs/examples/06-embed/main.ts   |   9 ++
 .../examples/06-embed/portal.controller.ts    |  20 +++
 .../api-collection/catalog/folder.yml         |   3 +
 .../api-collection/catalog/get product.yml    |   7 +
 .../api-collection/catalog/list products.yml  |   7 +
 .../api-collection/opencollection.yml         |   5 +
 .../nodejs/nestjs/examples/tsconfig.json      |  11 ++
 integrations/nodejs/nestjs/src/index.ts       |   5 +-
 integrations/nodejs/scripts/check-all.sh      |  12 +-
 integrations/nodejs/scripts/matrix.sh         |   7 +-
 integrations/package.json                     |  20 +--
 56 files changed, 871 insertions(+), 306 deletions(-)
 create mode 100644 integrations/contract-tests/apps/express.js
 rename integrations/{nodejs/fastify/example/server.js => contract-tests/apps/fastify.js} (79%)
 create mode 100644 integrations/contract-tests/apps/nestjs.js
 create mode 100644 integrations/contract-tests/examples.sh
 create mode 100644 integrations/contract-tests/lib.sh
 delete mode 100644 integrations/nodejs/express/example/server.js
 create mode 100644 integrations/nodejs/express/examples/api-collection/catalog/folder.yml
 create mode 100644 integrations/nodejs/express/examples/api-collection/catalog/get product.yml
 create mode 100644 integrations/nodejs/express/examples/api-collection/catalog/list products.yml
 create mode 100644 integrations/nodejs/express/examples/api-collection/opencollection.yml
 create mode 100644 integrations/nodejs/express/examples/auth.js
 create mode 100644 integrations/nodejs/express/examples/csp.js
 create mode 100644 integrations/nodejs/express/examples/embed.js
 create mode 100644 integrations/nodejs/express/examples/quickstart.js
 create mode 100644 integrations/nodejs/fastify/examples/api-collection/catalog/folder.yml
 create mode 100644 integrations/nodejs/fastify/examples/api-collection/catalog/get product.yml
 create mode 100644 integrations/nodejs/fastify/examples/api-collection/catalog/list products.yml
 create mode 100644 integrations/nodejs/fastify/examples/api-collection/opencollection.yml
 create mode 100644 integrations/nodejs/fastify/examples/auth.js
 create mode 100644 integrations/nodejs/fastify/examples/csp.js
 create mode 100644 integrations/nodejs/fastify/examples/embed.js
 create mode 100644 integrations/nodejs/fastify/examples/quickstart.js
 delete mode 100644 integrations/nodejs/nestjs/example/server.js
 create mode 100644 integrations/nodejs/nestjs/examples/01-quickstart/app.module.ts
 create mode 100644 integrations/nodejs/nestjs/examples/01-quickstart/main.ts
 create mode 100644 integrations/nodejs/nestjs/examples/02-auth/app.module.ts
 create mode 100644 integrations/nodejs/nestjs/examples/02-auth/main.ts
 create mode 100644 integrations/nodejs/nestjs/examples/03-global-prefix/app.module.ts
 create mode 100644 integrations/nodejs/nestjs/examples/03-global-prefix/main.ts
 create mode 100644 integrations/nodejs/nestjs/examples/04-fastify-adapter/app.module.ts
 create mode 100644 integrations/nodejs/nestjs/examples/04-fastify-adapter/main.ts
 create mode 100644 integrations/nodejs/nestjs/examples/05-csp/app.module.ts
 create mode 100644 integrations/nodejs/nestjs/examples/05-csp/main.ts
 create mode 100644 integrations/nodejs/nestjs/examples/06-embed/app.module.ts
 create mode 100644 integrations/nodejs/nestjs/examples/06-embed/main.ts
 create mode 100644 integrations/nodejs/nestjs/examples/06-embed/portal.controller.ts
 create mode 100644 integrations/nodejs/nestjs/examples/api-collection/catalog/folder.yml
 create mode 100644 integrations/nodejs/nestjs/examples/api-collection/catalog/get product.yml
 create mode 100644 integrations/nodejs/nestjs/examples/api-collection/catalog/list products.yml
 create mode 100644 integrations/nodejs/nestjs/examples/api-collection/opencollection.yml
 create mode 100644 integrations/nodejs/nestjs/examples/tsconfig.json

diff --git a/integrations/.dockerignore b/integrations/.dockerignore
index 12006333..d55e2642 100644
--- a/integrations/.dockerignore
+++ b/integrations/.dockerignore
@@ -5,3 +5,4 @@ nodejs/*/dist
 shell/shell.js
 nodejs/*/shell
 test-results
+nodejs/nestjs/examples/dist
diff --git a/integrations/contract-tests/apps/express.js b/integrations/contract-tests/apps/express.js
new file mode 100644
index 00000000..280af5de
--- /dev/null
+++ b/integrations/contract-tests/apps/express.js
@@ -0,0 +1,61 @@
+'use strict';
+
+const express = require('express');
+const helmet = require('helmet');
+const { apiDocs, embed } = require('@usebruno/api-docs-express');
+
+const PORT = Number(process.env.PORT || 5456);
+// relative on purpose: the core resolves it against this file, not the cwd, and check.sh boots
+// from a different directory to prove it
+const COLLECTION = '../fixtures/api-collection';
+const BUNDLED = '../fixtures/bundled.yml';
+
+const app = express();
+
+// the CSP the README documents: 'self' covers shell.js, the CDN serves the renderer, and the
+// renderer's wasm sandbox needs 'wasm-unsafe-eval' to instantiate and data: to be fetched
+app.use(
+  helmet({
+    contentSecurityPolicy: {
+      directives: {
+        scriptSrc: ["'self'", 'https://cdn.usebruno.com', "'wasm-unsafe-eval'"],
+        styleSrc: ["'self'", "'unsafe-inline'", 'https://cdn.usebruno.com', 'https://fonts.googleapis.com'],
+        fontSrc: ["'self'", 'https://fonts.gstatic.com'],
+        connectSrc: ["'self'", 'data:']
+      }
+    }
+  })
+);
+
+app.get('/control', (req, res) => res.json({ ok: true, from: 'the app itself' }));
+
+app.use('/docs', apiDocs({
+  collection: COLLECTION,
+  environments: { include: ['Local'] },
+  tags: { exclude: ['internal'] },
+  pageTitle: 'Acme API',
+  gitCollectionUrl: 'https://token:secret@github.com/acme/api-collection'
+}));
+
+app.use('/api/v2/docs', apiDocs({ collection: COLLECTION, environments: { all: true, exclude: ['Prod'] } }));
+
+app.use('/internal/docs', apiDocs({ collection: COLLECTION }));
+
+app.use('/bundled/docs', apiDocs({ collection: BUNDLED }));
+
+app.use('/broken/docs', apiDocs({ collection: './there-is-no-collection-here' }));
+
+// the docs inside the host's own page: the mount serves, the block only points at it
+app.use('/portal/docs', apiDocs({ collection: COLLECTION, environments: { include: ['Local'] } }));
+app.get('/portal', (req, res) => {
+  res.type('html').send(`<!doctype html>
+<html lang="en"><head><meta charset="utf-8"><title>Acme Developer Portal</title></head>
+<body>
+  <h1>Acme Developer Portal</h1>
+  ${embed({ base: '/portal/docs' })}
+</body></html>`);
+});
+
+app.listen(PORT, () => {
+  console.log(`express rig on http://localhost:${PORT}`);
+});
diff --git a/integrations/nodejs/fastify/example/server.js b/integrations/contract-tests/apps/fastify.js
similarity index 79%
rename from integrations/nodejs/fastify/example/server.js
rename to integrations/contract-tests/apps/fastify.js
index 3ce6f632..7625d59b 100644
--- a/integrations/nodejs/fastify/example/server.js
+++ b/integrations/contract-tests/apps/fastify.js
@@ -5,14 +5,13 @@ const { apiDocs } = require('@usebruno/api-docs-fastify');
 
 const PORT = Number(process.env.PORT || 5457);
 // relative on purpose: the core resolves it against this file, not the cwd
-const COLLECTION = process.env.COLLECTION || '../../../contract-tests/fixtures/api-collection';
-const BUNDLED = process.env.BUNDLED || '../../../contract-tests/fixtures/bundled.yml';
+const COLLECTION = '../fixtures/api-collection';
+const BUNDLED = '../fixtures/bundled.yml';
 
 const app = Fastify({ logger: false });
 
-
-// the same strict CSP the Express example sets with helmet, by hand here so the example
-// stays free of a plugin the contract does not depend on
+// the same CSP the Express rig sets with helmet, by hand so the rig stays free of a plugin the
+// contract does not depend on
 app.addHook('onSend', async (request, reply) => {
   reply.header(
     'content-security-policy',
@@ -20,7 +19,6 @@ app.addHook('onSend', async (request, reply) => {
     + "script-src 'self' https://cdn.usebruno.com 'wasm-unsafe-eval'; "
     + "style-src 'self' 'unsafe-inline' https://cdn.usebruno.com https://fonts.googleapis.com; "
     + "font-src 'self' https://fonts.gstatic.com; "
-    // data: because the renderer fetches its wasm sandbox from a data URI
     + "connect-src 'self' data:"
   );
 });
@@ -55,7 +53,7 @@ async function main() {
   await app.register(apiDocs, { prefix: '/broken/docs', collection: './there-is-no-collection-here' });
 
   await app.listen({ port: PORT, host: '127.0.0.1' });
-  console.log(`fastify example on http://localhost:${PORT}`);
+  console.log(`fastify rig on http://localhost:${PORT}`);
 }
 
 main();
diff --git a/integrations/contract-tests/apps/nestjs.js b/integrations/contract-tests/apps/nestjs.js
new file mode 100644
index 00000000..1a3c1038
--- /dev/null
+++ b/integrations/contract-tests/apps/nestjs.js
@@ -0,0 +1,68 @@
+'use strict';
+
+require('reflect-metadata');
+const { Module } = require('@nestjs/common');
+const { NestFactory } = require('@nestjs/core');
+const helmet = require('helmet');
+const { ApiDocsModule } = require('@usebruno/api-docs-nestjs');
+
+const PORT = Number(process.env.PORT || 5458);
+// ADAPTER=fastify runs the same app on platform-fastify. The wrapper is unchanged between them;
+// what differs is that middie leaves req.url as '/', which is why the mount path is an option.
+const ADAPTER = process.env.ADAPTER || 'express';
+// relative on purpose: the core resolves it against this file, not the cwd
+const COLLECTION = '../fixtures/api-collection';
+const BUNDLED = '../fixtures/bundled.yml';
+
+// plain JS, so the decorator is applied as the function it is. The real Nest examples live in
+// nodejs/nestjs/examples and are TypeScript.
+class AppModule {}
+Module({
+  imports: [
+    ApiDocsModule.forRoot({
+      mountPath: '/docs',
+      collection: COLLECTION,
+      environments: { include: ['Local'] },
+      tags: { exclude: ['internal'] },
+      pageTitle: 'Acme API',
+      gitCollectionUrl: 'https://token:secret@github.com/acme/api-collection'
+    }),
+    ApiDocsModule.forRoot({
+      mountPath: '/api/v2/docs',
+      collection: COLLECTION,
+      environments: { all: true, exclude: ['Prod'] }
+    }),
+    ApiDocsModule.forRoot({ mountPath: '/internal/docs', collection: COLLECTION }),
+    ApiDocsModule.forRoot({ mountPath: '/bundled/docs', collection: BUNDLED }),
+    ApiDocsModule.forRoot({ mountPath: '/broken/docs', collection: './there-is-no-collection-here' })
+  ]
+})(AppModule);
+
+async function main() {
+  let app;
+  if (ADAPTER === 'fastify') {
+    const { FastifyAdapter } = require('@nestjs/platform-fastify');
+    app = await NestFactory.create(AppModule, new FastifyAdapter(), { logger: false });
+  } else {
+    app = await NestFactory.create(AppModule, { logger: false });
+  }
+
+  app.use(helmet({
+    contentSecurityPolicy: {
+      directives: {
+        scriptSrc: ["'self'", 'https://cdn.usebruno.com', "'wasm-unsafe-eval'"],
+        styleSrc: ["'self'", "'unsafe-inline'", 'https://cdn.usebruno.com', 'https://fonts.googleapis.com'],
+        fontSrc: ["'self'", 'https://fonts.gstatic.com'],
+        connectSrc: ["'self'", 'data:']
+      }
+    }
+  }));
+
+  // the host's own route, straight on the adapter: both adapters take (req, res) and both `.send`
+  app.getHttpAdapter().get('/control', (req, res) => res.send({ ok: true, from: 'the app itself' }));
+
+  await app.listen(PORT, '127.0.0.1');
+  console.log(`nestjs rig on http://localhost:${PORT} (platform-${ADAPTER})`);
+}
+
+main();
diff --git a/integrations/contract-tests/browser/playwright.config.mjs b/integrations/contract-tests/browser/playwright.config.mjs
index 9e4c0397..a8911201 100644
--- a/integrations/contract-tests/browser/playwright.config.mjs
+++ b/integrations/contract-tests/browser/playwright.config.mjs
@@ -4,9 +4,9 @@ import { defineConfig } from '@playwright/test';
 
 const ROOT = path.join(path.dirname(fileURLToPath(import.meta.url)), '..', '..');
 
-// EXAMPLE and PORT are how another language core points this at its own server. The spec itself
+// APP and PORT are how another language core points this at its own server. The spec itself
 // asserts only what the contract promises, so it does not care which one booted.
-const EXAMPLE = process.env.EXAMPLE || 'nodejs/express/example/server.js';
+const APP = process.env.APP || 'contract-tests/apps/express.js';
 const PORT = process.env.PORT || '5462';
 
 export default defineConfig({
@@ -21,7 +21,7 @@ export default defineConfig({
     trace: 'retain-on-failure'
   },
   webServer: {
-    command: `node ${EXAMPLE}`,
+    command: `node ${APP}`,
     cwd: ROOT,
     env: { ...process.env, PORT },
     port: Number(PORT),
diff --git a/integrations/contract-tests/check.sh b/integrations/contract-tests/check.sh
index 0265fcee..50e30b40 100755
--- a/integrations/contract-tests/check.sh
+++ b/integrations/contract-tests/check.sh
@@ -1,13 +1,13 @@
 #!/usr/bin/env bash
 # The HTTP contract every wrapper, in every framework, in every language must satisfy.
-# Boots one example, asserts from outside it, exits non-zero on any miss.
+# Boots one rig from contract-tests/apps, asserts from outside it, exits non-zero on any miss.
 #
-#   bash contract-tests/check.sh --example nodejs/express/example/server.js --port 5456
-#   bash contract-tests/check.sh --example ... --save /tmp/express      keep the served bodies
-#   bash contract-tests/check.sh --example ... --compare /tmp/express   diff bodies against a run
+#   bash contract-tests/check.sh --app contract-tests/apps/express.js --port 5456
+#   bash contract-tests/check.sh --app ... --save /tmp/express      keep the served bodies
+#   bash contract-tests/check.sh --app ... --compare /tmp/express   diff bodies against a run
 #
-# Every example serves the same five mounts over the same fixture. That convention is what makes
-# one script cover the whole matrix: a cell is an invocation, not an edit.
+# Every rig serves the same five mounts over the same fixture. That convention is what makes one
+# script cover the whole matrix: a cell is an invocation, not an edit.
 #
 #   /docs          environments include Local, tags exclude internal, pageTitle, gitCollectionUrl
 #   /api/v2/docs   environments all minus Prod
@@ -17,77 +17,35 @@
 set -euo pipefail
 
 ROOT="$(cd "$(dirname "$0")/.." && pwd)"
-EXAMPLE=""
+source "$ROOT/contract-tests/lib.sh"
+
+APP=""
 PORT=5456
 SAVE=""
 COMPARE=""
 
 while [ $# -gt 0 ]; do
   case "$1" in
-    --example) EXAMPLE="$2"; shift 2 ;;
+    --app) APP="$2"; shift 2 ;;
     --port) PORT="$2"; shift 2 ;;
     --save) SAVE="$2"; shift 2 ;;
     --compare) COMPARE="$2"; shift 2 ;;
     *) echo "unknown argument: $1" >&2; exit 2 ;;
   esac
 done
-[ -n "$EXAMPLE" ] || { echo "--example is required" >&2; exit 2; }
-case "$EXAMPLE" in /*) ;; *) EXAMPLE="$ROOT/$EXAMPLE" ;; esac
-[ -f "$EXAMPLE" ] || { echo "no example at $EXAMPLE" >&2; exit 2; }
+[ -n "$APP" ] || { echo "--app is required" >&2; exit 2; }
+case "$APP" in /*) ;; *) APP="$ROOT/$APP" ;; esac
+[ -f "$APP" ] || { echo "no app at $APP" >&2; exit 2; }
 
 BASE="http://localhost:$PORT"
 TMP="$(mktemp -d)"
-# stderr goes first: the shell announces a killed background job, and that reads like a failure
-trap 'exec 2>/dev/null; pkill -P "${SERVER_PID:-0}" || true; kill "${SERVER_PID:-0}" || true; rm -rf "$TMP"' EXIT
-
-pass=0
-fail=0
-check() {
-  local name=$1
-  shift
-  if "$@"; then
-    pass=$((pass + 1))
-    printf '  ok   %s\n' "$name"
-  else
-    fail=$((fail + 1))
-    printf '  FAIL %s\n' "$name"
-  fi
-}
-
-# ---- helpers: each asserts exactly one fact ---------------------------------
-
-status_is() { [ "$(curl -s -o /dev/null -w '%{http_code}' "${@:2}")" = "$1" ]; }
-header_of() { curl -s -D - -o /dev/null "${@:2}" | tr -d '\r' | awk -v k="$1" 'tolower($1)==tolower(k":"){sub(/^[^:]*: */,"");print}'; }
-header_has() { local name=$1 want=$2; shift 2; header_of "$name" "$@" | grep -q "$want"; }
-header_absent() { local name=$1; shift; [ -z "$(header_of "$name" "$@")" ]; }
-body_has() { grep -q "$2" <<<"$(curl -s "$1")"; }
-body_lacks() { ! grep -Eq "$2" <<<"$(curl -s "$1")"; }
-file_has() { grep -q "$2" "$1"; }
-file_lacks() { ! grep -q "$2" "$1"; }
-revalidates() { status_is 304 -H "If-None-Match: $(header_of ETag "$1")" "$1"; }
-redirects_to() { status_is 301 "$1" && [ "$(header_of Location "$1")" = "$2" ]; }
-paths_in() { node -e 'const d=JSON.parse(require("fs").readFileSync(process.argv[1],"utf8"));console.log(Object.keys(d.files).sort().join(","))' "$1"; }
-paths_are() { [ "$(paths_in "$1")" = "$2" ]; }
-none_mention() { ! grep -q "$1" "${@:2}"; }
-no_origins() { ! grep -oE 'https?://[A-Za-z0-9./_-]+' "$1" | grep -q .; }
-occurs_once() { [ "$(curl -s "$1" | grep -c "$2")" = "1" ]; }
-config_of() { curl -s "$1" | grep -o 'data-config="[^"]*"'; }
-config_lacks() { ! config_of "$1" | grep -Eq "&quot;($2)&quot;:"; }
+trap 'stop; rm -rf "$TMP"' EXIT
 
 # ---- boot, from a different cwd on purpose ---------------------------------
 
-# a leftover server on this port would answer every assertion, and the suite would be grading
-# the wrong process. Say so once, instead of failing fifty times.
-if curl -s -o /dev/null --max-time 1 "$BASE/control"; then
-  echo "port $PORT is already serving something. Stop it, or pass --port." >&2
-  exit 2
-fi
-
-( cd "$TMP" && PORT="$PORT" node "$EXAMPLE" >"$TMP/server.log" 2>&1 ) &
-SERVER_PID=$!
-for _ in $(seq 1 60); do curl -s -o /dev/null "$BASE/control" && break; sleep 0.1; done
-curl -s -o /dev/null "$BASE/control" || { echo "server did not start"; cat "$TMP/server.log"; exit 1; }
-echo "booted $(basename "$(dirname "$(dirname "$EXAMPLE")")")/$(basename "$EXAMPLE") on :$PORT from $TMP"
+port_is_free "$PORT"
+boot "$APP" "$PORT"
+echo "booted $(basename "$APP") on :$PORT from $TMP"
 
 # ---- the routes, identical at every mount ----------------------------------
 
diff --git a/integrations/contract-tests/examples.sh b/integrations/contract-tests/examples.sh
new file mode 100644
index 00000000..0bcc6d92
--- /dev/null
+++ b/integrations/contract-tests/examples.sh
@@ -0,0 +1,148 @@
+#!/usr/bin/env bash
+# Every example under nodejs/*/examples boots and does what its own file says it does. One at a
+# time on one port, the way a reader runs them. The Nest ones run from their compiled dist, which
+# is the point of writing them in TypeScript.
+#
+#   bash contract-tests/examples.sh [--port 5480]
+set -euo pipefail
+
+ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+source "$ROOT/contract-tests/lib.sh"
+
+PORT=5480
+while [ $# -gt 0 ]; do
+  case "$1" in
+    --port) PORT="$2"; shift 2 ;;
+    *) echo "unknown argument: $1" >&2; exit 2 ;;
+  esac
+done
+
+BASE="http://localhost:$PORT"
+TMP="$(mktemp -d)"
+trap 'stop; rm -rf "$TMP"' EXIT
+port_is_free "$PORT"
+
+# example FILE: stops the one before, boots this one
+example() {
+  stop
+  echo
+  echo "== ${1#nodejs/}"
+  boot "$ROOT/$1" "$PORT"
+}
+
+CSP="Content-Security-Policy"
+BEARER=(-H 'Authorization: Bearer let-me-in')
+API_KEY=(-H 'x-api-key: let-me-in')
+
+# ---- express -------------------------------------------------------------------
+
+example nodejs/express/examples/quickstart.js
+check "/docs -> 301 docs/"                       redirects_to "$BASE/docs" "docs/"
+check "/docs/ -> the page"                       header_has Content-Type text/html "$BASE/docs/"
+check "/docs/shell.js -> 200"                    status_is 200 "$BASE/docs/shell.js"
+check "the collection is the one beside it"      body_has "$BASE/docs/collection.yml" 'Acme API'
+check "/health is the app's own"                 status_is 200 "$BASE/health"
+
+example nodejs/express/examples/auth.js
+check "/health stays open"                       status_is 200 "$BASE/health"
+check "/docs/ -> 401"                            status_is 401 "$BASE/docs/"
+check "/docs/ says how to authenticate"          header_has WWW-Authenticate Bearer "$BASE/docs/"
+check "/docs/collection.yml -> 401"              status_is 401 "$BASE/docs/collection.yml"
+check "/docs/shell.js -> 401"                    status_is 401 "$BASE/docs/shell.js"
+check "/docs -> 401, the guard is before the redirect" status_is 401 "$BASE/docs"
+check "/docs/ with the token -> 200"             status_is 200 "${BEARER[@]}" "$BASE/docs/"
+check "/docs/collection.yml with the token -> 200" status_is 200 "${BEARER[@]}" "$BASE/docs/collection.yml"
+
+example nodejs/express/examples/csp.js
+check "/docs/ -> 200"                            status_is 200 "$BASE/docs/"
+check "script-src allows the CDN and wasm"       header_has "$CSP" "script-src 'self' https://cdn.usebruno.com 'wasm-unsafe-eval'" "$BASE/docs/"
+check "connect-src allows data:"                 header_has "$CSP" "connect-src 'self' data:" "$BASE/docs/"
+check "style-src allows the fonts"               header_has "$CSP" "fonts.googleapis.com" "$BASE/docs/"
+
+example nodejs/express/examples/embed.js
+check "/ is the host's own page"                 body_has "$BASE/" 'Acme Developer Portal'
+check "with the docs block in it"                body_has "$BASE/" 'id="bruno-docs"'
+check "loading from the mount"                   body_has "$BASE/" 'src="/docs/shell.js"'
+check "one document, not two"                    occurs_once "$BASE/" '<html'
+check "the mount serves the collection"          body_has "$BASE/docs/collection.yml" 'Acme API'
+
+# ---- fastify -------------------------------------------------------------------
+
+example nodejs/fastify/examples/quickstart.js
+check "/docs -> 301 docs/"                       redirects_to "$BASE/docs" "docs/"
+check "/docs/ -> the page"                       header_has Content-Type text/html "$BASE/docs/"
+check "/docs/shell.js -> 200"                    status_is 200 "$BASE/docs/shell.js"
+check "the collection is the one beside it"      body_has "$BASE/docs/collection.yml" 'Acme API'
+check "/health is the app's own"                 status_is 200 "$BASE/health"
+
+example nodejs/fastify/examples/auth.js
+check "/health stays open"                       status_is 200 "$BASE/health"
+check "/docs/ -> 401"                            status_is 401 "$BASE/docs/"
+check "/docs/ says how to authenticate"          header_has WWW-Authenticate Bearer "$BASE/docs/"
+check "/docs/collection.yml -> 401"              status_is 401 "$BASE/docs/collection.yml"
+check "/docs/shell.js -> 401"                    status_is 401 "$BASE/docs/shell.js"
+check "/docs -> 401, the guard is before the redirect" status_is 401 "$BASE/docs"
+check "POST /docs/ -> 401, the guard is before the 405" status_is 401 -X POST "$BASE/docs/"
+check "/docs/ with the token -> 200"             status_is 200 "${BEARER[@]}" "$BASE/docs/"
+check "/docs/collection.yml with the token -> 200" status_is 200 "${BEARER[@]}" "$BASE/docs/collection.yml"
+
+example nodejs/fastify/examples/csp.js
+check "/docs/ -> 200"                            status_is 200 "$BASE/docs/"
+check "script-src allows the CDN and wasm"       header_has "$CSP" "script-src 'self' https://cdn.usebruno.com 'wasm-unsafe-eval'" "$BASE/docs/"
+check "connect-src allows data:"                 header_has "$CSP" "connect-src 'self' data:" "$BASE/docs/"
+check "style-src allows the fonts"               header_has "$CSP" "fonts.googleapis.com" "$BASE/docs/"
+
+example nodejs/fastify/examples/embed.js
+check "/ is the host's own page"                 body_has "$BASE/" 'Acme Developer Portal'
+check "with the docs block in it"                body_has "$BASE/" 'id="bruno-docs"'
+check "loading from the mount"                   body_has "$BASE/" 'src="/docs/shell.js"'
+check "one document, not two"                    occurs_once "$BASE/" '<html'
+check "the mount serves the collection"          body_has "$BASE/docs/collection.yml" 'Acme API'
+
+# ---- nestjs, from the compiled dist -------------------------------------------------
+
+example nodejs/nestjs/examples/dist/01-quickstart/main.js
+check "/docs -> 301 docs/"                       redirects_to "$BASE/docs" "docs/"
+check "/docs/ -> the page"                       header_has Content-Type text/html "$BASE/docs/"
+check "/docs/shell.js -> 200"                    status_is 200 "$BASE/docs/shell.js"
+check "the collection resolved from dist/"       body_has "$BASE/docs/collection.yml" 'Acme API'
+
+example nodejs/nestjs/examples/dist/02-auth/main.js
+check "/docs/ stays open"                        status_is 200 "$BASE/docs/"
+check "/internal/docs/ -> 401"                   status_is 401 "$BASE/internal/docs/"
+check "/internal/docs/collection.yml -> 401"     status_is 401 "$BASE/internal/docs/collection.yml"
+check "/internal/docs/shell.js -> 401"           status_is 401 "$BASE/internal/docs/shell.js"
+check "/internal/docs -> 401, the guard is before the redirect" status_is 401 "$BASE/internal/docs"
+check "/internal/docs/ with the key -> 200"      status_is 200 "${API_KEY[@]}" "$BASE/internal/docs/"
+check "/internal/docs/collection.yml with the key -> 200" status_is 200 "${API_KEY[@]}" "$BASE/internal/docs/collection.yml"
+
+example nodejs/nestjs/examples/dist/03-global-prefix/main.js
+check "/docs/ -> 404, it moved"                  status_is 404 "$BASE/docs/"
+check "/api/docs -> 301 docs/"                   redirects_to "$BASE/api/docs" "docs/"
+check "/api/docs/ -> the page"                   header_has Content-Type text/html "$BASE/api/docs/"
+check "/api/docs/shell.js -> 200"                status_is 200 "$BASE/api/docs/shell.js"
+check "/api/docs/collection.yml -> the collection" body_has "$BASE/api/docs/collection.yml" 'Acme API'
+
+example nodejs/nestjs/examples/dist/04-fastify-adapter/main.js
+check "/docs -> 301 docs/"                       redirects_to "$BASE/docs" "docs/"
+check "/docs/ -> the page"                       header_has Content-Type text/html "$BASE/docs/"
+check "/docs/shell.js -> 200, not the page"      header_has Content-Type javascript "$BASE/docs/shell.js"
+check "/docs/collection.yml -> the collection"   body_has "$BASE/docs/collection.yml" 'Acme API'
+check "/docs/<deep>/ -> the page"                header_has Content-Type text/html "$BASE/docs/catalog/list-products/"
+
+example nodejs/nestjs/examples/dist/05-csp/main.js
+check "/docs/ -> 200"                            status_is 200 "$BASE/docs/"
+check "script-src allows the CDN and wasm"       header_has "$CSP" "script-src 'self' https://cdn.usebruno.com 'wasm-unsafe-eval'" "$BASE/docs/"
+check "connect-src allows data:"                 header_has "$CSP" "connect-src 'self' data:" "$BASE/docs/"
+check "style-src allows the fonts"               header_has "$CSP" "fonts.googleapis.com" "$BASE/docs/"
+
+example nodejs/nestjs/examples/dist/06-embed/main.js
+check "/ is the host's own page"                 body_has "$BASE/" 'Acme Developer Portal'
+check "with the docs block in it"                body_has "$BASE/" 'id="bruno-docs"'
+check "loading from the mount"                   body_has "$BASE/" 'src="/docs/shell.js"'
+check "one document, not two"                    occurs_once "$BASE/" '<html'
+check "the mount serves the collection"          body_has "$BASE/docs/collection.yml" 'Acme API'
+
+echo
+echo "$pass passed, $fail failed"
+[ "$fail" -eq 0 ]
diff --git a/integrations/contract-tests/lib.sh b/integrations/contract-tests/lib.sh
new file mode 100644
index 00000000..e650d27b
--- /dev/null
+++ b/integrations/contract-tests/lib.sh
@@ -0,0 +1,67 @@
+# Shared by check.sh and examples.sh: boot a Node app on a port, assert one fact at a time from
+# outside it, count what passed. Needs $TMP for the server log; sets SERVER_PID.
+
+pass=0
+fail=0
+check() {
+  local name=$1
+  shift
+  if "$@"; then
+    pass=$((pass + 1))
+    printf '  ok   %s\n' "$name"
+  else
+    fail=$((fail + 1))
+    printf '  FAIL %s\n' "$name"
+  fi
+}
+
+# ---- the server ---------------------------------------------------------------
+
+# a leftover server on the port would answer every assertion, and the suite would be grading the
+# wrong process. Say so once, instead of failing fifty times.
+port_is_free() {
+  if curl -s -o /dev/null --max-time 1 "http://localhost:$1/"; then
+    echo "port $1 is already serving something. Stop it, or pass --port." >&2
+    exit 2
+  fi
+}
+
+# boot FILE PORT: from a different cwd on purpose, so a path that only works from the project
+# root is caught here. Ready means the port answers anything at all.
+boot() {
+  ( cd "$TMP" && PORT="$2" node "$1" >"$TMP/server.log" 2>&1 ) &
+  SERVER_PID=$!
+  for _ in $(seq 1 60); do curl -s -o /dev/null "http://localhost:$2/" && break; sleep 0.1; done
+  curl -s -o /dev/null "http://localhost:$2/" || { echo "server did not start"; cat "$TMP/server.log"; exit 1; }
+}
+
+# quietly: the shell announces a killed background job, and that reads like a failure
+stop() {
+  [ -n "${SERVER_PID:-}" ] || return 0
+  {
+    pkill -P "$SERVER_PID" || true
+    kill "$SERVER_PID" || true
+    wait "$SERVER_PID" || true
+  } 2>/dev/null
+  SERVER_PID=""
+}
+
+# ---- helpers: each asserts exactly one fact -----------------------------------
+
+status_is() { [ "$(curl -s -o /dev/null -w '%{http_code}' "${@:2}")" = "$1" ]; }
+header_of() { curl -s -D - -o /dev/null "${@:2}" | tr -d '\r' | awk -v k="$1" 'tolower($1)==tolower(k":"){sub(/^[^:]*: */,"");print}'; }
+header_has() { local name=$1 want=$2; shift 2; header_of "$name" "$@" | grep -q "$want"; }
+header_absent() { local name=$1; shift; [ -z "$(header_of "$name" "$@")" ]; }
+body_has() { grep -q "$2" <<<"$(curl -s "$1")"; }
+body_lacks() { ! grep -Eq "$2" <<<"$(curl -s "$1")"; }
+file_has() { grep -q "$2" "$1"; }
+file_lacks() { ! grep -q "$2" "$1"; }
+revalidates() { status_is 304 -H "If-None-Match: $(header_of ETag "$1")" "$1"; }
+redirects_to() { status_is 301 "$1" && [ "$(header_of Location "$1")" = "$2" ]; }
+paths_in() { node -e 'const d=JSON.parse(require("fs").readFileSync(process.argv[1],"utf8"));console.log(Object.keys(d.files).sort().join(","))' "$1"; }
+paths_are() { [ "$(paths_in "$1")" = "$2" ]; }
+none_mention() { ! grep -q "$1" "${@:2}"; }
+no_origins() { ! grep -oE 'https?://[A-Za-z0-9./_-]+' "$1" | grep -q .; }
+occurs_once() { [ "$(curl -s "$1" | grep -c "$2")" = "1" ]; }
+config_of() { curl -s "$1" | grep -o 'data-config="[^"]*"'; }
+config_lacks() { ! config_of "$1" | grep -Eq "&quot;($2)&quot;:"; }
diff --git a/integrations/eslint.config.mjs b/integrations/eslint.config.mjs
index 8baa5d49..f954c87b 100644
--- a/integrations/eslint.config.mjs
+++ b/integrations/eslint.config.mjs
@@ -24,7 +24,7 @@ export default [
         ...globals.node
       }
     },
-    files: ['eslint.config.mjs', '**/src/**/*.ts', '**/test/**/*.{ts,mjs}'],
+    files: ['eslint.config.mjs', '**/src/**/*.ts', '**/test/**/*.{ts,mjs}', 'contract-tests/apps/*.js', '**/examples/**/*.{js,ts}'],
     rules: {
       ...js.configs.recommended.rules,
       ...stylistic.configs.customize({
@@ -33,6 +33,7 @@ export default [
         semi: true,
         jsx: false
       }).rules,
+      '@stylistic/quotes': ['error', 'single', { avoidEscape: true }],
       '@stylistic/comma-dangle': ['error', 'never'],
       '@stylistic/brace-style': ['error', '1tbs', { allowSingleLine: true }],
       '@stylistic/arrow-parens': ['error', 'always'],
@@ -90,11 +91,7 @@ export default [
     }
   },
   {
-    files: ['**/example/**/*.{js,mjs,cjs}'],
-    languageOptions: {
-      sourceType: 'commonjs',
-      globals: { ...globals.node }
-    },
+    files: ['contract-tests/apps/*.js', '**/examples/**/*.{js,ts}'],
     rules: {
       'no-console': 'off'
     }
diff --git a/integrations/nodejs/core/src/create-docs.ts b/integrations/nodejs/core/src/create-docs.ts
index cfbfff4a..d9eae99e 100644
--- a/integrations/nodejs/core/src/create-docs.ts
+++ b/integrations/nodejs/core/src/create-docs.ts
@@ -1,4 +1,4 @@
-import { validateOptions, ConfigError, type ApiDocsOptions } from './options';
+import { validateOptions, type ApiDocsOptions } from './options';
 import type { HttpResponse, Conditional } from './http';
 import { log } from './log';
 import { providerFor } from './collection';
@@ -11,7 +11,6 @@ export interface Docs {
   shell(base: string): HttpResponse;
   shellJs(conditional?: Conditional): HttpResponse;
   collection(conditional?: Conditional): HttpResponse;
-  embed(opts: { base: string }): string;
 }
 
 export function createDocs(options: ApiDocsOptions): Docs {
@@ -32,13 +31,6 @@ function liveDocs(shell: Shell, provider: Provider): Docs {
     shell: (base) => shell.html(base),
     shellJs: (conditional = {}) => shell.js(conditional),
     collection: (conditional = {}) => provider(conditional),
-    embed: ({ base }) => {
-      if (!base) {
-        throw new ConfigError('embed: `base` (the docs mount, e.g. "/docs") is required');
-      }
-
-      return shell.embed(base.endsWith('/') ? base : base + '/');
-    },
     handler: () => createHandler(docs)
   };
 
@@ -50,7 +42,6 @@ function failedDocs(serve: Provider): Docs {
     shell: () => serve({}),
     shellJs: () => serve({}),
     collection: () => serve({}),
-    embed: () => `<!-- bruno api docs: ${String(serve({}).body).trim()} -->`,
     handler: () => createHandler(docs)
   };
 
diff --git a/integrations/nodejs/core/src/index.ts b/integrations/nodejs/core/src/index.ts
index 64cbcf0d..95f08b7d 100644
--- a/integrations/nodejs/core/src/index.ts
+++ b/integrations/nodejs/core/src/index.ts
@@ -1,7 +1,9 @@
 export { createDocs } from './create-docs';
+export { embed } from './routes/shell';
 export { ConfigError } from './options';
 
 export type { Docs } from './create-docs';
+export type { EmbedOptions } from './routes/shell';
 export type { ApiDocsOptions, CollectionOptions, RendererOptions, EnvironmentsOption, TagsOption } from './options';
 export type { Handler, Request } from './routes/handler';
 export type { HttpResponse, Conditional } from './http';
diff --git a/integrations/nodejs/core/src/routes/shell.ts b/integrations/nodejs/core/src/routes/shell.ts
index ae4a92e9..c017c7ea 100644
--- a/integrations/nodejs/core/src/routes/shell.ts
+++ b/integrations/nodejs/core/src/routes/shell.ts
@@ -2,7 +2,7 @@
 
 import fs from 'node:fs';
 import path from 'node:path';
-import type { RendererOptions, ApiDocsOptions } from '../options';
+import { ConfigError, type RendererOptions, type ApiDocsOptions } from '../options';
 import { etagOf, type HttpResponse, type Conditional } from '../http';
 
 /** Hardcoded for the beta */
@@ -43,32 +43,51 @@ export function rendererConfig(options: RendererOptions): RendererOptions {
   return config;
 }
 
+let template: string | undefined;
+const templateHtml = (): string => (template ??= fs.readFileSync(path.join(SHELL_DIR, 'shell.html'), 'utf8'));
+
+const stamp = (base: string, title: string, options: RendererOptions): string =>
+  templateHtml()
+    .replaceAll('{{CDN}}', CDN)
+    .replaceAll('{{TITLE}}', escapeHtml(title))
+    .replaceAll('{{BASE}}', escapeHtml(base))
+    .replaceAll('{{CONFIG}}', escapeHtml(JSON.stringify(rendererConfig(options))));
+
+export interface EmbedOptions extends RendererOptions {
+  /** The docs mount the block loads shell.js and collection.yml from, e.g. `/docs`. */
+  base: string;
+}
+
+/**
+ * The docs block for a page of your own, body-only. Needs no collection: the mount serves that,
+ * the block only has to know where the mount is and what the renderer may see.
+ */
+export function embed({ base, ...options }: EmbedOptions): string {
+  if (!base) {
+    throw new ConfigError('embed: `base` (the docs mount, e.g. "/docs") is required');
+  }
+
+  const stamped = stamp(base.endsWith('/') ? base : base + '/', DEFAULT_TITLE, options);
+
+  return stamped.slice(stamped.indexOf(EMBED_START), stamped.indexOf(EMBED_END) + EMBED_END.length);
+}
+
 export interface Shell {
   html(base: string): HttpResponse;
   js(conditional: Conditional): HttpResponse;
-  embed(base: string): string;
 }
 
 export function loadShell(options: ApiDocsOptions): Shell {
-  const template = fs.readFileSync(path.join(SHELL_DIR, 'shell.html'), 'utf8');
   const script = fs.readFileSync(path.join(SHELL_DIR, 'shell.js'), 'utf8');
   const scriptEtag = etagOf(script);
-  const config = escapeHtml(JSON.stringify(rendererConfig(options)));
-  const title = escapeHtml(options.pageTitle ?? DEFAULT_TITLE);
-
-  const stamp = (base: string): string =>
-    template
-      .replaceAll('{{CDN}}', CDN)
-      .replaceAll('{{TITLE}}', title)
-      .replaceAll('{{BASE}}', escapeHtml(base))
-      .replaceAll('{{CONFIG}}', config);
+  const title = options.pageTitle ?? DEFAULT_TITLE;
 
   return {
     html(base): HttpResponse {
       return {
         status: 200,
         headers: { 'Content-Type': 'text/html; charset=utf-8', 'Cache-Control': 'no-cache' },
-        body: stamp(base)
+        body: stamp(base, title, options)
       };
     },
 
@@ -87,11 +106,6 @@ export function loadShell(options: ApiDocsOptions): Shell {
         },
         body: script
       };
-    },
-
-    embed(base): string {
-      const stamped = stamp(base);
-      return stamped.slice(stamped.indexOf(EMBED_START), stamped.indexOf(EMBED_END) + EMBED_END.length);
     }
   };
 }
diff --git a/integrations/nodejs/core/test/docs.test.mjs b/integrations/nodejs/core/test/docs.test.mjs
index 6a3945d1..1cc414e7 100644
--- a/integrations/nodejs/core/test/docs.test.mjs
+++ b/integrations/nodejs/core/test/docs.test.mjs
@@ -133,8 +133,6 @@ const handler = docs.handler();
     assert.match(String(res.body), /Collection not found/);
   }
 
-  assert.match(broken.embed({ base: '/docs' }), /<!-- bruno api docs: Collection not found/);
-
   const overCap = quiet(() => createDocs({
     collection: path.join(here, '..', '..', '..', 'contract-tests', 'fixtures', 'walk-oversize')
   }));
@@ -144,13 +142,5 @@ const handler = docs.handler();
   assert.equal(badOptions.collection().status, 500, 'a config error reaches the mount too, not the boot');
 }
 
-// --- embed(): the block only, with the mount stamped in
-{
-  const embed = docs.embed({ base: '/docs' });
-  assert.ok(embed.includes('src="/docs/shell.js"'), 'a base without a trailing slash still works');
-  assert.equal(docs.embed({ base: '/docs/' }), embed, 'with or without, the same block');
-  assert.throws(() => docs.embed({ base: '' }), /`base`/);
-}
-
 fs.rmSync(path.join(os.tmpdir(), 'x-not-there'), { force: true });
 console.log('docs-test: all assertions passed');
diff --git a/integrations/nodejs/core/test/shell.test.mjs b/integrations/nodejs/core/test/shell.test.mjs
index d980ebd4..a7addd69 100644
--- a/integrations/nodejs/core/test/shell.test.mjs
+++ b/integrations/nodejs/core/test/shell.test.mjs
@@ -9,7 +9,7 @@ import { createRequire } from 'node:module';
 const here = path.dirname(fileURLToPath(import.meta.url));
 const require = createRequire(import.meta.url);
 const dist = path.join(here, '..', 'dist');
-const { loadShell, rendererConfig, stripGitCredentials, CDN } = require(path.join(dist, 'routes', 'shell.js'));
+const { loadShell, embed, rendererConfig, stripGitCredentials, CDN } = require(path.join(dist, 'routes', 'shell.js'));
 
 // --- stamping: every placeholder is filled, at any mount
 {
@@ -107,13 +107,17 @@ const { loadShell, rendererConfig, stripGitCredentials, CDN } = require(path.joi
   assert.equal(loadShell({ collection: './c' }).html('/docs/').headers['Cache-Control'], 'no-cache');
 }
 
-// --- embed(): the body block only, for an adopter's own page
+// --- embed(): the body block only, for an adopter's own page. No collection involved.
 {
-  const embed = loadShell({ collection: './c' }).embed('/docs/');
-  assert.ok(!embed.includes('<html'), 'no document wrapper');
-  assert.ok(!embed.includes('<title'), 'the host page owns the title');
-  assert.ok(embed.includes('id="bruno-docs"') && embed.includes('src="/docs/shell.js"'));
-  assert.ok(embed.startsWith('<!-- embed:start -->') && embed.endsWith('<!-- embed:end -->'));
+  const block = embed({ base: '/docs' });
+  assert.ok(!block.includes('<html'), 'no document wrapper');
+  assert.ok(!block.includes('<title'), 'the host page owns the title');
+  assert.ok(block.includes('id="bruno-docs"') && block.includes('src="/docs/shell.js"'), 'a base without a trailing slash still works');
+  assert.ok(block.startsWith('<!-- embed:start -->') && block.endsWith('<!-- embed:end -->'));
+  assert.equal(embed({ base: '/docs/' }), block, 'with or without the slash, the same block');
+  assert.ok(embed({ base: '/docs', gitCollectionUrl: 'https://u:p@github.com/acme/api' }).includes('github.com/acme/api'), 'renderer options reach the block');
+  assert.ok(!embed({ base: '/docs', gitCollectionUrl: 'https://u:p@github.com/acme/api' }).includes('u:p@'), 'with credentials stripped, as on the page');
+  assert.throws(() => embed({ base: '' }), /`base`/);
 }
 
 // --- the built bundle the core ships
diff --git a/integrations/nodejs/express/example/server.js b/integrations/nodejs/express/example/server.js
deleted file mode 100644
index e397ddab..00000000
--- a/integrations/nodejs/express/example/server.js
+++ /dev/null
@@ -1,73 +0,0 @@
-'use strict';
-
-const path = require('node:path');
-const express = require('express');
-const helmet = require('helmet');
-const { apiDocs } = require('@usebruno/api-docs-express');
-const { createDocs } = require('@usebruno/api-docs-core');
-
-const PORT = Number(process.env.PORT || 5456);
-// relative on purpose: the core resolves it against this file, not the cwd, and check.sh
-// boots from a different directory to prove it. COLLECTION overrides it for pack-and-install,
-// which runs this example from a temp dir with the packages installed from tarballs.
-const COLLECTION = process.env.COLLECTION || '../../../contract-tests/fixtures/api-collection';
-const BUNDLED = process.env.BUNDLED || '../../../contract-tests/fixtures/bundled.yml';
-
-const app = express();
-
-// a strict CSP. scripts: 'self' covers shell.js, the CDN serves the renderer.
-// styles still need 'unsafe-inline' and Google Fonts until the renderer stops injecting its own.
-app.use(
-  helmet({
-    contentSecurityPolicy: {
-      directives: {
-        // wasm-unsafe-eval, narrowly, because the renderer instantiates a wasm sandbox
-        scriptSrc: ["'self'", 'https://cdn.usebruno.com', "'wasm-unsafe-eval'"],
-        styleSrc: ["'self'", "'unsafe-inline'", 'https://cdn.usebruno.com', 'https://fonts.googleapis.com'],
-        fontSrc: ["'self'", 'https://fonts.gstatic.com'],
-        // data: because the renderer fetches its wasm sandbox from a data URI
-        connectSrc: ["'self'", 'data:']
-      }
-    }
-  })
-);
-
-app.get('/control', (req, res) => res.json({ ok: true, from: 'the app itself' }));
-
-app.use('/docs', apiDocs({
-  collection: COLLECTION,
-  environments: { include: ['Local'] },
-  tags: { exclude: ['internal'] },
-  pageTitle: 'Acme API',
-  gitCollectionUrl: 'https://token:secret@github.com/acme/api-collection'
-}));
-
-app.use('/api/v2/docs', apiDocs({ collection: COLLECTION, environments: { all: true, exclude: ['Prod'] } }));
-
-app.use('/internal/docs', apiDocs({ collection: COLLECTION }));
-
-app.use('/bundled/docs', apiDocs({ collection: BUNDLED }));
-
-app.use('/broken/docs', apiDocs({ collection: './there-is-no-collection-here' }));
-
-// an adopter who wants the docs inside their own page asks the core for the block and puts it
-// where they like. The mount still has to exist: the block loads shell.js and collection.yml from it.
-const embedded = createDocs({ collection: COLLECTION, environments: { include: ['Local'] } });
-app.use('/portal/docs', apiDocs({ collection: COLLECTION, environments: { include: ['Local'] } }));
-app.get('/portal', (req, res) => {
-  res.type('html').send(`<!doctype html>
-<html lang="en"><head><meta charset="utf-8"><title>Acme Developer Portal</title></head>
-<body>
-  <h1>Acme Developer Portal</h1>
-  ${embedded.embed({ base: '/portal/docs' })}
-</body></html>`);
-});
-
-app.listen(PORT, () => {
-  console.log(`express example on http://localhost:${PORT}`);
-  console.log('  /docs/           Local only, internal-tagged requests hidden');
-  console.log('  /api/v2/docs/    every environment except Prod');
-  console.log('  /internal/docs/  defaults: no environments, every request');
-  console.log('  /bundled/docs/   a single bundled yml');
-  console.log('  /broken/docs/    a collection that is not there, to prove the app still starts');
-});
diff --git a/integrations/nodejs/express/examples/api-collection/catalog/folder.yml b/integrations/nodejs/express/examples/api-collection/catalog/folder.yml
new file mode 100644
index 00000000..11250ef1
--- /dev/null
+++ b/integrations/nodejs/express/examples/api-collection/catalog/folder.yml
@@ -0,0 +1,3 @@
+info:
+  name: Catalog
+  seq: 1
diff --git a/integrations/nodejs/express/examples/api-collection/catalog/get product.yml b/integrations/nodejs/express/examples/api-collection/catalog/get product.yml
new file mode 100644
index 00000000..dbd33356
--- /dev/null
+++ b/integrations/nodejs/express/examples/api-collection/catalog/get product.yml	
@@ -0,0 +1,7 @@
+info:
+  name: Get product
+  type: http
+  seq: 2
+http:
+  method: GET
+  url: https://api.acme.example/products/42
diff --git a/integrations/nodejs/express/examples/api-collection/catalog/list products.yml b/integrations/nodejs/express/examples/api-collection/catalog/list products.yml
new file mode 100644
index 00000000..653d6bcf
--- /dev/null
+++ b/integrations/nodejs/express/examples/api-collection/catalog/list products.yml	
@@ -0,0 +1,7 @@
+info:
+  name: List products
+  type: http
+  seq: 1
+http:
+  method: GET
+  url: https://api.acme.example/products
diff --git a/integrations/nodejs/express/examples/api-collection/opencollection.yml b/integrations/nodejs/express/examples/api-collection/opencollection.yml
new file mode 100644
index 00000000..36f29597
--- /dev/null
+++ b/integrations/nodejs/express/examples/api-collection/opencollection.yml
@@ -0,0 +1,5 @@
+opencollection: 1.0.0
+info:
+  name: Acme API
+  version: 1.0.0
+  summary: A small collection to see the docs with. Point the option at your own to replace it.
diff --git a/integrations/nodejs/express/examples/auth.js b/integrations/nodejs/express/examples/auth.js
new file mode 100644
index 00000000..d6cd60bd
--- /dev/null
+++ b/integrations/nodejs/express/examples/auth.js
@@ -0,0 +1,25 @@
+'use strict';
+
+const express = require('express');
+const { apiDocs } = require('@usebruno/api-docs-express');
+
+const app = express();
+const port = process.env.PORT ?? 3000;
+
+// stand-in for your real auth: a session check, an SSO middleware, whatever the app already uses
+const requireToken = (req, res, next) => {
+  if (req.headers.authorization !== 'Bearer let-me-in') {
+    res.set('WWW-Authenticate', 'Bearer').sendStatus(401);
+    return;
+  }
+
+  next();
+};
+
+app.get('/health', (req, res) => res.json({ ok: true }));
+
+// the guard runs before the docs on this mount and nowhere else. It covers collection.yml too,
+// which is the file that carries the collection's own auth and variables.
+app.use('/docs', requireToken, apiDocs({ collection: './api-collection' }));
+
+app.listen(port, () => console.log(`docs at http://localhost:${port}/docs/ (Authorization: Bearer let-me-in)`));
diff --git a/integrations/nodejs/express/examples/csp.js b/integrations/nodejs/express/examples/csp.js
new file mode 100644
index 00000000..8302de37
--- /dev/null
+++ b/integrations/nodejs/express/examples/csp.js
@@ -0,0 +1,28 @@
+'use strict';
+
+const express = require('express');
+const helmet = require('helmet');
+const { apiDocs } = require('@usebruno/api-docs-express');
+
+const app = express();
+const port = process.env.PORT ?? 3000;
+
+// what the docs page needs from a strict CSP. 'self' covers shell.js; the renderer itself comes
+// from cdn.usebruno.com and runs a wasm sandbox, which is what 'wasm-unsafe-eval' and data: are for.
+// Without these the page still loads and looks fine, and the errors are only in the console.
+app.use(helmet({
+  contentSecurityPolicy: {
+    directives: {
+      scriptSrc: ["'self'", 'https://cdn.usebruno.com', "'wasm-unsafe-eval'"],
+      styleSrc: ["'self'", "'unsafe-inline'", 'https://cdn.usebruno.com', 'https://fonts.googleapis.com'],
+      fontSrc: ["'self'", 'https://fonts.gstatic.com'],
+      connectSrc: ["'self'", 'data:']
+    }
+  }
+}));
+
+app.get('/health', (req, res) => res.json({ ok: true }));
+
+app.use('/docs', apiDocs({ collection: './api-collection' }));
+
+app.listen(port, () => console.log(`docs at http://localhost:${port}/docs/`));
diff --git a/integrations/nodejs/express/examples/embed.js b/integrations/nodejs/express/examples/embed.js
new file mode 100644
index 00000000..5de3c49e
--- /dev/null
+++ b/integrations/nodejs/express/examples/embed.js
@@ -0,0 +1,24 @@
+'use strict';
+
+const express = require('express');
+const { apiDocs, embed } = require('@usebruno/api-docs-express');
+
+const app = express();
+const port = process.env.PORT ?? 3000;
+
+// the docs inside a page of your own. The mount serves the collection and shell.js; the block
+// only has to know where the mount is.
+app.use('/docs', apiDocs({ collection: './api-collection' }));
+
+app.get('/', (req, res) => {
+  res.type('html').send(`<!doctype html>
+<html lang="en">
+<head><meta charset="utf-8"><title>Acme Developer Portal</title></head>
+<body>
+  <h1>Acme Developer Portal</h1>
+  ${embed({ base: '/docs' })}
+</body>
+</html>`);
+});
+
+app.listen(port, () => console.log(`portal at http://localhost:${port}/`));
diff --git a/integrations/nodejs/express/examples/quickstart.js b/integrations/nodejs/express/examples/quickstart.js
new file mode 100644
index 00000000..9c02d824
--- /dev/null
+++ b/integrations/nodejs/express/examples/quickstart.js
@@ -0,0 +1,14 @@
+'use strict';
+
+const express = require('express');
+const { apiDocs } = require('@usebruno/api-docs-express');
+
+const app = express();
+const port = process.env.PORT ?? 3000;
+
+app.get('/health', (req, res) => res.json({ ok: true }));
+
+// the path is relative to this file, not to where node was started
+app.use('/docs', apiDocs({ collection: './api-collection' }));
+
+app.listen(port, () => console.log(`docs at http://localhost:${port}/docs/`));
diff --git a/integrations/nodejs/express/src/index.ts b/integrations/nodejs/express/src/index.ts
index 003e26aa..5f983147 100644
--- a/integrations/nodejs/express/src/index.ts
+++ b/integrations/nodejs/express/src/index.ts
@@ -1,7 +1,8 @@
 import type { RequestHandler } from 'express';
-import { createDocs, type ApiDocsOptions } from '@usebruno/api-docs-core';
+import { createDocs, embed, type ApiDocsOptions } from '@usebruno/api-docs-core';
 
-export type { ApiDocsOptions, CollectionOptions, RendererOptions, EnvironmentsOption, TagsOption }
+export { createDocs, embed };
+export type { ApiDocsOptions, CollectionOptions, RendererOptions, EmbedOptions, EnvironmentsOption, TagsOption }
   from '@usebruno/api-docs-core';
 
 /**
diff --git a/integrations/nodejs/fastify/examples/api-collection/catalog/folder.yml b/integrations/nodejs/fastify/examples/api-collection/catalog/folder.yml
new file mode 100644
index 00000000..11250ef1
--- /dev/null
+++ b/integrations/nodejs/fastify/examples/api-collection/catalog/folder.yml
@@ -0,0 +1,3 @@
+info:
+  name: Catalog
+  seq: 1
diff --git a/integrations/nodejs/fastify/examples/api-collection/catalog/get product.yml b/integrations/nodejs/fastify/examples/api-collection/catalog/get product.yml
new file mode 100644
index 00000000..dbd33356
--- /dev/null
+++ b/integrations/nodejs/fastify/examples/api-collection/catalog/get product.yml	
@@ -0,0 +1,7 @@
+info:
+  name: Get product
+  type: http
+  seq: 2
+http:
+  method: GET
+  url: https://api.acme.example/products/42
diff --git a/integrations/nodejs/fastify/examples/api-collection/catalog/list products.yml b/integrations/nodejs/fastify/examples/api-collection/catalog/list products.yml
new file mode 100644
index 00000000..653d6bcf
--- /dev/null
+++ b/integrations/nodejs/fastify/examples/api-collection/catalog/list products.yml	
@@ -0,0 +1,7 @@
+info:
+  name: List products
+  type: http
+  seq: 1
+http:
+  method: GET
+  url: https://api.acme.example/products
diff --git a/integrations/nodejs/fastify/examples/api-collection/opencollection.yml b/integrations/nodejs/fastify/examples/api-collection/opencollection.yml
new file mode 100644
index 00000000..36f29597
--- /dev/null
+++ b/integrations/nodejs/fastify/examples/api-collection/opencollection.yml
@@ -0,0 +1,5 @@
+opencollection: 1.0.0
+info:
+  name: Acme API
+  version: 1.0.0
+  summary: A small collection to see the docs with. Point the option at your own to replace it.
diff --git a/integrations/nodejs/fastify/examples/auth.js b/integrations/nodejs/fastify/examples/auth.js
new file mode 100644
index 00000000..edaabfee
--- /dev/null
+++ b/integrations/nodejs/fastify/examples/auth.js
@@ -0,0 +1,25 @@
+'use strict';
+
+const Fastify = require('fastify');
+const { apiDocs } = require('@usebruno/api-docs-fastify');
+
+const app = Fastify();
+const port = process.env.PORT ?? 3000;
+
+app.get('/health', async () => ({ ok: true }));
+
+// a hook is scoped to the plugin it is added in, so a wrapper plugin is the Fastify way to put a
+// guard in front of the docs and nothing else. It covers collection.yml too, which is the file
+// that carries the collection's own auth and variables.
+app.register(async (guarded) => {
+  guarded.addHook('onRequest', async (request, reply) => {
+    // stand-in for your real auth: a session check, a JWT plugin, whatever the app already uses
+    if (request.headers.authorization !== 'Bearer let-me-in') {
+      return reply.code(401).header('www-authenticate', 'Bearer').send();
+    }
+  });
+
+  await guarded.register(apiDocs, { prefix: '/docs', collection: './api-collection' });
+});
+
+app.listen({ port }).then(() => console.log(`docs at http://localhost:${port}/docs/ (Authorization: Bearer let-me-in)`));
diff --git a/integrations/nodejs/fastify/examples/csp.js b/integrations/nodejs/fastify/examples/csp.js
new file mode 100644
index 00000000..965929f2
--- /dev/null
+++ b/integrations/nodejs/fastify/examples/csp.js
@@ -0,0 +1,27 @@
+'use strict';
+
+const Fastify = require('fastify');
+const { apiDocs } = require('@usebruno/api-docs-fastify');
+
+const app = Fastify();
+const port = process.env.PORT ?? 3000;
+
+// what the docs page needs from a strict CSP. 'self' covers shell.js; the renderer itself comes
+// from cdn.usebruno.com and runs a wasm sandbox, which is what 'wasm-unsafe-eval' and data: are for.
+// Without these the page still loads and looks fine, and the errors are only in the console.
+app.addHook('onSend', async (request, reply) => {
+  reply.header(
+    'content-security-policy',
+    "default-src 'self'; "
+    + "script-src 'self' https://cdn.usebruno.com 'wasm-unsafe-eval'; "
+    + "style-src 'self' 'unsafe-inline' https://cdn.usebruno.com https://fonts.googleapis.com; "
+    + "font-src 'self' https://fonts.gstatic.com; "
+    + "connect-src 'self' data:"
+  );
+});
+
+app.get('/health', async () => ({ ok: true }));
+
+app.register(apiDocs, { prefix: '/docs', collection: './api-collection' });
+
+app.listen({ port }).then(() => console.log(`docs at http://localhost:${port}/docs/`));
diff --git a/integrations/nodejs/fastify/examples/embed.js b/integrations/nodejs/fastify/examples/embed.js
new file mode 100644
index 00000000..4ebdd842
--- /dev/null
+++ b/integrations/nodejs/fastify/examples/embed.js
@@ -0,0 +1,24 @@
+'use strict';
+
+const Fastify = require('fastify');
+const { apiDocs, embed } = require('@usebruno/api-docs-fastify');
+
+const app = Fastify();
+const port = process.env.PORT ?? 3000;
+
+// the docs inside a page of your own. The mount serves the collection and shell.js; the block
+// only has to know where the mount is.
+app.register(apiDocs, { prefix: '/docs', collection: './api-collection' });
+
+app.get('/', async (request, reply) => {
+  return reply.type('text/html').send(`<!doctype html>
+<html lang="en">
+<head><meta charset="utf-8"><title>Acme Developer Portal</title></head>
+<body>
+  <h1>Acme Developer Portal</h1>
+  ${embed({ base: '/docs' })}
+</body>
+</html>`);
+});
+
+app.listen({ port }).then(() => console.log(`portal at http://localhost:${port}/`));
diff --git a/integrations/nodejs/fastify/examples/quickstart.js b/integrations/nodejs/fastify/examples/quickstart.js
new file mode 100644
index 00000000..89bb5de7
--- /dev/null
+++ b/integrations/nodejs/fastify/examples/quickstart.js
@@ -0,0 +1,14 @@
+'use strict';
+
+const Fastify = require('fastify');
+const { apiDocs } = require('@usebruno/api-docs-fastify');
+
+const app = Fastify();
+const port = process.env.PORT ?? 3000;
+
+app.get('/health', async () => ({ ok: true }));
+
+// prefix is the mount. The collection path is relative to this file, not to where node was started.
+app.register(apiDocs, { prefix: '/docs', collection: './api-collection' });
+
+app.listen({ port }).then(() => console.log(`docs at http://localhost:${port}/docs/`));
diff --git a/integrations/nodejs/fastify/src/index.ts b/integrations/nodejs/fastify/src/index.ts
index dcb54077..7849c1d3 100644
--- a/integrations/nodejs/fastify/src/index.ts
+++ b/integrations/nodejs/fastify/src/index.ts
@@ -1,7 +1,8 @@
 import type { FastifyPluginAsync, FastifyReply } from 'fastify';
-import { createDocs, type ApiDocsOptions, type HttpResponse } from '@usebruno/api-docs-core';
+import { createDocs, embed, type ApiDocsOptions, type HttpResponse } from '@usebruno/api-docs-core';
 
-export type { ApiDocsOptions, CollectionOptions, RendererOptions, EnvironmentsOption, TagsOption }
+export { createDocs, embed };
+export type { ApiDocsOptions, CollectionOptions, RendererOptions, EmbedOptions, EnvironmentsOption, TagsOption }
   from '@usebruno/api-docs-core';
 
 /** `hide` is @fastify/swagger's, read at runtime, and Fastify's own FastifySchema omits it. */
@@ -18,7 +19,7 @@ const send = (reply: FastifyReply, response: HttpResponse): FastifyReply => {
 };
 
 /**
- * `await app.register(apiDocs, { collection: './api-collection', prefix: '/docs' })`. The mount is
+ * `app.register(apiDocs, { collection: './api-collection', prefix: '/docs' })`. The mount is
  * Fastify's own `prefix`, so there is no `mountPath`. Deliberately not wrapped in `fastify-plugin`:
  * staying encapsulated is what keeps the 405 off the host's routes and lets an adopter put auth in
  * front with `child.addHook('onRequest', ...)`.
diff --git a/integrations/nodejs/nestjs/example/server.js b/integrations/nodejs/nestjs/example/server.js
deleted file mode 100644
index eba9d321..00000000
--- a/integrations/nodejs/nestjs/example/server.js
+++ /dev/null
@@ -1,87 +0,0 @@
-'use strict';
-
-require('reflect-metadata');
-const { Module } = require('@nestjs/common');
-const { NestFactory } = require('@nestjs/core');
-const helmet = require('helmet');
-const { ApiDocsModule } = require('@usebruno/api-docs-nestjs');
-
-const PORT = Number(process.env.PORT || 5458);
-// ADAPTER=fastify runs the same app on platform-fastify. The wrapper is unchanged between them;
-// what differs is that middie leaves req.url as '/', which is why the mount path is an option.
-const ADAPTER = process.env.ADAPTER || 'express';
-// relative on purpose: the core resolves it against this file, not the cwd
-const COLLECTION = process.env.COLLECTION || '../../../contract-tests/fixtures/api-collection';
-const BUNDLED = process.env.BUNDLED || '../../../contract-tests/fixtures/bundled.yml';
-
-class ControlController {
-  control() {
-    return { ok: true, from: 'the app itself' };
-  }
-}
-class AppModule {}
-
-function defineApp() {
-  const { Controller, Get } = require('@nestjs/common');
-
-  // the decorators, applied by hand: this example is plain JS so that it runs with no build step
-  Get('control')(
-    ControlController.prototype,
-    'control',
-    Object.getOwnPropertyDescriptor(ControlController.prototype, 'control')
-  );
-  Controller()(ControlController);
-
-  Module({
-    controllers: [ControlController],
-    imports: [
-      ApiDocsModule.forRoot({
-        mountPath: '/docs',
-        collection: COLLECTION,
-        environments: { include: ['Local'] },
-        tags: { exclude: ['internal'] },
-        pageTitle: 'Acme API',
-        gitCollectionUrl: 'https://token:secret@github.com/acme/api-collection'
-      }),
-      ApiDocsModule.forRoot({
-        mountPath: '/api/v2/docs',
-        collection: COLLECTION,
-        environments: { all: true, exclude: ['Prod'] }
-      }),
-      ApiDocsModule.forRoot({ mountPath: '/internal/docs', collection: COLLECTION }),
-      ApiDocsModule.forRoot({ mountPath: '/bundled/docs', collection: BUNDLED }),
-      ApiDocsModule.forRoot({ mountPath: '/broken/docs', collection: './there-is-no-collection-here' })
-    ]
-  })(AppModule);
-}
-
-async function main() {
-  defineApp();
-
-  let app;
-  if (ADAPTER === 'fastify') {
-    const { FastifyAdapter } = require('@nestjs/platform-fastify');
-    app = await NestFactory.create(AppModule, new FastifyAdapter(), { logger: false });
-  } else {
-    app = await NestFactory.create(AppModule, { logger: false });
-  }
-
-  // the same strict CSP the other examples set, so the contract suite asserts it everywhere
-  app.use(helmet({
-    contentSecurityPolicy: {
-      directives: {
-        // wasm-unsafe-eval, narrowly, because the renderer instantiates a wasm sandbox
-        scriptSrc: ["'self'", 'https://cdn.usebruno.com', "'wasm-unsafe-eval'"],
-        styleSrc: ["'self'", "'unsafe-inline'", 'https://cdn.usebruno.com', 'https://fonts.googleapis.com'],
-        fontSrc: ["'self'", 'https://fonts.gstatic.com'],
-        // data: because the renderer fetches its wasm sandbox from a data URI
-        connectSrc: ["'self'", 'data:']
-      }
-    }
-  }));
-
-  await app.listen(PORT, '127.0.0.1');
-  console.log(`nestjs example on http://localhost:${PORT} (platform-${ADAPTER})`);
-}
-
-main();
diff --git a/integrations/nodejs/nestjs/examples/01-quickstart/app.module.ts b/integrations/nodejs/nestjs/examples/01-quickstart/app.module.ts
new file mode 100644
index 00000000..2f2c978d
--- /dev/null
+++ b/integrations/nodejs/nestjs/examples/01-quickstart/app.module.ts
@@ -0,0 +1,11 @@
+import { Module } from '@nestjs/common';
+import { ApiDocsModule } from '@usebruno/api-docs-nestjs';
+
+@Module({
+  imports: [
+    // relative to the compiled entry file, dist/01-quickstart/main.js, not to this source file
+    // and not to the cwd. From there, examples/api-collection is two levels up.
+    ApiDocsModule.forRoot({ collection: '../../api-collection' })
+  ]
+})
+export class AppModule {}
diff --git a/integrations/nodejs/nestjs/examples/01-quickstart/main.ts b/integrations/nodejs/nestjs/examples/01-quickstart/main.ts
new file mode 100644
index 00000000..87d15bd4
--- /dev/null
+++ b/integrations/nodejs/nestjs/examples/01-quickstart/main.ts
@@ -0,0 +1,9 @@
+import { NestFactory } from '@nestjs/core';
+import { AppModule } from './app.module';
+
+async function bootstrap(): Promise<void> {
+  const app = await NestFactory.create(AppModule);
+  await app.listen(process.env.PORT ?? 3000);
+}
+
+bootstrap();
diff --git a/integrations/nodejs/nestjs/examples/02-auth/app.module.ts b/integrations/nodejs/nestjs/examples/02-auth/app.module.ts
new file mode 100644
index 00000000..282045ea
--- /dev/null
+++ b/integrations/nodejs/nestjs/examples/02-auth/app.module.ts
@@ -0,0 +1,28 @@
+import { Module, type MiddlewareConsumer, type NestModule } from '@nestjs/common';
+import type { Request, Response, NextFunction } from 'express';
+import { ApiDocsModule } from '@usebruno/api-docs-nestjs';
+
+// stand-in for your real auth: a session check, a passport strategy, whatever the app already uses
+function requireApiKey(req: Request, res: Response, next: NextFunction): void {
+  if (req.headers['x-api-key'] !== 'let-me-in') {
+    res.status(401).end();
+    return;
+  }
+
+  next();
+}
+
+@Module({
+  imports: [
+    ApiDocsModule.forRoot({ collection: '../../api-collection' }),
+    ApiDocsModule.forRoot({ mountPath: '/internal/docs', collection: '../../api-collection' })
+  ]
+})
+export class AppModule implements NestModule {
+  configure(consumer: MiddlewareConsumer): void {
+    // the root module's middleware runs before an imported module's, so the docs never see an
+    // unauthenticated request. That includes collection.yml, the file that carries the
+    // collection's own auth and variables. /docs stays open.
+    consumer.apply(requireApiKey).forRoutes('internal/docs', 'internal/docs/*');
+  }
+}
diff --git a/integrations/nodejs/nestjs/examples/02-auth/main.ts b/integrations/nodejs/nestjs/examples/02-auth/main.ts
new file mode 100644
index 00000000..87d15bd4
--- /dev/null
+++ b/integrations/nodejs/nestjs/examples/02-auth/main.ts
@@ -0,0 +1,9 @@
+import { NestFactory } from '@nestjs/core';
+import { AppModule } from './app.module';
+
+async function bootstrap(): Promise<void> {
+  const app = await NestFactory.create(AppModule);
+  await app.listen(process.env.PORT ?? 3000);
+}
+
+bootstrap();
diff --git a/integrations/nodejs/nestjs/examples/03-global-prefix/app.module.ts b/integrations/nodejs/nestjs/examples/03-global-prefix/app.module.ts
new file mode 100644
index 00000000..9abb96e6
--- /dev/null
+++ b/integrations/nodejs/nestjs/examples/03-global-prefix/app.module.ts
@@ -0,0 +1,7 @@
+import { Module } from '@nestjs/common';
+import { ApiDocsModule } from '@usebruno/api-docs-nestjs';
+
+@Module({
+  imports: [ApiDocsModule.forRoot({ collection: '../../api-collection' })]
+})
+export class AppModule {}
diff --git a/integrations/nodejs/nestjs/examples/03-global-prefix/main.ts b/integrations/nodejs/nestjs/examples/03-global-prefix/main.ts
new file mode 100644
index 00000000..26b012d2
--- /dev/null
+++ b/integrations/nodejs/nestjs/examples/03-global-prefix/main.ts
@@ -0,0 +1,12 @@
+import { NestFactory } from '@nestjs/core';
+import { AppModule } from './app.module';
+
+async function bootstrap(): Promise<void> {
+  const app = await NestFactory.create(AppModule);
+  // the docs move with the prefix, like every other route: they answer at /api/docs/, and the
+  // module keeps its default mountPath of '/docs'
+  app.setGlobalPrefix('api');
+  await app.listen(process.env.PORT ?? 3000);
+}
+
+bootstrap();
diff --git a/integrations/nodejs/nestjs/examples/04-fastify-adapter/app.module.ts b/integrations/nodejs/nestjs/examples/04-fastify-adapter/app.module.ts
new file mode 100644
index 00000000..9abb96e6
--- /dev/null
+++ b/integrations/nodejs/nestjs/examples/04-fastify-adapter/app.module.ts
@@ -0,0 +1,7 @@
+import { Module } from '@nestjs/common';
+import { ApiDocsModule } from '@usebruno/api-docs-nestjs';
+
+@Module({
+  imports: [ApiDocsModule.forRoot({ collection: '../../api-collection' })]
+})
+export class AppModule {}
diff --git a/integrations/nodejs/nestjs/examples/04-fastify-adapter/main.ts b/integrations/nodejs/nestjs/examples/04-fastify-adapter/main.ts
new file mode 100644
index 00000000..85000fd6
--- /dev/null
+++ b/integrations/nodejs/nestjs/examples/04-fastify-adapter/main.ts
@@ -0,0 +1,11 @@
+import { NestFactory } from '@nestjs/core';
+import { FastifyAdapter, type NestFastifyApplication } from '@nestjs/platform-fastify';
+import { AppModule } from './app.module';
+
+async function bootstrap(): Promise<void> {
+  // nothing changes in the module: the docs are middleware, and Nest runs middleware on both adapters
+  const app = await NestFactory.create<NestFastifyApplication>(AppModule, new FastifyAdapter());
+  await app.listen(process.env.PORT ?? 3000);
+}
+
+bootstrap();
diff --git a/integrations/nodejs/nestjs/examples/05-csp/app.module.ts b/integrations/nodejs/nestjs/examples/05-csp/app.module.ts
new file mode 100644
index 00000000..9abb96e6
--- /dev/null
+++ b/integrations/nodejs/nestjs/examples/05-csp/app.module.ts
@@ -0,0 +1,7 @@
+import { Module } from '@nestjs/common';
+import { ApiDocsModule } from '@usebruno/api-docs-nestjs';
+
+@Module({
+  imports: [ApiDocsModule.forRoot({ collection: '../../api-collection' })]
+})
+export class AppModule {}
diff --git a/integrations/nodejs/nestjs/examples/05-csp/main.ts b/integrations/nodejs/nestjs/examples/05-csp/main.ts
new file mode 100644
index 00000000..c414b75c
--- /dev/null
+++ b/integrations/nodejs/nestjs/examples/05-csp/main.ts
@@ -0,0 +1,25 @@
+import { NestFactory } from '@nestjs/core';
+import helmet from 'helmet';
+import { AppModule } from './app.module';
+
+async function bootstrap(): Promise<void> {
+  const app = await NestFactory.create(AppModule);
+
+  // what the docs page needs from a strict CSP. 'self' covers shell.js; the renderer itself comes
+  // from cdn.usebruno.com and runs a wasm sandbox, which is what 'wasm-unsafe-eval' and data: are for.
+  // Without these the page still loads and looks fine, and the errors are only in the console.
+  app.use(helmet({
+    contentSecurityPolicy: {
+      directives: {
+        scriptSrc: ["'self'", 'https://cdn.usebruno.com', "'wasm-unsafe-eval'"],
+        styleSrc: ["'self'", "'unsafe-inline'", 'https://cdn.usebruno.com', 'https://fonts.googleapis.com'],
+        fontSrc: ["'self'", 'https://fonts.gstatic.com'],
+        connectSrc: ["'self'", 'data:']
+      }
+    }
+  }));
+
+  await app.listen(process.env.PORT ?? 3000);
+}
+
+bootstrap();
diff --git a/integrations/nodejs/nestjs/examples/06-embed/app.module.ts b/integrations/nodejs/nestjs/examples/06-embed/app.module.ts
new file mode 100644
index 00000000..e2290aa0
--- /dev/null
+++ b/integrations/nodejs/nestjs/examples/06-embed/app.module.ts
@@ -0,0 +1,9 @@
+import { Module } from '@nestjs/common';
+import { ApiDocsModule } from '@usebruno/api-docs-nestjs';
+import { PortalController } from './portal.controller';
+
+@Module({
+  controllers: [PortalController],
+  imports: [ApiDocsModule.forRoot({ collection: '../../api-collection' })]
+})
+export class AppModule {}
diff --git a/integrations/nodejs/nestjs/examples/06-embed/main.ts b/integrations/nodejs/nestjs/examples/06-embed/main.ts
new file mode 100644
index 00000000..87d15bd4
--- /dev/null
+++ b/integrations/nodejs/nestjs/examples/06-embed/main.ts
@@ -0,0 +1,9 @@
+import { NestFactory } from '@nestjs/core';
+import { AppModule } from './app.module';
+
+async function bootstrap(): Promise<void> {
+  const app = await NestFactory.create(AppModule);
+  await app.listen(process.env.PORT ?? 3000);
+}
+
+bootstrap();
diff --git a/integrations/nodejs/nestjs/examples/06-embed/portal.controller.ts b/integrations/nodejs/nestjs/examples/06-embed/portal.controller.ts
new file mode 100644
index 00000000..24d95524
--- /dev/null
+++ b/integrations/nodejs/nestjs/examples/06-embed/portal.controller.ts
@@ -0,0 +1,20 @@
+import { Controller, Get, Header } from '@nestjs/common';
+import { embed } from '@usebruno/api-docs-nestjs';
+
+@Controller()
+export class PortalController {
+  // the docs inside a page of your own. The module serves the collection and shell.js at /docs;
+  // the block only has to know where that mount is.
+  @Get()
+  @Header('Content-Type', 'text/html; charset=utf-8')
+  portal(): string {
+    return `<!doctype html>
+<html lang="en">
+<head><meta charset="utf-8"><title>Acme Developer Portal</title></head>
+<body>
+  <h1>Acme Developer Portal</h1>
+  ${embed({ base: '/docs' })}
+</body>
+</html>`;
+  }
+}
diff --git a/integrations/nodejs/nestjs/examples/api-collection/catalog/folder.yml b/integrations/nodejs/nestjs/examples/api-collection/catalog/folder.yml
new file mode 100644
index 00000000..11250ef1
--- /dev/null
+++ b/integrations/nodejs/nestjs/examples/api-collection/catalog/folder.yml
@@ -0,0 +1,3 @@
+info:
+  name: Catalog
+  seq: 1
diff --git a/integrations/nodejs/nestjs/examples/api-collection/catalog/get product.yml b/integrations/nodejs/nestjs/examples/api-collection/catalog/get product.yml
new file mode 100644
index 00000000..dbd33356
--- /dev/null
+++ b/integrations/nodejs/nestjs/examples/api-collection/catalog/get product.yml	
@@ -0,0 +1,7 @@
+info:
+  name: Get product
+  type: http
+  seq: 2
+http:
+  method: GET
+  url: https://api.acme.example/products/42
diff --git a/integrations/nodejs/nestjs/examples/api-collection/catalog/list products.yml b/integrations/nodejs/nestjs/examples/api-collection/catalog/list products.yml
new file mode 100644
index 00000000..653d6bcf
--- /dev/null
+++ b/integrations/nodejs/nestjs/examples/api-collection/catalog/list products.yml	
@@ -0,0 +1,7 @@
+info:
+  name: List products
+  type: http
+  seq: 1
+http:
+  method: GET
+  url: https://api.acme.example/products
diff --git a/integrations/nodejs/nestjs/examples/api-collection/opencollection.yml b/integrations/nodejs/nestjs/examples/api-collection/opencollection.yml
new file mode 100644
index 00000000..36f29597
--- /dev/null
+++ b/integrations/nodejs/nestjs/examples/api-collection/opencollection.yml
@@ -0,0 +1,5 @@
+opencollection: 1.0.0
+info:
+  name: Acme API
+  version: 1.0.0
+  summary: A small collection to see the docs with. Point the option at your own to replace it.
diff --git a/integrations/nodejs/nestjs/examples/tsconfig.json b/integrations/nodejs/nestjs/examples/tsconfig.json
new file mode 100644
index 00000000..5b45c3ad
--- /dev/null
+++ b/integrations/nodejs/nestjs/examples/tsconfig.json
@@ -0,0 +1,11 @@
+{
+  "extends": "../../../tsconfig.base.json",
+  "compilerOptions": {
+    "rootDir": ".",
+    "outDir": "dist",
+    "declaration": false,
+    "experimentalDecorators": true,
+    "emitDecoratorMetadata": true
+  },
+  "include": ["0*/*.ts"]
+}
diff --git a/integrations/nodejs/nestjs/src/index.ts b/integrations/nodejs/nestjs/src/index.ts
index f4442753..5ad7abb4 100644
--- a/integrations/nodejs/nestjs/src/index.ts
+++ b/integrations/nodejs/nestjs/src/index.ts
@@ -1,8 +1,9 @@
 import type { ServerResponse } from 'node:http';
 import { Module, type DynamicModule, type MiddlewareConsumer, type NestModule } from '@nestjs/common';
-import { createDocs, type ApiDocsOptions, type Request } from '@usebruno/api-docs-core';
+import { createDocs, embed, type ApiDocsOptions, type Request } from '@usebruno/api-docs-core';
 
-export type { ApiDocsOptions, CollectionOptions, RendererOptions, EnvironmentsOption, TagsOption }
+export { createDocs, embed };
+export type { ApiDocsOptions, CollectionOptions, RendererOptions, EmbedOptions, EnvironmentsOption, TagsOption }
   from '@usebruno/api-docs-core';
 
 export interface ApiDocsModuleOptions extends ApiDocsOptions {
diff --git a/integrations/nodejs/scripts/check-all.sh b/integrations/nodejs/scripts/check-all.sh
index 596b2105..d886ae16 100755
--- a/integrations/nodejs/scripts/check-all.sh
+++ b/integrations/nodejs/scripts/check-all.sh
@@ -9,17 +9,17 @@ BODIES="$(mktemp -d)"
 trap 'rm -rf "$BODIES"' EXIT
 
 run() {
-  local name=$1 example=$2 port=$3 adapter=${4:-express}
+  local name=$1 app=$2 port=$3 adapter=${4:-express}
   echo
   echo "### $name"
-  ADAPTER="$adapter" bash "$ROOT/contract-tests/check.sh" --example "$example" --port "$port" "${@:5}"
+  ADAPTER="$adapter" bash "$ROOT/contract-tests/check.sh" --app "$app" --port "$port" "${@:5}"
 }
 
 # the first run is the baseline every other one is compared against
-run "express"        nodejs/express/example/server.js 5456 express --save "$BODIES"
-run "fastify"        nodejs/fastify/example/server.js 5457 express --compare "$BODIES"
-run "nestjs/express" nodejs/nestjs/example/server.js  5458 express --compare "$BODIES"
-run "nestjs/fastify" nodejs/nestjs/example/server.js  5459 fastify --compare "$BODIES"
+run "express"        contract-tests/apps/express.js 5456 express --save "$BODIES"
+run "fastify"        contract-tests/apps/fastify.js 5457 express --compare "$BODIES"
+run "nestjs/express" contract-tests/apps/nestjs.js  5458 express --compare "$BODIES"
+run "nestjs/fastify" contract-tests/apps/nestjs.js  5459 fastify --compare "$BODIES"
 
 echo
 echo "every framework agrees, byte for byte"
diff --git a/integrations/nodejs/scripts/matrix.sh b/integrations/nodejs/scripts/matrix.sh
index a6326f8a..1e86eef8 100755
--- a/integrations/nodejs/scripts/matrix.sh
+++ b/integrations/nodejs/scripts/matrix.sh
@@ -94,9 +94,9 @@ run_cell() {
   local family="${cell%@*}"
   local app="$TMP/$cell"
 
-  mkdir -p "$app/example"
+  mkdir -p "$app/apps"
   printf '{ "name": "matrix-%s", "private": true, "version": "0.0.0" }\n' "${cell/@/-}" >"$app/package.json"
-  cp "$ROOT/nodejs/$family/example/server.js" "$app/example/server.js"
+  cp "$ROOT/contract-tests/apps/$family.js" "$app/apps/$family.js"
   cp -R "$ROOT/contract-tests/fixtures" "$app/fixtures"
 
   # shellcheck disable=SC2046
@@ -115,8 +115,7 @@ run_cell() {
   suite() {
     local port=$1
     shift
-    env COLLECTION=../fixtures/api-collection BUNDLED=../fixtures/bundled.yml "$@" \
-      bash "$ROOT/contract-tests/check.sh" --example "$app/example/server.js" --port "$port" | tail -1
+    env "$@" bash "$ROOT/contract-tests/check.sh" --app "$app/apps/$family.js" --port "$port" | tail -1
   }
   if [ "$family" = "nestjs" ]; then
     echo "   platform-express"
diff --git a/integrations/package.json b/integrations/package.json
index 3e9c1336..ee0f8c0a 100644
--- a/integrations/package.json
+++ b/integrations/package.json
@@ -7,31 +7,33 @@
     "nodejs/*"
   ],
   "scripts": {
-    "build": "npm run build:shell && npm run build:core && npm run build:express && npm run build:fastify && npm run build:nestjs",
+    "build": "npm run build:shell && npm run build:core && npm run build:express && npm run build:fastify && npm run build:nestjs && npm run build:examples",
     "build:core": "tsc -p nodejs/core/tsconfig.json",
+    "build:examples": "tsc -p nodejs/nestjs/examples/tsconfig.json",
     "build:express": "tsc -p nodejs/express/tsconfig.json",
     "build:fastify": "tsc -p nodejs/fastify/tsconfig.json",
     "build:nestjs": "tsc -p nodejs/nestjs/tsconfig.json",
     "build:shell": "esbuild shell/shell.src.mjs --bundle --minify --format=iife --platform=browser --target=es2020 --outfile=shell/shell.js --log-level=warning && mkdir -p nodejs/core/shell && cp shell/shell.html shell/shell.js nodejs/core/shell/",
     "check:all": "npm run build && bash nodejs/scripts/check-all.sh",
-    "check:express": "npm run build && bash contract-tests/check.sh --example nodejs/express/example/server.js --port 5456",
-    "check:fastify": "npm run build && bash contract-tests/check.sh --example nodejs/fastify/example/server.js --port 5457",
-    "check:nestjs": "npm run build && bash contract-tests/check.sh --example nodejs/nestjs/example/server.js --port 5458",
-    "check:nestjs-fastify": "npm run build && ADAPTER=fastify bash contract-tests/check.sh --example nodejs/nestjs/example/server.js --port 5459",
+    "check:express": "npm run build && bash contract-tests/check.sh --app contract-tests/apps/express.js --port 5456",
+    "check:fastify": "npm run build && bash contract-tests/check.sh --app contract-tests/apps/fastify.js --port 5457",
+    "check:nestjs": "npm run build && bash contract-tests/check.sh --app contract-tests/apps/nestjs.js --port 5458",
+    "check:nestjs-fastify": "npm run build && ADAPTER=fastify bash contract-tests/check.sh --app contract-tests/apps/nestjs.js --port 5459",
     "lint": "eslint",
     "lint:fix": "eslint --fix",
     "matrix": "npm run build && bash nodejs/scripts/matrix.sh",
     "pack-check": "npm run build && bash nodejs/scripts/matrix.sh --cell express@5",
     "setup": "bash scripts/setup.sh",
-    "start:express": "node nodejs/express/example/server.js",
-    "start:fastify": "node nodejs/fastify/example/server.js",
-    "start:nestjs": "node nodejs/nestjs/example/server.js",
+    "start:express": "node contract-tests/apps/express.js",
+    "start:fastify": "node contract-tests/apps/fastify.js",
+    "start:nestjs": "node contract-tests/apps/nestjs.js",
     "test": "npm run test:ci && npm run test:browser",
     "test:assemble": "node shell/test/assemble.test.mjs",
     "test:browser": "npm run build && playwright test --config contract-tests/browser/playwright.config.mjs",
-    "test:ci": "npm run lint && npm run test:unit && bash nodejs/scripts/check-all.sh && bash nodejs/scripts/matrix.sh --cell express@5",
+    "test:ci": "npm run lint && npm run test:unit && bash nodejs/scripts/check-all.sh && bash contract-tests/examples.sh && bash nodejs/scripts/matrix.sh --cell express@5",
     "test:collection": "npm run build:core && node nodejs/core/test/collection.test.mjs",
     "test:docs": "npm run build && node nodejs/core/test/docs.test.mjs",
+    "test:examples": "npm run build && bash contract-tests/examples.sh",
     "test:filter": "npm run build:core && node nodejs/core/test/filter.test.mjs",
     "test:nestjs": "npm run build && node nodejs/nestjs/test/sub-path.test.mjs",
     "test:shell": "npm run build && node nodejs/core/test/shell.test.mjs",

From 3558e59c9cb132be3ff8073416b1002d2e86caa1 Mon Sep 17 00:00:00 2001
From: Arpit Bruno <arpit@usebruno.com>
Date: Fri, 18 Sep 2026 11:27:53 +0530
Subject: [PATCH 14/21] adds test runner with a matrix table

---
 .github/workflows/ci.yml                  |  13 +++
 .github/workflows/integrations-matrix.yml |  75 +++++++++++++-
 .gitignore                                |   3 +-
 integrations/contract-tests/check.sh      |  31 +++---
 integrations/contract-tests/examples.sh   |   8 +-
 integrations/contract-tests/lib.sh        | 113 ++++++++++++++++++----
 integrations/contract-tests/report.mjs    |  91 +++++++++++++++++
 integrations/eslint.config.mjs            |   2 +-
 integrations/nodejs/scripts/check-all.sh  |   8 +-
 integrations/nodejs/scripts/matrix.sh     |  97 +++++++++++++++----
 integrations/test-results/.last-run.json  |   4 -
 11 files changed, 378 insertions(+), 67 deletions(-)
 create mode 100644 integrations/contract-tests/report.mjs
 delete mode 100644 integrations/test-results/.last-run.json

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index a3e106b5..1958a885 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -12,6 +12,7 @@ on:
 permissions:
   contents: read
   pull-requests: read
+  checks: write
 
 concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
@@ -119,6 +120,18 @@ jobs:
       - run: npm ci
 
       - run: npm run test:ci
+        env:
+          FORCE_COLOR: 1
+          JUNIT_DIR: results
+
+      # every assertion in the Checks tab, failures as annotations
+      - uses: dorny/test-reporter@a43b3a5f7366b97d083190328d2c652e1a8b6aa2 # v3.0.0
+        if: always()
+        with:
+          name: integrations
+          path: integrations/results/*.xml
+          reporter: java-junit
+          fail-on-error: false
 
       # depends on the live CDN bundle, which this repo does not control, so it cannot block a merge
       - name: browser contract, against the CDN
diff --git a/.github/workflows/integrations-matrix.yml b/.github/workflows/integrations-matrix.yml
index aa5b3ea5..a392f930 100644
--- a/.github/workflows/integrations-matrix.yml
+++ b/.github/workflows/integrations-matrix.yml
@@ -8,10 +8,18 @@ on:
     branches: [main, 'release/**']
     types: [labeled, synchronize]
 
+permissions:
+  contents: read
+  pull-requests: write
+  checks: write
+
 concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
   cancel-in-progress: ${{ github.event_name == 'pull_request' }}
 
+env:
+  FORCE_COLOR: 1
+
 jobs:
   cells:
     if: github.event_name != 'pull_request' || contains(github.event.pull_request.labels.*.name, 'run-integrations-matrix-tests')
@@ -34,7 +42,13 @@ jobs:
 
       - run: npm ci
 
-      - run: bash nodejs/scripts/matrix.sh --family ${{ matrix.family }}
+      - run: bash nodejs/scripts/matrix.sh --family ${{ matrix.family }} --results results
+
+      - uses: actions/upload-artifact@v4
+        if: always()
+        with:
+          name: matrix-${{ matrix.node }}-${{ matrix.family }}
+          path: integrations/results
 
   node-20:
     if: github.event_name != 'pull_request' || contains(github.event.pull_request.labels.*.name, 'run-integrations-matrix-tests')
@@ -50,4 +64,61 @@ jobs:
         with:
           node-version: 20
       - run: npm ci
-      - run: bash nodejs/scripts/matrix.sh
+      - run: bash nodejs/scripts/matrix.sh --results results
+      - uses: actions/upload-artifact@v4
+        if: always()
+        with:
+          name: matrix-20-all
+          path: integrations/results
+
+  report:
+    needs: [cells, node-20]
+    if: always() && needs.cells.result != 'skipped'
+    runs-on: ubuntu-latest
+    name: results table
+    defaults:
+      run:
+        working-directory: integrations
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/download-artifact@v4
+        with:
+          pattern: matrix-*
+          merge-multiple: true
+          path: integrations/results
+
+      - run: |
+          {
+            echo "## Integrations matrix"
+            echo
+            bash nodejs/scripts/matrix.sh --report results --md
+            echo
+            echo "_${{ github.sha }} · node 20 is informational_"
+          } > table.md
+          cat table.md >> "$GITHUB_STEP_SUMMARY"
+
+      # every assertion in the Checks tab, failures as annotations
+      - uses: dorny/test-reporter@a43b3a5f7366b97d083190328d2c652e1a8b6aa2 # v3.0.0
+        with:
+          name: integrations matrix
+          path: integrations/results/**/*.xml
+          reporter: java-junit
+          fail-on-error: false
+
+      # one comment per PR, updated in place on every run
+      - if: github.event_name == 'pull_request'
+        env:
+          GH_TOKEN: ${{ github.token }}
+          PR: ${{ github.event.pull_request.number }}
+        run: |
+          marker='<!-- integrations-matrix -->'
+          printf '%s\n' "$marker" > body.md
+          cat table.md >> body.md
+          existing=$(gh api "repos/$GITHUB_REPOSITORY/issues/$PR/comments" --paginate \
+            --jq ".[] | select(.body | startswith(\"$marker\")) | .id" | head -1)
+          if [ -n "$existing" ]; then
+            gh api -X PATCH "repos/$GITHUB_REPOSITORY/issues/comments/$existing" -F body=@body.md >/dev/null
+          else
+            gh pr comment "$PR" --body-file body.md
+          fi
diff --git a/.gitignore b/.gitignore
index 3a885038..5e3be8bf 100644
--- a/.gitignore
+++ b/.gitignore
@@ -6,4 +6,5 @@ test.js
 
 # Claude Code
 .claude/
-CLAUDE.md
\ No newline at end of file
+CLAUDE.md
+test-results
diff --git a/integrations/contract-tests/check.sh b/integrations/contract-tests/check.sh
index 50e30b40..eb6a15b5 100755
--- a/integrations/contract-tests/check.sh
+++ b/integrations/contract-tests/check.sh
@@ -38,6 +38,7 @@ case "$APP" in /*) ;; *) APP="$ROOT/$APP" ;; esac
 [ -f "$APP" ] || { echo "no app at $APP" >&2; exit 2; }
 
 BASE="http://localhost:$PORT"
+JUNIT_NAME="${JUNIT_NAME:-check-$(basename "$APP" .js)${ADAPTER:+-$ADAPTER}}"
 TMP="$(mktemp -d)"
 trap 'stop; rm -rf "$TMP"' EXIT
 
@@ -45,12 +46,12 @@ trap 'stop; rm -rf "$TMP"' EXIT
 
 port_is_free "$PORT"
 boot "$APP" "$PORT"
-echo "booted $(basename "$APP") on :$PORT from $TMP"
+echo "${BOLD}$(basename "$APP")${RESET} on :$PORT ${DIM}(cwd $TMP)${RESET}"
 
 # ---- the routes, identical at every mount ----------------------------------
 
 for MOUNT in /docs /api/v2/docs /internal/docs; do
-  echo "== $MOUNT"
+  describe "$MOUNT"
   url="$BASE$MOUNT"
   last="${MOUNT##*/}"
   saved="${MOUNT//\//_}"
@@ -79,13 +80,13 @@ for MOUNT in /docs /api/v2/docs /internal/docs; do
   curl -s "$url/shell.js" >"$TMP/shell$saved.js"
 done
 
-echo "== shell.js is one file, whatever the mount"
+describe "shell.js is one file, whatever the mount"
 check "byte-identical across mounts"            cmp -s "$TMP/shell_docs.js" "$TMP/shell_api_v2_docs.js"
 check "byte-identical across mounts (2)"        cmp -s "$TMP/shell_docs.js" "$TMP/shell_internal_docs.js"
 check "no origin is baked into the bundle"      no_origins "$TMP/shell_docs.js"
 check "it understands the fragments envelope"   file_has "$TMP/shell_docs.js" 'opencollection-fragments'
 
-echo "== environments: server side, by whole file"
+describe "environments: server side, by whole file"
 check "/docs include Local -> exactly Local"    file_has "$TMP/coll_docs.json" 'environments/Local.yml'
 check "/docs -> no other environment"           file_lacks "$TMP/coll_docs.json" 'environments/Prod.yml'
 check "/api/v2 all minus Prod -> Local only"    file_has "$TMP/coll_api_v2_docs.json" 'environments/Local.yml'
@@ -93,7 +94,7 @@ check "/api/v2 -> Prod file absent"             file_lacks "$TMP/coll_api_v2_doc
 check "/internal default -> no environments"    file_lacks "$TMP/coll_internal_docs.json" 'environments/'
 check "Prod's token appears in no served byte"  none_mention 'prod-token-must-never-be-served' "$TMP"/coll_*.json "$TMP"/shell_docs.js
 
-echo "== tags: server side, by whole file, folders pruned behind them"
+describe "tags: server side, by whole file, folders pruned behind them"
 check "/docs -> the tagged request is gone"     file_lacks "$TMP/coll_docs.json" 'reindex catalog'
 check "/docs -> its URL literal is gone too"    file_lacks "$TMP/coll_docs.json" 'admin/reindex-catalog'
 check "/docs -> a folder with no survivor goes" file_lacks "$TMP/coll_docs.json" 'internal/folder.yml'
@@ -104,27 +105,27 @@ check "/internal no tags -> tagged request served" file_has "$TMP/coll_internal_
 check "/docs serves exactly these seven files" paths_are "$TMP/coll_docs.json" \
   'catalog/folder.yml,catalog/get product.yml,catalog/list products.yml,environments/Local.yml,mixed/folder.yml,mixed/health.yml,opencollection.yml'
 
-echo "== what reaches the browser"
+describe "what reaches the browser"
 check "/docs title comes from pageTitle"        body_has "$BASE/docs/" '<title>Acme API</title>'
 check "/docs data-config has no pageTitle"      config_lacks "$BASE/docs/" 'pageTitle'
 check "/docs data-config has no server option"  config_lacks "$BASE/docs/" 'tags|environments|collection'
 check "/docs git url is forwarded"              body_has "$BASE/docs/" 'acme/api-collection'
 check "/docs git credentials are stripped"      body_lacks "$BASE/docs/" 'token:secret'
 
-echo "== a single bundled file"
+describe "a single bundled file"
 check "/bundled/docs/ -> the page"              status_is 200 "$BASE/bundled/docs/"
 check "/bundled/docs/collection.yml -> yaml"    header_has Content-Type yaml "$BASE/bundled/docs/collection.yml"
 check "/bundled/docs/collection.yml -> ETag"    revalidates "$BASE/bundled/docs/collection.yml"
 check "/bundled/docs -> served as written"      body_has "$BASE/bundled/docs/collection.yml" 'Acme API (bundled)'
 
-echo "== a broken setup does not stop the app"
+describe "a broken setup does not stop the app"
 check "the app's own route still answers"       body_has "$BASE/control" 'the app itself'
 check "/broken/docs/ -> 404, not a crash"       status_is 404 "$BASE/broken/docs/"
 check "/broken/docs/ says what is wrong"        body_has "$BASE/broken/docs/" 'Collection not found'
 check "/broken/docs/collection.yml -> 404 too"  status_is 404 "$BASE/broken/docs/collection.yml"
 
 if [ "$(curl -s -o /dev/null -w '%{http_code}' "$BASE/portal")" = "200" ]; then
-  echo "== embed(): the docs block inside the host's own page"
+  describe "embed(): the docs block inside the host's own page"
   check "the host's own page is what is served"  body_has "$BASE/portal" 'Acme Developer Portal'
   check "the block is in it"                     body_has "$BASE/portal" 'id="bruno-docs"'
   check "pointing at the mount it belongs to"    body_has "$BASE/portal" 'src="/portal/docs/shell.js"'
@@ -132,17 +133,17 @@ if [ "$(curl -s -o /dev/null -w '%{http_code}' "$BASE/portal")" = "200" ]; then
   check "and the host page keeps its own title"  occurs_once "$BASE/portal" '<title'
 fi
 
-echo "== the host app is left alone"
+describe "the host app is left alone"
 check "its own 404 still comes from it"         status_is 404 -X POST "$BASE/control"
 
 if [ "$(curl -s -o /dev/null -w '%{http_code}' "$BASE/openapi.json")" = "200" ]; then
-  echo "== the host publishes a spec, and the docs routes are not in it"
+  describe "the host publishes a spec, and the docs routes are not in it"
   curl -s "$BASE/openapi.json" >"$TMP/spec.json"
   check "no docs route leaked into it"          file_lacks "$TMP/spec.json" '/docs'
   check "the host's own routes are still there" file_has "$TMP/spec.json" '/control'
 fi
 
-echo "== the adopter's CSP holds"
+describe "the adopter's CSP holds"
 check "the CSP allows the renderer's origin"    header_has Content-Security-Policy "script-src 'self' https://cdn.usebruno.com" "$BASE/docs/"
 check "and the data: uri its wasm comes from"  header_has Content-Security-Policy "connect-src 'self' data:" "$BASE/docs/"
 check "and instantiating that wasm"            header_has Content-Security-Policy "wasm-unsafe-eval" "$BASE/docs/"
@@ -156,13 +157,11 @@ if [ -n "$SAVE" ]; then
 fi
 
 if [ -n "$COMPARE" ]; then
-  echo "== byte-identical to $COMPARE"
+  describe "byte-identical to $COMPARE"
   for f in "$TMP"/coll_*.json "$TMP"/shell_docs.js; do
     name="$(basename "$f")"
     check "$name matches" cmp -s "$f" "$COMPARE/$name"
   done
 fi
 
-echo
-echo "$pass passed, $fail failed"
-[ "$fail" -eq 0 ]
+summary
diff --git a/integrations/contract-tests/examples.sh b/integrations/contract-tests/examples.sh
index 0bcc6d92..61c5d186 100644
--- a/integrations/contract-tests/examples.sh
+++ b/integrations/contract-tests/examples.sh
@@ -18,6 +18,7 @@ while [ $# -gt 0 ]; do
 done
 
 BASE="http://localhost:$PORT"
+JUNIT_NAME="${JUNIT_NAME:-examples}"
 TMP="$(mktemp -d)"
 trap 'stop; rm -rf "$TMP"' EXIT
 port_is_free "$PORT"
@@ -25,8 +26,7 @@ port_is_free "$PORT"
 # example FILE: stops the one before, boots this one
 example() {
   stop
-  echo
-  echo "== ${1#nodejs/}"
+  describe "${1#nodejs/}"
   boot "$ROOT/$1" "$PORT"
 }
 
@@ -143,6 +143,4 @@ check "loading from the mount"                   body_has "$BASE/" 'src="/docs/s
 check "one document, not two"                    occurs_once "$BASE/" '<html'
 check "the mount serves the collection"          body_has "$BASE/docs/collection.yml" 'Acme API'
 
-echo
-echo "$pass passed, $fail failed"
-[ "$fail" -eq 0 ]
+summary
diff --git a/integrations/contract-tests/lib.sh b/integrations/contract-tests/lib.sh
index e650d27b..d1669dcc 100644
--- a/integrations/contract-tests/lib.sh
+++ b/integrations/contract-tests/lib.sh
@@ -1,18 +1,95 @@
-# Shared by check.sh and examples.sh: boot a Node app on a port, assert one fact at a time from
-# outside it, count what passed. Needs $TMP for the server log; sets SERVER_PID.
+# Shared by check.sh, examples.sh and the matrix: boot a Node app on a port, assert one fact at a
+# time from outside it, report the way a test runner does. Needs $TMP for the server log.
+#
+# Set JUNIT_DIR to also leave a JUnit file per run (JUNIT_NAME names it), which is what CI feeds
+# to the Checks tab.
 
+# colour when a person is watching, or asked for it (CI renders ANSI but is not a tty). Never
+# into a file or a pipe, so saved and compared output stays plain.
+if [ -n "${FORCE_COLOR:-}" ] || { [ -t 1 ] && [ -z "${NO_COLOR:-}" ]; }; then
+  GREEN=$'\e[32m' RED=$'\e[31m' BOLD=$'\e[1m' DIM=$'\e[2m' RESET=$'\e[0m'
+else
+  GREEN="" RED="" BOLD="" DIM="" RESET=""
+fi
+
+SECONDS=0
 pass=0
 fail=0
+SUITE=""
+failures=()
+junit=""
+want=""
+got=""
+
+# ---- the runner -----------------------------------------------------------------
+
+describe() {
+  SUITE=$1
+  echo
+  echo "  ${BOLD}$1${RESET}"
+}
+
+xml_escape() { sed -e 's/&/\&amp;/g' -e 's/</\&lt;/g' -e 's/>/\&gt;/g' -e 's/"/\&quot;/g' <<<"$1"; }
+
+# check NAME HELPER ARGS...: one assertion. A helper leaves what it wanted in $want and what it saw
+# in $got, so a failure reads as expected and received, not only as a name.
 check() {
   local name=$1
   shift
+  want=""
+  got=""
   if "$@"; then
     pass=$((pass + 1))
-    printf '  ok   %s\n' "$name"
+    printf '    %s✓%s %s\n' "$GREEN" "$RESET" "$name"
+    junit+="    <testcase classname=\"$(xml_escape "$SUITE")\" name=\"$(xml_escape "$name")\"/>"$'\n'
   else
     fail=$((fail + 1))
-    printf '  FAIL %s\n' "$name"
+    printf '    %s✗ %s%s\n' "$RED" "$name" "$RESET"
+    local detail="$*"$'\n'"Expected: ${want:-see the call}"$'\n'"Received: ${got:-nothing recorded}"
+    failures+=("${SUITE:+$SUITE › }$name"$'\n'"$detail")
+    junit+="    <testcase classname=\"$(xml_escape "$SUITE")\" name=\"$(xml_escape "$name")\">"$'\n'
+    junit+="      <failure message=\"$(xml_escape "expected ${want:-see the call}, received ${got:-nothing}")\">$(xml_escape "$detail")</failure>"$'\n'
+    junit+="    </testcase>"$'\n'
+  fi
+}
+
+# the failures again, numbered and in one place, then the totals. RESULTS_FILE, when set, gets the
+# two counts for whoever is collecting a table; JUNIT_DIR gets the file for the Checks tab.
+summary() {
+  if [ "$fail" -gt 0 ]; then
+    local n=0
+    for f in "${failures[@]}"; do
+      n=$((n + 1))
+      echo
+      echo "  ${RED}$n)${RESET} ${BOLD}${f%%$'\n'*}${RESET}"
+      echo "${f#*$'\n'}" | sed 's/^/       /'
+    done
   fi
+
+  echo
+  if [ "$fail" -eq 0 ]; then
+    printf '  %s%s passed%s %s(%ss)%s\n' "$GREEN" "$pass" "$RESET" "$DIM" "$SECONDS" "$RESET"
+  else
+    printf '  %s%s failed%s, %s passed %s(%ss)%s\n' "$RED" "$fail" "$RESET" "$pass" "$DIM" "$SECONDS" "$RESET"
+  fi
+
+  if [ -n "${RESULTS_FILE:-}" ]; then
+    printf '%s\t%s\n' "$pass" "$fail" >"$RESULTS_FILE"
+  fi
+
+  if [ -n "${JUNIT_DIR:-}" ]; then
+    mkdir -p "$JUNIT_DIR"
+    {
+      echo '<?xml version="1.0" encoding="UTF-8"?>'
+      echo "<testsuites>"
+      echo "  <testsuite name=\"$(xml_escape "${JUNIT_NAME:-suite}")\" tests=\"$((pass + fail))\" failures=\"$fail\" time=\"$SECONDS\">"
+      printf '%s' "$junit"
+      echo "  </testsuite>"
+      echo "</testsuites>"
+    } >"$JUNIT_DIR/${JUNIT_NAME:-suite}.xml"
+  fi
+
+  [ "$fail" -eq 0 ]
 }
 
 # ---- the server ---------------------------------------------------------------
@@ -46,22 +123,22 @@ stop() {
   SERVER_PID=""
 }
 
-# ---- helpers: each asserts exactly one fact -----------------------------------
+# ---- helpers: each asserts exactly one fact and records want and got -------------
 
-status_is() { [ "$(curl -s -o /dev/null -w '%{http_code}' "${@:2}")" = "$1" ]; }
+status_is() { want="$1"; got="$(curl -s -o /dev/null -w '%{http_code}' "${@:2}")"; [ "$got" = "$1" ]; }
 header_of() { curl -s -D - -o /dev/null "${@:2}" | tr -d '\r' | awk -v k="$1" 'tolower($1)==tolower(k":"){sub(/^[^:]*: */,"");print}'; }
-header_has() { local name=$1 want=$2; shift 2; header_of "$name" "$@" | grep -q "$want"; }
-header_absent() { local name=$1; shift; [ -z "$(header_of "$name" "$@")" ]; }
-body_has() { grep -q "$2" <<<"$(curl -s "$1")"; }
-body_lacks() { ! grep -Eq "$2" <<<"$(curl -s "$1")"; }
-file_has() { grep -q "$2" "$1"; }
-file_lacks() { ! grep -q "$2" "$1"; }
+header_has() { local name=$1 pattern=$2; shift 2; want="$name containing '$pattern'"; got="$name: $(header_of "$name" "$@")"; grep -q "$pattern" <<<"$got"; }
+header_absent() { local name=$1; shift; want="no $name header"; got="$name: $(header_of "$name" "$@")"; [ "$got" = "$name: " ]; }
+body_has() { local body; body="$(curl -s "$1")"; want="'$2' in the body"; got="not there, in ${#body} bytes"; grep -q "$2" <<<"$body"; }
+body_lacks() { want="no '$2' in the body"; got="it is there"; ! grep -Eq "$2" <<<"$(curl -s "$1")"; }
+file_has() { want="'$2' in $(basename "$1")"; got="not there"; grep -q "$2" "$1"; }
+file_lacks() { want="no '$2' in $(basename "$1")"; got="it is there"; ! grep -q "$2" "$1"; }
 revalidates() { status_is 304 -H "If-None-Match: $(header_of ETag "$1")" "$1"; }
-redirects_to() { status_is 301 "$1" && [ "$(header_of Location "$1")" = "$2" ]; }
+redirects_to() { local status location; status="$(curl -s -o /dev/null -w '%{http_code}' "$1")"; location="$(header_of Location "$1")"; want="301, Location: $2"; got="$status, Location: $location"; [ "$status" = 301 ] && [ "$location" = "$2" ]; }
 paths_in() { node -e 'const d=JSON.parse(require("fs").readFileSync(process.argv[1],"utf8"));console.log(Object.keys(d.files).sort().join(","))' "$1"; }
-paths_are() { [ "$(paths_in "$1")" = "$2" ]; }
-none_mention() { ! grep -q "$1" "${@:2}"; }
-no_origins() { ! grep -oE 'https?://[A-Za-z0-9./_-]+' "$1" | grep -q .; }
-occurs_once() { [ "$(curl -s "$1" | grep -c "$2")" = "1" ]; }
+paths_are() { want="$2"; got="$(paths_in "$1")"; [ "$got" = "$2" ]; }
+none_mention() { want="'$1' in no file"; got="found in: $(grep -l "$1" "${@:2}" 2>/dev/null | xargs -n1 basename 2>/dev/null | tr '\n' ' ')"; ! grep -q "$1" "${@:2}"; }
+no_origins() { want="no absolute origin in $(basename "$1")"; got="origins: $(grep -oE 'https?://[A-Za-z0-9./_-]+' "$1" | sort -u | tr '\n' ' ')"; ! grep -oE 'https?://[A-Za-z0-9./_-]+' "$1" | grep -q .; }
+occurs_once() { want="exactly 1 occurrence of '$2'"; got="$(curl -s "$1" | grep -c "$2") occurrences"; [ "${got%% *}" = "1" ]; }
 config_of() { curl -s "$1" | grep -o 'data-config="[^"]*"'; }
-config_lacks() { ! config_of "$1" | grep -Eq "&quot;($2)&quot;:"; }
+config_lacks() { want="data-config without ($2)"; got="$(config_of "$1")"; ! grep -Eq "&quot;($2)&quot;:" <<<"$got"; }
diff --git a/integrations/contract-tests/report.mjs b/integrations/contract-tests/report.mjs
new file mode 100644
index 00000000..3e6f57d8
--- /dev/null
+++ b/integrations/contract-tests/report.mjs
@@ -0,0 +1,91 @@
+// The matrix table, from the result files the suites leave behind.
+//
+//   node contract-tests/report.mjs DIR        a box table for the terminal
+//   node contract-tests/report.mjs DIR --md   markdown, for the step summary and the PR comment
+//
+// A result file is one line: node<TAB>cell<TAB>adapter<TAB>passed<TAB>failed. A suite that never
+// wrote its counts did not get as far as booting.
+import fs from 'node:fs';
+import path from 'node:path';
+
+const [dir, mode] = process.argv.slice(2);
+if (!dir) {
+  console.error('usage: report.mjs DIR [--md]');
+  process.exit(2);
+}
+
+const colour = process.env.FORCE_COLOR || (process.stdout.isTTY && !process.env.NO_COLOR);
+const paint = (code, s) => (colour ? `\x1b[${code}m${s}\x1b[0m` : s);
+const green = (s) => paint(32, s);
+const red = (s) => paint(31, s);
+const dim = (s) => paint(2, s);
+const bold = (s) => paint(1, s);
+
+const files = (d) => fs.readdirSync(d, { withFileTypes: true })
+  .flatMap((e) => (e.isDirectory() ? files(path.join(d, e.name)) : e.name.endsWith('.tsv') ? [path.join(d, e.name)] : []));
+
+const rows = files(dir).map((f) => {
+  const [node, cell, adapter, passed, failed] = fs.readFileSync(f, 'utf8').trim().split('\t');
+
+  return { node: Number(node), suite: adapter === '-' ? cell : `${cell} (platform-${adapter})`, passed, failed };
+});
+
+const nodes = [...new Set(rows.map((r) => r.node))].sort((a, b) => a - b);
+const suites = [...new Set(rows.map((r) => r.suite))].sort();
+const at = (suite, node) => rows.find((r) => r.suite === suite && r.node === node);
+
+const verdict = (r) => {
+  if (!r) {
+    return { text: '', ok: true };
+  }
+  if (r.passed === '-') {
+    return { text: '✗ did not boot', ok: false };
+  }
+  if (Number(r.failed) > 0) {
+    return { text: `✗ ${r.failed} of ${Number(r.passed) + Number(r.failed)} failed`, ok: false };
+  }
+
+  return { text: `✓ ${r.passed}`, ok: true };
+};
+
+const header = ['cell', ...nodes.map((n) => `node ${n}`)];
+const body = suites.map((s) => [s, ...nodes.map((n) => verdict(at(s, n)))]);
+const allOk = body.every((cells) => cells.slice(1).every((v) => v.ok));
+const ran = rows.filter((r) => r.passed !== '-');
+const assertions = ran.reduce((sum, r) => sum + Number(r.passed) + Number(r.failed), 0);
+
+if (mode === '--md') {
+  console.log(`| ${header.join(' | ')} |`);
+  console.log(`|${header.map(() => '---').join('|')}|`);
+  for (const cells of body) {
+    console.log(`| ${cells[0]} | ${cells.slice(1).map((v) => v.text).join(' | ')} |`);
+  }
+  console.log();
+  console.log(allOk
+    ? `**${rows.length} suites green** across node ${nodes.join(', ')} · ${assertions} assertions`
+    : `**${body.flatMap((c) => c.slice(1)).filter((v) => !v.ok).length} suites red** · see the failing jobs`);
+  process.exit(0);
+}
+
+// ---- the terminal table ------------------------------------------------------------
+
+const textAt = (cells, i) => (i === 0 ? cells[0] : cells[i].text);
+const widths = header.map((h, i) => Math.max(h.length, ...body.map((cells) => textAt(cells, i).length)));
+const pad = (s, w) => s + ' '.repeat(w - s.length);
+const line = (l, m, r) => l + widths.map((w) => '─'.repeat(w + 2)).join(m) + r;
+const row = (cells) => '│ ' + cells.join(' │ ') + ' │';
+
+console.log(line('┌', '┬', '┐'));
+console.log(row(header.map((h, i) => bold(pad(h, widths[i])))));
+console.log(line('├', '┼', '┤'));
+for (const cells of body) {
+  console.log(row([
+    pad(cells[0], widths[0]),
+    ...cells.slice(1).map((v, i) => (v.ok ? green : red)(pad(v.text, widths[i + 1])))
+  ]));
+}
+console.log(line('└', '┴', '┘'));
+console.log();
+console.log(allOk
+  ? `  ${green(`${rows.length} suites green`)} ${dim(`· node ${nodes.join(', ')} · ${assertions} assertions`)}`
+  : `  ${red(`${body.flatMap((c) => c.slice(1)).filter((v) => !v.ok).length} suites red`)} ${dim(`· ${rows.length} suites · node ${nodes.join(', ')}`)}`);
diff --git a/integrations/eslint.config.mjs b/integrations/eslint.config.mjs
index f954c87b..98489fe1 100644
--- a/integrations/eslint.config.mjs
+++ b/integrations/eslint.config.mjs
@@ -24,7 +24,7 @@ export default [
         ...globals.node
       }
     },
-    files: ['eslint.config.mjs', '**/src/**/*.ts', '**/test/**/*.{ts,mjs}', 'contract-tests/apps/*.js', '**/examples/**/*.{js,ts}'],
+    files: ['eslint.config.mjs', '**/src/**/*.ts', '**/test/**/*.{ts,mjs}', 'contract-tests/**/*.{js,mjs}', '**/examples/**/*.{js,ts}'],
     rules: {
       ...js.configs.recommended.rules,
       ...stylistic.configs.customize({
diff --git a/integrations/nodejs/scripts/check-all.sh b/integrations/nodejs/scripts/check-all.sh
index d886ae16..edb52793 100755
--- a/integrations/nodejs/scripts/check-all.sh
+++ b/integrations/nodejs/scripts/check-all.sh
@@ -5,14 +5,16 @@
 set -euo pipefail
 
 ROOT="$(cd "$(dirname "$0")/../.." && pwd)"
+source "$ROOT/contract-tests/lib.sh"
+
 BODIES="$(mktemp -d)"
 trap 'rm -rf "$BODIES"' EXIT
 
 run() {
   local name=$1 app=$2 port=$3 adapter=${4:-express}
   echo
-  echo "### $name"
-  ADAPTER="$adapter" bash "$ROOT/contract-tests/check.sh" --app "$app" --port "$port" "${@:5}"
+  echo "${BOLD}▸ $name${RESET}"
+  ADAPTER="$adapter" JUNIT_NAME="check-${name//\//-}" bash "$ROOT/contract-tests/check.sh" --app "$app" --port "$port" "${@:5}"
 }
 
 # the first run is the baseline every other one is compared against
@@ -22,4 +24,4 @@ run "nestjs/express" contract-tests/apps/nestjs.js  5458 express --compare "$BOD
 run "nestjs/fastify" contract-tests/apps/nestjs.js  5459 fastify --compare "$BODIES"
 
 echo
-echo "every framework agrees, byte for byte"
+echo "${GREEN}every framework agrees, byte for byte${RESET}"
diff --git a/integrations/nodejs/scripts/matrix.sh b/integrations/nodejs/scripts/matrix.sh
index 1e86eef8..aad092b4 100755
--- a/integrations/nodejs/scripts/matrix.sh
+++ b/integrations/nodejs/scripts/matrix.sh
@@ -7,35 +7,71 @@
 #   bash nodejs/scripts/matrix.sh --family fastify     that family's majors (CI runs one job per family)
 #   bash nodejs/scripts/matrix.sh --cell nestjs@10     one cell, to reproduce a failure
 #   bash nodejs/scripts/matrix.sh --docker             every cell under node 22 and 24, in containers
+#   bash nodejs/scripts/matrix.sh --results DIR        also leave one result file per suite in DIR
+#   bash nodejs/scripts/matrix.sh --report DIR [--md]  only render the table from those files
 #
 # A cell is family@major. The nestjs cells run both adapters, since the adapter is what broke.
+# Every run ends with a cell x node table in markdown; CI's jobs each leave their results as an
+# artifact and one job renders them all into the step summary and the PR comment.
 set -euo pipefail
 
 ROOT="$(cd "$(dirname "$0")/../.." && pwd)"
+source "$ROOT/contract-tests/lib.sh"
+
 FAMILY=""
 CELL=""
 DOCKER=""
+RESULTS_DIR=""
+COLLECTED=""
+REPORT_DIR=""
+MD=""
 PASSTHROUGH=()
 while [ $# -gt 0 ]; do
   case "$1" in
     --family) FAMILY="$2"; PASSTHROUGH+=("$1" "$2"); shift 2 ;;
     --cell) CELL="$2"; PASSTHROUGH+=("$1" "$2"); shift 2 ;;
     --docker) DOCKER=1; shift ;;
+    --results) RESULTS_DIR="$2"; COLLECTED=1; shift 2 ;;
+    --report) REPORT_DIR="$2"; shift 2 ;;
+    --md) MD="--md"; shift ;;
     *) echo "unknown argument: $1" >&2; exit 2 ;;
   esac
 done
 
+# ---- the table --------------------------------------------------------------------------
+
+report() {
+  echo
+  node "$ROOT/contract-tests/report.mjs" "$1" $MD
+}
+
+if [ -n "$REPORT_DIR" ]; then
+  report "$REPORT_DIR"
+  exit 0
+fi
+
 # --docker is a wrapper, not a second implementation: each container runs this same script natively
 if [ -n "$DOCKER" ]; then
   docker info >/dev/null 2>&1 || { echo "docker is installed but the daemon is not running" >&2; exit 2; }
+  # the container's stdout is a pipe, so it would go plain: pass our own colour decision in
+  docker_env=()
+  if [ -n "$GREEN" ]; then
+    docker_env=(-e FORCE_COLOR=1)
+  fi
+  # the containers write their results into one host directory, so the table covers both nodes
+  RESULTS_DIR="${RESULTS_DIR:-$(mktemp -d)}"
+  mkdir -p "$RESULTS_DIR"
+  status=0
   for node in 22 24; do
     echo
-    echo "############ node $node, in a container"
+    echo "${BOLD}############ node $node, in a container${RESET}"
     docker build --quiet --build-arg "NODE=$node" -f "$ROOT/nodejs/scripts/matrix.Dockerfile" \
       -t "api-docs-matrix:node$node" "$ROOT" >/dev/null
-    docker run --rm "api-docs-matrix:node$node" ${PASSTHROUGH[@]+"${PASSTHROUGH[@]}"}
+    docker run --rm ${docker_env[@]+"${docker_env[@]}"} -v "$RESULTS_DIR:/results" \
+      "api-docs-matrix:node$node" --results /results ${PASSTHROUGH[@]+"${PASSTHROUGH[@]}"} || status=1
   done
-  exit 0
+  report "$RESULTS_DIR"
+  exit "$status"
 fi
 
 ALL_CELLS="express@4 express@5 fastify@4 fastify@5 nestjs@10 nestjs@11 nestjs@12"
@@ -57,6 +93,18 @@ fi
 
 TMP="$(mktemp -d)"
 trap 'rm -rf "$TMP"' EXIT
+RESULTS_DIR="${RESULTS_DIR:-$TMP/results}"
+mkdir -p "$RESULTS_DIR"
+NODE_MAJOR="$(node -p 'process.versions.node.split(".")[0]')"
+
+suites=0
+for c in $CELLS; do
+  case "$c" in nestjs@*) suites=$((suites + 2)) ;; *) suites=$((suites + 1)) ;; esac
+done
+echo
+echo "${BOLD}Integrations matrix${RESET} ${DIM}· node $(node -v) · $(echo $CELLS | wc -w | tr -d ' ') cells, $suites suites${RESET}"
+echo "  ${DIM}$CELLS${RESET}"
+echo
 
 # ---- pack once, every cell installs the same tarballs ---------------------------------
 
@@ -70,7 +118,7 @@ done
 core_files="$(tar -tzf "$TARBALLS"/*api-docs-core*.tgz)"
 grep -q 'package/shell/shell.js' <<<"$core_files" || { echo "shell.js is NOT in the core tarball" >&2; exit 1; }
 grep -q 'package/shell/shell.html' <<<"$core_files" || { echo "shell.html is NOT in the core tarball" >&2; exit 1; }
-echo "packed $(ls "$TARBALLS" | wc -l | tr -d ' ') tarballs, the core ships its shell"
+echo "${DIM}packed $(ls "$TARBALLS" | wc -l | tr -d ' ') tarballs, the core ships its shell${RESET}"
 
 # ---- what each cell installs, on top of our tarballs -----------------------------------
 
@@ -109,22 +157,34 @@ run_cell() {
     fastify) installed="fastify $(node -p "require('$app/node_modules/fastify/package.json').version")" ;;
     nestjs)  installed="@nestjs/core $(node -p "require('$app/node_modules/@nestjs/core/package.json').version")" ;;
   esac
-  echo "   installed $installed"
+  echo "  ${DIM}installed $installed${RESET}"
 
-  # suite PORT [VAR=value ...]
+  # suite PORT ADAPTER [VAR=value ...]: runs the contract suite, leaves its row for the table.
+  # A suite that never wrote its counts did not get as far as booting.
   suite() {
-    local port=$1
-    shift
-    env "$@" bash "$ROOT/contract-tests/check.sh" --app "$app/apps/$family.js" --port "$port" | tail -1
+    local port=$1 adapter=$2 status=0
+    shift 2
+    local counts="$TMP/counts.tsv"
+    rm -f "$counts"
+    env RESULTS_FILE="$counts" JUNIT_DIR="$RESULTS_DIR" JUNIT_NAME="node$NODE_MAJOR-$cell-$adapter" "$@" \
+      bash "$ROOT/contract-tests/check.sh" --app "$app/apps/$family.js" --port "$port" || status=1
+    printf '%s\t%s\t%s\t%s\n' "$NODE_MAJOR" "$cell" "$adapter" "$(cat "$counts" 2>/dev/null || printf -- '-\t-')" \
+      >"$RESULTS_DIR/node$NODE_MAJOR-$cell-$adapter.tsv"
+
+    return "$status"
   }
+  local status=0
   if [ "$family" = "nestjs" ]; then
-    echo "   platform-express"
-    suite "$port"
-    echo "   platform-fastify"
-    suite "$((port + 1))" ADAPTER=fastify
+    echo "  ${BOLD}platform-express${RESET}"
+    suite "$port" express || status=1
+    echo
+    echo "  ${BOLD}platform-fastify${RESET}"
+    suite "$((port + 1))" fastify ADAPTER=fastify || status=1
   else
-    suite "$port"
+    suite "$port" - || status=1
   fi
+
+  return "$status"
 }
 
 # ---- the run ----------------------------------------------------------------------------
@@ -135,7 +195,7 @@ failed=""
 for cell in $CELLS; do
   n=$((n + 1))
   echo
-  echo "### [$n/$total] node $(node -v)  $cell"
+  echo "${BOLD}▸ [$n/$total] $cell${RESET}"
   if run_cell "$cell" $((5470 + n * 2)); then
     :
   else
@@ -143,9 +203,12 @@ for cell in $CELLS; do
   fi
 done
 
+# with --results, whoever collects the files renders the table: the --docker host, or CI's report job
+if [ -z "$COLLECTED" ]; then
+  report "$RESULTS_DIR"
+fi
 echo
 if [ -n "$failed" ]; then
-  echo "FAILED:$failed"
+  echo "  ${RED}failed cells:$failed${RESET}"
   exit 1
 fi
-echo "all $total cells green on node $(node -v)"
diff --git a/integrations/test-results/.last-run.json b/integrations/test-results/.last-run.json
deleted file mode 100644
index cbcc1fba..00000000
--- a/integrations/test-results/.last-run.json
+++ /dev/null
@@ -1,4 +0,0 @@
-{
-  "status": "passed",
-  "failedTests": []
-}
\ No newline at end of file

From 2809aa85be8743eb0b5874956ac23ce54bb20c40 Mon Sep 17 00:00:00 2001
From: Arpit Bruno <arpit@usebruno.com>
Date: Fri, 18 Sep 2026 11:34:16 +0530
Subject: [PATCH 15/21] reject unknown options and coverage for:413, 500, logo
 and the page itself in the contract suite

---
 .gitignore                                    |  1 +
 integrations/contract-tests/apps/express.js   |  6 ++++++
 integrations/contract-tests/apps/fastify.js   |  3 +++
 integrations/contract-tests/apps/nestjs.js    |  5 ++++-
 integrations/contract-tests/check.sh          | 20 +++++++++++++++++--
 .../node_modules/some-dep/index.yml           |  2 ++
 .../fixtures/walk-safety/notes.md             |  3 +++
 integrations/contract-tests/lib.sh            |  2 ++
 integrations/nodejs/core/src/options.ts       | 15 ++++++++++++--
 integrations/nodejs/core/test/docs.test.mjs   |  4 ++++
 integrations/nodejs/core/test/filter.test.mjs |  1 +
 integrations/nodejs/core/test/walk.test.mjs   |  2 ++
 integrations/nodejs/fastify/src/index.ts      |  7 +++++--
 integrations/nodejs/nestjs/src/index.ts       |  5 +++--
 integrations/nodejs/scripts/check-all.sh      |  2 +-
 15 files changed, 68 insertions(+), 10 deletions(-)
 create mode 100644 integrations/contract-tests/fixtures/walk-safety/node_modules/some-dep/index.yml
 create mode 100644 integrations/contract-tests/fixtures/walk-safety/notes.md

diff --git a/.gitignore b/.gitignore
index 5e3be8bf..69ab7c0b 100644
--- a/.gitignore
+++ b/.gitignore
@@ -8,3 +8,4 @@ test.js
 .claude/
 CLAUDE.md
 test-results
+!integrations/contract-tests/fixtures/walk-safety/node_modules/
diff --git a/integrations/contract-tests/apps/express.js b/integrations/contract-tests/apps/express.js
index 280af5de..be8b8ba8 100644
--- a/integrations/contract-tests/apps/express.js
+++ b/integrations/contract-tests/apps/express.js
@@ -34,6 +34,7 @@ app.use('/docs', apiDocs({
   environments: { include: ['Local'] },
   tags: { exclude: ['internal'] },
   pageTitle: 'Acme API',
+  logo: 'data:image/svg+xml,%3Csvg xmlns=%22http://www.w3.org/2000/svg%22 viewBox=%220 0 10 10%22%3E%3Ccircle cx=%225%22 cy=%225%22 r=%225%22/%3E%3C/svg%3E',
   gitCollectionUrl: 'https://token:secret@github.com/acme/api-collection'
 }));
 
@@ -45,6 +46,11 @@ app.use('/bundled/docs', apiDocs({ collection: BUNDLED }));
 
 app.use('/broken/docs', apiDocs({ collection: './there-is-no-collection-here' }));
 
+app.use('/oversize/docs', apiDocs({ collection: '../fixtures/walk-oversize' }));
+
+// theme is what the renderer will take next; until it does, passing it is a mistake we report
+app.use('/misconfigured/docs', apiDocs({ collection: COLLECTION, theme: 'dark' }));
+
 // the docs inside the host's own page: the mount serves, the block only points at it
 app.use('/portal/docs', apiDocs({ collection: COLLECTION, environments: { include: ['Local'] } }));
 app.get('/portal', (req, res) => {
diff --git a/integrations/contract-tests/apps/fastify.js b/integrations/contract-tests/apps/fastify.js
index 7625d59b..71178519 100644
--- a/integrations/contract-tests/apps/fastify.js
+++ b/integrations/contract-tests/apps/fastify.js
@@ -39,6 +39,7 @@ async function main() {
     environments: { include: ['Local'] },
     tags: { exclude: ['internal'] },
     pageTitle: 'Acme API',
+    logo: 'data:image/svg+xml,%3Csvg xmlns=%22http://www.w3.org/2000/svg%22 viewBox=%220 0 10 10%22%3E%3Ccircle cx=%225%22 cy=%225%22 r=%225%22/%3E%3C/svg%3E',
     gitCollectionUrl: 'https://token:secret@github.com/acme/api-collection'
   });
 
@@ -51,6 +52,8 @@ async function main() {
   await app.register(apiDocs, { prefix: '/internal/docs', collection: COLLECTION });
   await app.register(apiDocs, { prefix: '/bundled/docs', collection: BUNDLED });
   await app.register(apiDocs, { prefix: '/broken/docs', collection: './there-is-no-collection-here' });
+  await app.register(apiDocs, { prefix: '/oversize/docs', collection: '../fixtures/walk-oversize' });
+  await app.register(apiDocs, { prefix: '/misconfigured/docs', collection: COLLECTION, theme: 'dark' });
 
   await app.listen({ port: PORT, host: '127.0.0.1' });
   console.log(`fastify rig on http://localhost:${PORT}`);
diff --git a/integrations/contract-tests/apps/nestjs.js b/integrations/contract-tests/apps/nestjs.js
index 1a3c1038..f94c251c 100644
--- a/integrations/contract-tests/apps/nestjs.js
+++ b/integrations/contract-tests/apps/nestjs.js
@@ -25,6 +25,7 @@ Module({
       environments: { include: ['Local'] },
       tags: { exclude: ['internal'] },
       pageTitle: 'Acme API',
+      logo: 'data:image/svg+xml,%3Csvg xmlns=%22http://www.w3.org/2000/svg%22 viewBox=%220 0 10 10%22%3E%3Ccircle cx=%225%22 cy=%225%22 r=%225%22/%3E%3C/svg%3E',
       gitCollectionUrl: 'https://token:secret@github.com/acme/api-collection'
     }),
     ApiDocsModule.forRoot({
@@ -34,7 +35,9 @@ Module({
     }),
     ApiDocsModule.forRoot({ mountPath: '/internal/docs', collection: COLLECTION }),
     ApiDocsModule.forRoot({ mountPath: '/bundled/docs', collection: BUNDLED }),
-    ApiDocsModule.forRoot({ mountPath: '/broken/docs', collection: './there-is-no-collection-here' })
+    ApiDocsModule.forRoot({ mountPath: '/broken/docs', collection: './there-is-no-collection-here' }),
+    ApiDocsModule.forRoot({ mountPath: '/oversize/docs', collection: '../fixtures/walk-oversize' }),
+    ApiDocsModule.forRoot({ mountPath: '/misconfigured/docs', collection: COLLECTION, theme: 'dark' })
   ]
 })(AppModule);
 
diff --git a/integrations/contract-tests/check.sh b/integrations/contract-tests/check.sh
index eb6a15b5..f07eea3c 100755
--- a/integrations/contract-tests/check.sh
+++ b/integrations/contract-tests/check.sh
@@ -14,6 +14,8 @@
 #   /internal/docs no options
 #   /bundled/docs  a single bundled yml
 #   /broken/docs   a collection that is not there
+#   /oversize/docs a collection over the caps
+#   /misconfigured/docs  an option the core does not know
 set -euo pipefail
 
 ROOT="$(cd "$(dirname "$0")/.." && pwd)"
@@ -66,6 +68,7 @@ for MOUNT in /docs /api/v2/docs /internal/docs; do
   check "$MOUNT/shell.js -> javascript"                        header_has Content-Type javascript "$url/shell.js"
   check "$MOUNT/shell.js -> public, max-age=3600"              header_has Cache-Control 'public, max-age=3600' "$url/shell.js"
   check "$MOUNT/shell.js -> 304 on If-None-Match"              revalidates "$url/shell.js"
+  check "$MOUNT/collection.yml -> json, it is a directory"     header_has Content-Type application/json "$url/collection.yml"
   check "$MOUNT/collection.yml -> no-store"                    header_has Cache-Control no-store "$url/collection.yml"
   check "$MOUNT/collection.yml -> nosniff"                     header_has X-Content-Type-Options nosniff "$url/collection.yml"
   check "$MOUNT/collection.yml -> 304 on If-None-Match"        revalidates "$url/collection.yml"
@@ -75,9 +78,11 @@ for MOUNT in /docs /api/v2/docs /internal/docs; do
   check "$MOUNT/ HEAD -> 200"                                  status_is 200 -I "$url/"
   check "$MOUNT/shell.js HEAD -> 200"                          status_is 200 -I "$url/shell.js"
   check "$MOUNT/collection.yml HEAD -> 200"                    status_is 200 -I "$url/collection.yml"
+  check "$MOUNT/collection.yml HEAD -> the GET's headers"      head_like_get "$url/collection.yml"
 
   curl -s "$url/collection.yml" >"$TMP/coll$saved.json"
   curl -s "$url/shell.js" >"$TMP/shell$saved.js"
+  curl -s "$url/" >"$TMP/page$saved.html"
 done
 
 describe "shell.js is one file, whatever the mount"
@@ -111,6 +116,8 @@ check "/docs data-config has no pageTitle"      config_lacks "$BASE/docs/" 'page
 check "/docs data-config has no server option"  config_lacks "$BASE/docs/" 'tags|environments|collection'
 check "/docs git url is forwarded"              body_has "$BASE/docs/" 'acme/api-collection'
 check "/docs git credentials are stripped"      body_lacks "$BASE/docs/" 'token:secret'
+check "/docs data-config carries the logo"      config_has "$BASE/docs/" 'logo'
+check "/internal/docs, no logo set, has none"   config_lacks "$BASE/internal/docs/" 'logo'
 
 describe "a single bundled file"
 check "/bundled/docs/ -> the page"              status_is 200 "$BASE/bundled/docs/"
@@ -124,6 +131,15 @@ check "/broken/docs/ -> 404, not a crash"       status_is 404 "$BASE/broken/docs
 check "/broken/docs/ says what is wrong"        body_has "$BASE/broken/docs/" 'Collection not found'
 check "/broken/docs/collection.yml -> 404 too"  status_is 404 "$BASE/broken/docs/collection.yml"
 
+describe "a collection over the caps is refused at the mount"
+check "/oversize/docs/collection.yml -> 413"    status_is 413 "$BASE/oversize/docs/collection.yml"
+check "/oversize/docs/ -> 413 as well"          status_is 413 "$BASE/oversize/docs/"
+check "and it names the cap"                    body_has "$BASE/oversize/docs/" 'per-file size cap'
+
+describe "an option we do not know is an error, not a silent no-op"
+check "/misconfigured/docs/ -> 500"             status_is 500 "$BASE/misconfigured/docs/"
+check "naming the key"                          body_has "$BASE/misconfigured/docs/" 'unknown option theme'
+
 if [ "$(curl -s -o /dev/null -w '%{http_code}' "$BASE/portal")" = "200" ]; then
   describe "embed(): the docs block inside the host's own page"
   check "the host's own page is what is served"  body_has "$BASE/portal" 'Acme Developer Portal'
@@ -152,13 +168,13 @@ check "and instantiating that wasm"            header_has Content-Security-Polic
 
 if [ -n "$SAVE" ]; then
   mkdir -p "$SAVE"
-  cp "$TMP"/coll_*.json "$TMP"/shell_docs.js "$SAVE/"
+  cp "$TMP"/coll_*.json "$TMP"/page_*.html "$TMP"/shell_docs.js "$SAVE/"
   echo "saved served bodies to $SAVE"
 fi
 
 if [ -n "$COMPARE" ]; then
   describe "byte-identical to $COMPARE"
-  for f in "$TMP"/coll_*.json "$TMP"/shell_docs.js; do
+  for f in "$TMP"/coll_*.json "$TMP"/page_*.html "$TMP"/shell_docs.js; do
     name="$(basename "$f")"
     check "$name matches" cmp -s "$f" "$COMPARE/$name"
   done
diff --git a/integrations/contract-tests/fixtures/walk-safety/node_modules/some-dep/index.yml b/integrations/contract-tests/fixtures/walk-safety/node_modules/some-dep/index.yml
new file mode 100644
index 00000000..8cb115ed
--- /dev/null
+++ b/integrations/contract-tests/fixtures/walk-safety/node_modules/some-dep/index.yml
@@ -0,0 +1,2 @@
+info:
+  name: a dependency shipping yml that must never be served
diff --git a/integrations/contract-tests/fixtures/walk-safety/notes.md b/integrations/contract-tests/fixtures/walk-safety/notes.md
new file mode 100644
index 00000000..e8f4b8e4
--- /dev/null
+++ b/integrations/contract-tests/fixtures/walk-safety/notes.md
@@ -0,0 +1,3 @@
+# Notes
+
+A markdown file beside the collection. Not yml, not served.
diff --git a/integrations/contract-tests/lib.sh b/integrations/contract-tests/lib.sh
index d1669dcc..be66dcc6 100644
--- a/integrations/contract-tests/lib.sh
+++ b/integrations/contract-tests/lib.sh
@@ -140,5 +140,7 @@ paths_are() { want="$2"; got="$(paths_in "$1")"; [ "$got" = "$2" ]; }
 none_mention() { want="'$1' in no file"; got="found in: $(grep -l "$1" "${@:2}" 2>/dev/null | xargs -n1 basename 2>/dev/null | tr '\n' ' ')"; ! grep -q "$1" "${@:2}"; }
 no_origins() { want="no absolute origin in $(basename "$1")"; got="origins: $(grep -oE 'https?://[A-Za-z0-9./_-]+' "$1" | sort -u | tr '\n' ' ')"; ! grep -oE 'https?://[A-Za-z0-9./_-]+' "$1" | grep -q .; }
 occurs_once() { want="exactly 1 occurrence of '$2'"; got="$(curl -s "$1" | grep -c "$2") occurrences"; [ "${got%% *}" = "1" ]; }
+head_like_get() { want="$(header_of Content-Type "$1"; header_of Cache-Control "$1")"; got="$(header_of Content-Type -I "$1"; header_of Cache-Control -I "$1")"; [ "$got" = "$want" ]; }
 config_of() { curl -s "$1" | grep -o 'data-config="[^"]*"'; }
+config_has() { want="data-config with ($2)"; got="$(config_of "$1")"; grep -Eq "&quot;($2)&quot;:" <<<"$got"; }
 config_lacks() { want="data-config without ($2)"; got="$(config_of "$1")"; ! grep -Eq "&quot;($2)&quot;:" <<<"$got"; }
diff --git a/integrations/nodejs/core/src/options.ts b/integrations/nodejs/core/src/options.ts
index f0291af0..78dbb63d 100644
--- a/integrations/nodejs/core/src/options.ts
+++ b/integrations/nodejs/core/src/options.ts
@@ -10,7 +10,10 @@ export interface TagsOption {
 }
 
 export interface CollectionOptions {
-  /** A collection directory or one bundled .yml. Relative to the app's entry file, not the cwd. */
+  /**
+   * A collection directory or one bundled .yml. Relative to the app's entry file, not the cwd;
+   * after a build that is the built entry, so `dist/main.js` counts from `dist/`.
+   */
   collection: string;
   /** Environments to publish. Absent means none, as in the app and the CLI. Directory mode only. */
   environments?: EnvironmentsOption;
@@ -30,7 +33,15 @@ export interface ApiDocsOptions extends CollectionOptions, RendererOptions {
 
 export class ConfigError extends Error {}
 
-export function validateOptions(options: CollectionOptions): void {
+const KNOWN_OPTIONS = new Set(['collection', 'environments', 'tags', 'logo', 'gitCollectionUrl', 'pageTitle']);
+
+/** A key we do not know is a typo or an option the renderer does not read yet. Either way, say so. */
+export function validateOptions(options: ApiDocsOptions): void {
+  const unknown = Object.keys(options).filter((key) => !KNOWN_OPTIONS.has(key));
+  if (unknown.length > 0) {
+    throw new ConfigError(`apiDocs: unknown option ${unknown.join(', ')}`);
+  }
+
   const env = options.environments;
   if (!env) return;
 
diff --git a/integrations/nodejs/core/test/docs.test.mjs b/integrations/nodejs/core/test/docs.test.mjs
index 1cc414e7..e6a5702b 100644
--- a/integrations/nodejs/core/test/docs.test.mjs
+++ b/integrations/nodejs/core/test/docs.test.mjs
@@ -140,6 +140,10 @@ const handler = docs.handler();
 
   const badOptions = quiet(() => createDocs({ collection, environments: { exclude: ['Prod'] } }));
   assert.equal(badOptions.collection().status, 500, 'a config error reaches the mount too, not the boot');
+
+  const typo = quiet(() => createDocs({ collection, theme: 'dark' }));
+  assert.equal(typo.collection().status, 500, 'an option we do not know is an error, not silently forwarded');
+  assert.match(String(typo.collection().body), /unknown option theme/);
 }
 
 fs.rmSync(path.join(os.tmpdir(), 'x-not-there'), { force: true });
diff --git a/integrations/nodejs/core/test/filter.test.mjs b/integrations/nodejs/core/test/filter.test.mjs
index 0ec754b7..71cd125d 100644
--- a/integrations/nodejs/core/test/filter.test.mjs
+++ b/integrations/nodejs/core/test/filter.test.mjs
@@ -107,6 +107,7 @@ assert.equal(isRequestTagsIncluded(['a', 'b'], [], ['b']), false, 'any one exclu
 
 // --- startup validation of the same options
 assert.throws(() => validateOptions({ environments: { exclude: ['Prod'] } }), /needs a base/);
+assert.throws(() => validateOptions({ collection: './c', theme: 'dark', favicon: 'x' }), /unknown option theme, favicon/, 'every unknown key, named');
 assert.throws(() => validateOptions({ environments: { all: true, include: ['Local'] } }), /cannot be combined/);
 validateOptions({ environments: { all: true, exclude: ['Prod'] } });
 validateOptions({});
diff --git a/integrations/nodejs/core/test/walk.test.mjs b/integrations/nodejs/core/test/walk.test.mjs
index ba6fc0b3..ef3b0007 100644
--- a/integrations/nodejs/core/test/walk.test.mjs
+++ b/integrations/nodejs/core/test/walk.test.mjs
@@ -25,6 +25,8 @@ const fixture = (name) => path.join(here, '..', '..', '..', 'contract-tests', 'f
     assert.ok(!f.text.includes('root:x:0:0'), '/etc/passwd content never served');
   }
   assert.ok(skipped.some((s) => s.path === 'control/not-utf8.yml' && /UTF-8/.test(s.rule)), 'invalid UTF-8 file is skipped, not served');
+  assert.ok(skipped.some((s) => s.path === 'node_modules' && /stray/.test(s.rule)), 'node_modules is skipped whole, never entered');
+  assert.ok(skipped.some((s) => s.path === 'notes.md' && /not \.yml/.test(s.rule)), 'a non-yml file is skipped by extension');
   assert.deepEqual(served, ['control/ping.yml', 'environments/Local.yml', 'opencollection.yml'], 'exactly these files, in this order');
   console.log(`walk-safety: ${served.length} served, ${skipped.length} skipped`);
   for (const s of skipped) {
diff --git a/integrations/nodejs/fastify/src/index.ts b/integrations/nodejs/fastify/src/index.ts
index 7849c1d3..debc6a36 100644
--- a/integrations/nodejs/fastify/src/index.ts
+++ b/integrations/nodejs/fastify/src/index.ts
@@ -1,4 +1,4 @@
-import type { FastifyPluginAsync, FastifyReply } from 'fastify';
+import type { FastifyPluginAsync, FastifyReply, RegisterOptions } from 'fastify';
 import { createDocs, embed, type ApiDocsOptions, type HttpResponse } from '@usebruno/api-docs-core';
 
 export { createDocs, embed };
@@ -25,7 +25,10 @@ const send = (reply: FastifyReply, response: HttpResponse): FastifyReply => {
  * front with `child.addHook('onRequest', ...)`.
  */
 export const apiDocs: FastifyPluginAsync<ApiDocsOptions> = async (fastify, options) => {
-  const docs = createDocs(options);
+  // Fastify hands its own register options (prefix, logLevel, ...) to the plugin with ours
+  const { prefix: _prefix, logLevel: _logLevel, logSerializers: _logSerializers, ...docsOptions }
+    = options as ApiDocsOptions & RegisterOptions;
+  const docs = createDocs(docsOptions);
   const base = `${fastify.prefix}/`;
   const lastSegment = fastify.prefix.split('/').filter(Boolean).pop() ?? '';
   const hide = { schema: { hide: true } };
diff --git a/integrations/nodejs/nestjs/src/index.ts b/integrations/nodejs/nestjs/src/index.ts
index 5ad7abb4..4345a974 100644
--- a/integrations/nodejs/nestjs/src/index.ts
+++ b/integrations/nodejs/nestjs/src/index.ts
@@ -26,8 +26,9 @@ export function subPathOf(fullUrl: string, mountPath: string): string {
 /** `ApiDocsModule.forRoot({ collection: './api-collection', mountPath: '/docs' })`. */
 export class ApiDocsModule {
   static forRoot(options: ApiDocsModuleOptions): DynamicModule {
-    const mountPath = (options.mountPath ?? DEFAULT_MOUNT_PATH).replace(/\/+$/, '');
-    const handler = createDocs(options).handler();
+    const { mountPath: mountOption, ...docsOptions } = options;
+    const mountPath = (mountOption ?? DEFAULT_MOUNT_PATH).replace(/\/+$/, '');
+    const handler = createDocs(docsOptions).handler();
 
     @Module({})
     class ApiDocsHostModule implements NestModule {
diff --git a/integrations/nodejs/scripts/check-all.sh b/integrations/nodejs/scripts/check-all.sh
index edb52793..27315220 100755
--- a/integrations/nodejs/scripts/check-all.sh
+++ b/integrations/nodejs/scripts/check-all.sh
@@ -24,4 +24,4 @@ run "nestjs/express" contract-tests/apps/nestjs.js  5458 express --compare "$BOD
 run "nestjs/fastify" contract-tests/apps/nestjs.js  5459 fastify --compare "$BODIES"
 
 echo
-echo "${GREEN}every framework agrees, byte for byte${RESET}"
+echo "${GREEN}every framework agrees, byte for byte: the page, the documents, the bundle${RESET}"

From 7c98f239017ca9f5f49dbf11393714231c454001 Mon Sep 17 00:00:00 2001
From: Arpit Bruno <arpit@usebruno.com>
Date: Fri, 18 Sep 2026 11:42:07 +0530
Subject: [PATCH 16/21] reports four test layers separately

---
 .github/workflows/ci.yml                 | 26 +++++++++++++++----
 integrations/contract-tests/examples.sh  |  4 +++
 integrations/contract-tests/lib.sh       | 10 +++++++
 integrations/nodejs/scripts/check-all.sh |  2 ++
 integrations/nodejs/scripts/matrix.sh    |  4 +++
 integrations/nodejs/scripts/unit.sh      | 33 ++++++++++++++++++++++++
 integrations/package.json                |  3 ++-
 7 files changed, 76 insertions(+), 6 deletions(-)
 create mode 100644 integrations/nodejs/scripts/unit.sh

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 1958a885..4161427e 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -104,6 +104,9 @@ jobs:
     defaults:
       run:
         working-directory: integrations
+    env:
+      FORCE_COLOR: 1
+      JUNIT_DIR: results
     steps:
       - uses: actions/checkout@v4
 
@@ -119,17 +122,30 @@ jobs:
 
       - run: npm ci
 
-      - run: npm run test:ci
-        env:
-          FORCE_COLOR: 1
-          JUNIT_DIR: results
+      - name: lint
+        run: npm run lint
+
+      - name: build
+        run: npm run build
+
+      - name: unit
+        run: bash nodejs/scripts/unit.sh
+
+      - name: contract, every framework byte for byte
+        run: bash nodejs/scripts/check-all.sh
+
+      - name: examples
+        run: bash contract-tests/examples.sh
+
+      - name: one matrix cell, from packed tarballs
+        run: bash nodejs/scripts/matrix.sh --cell express@5 --results results
 
       # every assertion in the Checks tab, failures as annotations
       - uses: dorny/test-reporter@a43b3a5f7366b97d083190328d2c652e1a8b6aa2 # v3.0.0
         if: always()
         with:
           name: integrations
-          path: integrations/results/*.xml
+          path: integrations/results/**/*.xml
           reporter: java-junit
           fail-on-error: false
 
diff --git a/integrations/contract-tests/examples.sh b/integrations/contract-tests/examples.sh
index 61c5d186..9960a60e 100644
--- a/integrations/contract-tests/examples.sh
+++ b/integrations/contract-tests/examples.sh
@@ -17,6 +17,10 @@ while [ $# -gt 0 ]; do
   esac
 done
 
+covered "$0" \
+  $(cd "$ROOT" && ls nodejs/*/examples/*.js) \
+  $(cd "$ROOT" && ls -d nodejs/nestjs/examples/0*/ | sed 's|examples/\(.*\)/$|examples/dist/\1/main.js|')
+
 BASE="http://localhost:$PORT"
 JUNIT_NAME="${JUNIT_NAME:-examples}"
 TMP="$(mktemp -d)"
diff --git a/integrations/contract-tests/lib.sh b/integrations/contract-tests/lib.sh
index be66dcc6..0ac36efb 100644
--- a/integrations/contract-tests/lib.sh
+++ b/integrations/contract-tests/lib.sh
@@ -92,6 +92,16 @@ summary() {
   [ "$fail" -eq 0 ]
 }
 
+# covered SCRIPT NAME...: every NAME must appear in SCRIPT, or something new was dropped in without
+# being wired up. Fails loudly rather than leaving a silent gap in coverage.
+covered() {
+  local script=$1
+  shift
+  for name in "$@"; do
+    grep -qF "$name" "$script" || { echo "$(basename "$script") does not run $name. Add it." >&2; exit 1; }
+  done
+}
+
 # ---- the server ---------------------------------------------------------------
 
 # a leftover server on the port would answer every assertion, and the suite would be grading the
diff --git a/integrations/nodejs/scripts/check-all.sh b/integrations/nodejs/scripts/check-all.sh
index 27315220..5bbd047d 100755
--- a/integrations/nodejs/scripts/check-all.sh
+++ b/integrations/nodejs/scripts/check-all.sh
@@ -7,6 +7,8 @@ set -euo pipefail
 ROOT="$(cd "$(dirname "$0")/../.." && pwd)"
 source "$ROOT/contract-tests/lib.sh"
 
+covered "$0" $(cd "$ROOT/contract-tests/apps" && ls *.js | sed 's|^|apps/|')
+
 BODIES="$(mktemp -d)"
 trap 'rm -rf "$BODIES"' EXIT
 
diff --git a/integrations/nodejs/scripts/matrix.sh b/integrations/nodejs/scripts/matrix.sh
index aad092b4..2e0a8143 100755
--- a/integrations/nodejs/scripts/matrix.sh
+++ b/integrations/nodejs/scripts/matrix.sh
@@ -75,6 +75,10 @@ if [ -n "$DOCKER" ]; then
 fi
 
 ALL_CELLS="express@4 express@5 fastify@4 fastify@5 nestjs@10 nestjs@11 nestjs@12"
+for app in "$ROOT"/contract-tests/apps/*.js; do
+  family="$(basename "$app" .js)"
+  [[ " $ALL_CELLS " == *" $family@"* ]] || { echo "$family has a rig but no cells in the matrix. Add its majors to ALL_CELLS and deps_for." >&2; exit 1; }
+done
 if [ -n "$CELL" ]; then
   case " $ALL_CELLS " in *" $CELL "*) ;; *) echo "unknown cell '$CELL'. one of: $ALL_CELLS" >&2; exit 2 ;; esac
   CELLS="$CELL"
diff --git a/integrations/nodejs/scripts/unit.sh b/integrations/nodejs/scripts/unit.sh
new file mode 100644
index 00000000..279e80c2
--- /dev/null
+++ b/integrations/nodejs/scripts/unit.sh
@@ -0,0 +1,33 @@
+#!/usr/bin/env bash
+# The unit suites, reported like the other layers: one line each, a JUnit file when CI asks.
+# Each suite is a plain node script that exits non-zero on its first failed assertion.
+set -euo pipefail
+
+ROOT="$(cd "$(dirname "$0")/../.." && pwd)"
+source "$ROOT/contract-tests/lib.sh"
+JUNIT_NAME="${JUNIT_NAME:-unit}"
+
+# runs CMD...: passes when the command exits clean; otherwise the tail of its output is what we saw
+runs() {
+  local out
+  out="$("$@" 2>&1)" && return 0
+  want="a clean exit"
+  got="$(tail -4 <<<"$out")"
+
+  return 1
+}
+
+describe "core"
+check "walk: the safety rules and the caps"      runs node "$ROOT/nodejs/core/test/walk.test.mjs"
+check "filter: environments and tags by file"    runs node "$ROOT/nodejs/core/test/filter.test.mjs"
+check "collection: sources and providers"        runs node "$ROOT/nodejs/core/test/collection.test.mjs"
+check "shell: the page, the bundle, embed()"     runs node "$ROOT/nodejs/core/test/shell.test.mjs"
+check "docs: createDocs end to end"              runs node "$ROOT/nodejs/core/test/docs.test.mjs"
+
+describe "wrappers"
+check "nestjs: the sub-path on platform-fastify" runs node "$ROOT/nodejs/nestjs/test/sub-path.test.mjs"
+
+describe "shell"
+check "assemble: fragments into one document"    runs node "$ROOT/shell/test/assemble.test.mjs"
+
+summary
diff --git a/integrations/package.json b/integrations/package.json
index ee0f8c0a..b0174429 100644
--- a/integrations/package.json
+++ b/integrations/package.json
@@ -22,6 +22,7 @@
     "lint": "eslint",
     "lint:fix": "eslint --fix",
     "matrix": "npm run build && bash nodejs/scripts/matrix.sh",
+    "matrix:docker": "npm run build && bash nodejs/scripts/matrix.sh --docker",
     "pack-check": "npm run build && bash nodejs/scripts/matrix.sh --cell express@5",
     "setup": "bash scripts/setup.sh",
     "start:express": "node contract-tests/apps/express.js",
@@ -37,7 +38,7 @@
     "test:filter": "npm run build:core && node nodejs/core/test/filter.test.mjs",
     "test:nestjs": "npm run build && node nodejs/nestjs/test/sub-path.test.mjs",
     "test:shell": "npm run build && node nodejs/core/test/shell.test.mjs",
-    "test:unit": "npm run build && node nodejs/core/test/walk.test.mjs && node nodejs/core/test/filter.test.mjs && node nodejs/core/test/collection.test.mjs && node nodejs/core/test/shell.test.mjs && node nodejs/core/test/docs.test.mjs && node nodejs/nestjs/test/sub-path.test.mjs && node shell/test/assemble.test.mjs",
+    "test:unit": "npm run build && bash nodejs/scripts/unit.sh",
     "test:walk": "npm run build:core && node nodejs/core/test/walk.test.mjs"
   },
   "devDependencies": {

From 127723a484394ef4406380a856e574f4c8669c3a Mon Sep 17 00:00:00 2001
From: Arpit Bruno <arpit@usebruno.com>
Date: Fri, 18 Sep 2026 12:05:29 +0530
Subject: [PATCH 17/21]  fix folders lost in assembly and the fixture's auth

---
 .github/workflows/ci.yml                      | 15 +++-
 .../{docs.spec.mjs => contract.spec.mjs}      | 47 ++++++++++++-
 .../browser/playwright.config.mjs             | 19 ++++--
 .../contract-tests/browser/renderer.spec.mjs  | 68 +++++++++++++++++++
 .../api-collection/catalog/folder.yml         |  2 +
 .../api-collection/catalog/get product.yml    |  1 +
 .../api-collection/catalog/list products.yml  |  1 +
 .../catalog/reindex catalog.yml               |  1 +
 .../api-collection/internal/folder.yml        |  2 +
 .../api-collection/internal/purge cache.yml   |  1 +
 .../api-collection/mixed/drain node.yml       |  1 +
 .../fixtures/api-collection/mixed/folder.yml  |  2 +
 .../fixtures/api-collection/mixed/health.yml  |  1 +
 .../api-collection/opencollection.yml         |  7 +-
 integrations/shell/assemble.mjs               |  5 +-
 integrations/shell/test/assemble.test.mjs     |  2 +
 16 files changed, 161 insertions(+), 14 deletions(-)
 rename integrations/contract-tests/browser/{docs.spec.mjs => contract.spec.mjs} (55%)
 create mode 100644 integrations/contract-tests/browser/renderer.spec.mjs

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 4161427e..8c319b50 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -149,7 +149,16 @@ jobs:
           reporter: java-junit
           fail-on-error: false
 
-      # depends on the live CDN bundle, which this repo does not control, so it cannot block a merge
-      - name: browser contract, against the CDN
+      # both tiers depend on the live CDN bundle, which this repo does not control, so neither can
+      # block a merge. `contract` is ours to fix when red; `renderer` is theirs to know about.
+      - name: browser
         continue-on-error: true
-        run: npx playwright install --with-deps chromium && npm run test:browser
+        run: npx playwright install --with-deps chromium
+
+      - name: browser, our contract
+        continue-on-error: true
+        run: npx playwright test --config contract-tests/browser/playwright.config.mjs --project=contract
+
+      - name: browser, the renderer
+        continue-on-error: true
+        run: npx playwright test --config contract-tests/browser/playwright.config.mjs --project=renderer
diff --git a/integrations/contract-tests/browser/docs.spec.mjs b/integrations/contract-tests/browser/contract.spec.mjs
similarity index 55%
rename from integrations/contract-tests/browser/docs.spec.mjs
rename to integrations/contract-tests/browser/contract.spec.mjs
index f2bbdd29..8ed54763 100644
--- a/integrations/contract-tests/browser/docs.spec.mjs
+++ b/integrations/contract-tests/browser/contract.spec.mjs
@@ -1,6 +1,9 @@
 import { test, expect } from '@playwright/test';
 
-// What a reader actually gets. check.sh proves the bytes; this proves the page built from them.
+// What our shell and server promise a reader, seen from a browser. check.sh proves the bytes; this
+// proves the page built from them. Everything here is ours to fix when it fails.
+
+const LOCAL_TOKEN = 'local-token-safe-to-publish';
 
 const consoleErrorsOn = (page) => {
   const errors = [];
@@ -32,6 +35,10 @@ test('the renderer booted, from the CDN, with our shell from our own origin', as
   expect(sources.some((u) => u.endsWith('/docs/shell.js')), 'shell.js is same-origin').toBe(true);
   expect(sources.some((u) => u.startsWith('https://cdn.usebruno.com/')), 'the renderer is the CDN bundle').toBe(true);
   expect(await page.evaluate(() => typeof window.OpenCollection)).toBe('function');
+
+  // the shell boots through window.Bruno first when it exists. The day the CDN bundle ships it,
+  // this fails on purpose: re-check the boot order and the options we pass, then update it.
+  expect(await page.evaluate(() => typeof window.Bruno), 'window.Bruno has appeared on the CDN bundle').toBe('undefined');
 });
 
 test('the filters hold all the way to the page', async ({ page }) => {
@@ -50,16 +57,39 @@ test('the filters hold all the way to the page', async ({ page }) => {
   expect(text, 'and its values never left the server').not.toContain('prod-token-must-never-be-served');
 });
 
-test('a deep link renders on its own, after a reload', async ({ page }) => {
+test('the page is served at any depth, and the renderer routes by hash', async ({ page }) => {
   const errors = consoleErrorsOn(page);
+
+  // any path under the mount is the page: a proxy or a hand-typed URL lands on the docs
   await page.goto('/docs/catalog/list-products/', { waitUntil: 'networkidle' });
   await expect(page.getByText('Catalog', { exact: true }).first()).toBeVisible();
 
+  // the link that opens a request is the renderer's hash route, and it survives a reload
+  await page.goto('/docs/#/catalog/list-products', { waitUntil: 'networkidle' });
+  await expect(page.locator('[data-page-slug="catalog/list-products"]')).toBeVisible();
   await page.reload({ waitUntil: 'networkidle' });
-  await expect(page.getByText('Catalog', { exact: true }).first()).toBeVisible();
+  await expect(page.locator('[data-page-slug="catalog/list-products"]')).toBeVisible();
   expect(errors).toEqual([]);
 });
 
+test('try it sends the published environment, and only that', async ({ page }) => {
+  let sent;
+  // the fixture's baseUrl points at a port nothing listens on; answer for it and keep the request
+  await page.route('**/products', async (route) => {
+    sent = route.request();
+    await route.fulfill({ status: 200, contentType: 'application/json', body: '[]', headers: { 'access-control-allow-origin': '*', 'access-control-allow-headers': '*' } });
+  });
+
+  await page.goto('/docs/#/catalog/list-products', { waitUntil: 'networkidle' });
+  await page.getByTestId('request-try-button').click();
+  await page.getByTestId('query-bar-send').click();
+  await expect.poll(() => sent, 'the request left the browser').toBeTruthy();
+
+  const headers = await sent.allHeaders();
+  expect(headers.authorization, 'the collection auth, resolved from the Local environment').toBe(`Bearer ${LOCAL_TOKEN}`);
+  expect(sent.url(), 'the Local baseUrl was interpolated').toContain('localhost:5456/products');
+});
+
 test('a bundled single file renders the same way', async ({ page }) => {
   await page.goto('/bundled/docs/', { waitUntil: 'networkidle' });
   await expect(page).toHaveTitle('API Documentation');
@@ -76,3 +106,14 @@ test('a broken mount explains itself in the page, and the app is still up', asyn
 
   expect((await request.get('/control')).status(), 'the host app is unaffected').toBe(200);
 });
+
+test('when the CDN is unreachable, the shell says so instead of a blank page', async ({ page }) => {
+  await page.route('https://cdn.usebruno.com/**', (route) => route.abort());
+  await page.goto('/docs/', { waitUntil: 'networkidle' });
+
+  const box = page.locator('#bruno-docs-error');
+  await expect(box).toBeVisible();
+  await expect(box).toContainText('renderer bundle did not load');
+  await expect(box, 'it names the origin the adopter has to allow').toContainText('cdn.usebruno.com');
+  await expect(page.locator('#bruno-docs')).toBeHidden();
+});
diff --git a/integrations/contract-tests/browser/playwright.config.mjs b/integrations/contract-tests/browser/playwright.config.mjs
index a8911201..3d669ee3 100644
--- a/integrations/contract-tests/browser/playwright.config.mjs
+++ b/integrations/contract-tests/browser/playwright.config.mjs
@@ -4,16 +4,27 @@ import { defineConfig } from '@playwright/test';
 
 const ROOT = path.join(path.dirname(fileURLToPath(import.meta.url)), '..', '..');
 
-// APP and PORT are how another language core points this at its own server. The spec itself
-// asserts only what the contract promises, so it does not care which one booted.
+// APP and PORT are how another language core points this at its own server. The specs assert
+// only what the contract promises, so they do not care which one booted.
 const APP = process.env.APP || 'contract-tests/apps/express.js';
-const PORT = process.env.PORT || '5462';
+// 5456 is the fixture's Local baseUrl: try it hits the same origin, as it does when the docs live in the API
+const PORT = process.env.PORT || '5456';
 
+// two tiers. `contract` is what our shell and server promise, and a failure there is ours.
+// `renderer` is the renderer's own behaviour reached through our mount, and a failure there is
+// something to tell them, so CI runs it without blocking: npx playwright test --project renderer
 export default defineConfig({
   testDir: '.',
   timeout: 60_000,
   fullyParallel: false,
-  reporter: [['list']],
+  reporter: [
+    ['list'],
+    ...(process.env.JUNIT_DIR ? [['junit', { outputFile: path.join(ROOT, process.env.JUNIT_DIR, 'browser.xml') }]] : [])
+  ],
+  projects: [
+    { name: 'contract', testMatch: /contract\.spec\.mjs/ },
+    { name: 'renderer', testMatch: /renderer\.spec\.mjs/ }
+  ],
   use: {
     baseURL: `http://localhost:${PORT}`,
     // the renderer comes from the CDN, and there is no `cdn` option to point elsewhere, so this
diff --git a/integrations/contract-tests/browser/renderer.spec.mjs b/integrations/contract-tests/browser/renderer.spec.mjs
new file mode 100644
index 00000000..846cb968
--- /dev/null
+++ b/integrations/contract-tests/browser/renderer.spec.mjs
@@ -0,0 +1,68 @@
+import { test, expect } from '@playwright/test';
+
+// The renderer's own behaviour, reached through our mount. These are the things a reader does on
+// the page: pick an environment, open a request, search, use a phone. They lean on the renderer's
+// data-testids, so a failure here is most likely theirs to know about, not ours to fix. CI runs
+// this project without blocking.
+
+test('the environment switcher offers exactly what was published', async ({ page }) => {
+  await page.goto('/docs/', { waitUntil: 'networkidle' });
+  await page.getByLabel('Select environment').first().click();
+
+  const menu = page.getByRole('menu');
+  await expect(menu.getByText('Local', { exact: true })).toBeVisible();
+  await expect(menu.getByText('Prod', { exact: true })).toHaveCount(0);
+});
+
+test('a request page shows its method and the interpolated URL', async ({ page }) => {
+  await page.goto('/docs/#/catalog/list-products', { waitUntil: 'networkidle' });
+
+  await expect(page.getByTestId('request-method').first()).toHaveText(/GET/i);
+  await expect(page.getByText('/products').first()).toBeVisible();
+});
+
+test('the sidebar keeps the collection order', async ({ page }) => {
+  await page.goto('/docs/', { waitUntil: 'networkidle' });
+  const slugs = () => page.locator('[data-slug]').evaluateAll((els) => els.map((el) => el.dataset.slug));
+
+  // folders come collapsed; their seq decides the order
+  expect(await slugs()).toEqual(['catalog', 'mixed']);
+
+  await page.getByRole('button', { name: 'Expand folder' }).first().click();
+  expect(await slugs()).toEqual(['catalog', 'catalog/list-products', 'catalog/get-product', 'mixed']);
+});
+
+test('the logo we forwarded is what the renderer shows', async ({ page }) => {
+  await page.goto('/docs/', { waitUntil: 'networkidle' });
+  await expect(page.locator('img[src^="data:image/svg+xml"]').first()).toBeVisible();
+});
+
+test('search opens on the keyboard and respects the filters', async ({ page }) => {
+  await page.goto('/docs/', { waitUntil: 'networkidle' });
+  await page.keyboard.press('ControlOrMeta+k');
+
+  const input = page.getByLabel('Search requests and folders');
+  await expect(input).toBeFocused();
+  await input.fill('prod');
+
+  const results = page.getByTestId('search-results');
+  await expect(results).toContainText('List products');
+  await expect(results).toContainText('Get product');
+
+  // reindex is tagged internal: not on the page, and not in the index either
+  await input.fill('reindex');
+  await expect(page.getByText('No matches')).toBeVisible();
+});
+
+test('on a phone the sidebar is a drawer', async ({ page }) => {
+  await page.setViewportSize({ width: 390, height: 844 });
+  await page.goto('/docs/', { waitUntil: 'networkidle' });
+
+  const drawer = page.getByRole('dialog', { name: 'Navigation' });
+  await expect(page.getByTestId('app-sidebar'), 'no fixed sidebar on a phone').toHaveCount(0);
+  await expect(drawer).toBeHidden();
+
+  await page.getByLabel('Toggle sidebar').click();
+  await expect(drawer).toBeVisible();
+  await expect(drawer.getByText('Catalog', { exact: true })).toBeVisible();
+});
diff --git a/integrations/contract-tests/fixtures/api-collection/catalog/folder.yml b/integrations/contract-tests/fixtures/api-collection/catalog/folder.yml
index 11250ef1..c44bded1 100644
--- a/integrations/contract-tests/fixtures/api-collection/catalog/folder.yml
+++ b/integrations/contract-tests/fixtures/api-collection/catalog/folder.yml
@@ -1,3 +1,5 @@
 info:
   name: Catalog
   seq: 1
+request:
+  auth: inherit
diff --git a/integrations/contract-tests/fixtures/api-collection/catalog/get product.yml b/integrations/contract-tests/fixtures/api-collection/catalog/get product.yml
index e7800b3d..be8402d9 100644
--- a/integrations/contract-tests/fixtures/api-collection/catalog/get product.yml	
+++ b/integrations/contract-tests/fixtures/api-collection/catalog/get product.yml	
@@ -5,3 +5,4 @@ info:
 http:
   method: GET
   url: "{{baseUrl}}/products/:id"
+  auth: inherit
diff --git a/integrations/contract-tests/fixtures/api-collection/catalog/list products.yml b/integrations/contract-tests/fixtures/api-collection/catalog/list products.yml
index 6aceaf3d..c4554085 100644
--- a/integrations/contract-tests/fixtures/api-collection/catalog/list products.yml	
+++ b/integrations/contract-tests/fixtures/api-collection/catalog/list products.yml	
@@ -5,3 +5,4 @@ info:
 http:
   method: GET
   url: "{{baseUrl}}/products"
+  auth: inherit
diff --git a/integrations/contract-tests/fixtures/api-collection/catalog/reindex catalog.yml b/integrations/contract-tests/fixtures/api-collection/catalog/reindex catalog.yml
index fc96dfc5..bba1df4e 100644
--- a/integrations/contract-tests/fixtures/api-collection/catalog/reindex catalog.yml	
+++ b/integrations/contract-tests/fixtures/api-collection/catalog/reindex catalog.yml	
@@ -7,3 +7,4 @@ info:
 http:
   method: POST
   url: "{{baseUrl}}/admin/reindex-catalog"
+  auth: inherit
diff --git a/integrations/contract-tests/fixtures/api-collection/internal/folder.yml b/integrations/contract-tests/fixtures/api-collection/internal/folder.yml
index 30c588aa..db5c2fe3 100644
--- a/integrations/contract-tests/fixtures/api-collection/internal/folder.yml
+++ b/integrations/contract-tests/fixtures/api-collection/internal/folder.yml
@@ -1,3 +1,5 @@
 info:
   name: Internal
   seq: 2
+request:
+  auth: inherit
diff --git a/integrations/contract-tests/fixtures/api-collection/internal/purge cache.yml b/integrations/contract-tests/fixtures/api-collection/internal/purge cache.yml
index 9ef927f8..675cdaa5 100644
--- a/integrations/contract-tests/fixtures/api-collection/internal/purge cache.yml	
+++ b/integrations/contract-tests/fixtures/api-collection/internal/purge cache.yml	
@@ -10,3 +10,4 @@ http:
   headers:
     - name: X-Admin-Key
       value: "{{adminKey}}"
+  auth: inherit
diff --git a/integrations/contract-tests/fixtures/api-collection/mixed/drain node.yml b/integrations/contract-tests/fixtures/api-collection/mixed/drain node.yml
index a87b8c6f..0987d8e0 100644
--- a/integrations/contract-tests/fixtures/api-collection/mixed/drain node.yml	
+++ b/integrations/contract-tests/fixtures/api-collection/mixed/drain node.yml	
@@ -8,3 +8,4 @@ info:
 http:
   method: POST
   url: "{{baseUrl}}/admin/drain-node"
+  auth: inherit
diff --git a/integrations/contract-tests/fixtures/api-collection/mixed/folder.yml b/integrations/contract-tests/fixtures/api-collection/mixed/folder.yml
index 7bd91d15..f67a8a05 100644
--- a/integrations/contract-tests/fixtures/api-collection/mixed/folder.yml
+++ b/integrations/contract-tests/fixtures/api-collection/mixed/folder.yml
@@ -1,3 +1,5 @@
 info:
   name: Mixed
   seq: 3
+request:
+  auth: inherit
diff --git a/integrations/contract-tests/fixtures/api-collection/mixed/health.yml b/integrations/contract-tests/fixtures/api-collection/mixed/health.yml
index dd0e2134..2497b676 100644
--- a/integrations/contract-tests/fixtures/api-collection/mixed/health.yml
+++ b/integrations/contract-tests/fixtures/api-collection/mixed/health.yml
@@ -5,3 +5,4 @@ info:
 http:
   method: GET
   url: "{{baseUrl}}/health"
+  auth: inherit
diff --git a/integrations/contract-tests/fixtures/api-collection/opencollection.yml b/integrations/contract-tests/fixtures/api-collection/opencollection.yml
index 725513ec..be54d4c6 100644
--- a/integrations/contract-tests/fixtures/api-collection/opencollection.yml
+++ b/integrations/contract-tests/fixtures/api-collection/opencollection.yml
@@ -4,6 +4,7 @@ info:
   version: 1.0.0
   summary: The fixture every example serves and every contract run asserts against.
 bundled: false
-auth:
-  type: bearer
-  token: "{{apiToken}}"
+request:
+  auth:
+    type: bearer
+    token: "{{apiToken}}"
diff --git a/integrations/shell/assemble.mjs b/integrations/shell/assemble.mjs
index 8301d45f..dbb79f84 100644
--- a/integrations/shell/assemble.mjs
+++ b/integrations/shell/assemble.mjs
@@ -100,7 +100,10 @@ function materialize(dir, dirs) {
   const folders = node.children.map((childDir) => {
     const child = dirs.get(childDir);
     const name = childDir.slice(childDir.lastIndexOf('/') + 1);
-    const folder = child.meta || { info: { name, type: 'folder' } };
+    const folder = child.meta || { info: { name } };
+    // a directory is a folder whatever its folder.yml says or leaves out; the renderer decides
+    // by this field alone, and without it a folder renders as an empty request
+    folder.info = { ...folder.info, type: 'folder' };
     folder.items = materialize(childDir, dirs);
 
     return folder;
diff --git a/integrations/shell/test/assemble.test.mjs b/integrations/shell/test/assemble.test.mjs
index f360f5e9..0404bdc2 100644
--- a/integrations/shell/test/assemble.test.mjs
+++ b/integrations/shell/test/assemble.test.mjs
@@ -35,6 +35,8 @@ const names = (items) => items.map((i) => i.info.name);
   assert.deepEqual(names(doc.items), ['Public', 'Admin', 'zeta', 'alpha', 'beta'],
     'folders first by seq, then requests by seq, then the unsequenced by name');
   assert.deepEqual(names(doc.items[0].items), ['hello'], 'a folder carries its own requests');
+  assert.equal(doc.items[0].info.type, 'folder', 'a folder.yml that omits the type is still a folder');
+  assert.equal(doc.items[0].info.seq, 1, 'and keeps everything else it said');
 }
 
 // --- a folder with no folder.yml still becomes a folder, named after the directory

From c547ea34cf529799de6d0801702ebb6cd7209d4e Mon Sep 17 00:00:00 2001
From: Arpit Bruno <arpit@usebruno.com>
Date: Mon, 21 Sep 2026 11:02:53 +0530
Subject: [PATCH 18/21] write to the integrations job

---
 .github/workflows/ci.yml | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 8c319b50..67bb2aaf 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -12,7 +12,6 @@ on:
 permissions:
   contents: read
   pull-requests: read
-  checks: write
 
 concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
@@ -101,6 +100,10 @@ jobs:
     # a job-level if, not a workflow paths filter: a skipped job still reports and satisfies the required check
     if: needs.changes.outputs.integrations == 'true'
     runs-on: ubuntu-latest
+    # checks: write is for the test reporter; job-scoped so the renderer jobs keep least privilege
+    permissions:
+      contents: read
+      checks: write
     defaults:
       run:
         working-directory: integrations

From af70b36c4ba1c357dd2bcc8d31e8df483e6799d4 Mon Sep 17 00:00:00 2001
From: Arpit Bruno <arpit@usebruno.com>
Date: Mon, 21 Sep 2026 11:08:38 +0530
Subject: [PATCH 19/21] build before packing in the matrix workflow and report
 no results instead of crashing

---
 .github/workflows/integrations-matrix.yml | 3 +++
 integrations/contract-tests/report.mjs    | 6 ++++++
 2 files changed, 9 insertions(+)

diff --git a/.github/workflows/integrations-matrix.yml b/.github/workflows/integrations-matrix.yml
index a392f930..75aa221e 100644
--- a/.github/workflows/integrations-matrix.yml
+++ b/.github/workflows/integrations-matrix.yml
@@ -42,6 +42,8 @@ jobs:
 
       - run: npm ci
 
+      - run: npm run build
+
       - run: bash nodejs/scripts/matrix.sh --family ${{ matrix.family }} --results results
 
       - uses: actions/upload-artifact@v4
@@ -64,6 +66,7 @@ jobs:
         with:
           node-version: 20
       - run: npm ci
+      - run: npm run build
       - run: bash nodejs/scripts/matrix.sh --results results
       - uses: actions/upload-artifact@v4
         if: always()
diff --git a/integrations/contract-tests/report.mjs b/integrations/contract-tests/report.mjs
index 3e6f57d8..a37f58dd 100644
--- a/integrations/contract-tests/report.mjs
+++ b/integrations/contract-tests/report.mjs
@@ -24,6 +24,12 @@ const bold = (s) => paint(1, s);
 const files = (d) => fs.readdirSync(d, { withFileTypes: true })
   .flatMap((e) => (e.isDirectory() ? files(path.join(d, e.name)) : e.name.endsWith('.tsv') ? [path.join(d, e.name)] : []));
 
+if (!fs.existsSync(dir) || files(dir).length === 0) {
+  // every suite failed before writing its counts, or nothing ran: say so, the jobs carry the reason
+  console.log(mode === '--md' ? '_no results: no suite got as far as reporting_' : '  no results: no suite got as far as reporting');
+  process.exit(0);
+}
+
 const rows = files(dir).map((f) => {
   const [node, cell, adapter, passed, failed] = fs.readFileSync(f, 'utf8').trim().split('\t');
 

From 55ac0351f96c596d5833fdc6dcf4b3f7cf0b4b25 Mon Sep 17 00:00:00 2001
From: Arpit Bruno <arpit@usebruno.com>
Date: Mon, 21 Sep 2026 11:33:09 +0530
Subject: [PATCH 20/21] try script that installs the packages into a real app
 from tarballs

---
 .gitignore                  |  1 +
 integrations/.dockerignore  |  1 +
 integrations/package.json   |  3 +-
 integrations/scripts/try.sh | 68 +++++++++++++++++++++++++++++++++++++
 4 files changed, 72 insertions(+), 1 deletion(-)
 create mode 100644 integrations/scripts/try.sh

diff --git a/.gitignore b/.gitignore
index 69ab7c0b..724e39c0 100644
--- a/.gitignore
+++ b/.gitignore
@@ -9,3 +9,4 @@ test.js
 CLAUDE.md
 test-results
 !integrations/contract-tests/fixtures/walk-safety/node_modules/
+integrations/dist-tarballs
diff --git a/integrations/.dockerignore b/integrations/.dockerignore
index d55e2642..c78e9e83 100644
--- a/integrations/.dockerignore
+++ b/integrations/.dockerignore
@@ -6,3 +6,4 @@ shell/shell.js
 nodejs/*/shell
 test-results
 nodejs/nestjs/examples/dist
+dist-tarballs
diff --git a/integrations/package.json b/integrations/package.json
index b0174429..4c64ab95 100644
--- a/integrations/package.json
+++ b/integrations/package.json
@@ -39,7 +39,8 @@
     "test:nestjs": "npm run build && node nodejs/nestjs/test/sub-path.test.mjs",
     "test:shell": "npm run build && node nodejs/core/test/shell.test.mjs",
     "test:unit": "npm run build && bash nodejs/scripts/unit.sh",
-    "test:walk": "npm run build:core && node nodejs/core/test/walk.test.mjs"
+    "test:walk": "npm run build:core && node nodejs/core/test/walk.test.mjs",
+    "try": "bash scripts/try.sh"
   },
   "devDependencies": {
     "@eslint/js": "^9.39.5",
diff --git a/integrations/scripts/try.sh b/integrations/scripts/try.sh
new file mode 100644
index 00000000..8076dadb
--- /dev/null
+++ b/integrations/scripts/try.sh
@@ -0,0 +1,68 @@
+#!/usr/bin/env bash
+# Try the packages in a real app before they are on npm. Builds, packs the tarballs, installs the
+# core and one wrapper into the app exactly as npm would, and prints the mount to add.
+#
+#   npm run try -- ~/code/my-api express       install into that app (express | fastify | nestjs)
+#   npm run try -- ~/code/my-api --remove      uninstall again, leaving the app as it was
+#
+# Nothing is linked: the packages are copied into the app's node_modules with file: entries in
+# its package.json, so --remove is a plain npm uninstall.
+set -euo pipefail
+
+ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+APP="${1:-}"
+WHAT="${2:-}"
+PACKAGES="@usebruno/api-docs-core @usebruno/api-docs-express @usebruno/api-docs-fastify @usebruno/api-docs-nestjs"
+
+usage() { sed -n '2,8p' "$0" | sed 's/^# \{0,1\}//'; exit 2; }
+[ -n "$APP" ] && [ -n "$WHAT" ] || usage
+[ -f "$APP/package.json" ] || { echo "no package.json in $APP" >&2; exit 2; }
+
+if [ "$WHAT" = "--remove" ]; then
+  installed=""
+  for p in $PACKAGES; do
+    grep -q "\"$p\"" "$APP/package.json" && installed="$installed $p"
+  done
+  [ -n "$installed" ] || { echo "nothing of ours is installed in $APP"; exit 0; }
+  # shellcheck disable=SC2086
+  ( cd "$APP" && npm uninstall $installed )
+  echo "removed:$installed"
+  exit 0
+fi
+
+case "$WHAT" in express | fastify | nestjs) ;; *) usage ;; esac
+
+# the app's package.json will point at these by path, so they stay in the checkout, not in a temp dir
+( cd "$ROOT" && npm run build --silent )
+TARBALLS="$ROOT/dist-tarballs"
+mkdir -p "$TARBALLS"
+for p in core "$WHAT"; do
+  ( cd "$ROOT/nodejs/$p" && npm pack --silent --pack-destination "$TARBALLS" >/dev/null )
+done
+
+# one install for both, so the wrapper's exact pin on the core resolves from the tarball beside it
+( cd "$APP" && npm install "$TARBALLS"/*api-docs-core*.tgz "$TARBALLS"/*api-docs-"$WHAT"*.tgz )
+echo
+echo "installed @usebruno/api-docs-core and @usebruno/api-docs-$WHAT into $APP"
+echo
+echo "add the mount. The collection path is relative to your entry file, not the cwd;"
+echo "for a built Nest app that is dist/main.js, so count from dist/."
+echo
+case "$WHAT" in
+  express)
+    echo "  const { apiDocs } = require('@usebruno/api-docs-express');"
+    echo "  app.use('/docs', apiDocs({ collection: './api-collection' }));"
+    ;;
+  fastify)
+    echo "  const { apiDocs } = require('@usebruno/api-docs-fastify');"
+    echo "  app.register(apiDocs, { prefix: '/docs', collection: './api-collection' });"
+    ;;
+  nestjs)
+    echo "  import { ApiDocsModule } from '@usebruno/api-docs-nestjs';"
+    echo "  @Module({ imports: [ApiDocsModule.forRoot({ collection: '../api-collection' })] })"
+    ;;
+esac
+echo
+echo "then open http://localhost:<port>/docs/. If the app sets a CSP, script-src needs"
+echo "https://cdn.usebruno.com and 'wasm-unsafe-eval', and connect-src needs data:."
+echo "to undo: npm run try -- $APP --remove"

From 331c03b048b6c99f5aafff61df1a9ad0596b90e6 Mon Sep 17 00:00:00 2001
From: Arpit Bruno <arpit@usebruno.com>
Date: Mon, 21 Sep 2026 12:58:06 +0530
Subject: [PATCH 21/21] fixes: missing collection paths report as missing

---
 integrations/contract-tests/apps/express.js   |  9 ++++---
 integrations/contract-tests/apps/fastify.js   |  9 ++++---
 integrations/contract-tests/apps/nestjs.js    |  9 ++++---
 .../contract-tests/browser/contract.spec.mjs  |  5 ++++
 integrations/contract-tests/check.sh          |  3 +++
 integrations/contract-tests/examples.sh       |  6 ++---
 .../nodejs/core/src/collection/index.ts       |  4 +--
 .../nodejs/core/test/collection.test.mjs      |  2 ++
 integrations/nodejs/express/examples/csp.js   | 10 ++++---
 integrations/nodejs/fastify/examples/csp.js   | 10 ++++---
 .../nodejs/nestjs/examples/05-csp/main.ts     | 10 ++++---
 integrations/nodejs/nestjs/src/index.ts       | 26 ++++++++++++++++---
 integrations/scripts/try.sh                   |  2 +-
 13 files changed, 72 insertions(+), 33 deletions(-)

diff --git a/integrations/contract-tests/apps/express.js b/integrations/contract-tests/apps/express.js
index be8b8ba8..7e4a84c5 100644
--- a/integrations/contract-tests/apps/express.js
+++ b/integrations/contract-tests/apps/express.js
@@ -18,10 +18,11 @@ app.use(
   helmet({
     contentSecurityPolicy: {
       directives: {
-        scriptSrc: ["'self'", 'https://cdn.usebruno.com', "'wasm-unsafe-eval'"],
-        styleSrc: ["'self'", "'unsafe-inline'", 'https://cdn.usebruno.com', 'https://fonts.googleapis.com'],
-        fontSrc: ["'self'", 'https://fonts.gstatic.com'],
-        connectSrc: ["'self'", 'data:']
+        scriptSrc: ["'self'", 'https://cdn.usebruno.com', 'https://cdn.jsdelivr.net', "'wasm-unsafe-eval'"],
+        styleSrc: ["'self'", "'unsafe-inline'", 'https://cdn.usebruno.com', 'https://cdn.jsdelivr.net', 'https://fonts.googleapis.com'],
+        fontSrc: ["'self'", 'data:', 'https://fonts.gstatic.com'],
+        workerSrc: ["'self'", 'blob:', 'https://cdn.jsdelivr.net'],
+        connectSrc: ["'self'", 'data:', 'https://cdn.jsdelivr.net']
       }
     }
   })
diff --git a/integrations/contract-tests/apps/fastify.js b/integrations/contract-tests/apps/fastify.js
index 71178519..ffac87d2 100644
--- a/integrations/contract-tests/apps/fastify.js
+++ b/integrations/contract-tests/apps/fastify.js
@@ -16,10 +16,11 @@ app.addHook('onSend', async (request, reply) => {
   reply.header(
     'content-security-policy',
     "default-src 'self'; "
-    + "script-src 'self' https://cdn.usebruno.com 'wasm-unsafe-eval'; "
-    + "style-src 'self' 'unsafe-inline' https://cdn.usebruno.com https://fonts.googleapis.com; "
-    + "font-src 'self' https://fonts.gstatic.com; "
-    + "connect-src 'self' data:"
+    + "script-src 'self' https://cdn.usebruno.com https://cdn.jsdelivr.net 'wasm-unsafe-eval'; "
+    + "style-src 'self' 'unsafe-inline' https://cdn.usebruno.com https://cdn.jsdelivr.net https://fonts.googleapis.com; "
+    + "font-src 'self' data: https://fonts.gstatic.com; "
+    + "worker-src 'self' blob: https://cdn.jsdelivr.net; "
+    + "connect-src 'self' data: https://cdn.jsdelivr.net"
   );
 });
 
diff --git a/integrations/contract-tests/apps/nestjs.js b/integrations/contract-tests/apps/nestjs.js
index f94c251c..68067d7f 100644
--- a/integrations/contract-tests/apps/nestjs.js
+++ b/integrations/contract-tests/apps/nestjs.js
@@ -53,10 +53,11 @@ async function main() {
   app.use(helmet({
     contentSecurityPolicy: {
       directives: {
-        scriptSrc: ["'self'", 'https://cdn.usebruno.com', "'wasm-unsafe-eval'"],
-        styleSrc: ["'self'", "'unsafe-inline'", 'https://cdn.usebruno.com', 'https://fonts.googleapis.com'],
-        fontSrc: ["'self'", 'https://fonts.gstatic.com'],
-        connectSrc: ["'self'", 'data:']
+        scriptSrc: ["'self'", 'https://cdn.usebruno.com', 'https://cdn.jsdelivr.net', "'wasm-unsafe-eval'"],
+        styleSrc: ["'self'", "'unsafe-inline'", 'https://cdn.usebruno.com', 'https://cdn.jsdelivr.net', 'https://fonts.googleapis.com'],
+        fontSrc: ["'self'", 'data:', 'https://fonts.gstatic.com'],
+        workerSrc: ["'self'", 'blob:', 'https://cdn.jsdelivr.net'],
+        connectSrc: ["'self'", 'data:', 'https://cdn.jsdelivr.net']
       }
     }
   }));
diff --git a/integrations/contract-tests/browser/contract.spec.mjs b/integrations/contract-tests/browser/contract.spec.mjs
index 8ed54763..39b86233 100644
--- a/integrations/contract-tests/browser/contract.spec.mjs
+++ b/integrations/contract-tests/browser/contract.spec.mjs
@@ -73,6 +73,7 @@ test('the page is served at any depth, and the renderer routes by hash', async (
 });
 
 test('try it sends the published environment, and only that', async ({ page }) => {
+  const errors = consoleErrorsOn(page);
   let sent;
   // the fixture's baseUrl points at a port nothing listens on; answer for it and keep the request
   await page.route('**/products', async (route) => {
@@ -88,6 +89,10 @@ test('try it sends the published environment, and only that', async ({ page }) =
   const headers = await sent.allHeaders();
   expect(headers.authorization, 'the collection auth, resolved from the Local environment').toBe(`Bearer ${LOCAL_TOKEN}`);
   expect(sent.url(), 'the Local baseUrl was interpolated').toContain('localhost:5456/products');
+
+  // the response viewer is Monaco, loaded from jsdelivr: the CSP we document has to let it in
+  await expect(page.locator('.monaco-editor').first()).toBeVisible();
+  expect(errors, 'nothing the playground loads is blocked by the documented CSP').toEqual([]);
 });
 
 test('a bundled single file renders the same way', async ({ page }) => {
diff --git a/integrations/contract-tests/check.sh b/integrations/contract-tests/check.sh
index f07eea3c..da66737b 100755
--- a/integrations/contract-tests/check.sh
+++ b/integrations/contract-tests/check.sh
@@ -163,6 +163,9 @@ describe "the adopter's CSP holds"
 check "the CSP allows the renderer's origin"    header_has Content-Security-Policy "script-src 'self' https://cdn.usebruno.com" "$BASE/docs/"
 check "and the data: uri its wasm comes from"  header_has Content-Security-Policy "connect-src 'self' data:" "$BASE/docs/"
 check "and instantiating that wasm"            header_has Content-Security-Policy "wasm-unsafe-eval" "$BASE/docs/"
+check "and Monaco, which try it loads from jsdelivr" header_has Content-Security-Policy "script-src 'self' https://cdn.usebruno.com https://cdn.jsdelivr.net" "$BASE/docs/"
+check "with its workers"                         header_has Content-Security-Policy "worker-src 'self' blob: https://cdn.jsdelivr.net" "$BASE/docs/"
+check "and its icon font, a data: uri"            header_has Content-Security-Policy "font-src 'self' data:" "$BASE/docs/"
 
 # ---- bodies, for comparing one framework against another -------------------
 
diff --git a/integrations/contract-tests/examples.sh b/integrations/contract-tests/examples.sh
index 9960a60e..ef92f969 100644
--- a/integrations/contract-tests/examples.sh
+++ b/integrations/contract-tests/examples.sh
@@ -59,7 +59,7 @@ check "/docs/collection.yml with the token -> 200" status_is 200 "${BEARER[@]}"
 
 example nodejs/express/examples/csp.js
 check "/docs/ -> 200"                            status_is 200 "$BASE/docs/"
-check "script-src allows the CDN and wasm"       header_has "$CSP" "script-src 'self' https://cdn.usebruno.com 'wasm-unsafe-eval'" "$BASE/docs/"
+check "script-src allows the CDN, Monaco and wasm" header_has "$CSP" "script-src 'self' https://cdn.usebruno.com https://cdn.jsdelivr.net 'wasm-unsafe-eval'" "$BASE/docs/"
 check "connect-src allows data:"                 header_has "$CSP" "connect-src 'self' data:" "$BASE/docs/"
 check "style-src allows the fonts"               header_has "$CSP" "fonts.googleapis.com" "$BASE/docs/"
 
@@ -92,7 +92,7 @@ check "/docs/collection.yml with the token -> 200" status_is 200 "${BEARER[@]}"
 
 example nodejs/fastify/examples/csp.js
 check "/docs/ -> 200"                            status_is 200 "$BASE/docs/"
-check "script-src allows the CDN and wasm"       header_has "$CSP" "script-src 'self' https://cdn.usebruno.com 'wasm-unsafe-eval'" "$BASE/docs/"
+check "script-src allows the CDN, Monaco and wasm" header_has "$CSP" "script-src 'self' https://cdn.usebruno.com https://cdn.jsdelivr.net 'wasm-unsafe-eval'" "$BASE/docs/"
 check "connect-src allows data:"                 header_has "$CSP" "connect-src 'self' data:" "$BASE/docs/"
 check "style-src allows the fonts"               header_has "$CSP" "fonts.googleapis.com" "$BASE/docs/"
 
@@ -136,7 +136,7 @@ check "/docs/<deep>/ -> the page"                header_has Content-Type text/ht
 
 example nodejs/nestjs/examples/dist/05-csp/main.js
 check "/docs/ -> 200"                            status_is 200 "$BASE/docs/"
-check "script-src allows the CDN and wasm"       header_has "$CSP" "script-src 'self' https://cdn.usebruno.com 'wasm-unsafe-eval'" "$BASE/docs/"
+check "script-src allows the CDN, Monaco and wasm" header_has "$CSP" "script-src 'self' https://cdn.usebruno.com https://cdn.jsdelivr.net 'wasm-unsafe-eval'" "$BASE/docs/"
 check "connect-src allows data:"                 header_has "$CSP" "connect-src 'self' data:" "$BASE/docs/"
 check "style-src allows the fonts"               header_has "$CSP" "fonts.googleapis.com" "$BASE/docs/"
 
diff --git a/integrations/nodejs/core/src/collection/index.ts b/integrations/nodejs/core/src/collection/index.ts
index 25a5ff83..a477559c 100644
--- a/integrations/nodejs/core/src/collection/index.ts
+++ b/integrations/nodejs/core/src/collection/index.ts
@@ -10,11 +10,11 @@ export function providerFor(options: CollectionOptions): Provider {
   const source = resolveCollectionSource(options.collection);
   const filters = { environments: options.environments, tags: options.tags };
 
+  // built first: a path that is not there is reported as missing, not as a filter mistake
+  const built = source.mode === 'file' ? fileProvider(source.path) : dirProvider(source.path, filters);
   if (source.mode === 'file' && (filters.environments || filters.tags)) {
     throw new ConfigError('apiDocs: `environments` / `tags` filtering needs a collection directory');
   }
-
-  const built = source.mode === 'file' ? fileProvider(source.path) : dirProvider(source.path, filters);
   report(source.path, built);
 
   return built.serve;
diff --git a/integrations/nodejs/core/test/collection.test.mjs b/integrations/nodejs/core/test/collection.test.mjs
index 9d644861..fa516e27 100644
--- a/integrations/nodejs/core/test/collection.test.mjs
+++ b/integrations/nodejs/core/test/collection.test.mjs
@@ -107,6 +107,8 @@ const quiet = (fn) => {
   assert.equal(resolveCollectionSource(gone).mode, 'file', 'an unstattable path falls through to file mode');
   assert.throws(() => quiet(() => providerFor({ collection: gone })), { code: 'ENOENT' });
   assert.equal(errorProvider(thrownBy(() => providerFor({ collection: gone })))({}).status, 404);
+  assert.throws(() => quiet(() => providerFor({ collection: gone, tags: { exclude: ['x'] } })), { code: 'ENOENT' },
+    'with filters set, a missing path is still reported as missing, not as a filter mistake');
 
   if (process.getuid?.() !== 0) {
     const locked = write('locked/opencollection.yml', 'opencollection: 1.0.0\nbundled: false\n');
diff --git a/integrations/nodejs/express/examples/csp.js b/integrations/nodejs/express/examples/csp.js
index 8302de37..673aca1e 100644
--- a/integrations/nodejs/express/examples/csp.js
+++ b/integrations/nodejs/express/examples/csp.js
@@ -9,14 +9,16 @@ const port = process.env.PORT ?? 3000;
 
 // what the docs page needs from a strict CSP. 'self' covers shell.js; the renderer itself comes
 // from cdn.usebruno.com and runs a wasm sandbox, which is what 'wasm-unsafe-eval' and data: are for.
+// The response viewer is Monaco, loaded from cdn.jsdelivr.net when "try it" opens, with its workers.
 // Without these the page still loads and looks fine, and the errors are only in the console.
 app.use(helmet({
   contentSecurityPolicy: {
     directives: {
-      scriptSrc: ["'self'", 'https://cdn.usebruno.com', "'wasm-unsafe-eval'"],
-      styleSrc: ["'self'", "'unsafe-inline'", 'https://cdn.usebruno.com', 'https://fonts.googleapis.com'],
-      fontSrc: ["'self'", 'https://fonts.gstatic.com'],
-      connectSrc: ["'self'", 'data:']
+      scriptSrc: ["'self'", 'https://cdn.usebruno.com', 'https://cdn.jsdelivr.net', "'wasm-unsafe-eval'"],
+      styleSrc: ["'self'", "'unsafe-inline'", 'https://cdn.usebruno.com', 'https://cdn.jsdelivr.net', 'https://fonts.googleapis.com'],
+      fontSrc: ["'self'", 'data:', 'https://fonts.gstatic.com'],
+      workerSrc: ["'self'", 'blob:', 'https://cdn.jsdelivr.net'],
+      connectSrc: ["'self'", 'data:', 'https://cdn.jsdelivr.net']
     }
   }
 }));
diff --git a/integrations/nodejs/fastify/examples/csp.js b/integrations/nodejs/fastify/examples/csp.js
index 965929f2..ad9b4f1d 100644
--- a/integrations/nodejs/fastify/examples/csp.js
+++ b/integrations/nodejs/fastify/examples/csp.js
@@ -8,15 +8,17 @@ const port = process.env.PORT ?? 3000;
 
 // what the docs page needs from a strict CSP. 'self' covers shell.js; the renderer itself comes
 // from cdn.usebruno.com and runs a wasm sandbox, which is what 'wasm-unsafe-eval' and data: are for.
+// The response viewer is Monaco, loaded from cdn.jsdelivr.net when "try it" opens, with its workers.
 // Without these the page still loads and looks fine, and the errors are only in the console.
 app.addHook('onSend', async (request, reply) => {
   reply.header(
     'content-security-policy',
     "default-src 'self'; "
-    + "script-src 'self' https://cdn.usebruno.com 'wasm-unsafe-eval'; "
-    + "style-src 'self' 'unsafe-inline' https://cdn.usebruno.com https://fonts.googleapis.com; "
-    + "font-src 'self' https://fonts.gstatic.com; "
-    + "connect-src 'self' data:"
+    + "script-src 'self' https://cdn.usebruno.com https://cdn.jsdelivr.net 'wasm-unsafe-eval'; "
+    + "style-src 'self' 'unsafe-inline' https://cdn.usebruno.com https://cdn.jsdelivr.net https://fonts.googleapis.com; "
+    + "font-src 'self' data: https://fonts.gstatic.com; "
+    + "worker-src 'self' blob: https://cdn.jsdelivr.net; "
+    + "connect-src 'self' data: https://cdn.jsdelivr.net"
   );
 });
 
diff --git a/integrations/nodejs/nestjs/examples/05-csp/main.ts b/integrations/nodejs/nestjs/examples/05-csp/main.ts
index c414b75c..bef0be52 100644
--- a/integrations/nodejs/nestjs/examples/05-csp/main.ts
+++ b/integrations/nodejs/nestjs/examples/05-csp/main.ts
@@ -7,14 +7,16 @@ async function bootstrap(): Promise<void> {
 
   // what the docs page needs from a strict CSP. 'self' covers shell.js; the renderer itself comes
   // from cdn.usebruno.com and runs a wasm sandbox, which is what 'wasm-unsafe-eval' and data: are for.
+  // The response viewer is Monaco, loaded from cdn.jsdelivr.net when "try it" opens, with its workers.
   // Without these the page still loads and looks fine, and the errors are only in the console.
   app.use(helmet({
     contentSecurityPolicy: {
       directives: {
-        scriptSrc: ["'self'", 'https://cdn.usebruno.com', "'wasm-unsafe-eval'"],
-        styleSrc: ["'self'", "'unsafe-inline'", 'https://cdn.usebruno.com', 'https://fonts.googleapis.com'],
-        fontSrc: ["'self'", 'https://fonts.gstatic.com'],
-        connectSrc: ["'self'", 'data:']
+        scriptSrc: ["'self'", 'https://cdn.usebruno.com', 'https://cdn.jsdelivr.net', "'wasm-unsafe-eval'"],
+        styleSrc: ["'self'", "'unsafe-inline'", 'https://cdn.usebruno.com', 'https://cdn.jsdelivr.net', 'https://fonts.googleapis.com'],
+        fontSrc: ["'self'", 'data:', 'https://fonts.gstatic.com'],
+        workerSrc: ["'self'", 'blob:', 'https://cdn.jsdelivr.net'],
+        connectSrc: ["'self'", 'data:', 'https://cdn.jsdelivr.net']
       }
     }
   }));
diff --git a/integrations/nodejs/nestjs/src/index.ts b/integrations/nodejs/nestjs/src/index.ts
index 4345a974..9f4fc32e 100644
--- a/integrations/nodejs/nestjs/src/index.ts
+++ b/integrations/nodejs/nestjs/src/index.ts
@@ -1,3 +1,5 @@
+import fs from 'node:fs';
+import path from 'node:path';
 import type { ServerResponse } from 'node:http';
 import { Module, type DynamicModule, type MiddlewareConsumer, type NestModule } from '@nestjs/common';
 import { createDocs, embed, type ApiDocsOptions, type Request } from '@usebruno/api-docs-core';
@@ -13,6 +15,21 @@ export interface ApiDocsModuleOptions extends ApiDocsOptions {
 
 const DEFAULT_MOUNT_PATH = '/docs';
 
+/**
+ * Nest 10 routes `/*` and its fastify adapter throws on `/*splat`; Nest 11 and 12 route both but log
+ * a deprecation warning for `/*`. Read from the installed package, whose `exports` map on 12 no
+ * longer lets `require('@nestjs/core/package.json')` through.
+ */
+function wildcard(): string {
+  let dir = path.dirname(require.resolve('@nestjs/core'));
+  while (!fs.existsSync(path.join(dir, 'package.json'))) {
+    dir = path.dirname(dir);
+  }
+  const major = Number(JSON.parse(fs.readFileSync(path.join(dir, 'package.json'), 'utf8')).version.split('.')[0]);
+
+  return major >= 11 ? '*splat' : '*';
+}
+
 /** Searched for, not stripped: `setGlobalPrefix('api')` moves a `/docs` mount to `/api/docs`. */
 export function subPathOf(fullUrl: string, mountPath: string): string {
   const at = fullUrl.indexOf(mountPath);
@@ -23,7 +40,10 @@ export function subPathOf(fullUrl: string, mountPath: string): string {
   return fullUrl.slice(at + mountPath.length) || '/';
 }
 
-/** `ApiDocsModule.forRoot({ collection: './api-collection', mountPath: '/docs' })`. */
+/**
+ * `ApiDocsModule.forRoot({ collection: '../api-collection', mountPath: '/docs' })`. The path counts
+ * from the built entry file, `dist/main.js`, so a collection beside `src/` is one level up.
+ */
 export class ApiDocsModule {
   static forRoot(options: ApiDocsModuleOptions): DynamicModule {
     const { mountPath: mountOption, ...docsOptions } = options;
@@ -41,8 +61,8 @@ export class ApiDocsModule {
           })
           // the mount alone is enough on platform-express, which matches by prefix. On
           // platform-fastify it matches only the mount itself, so the wildcard is what serves
-          // shell.js and every deep link. `*` is understood by Nest 10 and 11 alike.
-          .forRoutes(mountPath, `${mountPath}/*`);
+          // shell.js and every deep link
+          .forRoutes(mountPath, `${mountPath}/${wildcard()}`);
       }
     }
 
diff --git a/integrations/scripts/try.sh b/integrations/scripts/try.sh
index 8076dadb..258ab53a 100644
--- a/integrations/scripts/try.sh
+++ b/integrations/scripts/try.sh
@@ -41,7 +41,7 @@ for p in core "$WHAT"; do
 done
 
 # one install for both, so the wrapper's exact pin on the core resolves from the tarball beside it
-( cd "$APP" && npm install "$TARBALLS"/*api-docs-core*.tgz "$TARBALLS"/*api-docs-"$WHAT"*.tgz )
+( cd "$APP" && npm install --no-audit --no-fund "$TARBALLS"/*api-docs-core*.tgz "$TARBALLS"/*api-docs-"$WHAT"*.tgz )
 echo
 echo "installed @usebruno/api-docs-core and @usebruno/api-docs-$WHAT into $APP"
 echo