@contractkit/plugin-bruno 0.9.1 → 0.10.0

package/coverage/tests/helpers.ts.html

@@ -23,30 +23,30 @@
         <div class='clearfix'>
             
             <div class='fl pad1y space-right2'>
-                <span class="strong">68.18% </span>
+                <span class="strong">75% </span>
                 <span class="quiet">Statements</span>
-                <span class='fraction'>30/44</span>
+                <span class='fraction'>33/44</span>
             </div>
         
             
             <div class='fl pad1y space-right2'>
-                <span class="strong">67.74% </span>
+                <span class="strong">77.41% </span>
                 <span class="quiet">Branches</span>
-                <span class='fraction'>21/31</span>
+                <span class='fraction'>24/31</span>
             </div>
         
             
             <div class='fl pad1y space-right2'>
-                <span class="strong">72% </span>
+                <span class="strong">76% </span>
                 <span class="quiet">Functions</span>
-                <span class='fraction'>18/25</span>
+                <span class='fraction'>19/25</span>
             </div>
         
             
             <div class='fl pad1y space-right2'>
-                <span class="strong">71.05% </span>
+                <span class="strong">78.94% </span>
                 <span class="quiet">Lines</span>
-                <span class='fraction'>27/38</span>
+                <span class='fraction'>30/38</span>
             </div>
         
             
@@ -266,7 +266,7 @@
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">228x</span>
+<span class="cline-any cline-yes">248x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
@@ -298,7 +298,7 @@
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">10x</span>
+<span class="cline-any cline-yes">11x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
@@ -361,16 +361,16 @@
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">3x</span>
-<span class="cline-any cline-yes">3x</span>
+<span class="cline-any cline-yes">10x</span>
+<span class="cline-any cline-yes">10x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-no">&nbsp;</span>
-<span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
 <span class="cline-any cline-no">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-yes">1x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
@@ -384,10 +384,10 @@
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">84x</span>
-<span class="cline-any cline-yes">84x</span>
-<span class="cline-any cline-yes">84x</span>
-<span class="cline-any cline-yes">84x</span>
+<span class="cline-any cline-yes">94x</span>
+<span class="cline-any cline-yes">94x</span>
+<span class="cline-any cline-yes">94x</span>
+<span class="cline-any cline-yes">94x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
@@ -402,12 +402,12 @@
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">80x</span>
-<span class="cline-any cline-yes">80x</span>
+<span class="cline-any cline-yes">90x</span>
+<span class="cline-any cline-yes">90x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">79x</span>
+<span class="cline-any cline-yes">89x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span></td><td class="text"><pre class="prettyprint lang-js">import type {
     ContractRootNode,
@@ -534,16 +534,16 @@ export function opRequest(
 &nbsp;
 export function opResponse(statusCode: number, bodyType?: string | ContractTypeNode, contentType?: 'application/json'): OpResponseNode {
     const bt: ContractTypeNode | undefined =
-        bodyType === undefined ? undefined : <span class="branch-1 cbranch-no" title="branch not covered" >typeof bodyType === 'string' ? parseBodyTypeString(bodyType) : bodyType;</span>
+        bodyType === undefined ? undefined : typeof bodyType === 'string' ? parseBodyTypeString(bodyType) : <span class="branch-1 cbranch-no" title="branch not covered" >bodyType;</span>
     return { statusCode, contentType, bodyType: bt };
 }
 &nbsp;
-function <span class="fstat-no" title="function not covered" >parseBodyTypeString(s</span>: string): ContractTypeNode {
-    const arrayMatch = <span class="cstat-no" title="statement not covered" >s.match(/^array\((.+)\)$/);</span>
-<span class="cstat-no" title="statement not covered" >    if (arrayMatch?.[1]) {</span>
+function parseBodyTypeString(s: string): ContractTypeNode {
+    const arrayMatch = s.match(/^array\((.+)\)$/);
+    <span class="missing-if-branch" title="if path not taken" >I</span>if (arrayMatch?.[1]) {
 <span class="cstat-no" title="statement not covered" >        return { kind: 'array', item: refType(arrayMatch[1]) };</span>
     }
-<span class="cstat-no" title="statement not covered" >    return refType(s);</span>
+    return refType(s);
 }
 &nbsp;
 /** Normalize a raw param value (old bare format or new discriminated union) to ParamSource. */
@@ -589,7 +589,7 @@ export function opRoot(routes: OpRouteNode[], file = 'users.op', meta: Record&lt
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2026-04-29T12:51:10.099Z
+                at 2026-05-01T17:30:36.787Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/coverage/tests/index.html

@@ -23,30 +23,30 @@
         <div class='clearfix'>
             
             <div class='fl pad1y space-right2'>
-                <span class="strong">68.18% </span>
+                <span class="strong">75% </span>
                 <span class="quiet">Statements</span>
-                <span class='fraction'>30/44</span>
+                <span class='fraction'>33/44</span>
             </div>
         
             
             <div class='fl pad1y space-right2'>
-                <span class="strong">67.74% </span>
+                <span class="strong">77.41% </span>
                 <span class="quiet">Branches</span>
-                <span class='fraction'>21/31</span>
+                <span class='fraction'>24/31</span>
             </div>
         
             
             <div class='fl pad1y space-right2'>
-                <span class="strong">72% </span>
+                <span class="strong">76% </span>
                 <span class="quiet">Functions</span>
-                <span class='fraction'>18/25</span>
+                <span class='fraction'>19/25</span>
             </div>
         
             
             <div class='fl pad1y space-right2'>
-                <span class="strong">71.05% </span>
+                <span class="strong">78.94% </span>
                 <span class="quiet">Lines</span>
-                <span class='fraction'>27/38</span>
+                <span class='fraction'>30/38</span>
             </div>
         
             
@@ -80,17 +80,17 @@
 </thead>
 <tbody><tr>
 	<td class="file medium" data-value="helpers.ts"><a href="helpers.ts.html">helpers.ts</a></td>
-	<td data-value="68.18" class="pic medium">
-	<div class="chart"><div class="cover-fill" style="width: 68%"></div><div class="cover-empty" style="width: 32%"></div></div>
+	<td data-value="75" class="pic medium">
+	<div class="chart"><div class="cover-fill" style="width: 75%"></div><div class="cover-empty" style="width: 25%"></div></div>
 	</td>
-	<td data-value="68.18" class="pct medium">68.18%</td>
-	<td data-value="44" class="abs medium">30/44</td>
-	<td data-value="67.74" class="pct medium">67.74%</td>
-	<td data-value="31" class="abs medium">21/31</td>
-	<td data-value="72" class="pct medium">72%</td>
-	<td data-value="25" class="abs medium">18/25</td>
-	<td data-value="71.05" class="pct medium">71.05%</td>
-	<td data-value="38" class="abs medium">27/38</td>
+	<td data-value="75" class="pct medium">75%</td>
+	<td data-value="44" class="abs medium">33/44</td>
+	<td data-value="77.41" class="pct medium">77.41%</td>
+	<td data-value="31" class="abs medium">24/31</td>
+	<td data-value="76" class="pct medium">76%</td>
+	<td data-value="25" class="abs medium">19/25</td>
+	<td data-value="78.94" class="pct medium">78.94%</td>
+	<td data-value="38" class="abs medium">30/38</td>
 	</tr>
 
 </tbody>
@@ -101,7 +101,7 @@
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2026-04-29T12:51:10.099Z
+                at 2026-05-01T17:30:36.787Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/dist/codegen-bruno.d.ts

@@ -1,4 +1,5 @@
 import type { OpRootNode, ContractRootNode } from '@contractkit/core';
+/** A single file produced by the Bruno codegen — a relative output path and its YAML content. */
 export interface OpenCollectionFile {
     relativePath: string;
     content: string;
@@ -12,12 +13,14 @@ export interface BrunoSecurityScheme {
     name?: string;
     in?: string;
 }
+/** Auth configuration passed to the Bruno codegen; drives collection-level auth and per-operation auth blocks. */
 export interface BrunoAuthOptions {
     /** Name of the default scheme (from config.security.default) */
     defaultScheme?: string;
     /** Scheme definitions keyed by name (non-HMAC only) */
     schemes?: Record<string, BrunoSecurityScheme>;
 }
+/** Options controlling what {@link generateOpenCollection} emits. */
 export interface OpenCollectionOptions {
     collectionName: string;
     contractRoots?: ContractRootNode[];
@@ -43,6 +46,18 @@ export interface OpenCollectionOptions {
 export declare function generateOpenCollection(roots: OpRootNode[], options: OpenCollectionOptions): OpenCollectionFile[];
 /** Parse a previously-written manifest. Returns the list of relative paths to clean up. Returns [] if missing or unreadable so a stale/garbled manifest never blocks regeneration. */
 export declare function parseManifest(content: string): string[];
+/**
+ * Deep-merges a YAML override string into a generated YAML string.
+ *
+ * Objects are merged recursively; arrays and scalars in the override replace the
+ * generated value entirely. If `pluginFileContent` is not a YAML mapping (e.g. it
+ * is a scalar or a list), the generated content is returned unchanged.
+ *
+ * @param generatedYaml - The YAML string produced by the Bruno codegen.
+ * @param pluginFileContent - The YAML override string to merge in.
+ * @returns The merged YAML string, or `generatedYaml` if the override is not a mapping.
+ */
+export declare function mergePluginFile(generatedYaml: string, pluginFileContent: string): string;
 /** Convert "Create an Offer" → create-an-offer (for .yml file names) */
 export declare function slugifyName(name: string): string;
 /** Convert /users/{id}/posts → users-id-posts (for .yml file names) */

package/dist/codegen-bruno.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"codegen-bruno.d.ts","sourceRoot":"","sources":["../src/codegen-bruno.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,UAAU,EAMV,gBAAgB,EAGnB,MAAM,mBAAmB,CAAC;AAI3B,MAAM,WAAW,kBAAkB;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,8JAA8J;AAC9J,eAAO,MAAM,iBAAiB,qCAAqC,CAAC;AAEpE,mFAAmF;AACnF,MAAM,WAAW,mBAAmB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC7B,gEAAgE;IAChE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;CACjD;AAED,MAAM,WAAW,qBAAqB;IAClC,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,gBAAgB,EAAE,CAAC;IACnC,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,OAAO,EAAE,qBAAqB,GAAG,kBAAkB,EAAE,CAmDhH;AAED,sLAAsL;AACtL,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAUvD;AAybD,wEAAwE;AACxE,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMhD;AAED,uEAAuE;AACvE,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CASjD"}
+{"version":3,"file":"codegen-bruno.d.ts","sourceRoot":"","sources":["../src/codegen-bruno.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,UAAU,EAMV,gBAAgB,EAGnB,MAAM,mBAAmB,CAAC;AAK3B,iGAAiG;AACjG,MAAM,WAAW,kBAAkB;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,8JAA8J;AAC9J,eAAO,MAAM,iBAAiB,qCAAqC,CAAC;AAEpE,mFAAmF;AACnF,MAAM,WAAW,mBAAmB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;CACf;AAED,kHAAkH;AAClH,MAAM,WAAW,gBAAgB;IAC7B,gEAAgE;IAChE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;CACjD;AAED,qEAAqE;AACrE,MAAM,WAAW,qBAAqB;IAClC,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,gBAAgB,EAAE,CAAC;IACnC,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,OAAO,EAAE,qBAAqB,GAAG,kBAAkB,EAAE,CAqDhH;AAED,sLAAsL;AACtL,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAUvD;AAsBD;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,aAAa,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,GAAG,MAAM,CAOxF;AAubD,wEAAwE;AACxE,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMhD;AAED,uEAAuE;AACvE,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CASjD"}

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 import type { BrunoSecurityScheme } from './codegen-bruno.js';
 import type { ContractKitPlugin } from '@contractkit/core';
+/** Configuration accepted by the Bruno plugin, both via `contractkit.config.json` and `createBrunoPlugin`. */
 export interface BrunoPluginConfig {
     baseDir?: string;
     output?: string;
@@ -16,7 +17,16 @@ export interface BrunoPluginConfig {
      * benefit from full coverage. Set to `false` to omit internal ops.
      */
     includeInternal?: boolean;
+    /**
+     * Directory containing YAML override files, resolved relative to `rootDir`.
+     * The directory mirrors the generated output structure — a file at
+     * `<overrideDir>/payments/get-payment.yml` is deep-merged into the generated
+     * `payments/get-payment.yml`. Arrays in the override replace the generated
+     * array entirely. Files with no matching override are emitted unchanged.
+     */
+    overrideDir?: string;
 }
+/** Full plugin options shape read from `ctx.options` — extends {@link BrunoPluginConfig} with the `auth` block. */
 export interface BrunoPluginOptions extends BrunoPluginConfig {
     auth?: {
         defaultScheme: string;
@@ -25,6 +35,16 @@ export interface BrunoPluginOptions extends BrunoPluginConfig {
 }
 declare const plugin: ContractKitPlugin;
 export default plugin;
+/**
+ * Creates a Bruno plugin instance with explicit configuration, for programmatic use.
+ *
+ * Prefer the default export when loading via `contractkit.config.json`. Use this
+ * factory when constructing the plugin in code (e.g. in tests or custom build scripts).
+ *
+ * @param config - Plugin configuration (output paths, feature flags, overrides).
+ * @param rootDir - Absolute path used to resolve relative paths in `config`.
+ * @param auth - Optional auth scheme configuration mirroring the `auth` key in plugin options.
+ */
 export declare function createBrunoPlugin(config: BrunoPluginConfig, rootDir: string, auth?: {
     defaultScheme: string;
     schemes?: Record<string, BrunoSecurityScheme>;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE3D,MAAM,WAAW,iBAAiB;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,kBAAmB,SAAQ,iBAAiB;IACzD,IAAI,CAAC,EAAE;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAA;KAAE,CAAC;CACnF;AAID,QAAA,MAAM,MAAM,EAAE,iBAsBb,CAAC;AAEF,eAAe,MAAM,CAAC;AAItB,wBAAgB,iBAAiB,CAC7B,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAA;CAAE,GAChF,iBAAiB,CAsBnB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE3D,8GAA8G;AAC9G,MAAM,WAAW,iBAAiB;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,mHAAmH;AACnH,MAAM,WAAW,kBAAmB,SAAQ,iBAAiB;IACzD,IAAI,CAAC,EAAE;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAA;KAAE,CAAC;CACnF;AAID,QAAA,MAAM,MAAM,EAAE,iBAuBb,CAAC;AAEF,eAAe,MAAM,CAAC;AAItB;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC7B,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAA;CAAE,GAChF,iBAAiB,CAuBnB"}

package/dist/index.js

@@ -8,6 +8,7 @@ import { existsSync, readFileSync, rmSync, readdirSync, rmdirSync } from "fs";
 // src/codegen-bruno.ts
 import { resolveSecurity, resolveModifiers, SECURITY_NONE } from "@contractkit/core";
 import { basename } from "path";
+import { parse as parseYaml, stringify as stringifyYaml } from "yaml";
 var MANIFEST_FILENAME = ".contractkit-bruno-manifest.json";
 function generateOpenCollection(roots, options) {
   const files = [];
@@ -48,9 +49,14 @@ function generateOpenCollection(roots, options) {
         if (!includeInternal && resolveModifiers(route, op).includes("internal")) continue;
         const requestName = op.name ?? route.path;
         const fileName = op.name ? `${slugifyName(op.name)}.yml` : `${op.method}-${sanitizePath(route.path)}.yml`;
+        let content = generateRequestFile(route, op, requestName, seq, modelMap, root, defaultScheme, randomExamples);
+        const pluginOverride = op.pluginFiles?.["bruno"];
+        if (pluginOverride !== void 0) {
+          content = mergePluginFile(content, pluginOverride);
+        }
         files.push({
           relativePath: `${requestDir}/${fileName}`,
-          content: generateRequestFile(route, op, requestName, seq, modelMap, root, defaultScheme, randomExamples)
+          content
         });
         seq++;
       }
@@ -80,6 +86,30 @@ function parseManifest(content) {
   return [];
 }
 __name(parseManifest, "parseManifest");
+function deepMerge(base, override) {
+  if (override !== null && typeof override === "object" && !Array.isArray(override) && base !== null && typeof base === "object" && !Array.isArray(base)) {
+    const result = {
+      ...base
+    };
+    for (const [key, val] of Object.entries(override)) {
+      result[key] = deepMerge(result[key], val);
+    }
+    return result;
+  }
+  return override;
+}
+__name(deepMerge, "deepMerge");
+function mergePluginFile(generatedYaml, pluginFileContent) {
+  const overrideParsed = parseYaml(pluginFileContent);
+  if (overrideParsed === null || typeof overrideParsed !== "object" || Array.isArray(overrideParsed)) {
+    return generatedYaml;
+  }
+  const merged = deepMerge(parseYaml(generatedYaml), overrideParsed);
+  return stringifyYaml(merged, {
+    lineWidth: 0
+  });
+}
+__name(mergePluginFile, "mergePluginFile");
 function generateCollectionRoot(name, scheme) {
   const lines = [
     `opencollection: "1.0.0"`,
@@ -502,9 +532,7 @@ function fieldsToExampleObject(fields, modelMap, randomExamples = false) {
     if (field.visibility === "readonly") continue;
     if (field.default !== void 0) {
       obj[field.name] = field.default;
-    } else if (field.optional) {
-      obj[field.name] = null;
-    } else {
+    } else if (!field.optional) {
       obj[field.name] = typeToExampleValue(field.type, modelMap, randomExamples);
     }
   }
@@ -553,6 +581,7 @@ var plugin = {
     const outDir = resolve(base, config.output ?? "bruno-collection");
     const collectionName = config.collectionName ?? basename2(ctx.rootDir);
     cleanupTrackedFiles(outDir);
+    const overrideDirAbs = config.overrideDir ? resolve(ctx.rootDir, config.overrideDir) : void 0;
     const files = generateOpenCollection(opRoots, {
       collectionName,
       contractRoots,
@@ -561,7 +590,7 @@ var plugin = {
       includeInternal: config.includeInternal
     });
     for (const { relativePath, content } of files) {
-      ctx.emitFile(resolve(outDir, relativePath), content);
+      ctx.emitFile(resolve(outDir, relativePath), applyDirOverride(relativePath, content, overrideDirAbs));
     }
   }
 };
@@ -575,6 +604,7 @@ function createBrunoPlugin(config, rootDir, auth) {
       const outDir = resolve(base, config.output ?? "bruno-collection");
       const collectionName = config.collectionName ?? basename2(rootDir);
       cleanupTrackedFiles(outDir);
+      const overrideDirAbs = config.overrideDir ? resolve(rootDir, config.overrideDir) : void 0;
       const files = generateOpenCollection(opRoots, {
         collectionName,
         contractRoots,
@@ -582,12 +612,19 @@ function createBrunoPlugin(config, rootDir, auth) {
         randomExamples: config.randomExamples ?? true
       });
       for (const { relativePath, content } of files) {
-        ctx.emitFile(resolve(outDir, relativePath), content);
+        ctx.emitFile(resolve(outDir, relativePath), applyDirOverride(relativePath, content, overrideDirAbs));
       }
     }
   };
 }
 __name(createBrunoPlugin, "createBrunoPlugin");
+function applyDirOverride(relativePath, content, overrideDirAbs) {
+  if (!overrideDirAbs || relativePath === MANIFEST_FILENAME) return content;
+  const overrideFile = resolve(overrideDirAbs, relativePath);
+  if (!existsSync(overrideFile)) return content;
+  return mergePluginFile(content, readFileSync(overrideFile, "utf-8"));
+}
+__name(applyDirOverride, "applyDirOverride");
 function cleanupTrackedFiles(outDir) {
   const manifestPath = resolve(outDir, MANIFEST_FILENAME);
   if (!existsSync(manifestPath)) return;