@contractkit/plugin-bruno 0.10.0 → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (22) hide show
  1. package/.turbo/turbo-build$colon$ci.log +7 -7
  2. package/.turbo/turbo-test$colon$ci.log +8 -9
  3. package/CHANGELOG.md +36 -0
  4. package/README.md +34 -12
  5. package/coverage/clover.xml +285 -323
  6. package/coverage/coverage-final.json +2 -3
  7. package/coverage/index.html +19 -19
  8. package/coverage/src/codegen-bruno.ts.html +218 -119
  9. package/coverage/src/index.html +19 -34
  10. package/coverage/tests/helpers.ts.html +9 -9
  11. package/coverage/tests/index.html +1 -1
  12. package/dist/codegen-bruno.d.ts +11 -0
  13. package/dist/codegen-bruno.d.ts.map +1 -1
  14. package/dist/index.d.ts +7 -7
  15. package/dist/index.d.ts.map +1 -1
  16. package/dist/index.js +43 -28
  17. package/dist/index.js.map +1 -1
  18. package/package.json +2 -2
  19. package/src/codegen-bruno.ts +40 -7
  20. package/src/index.ts +13 -19
  21. package/tests/codegen-bruno.test.ts +55 -67
  22. package/coverage/src/index.ts.html +0 -562
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/index.ts","../src/codegen-bruno.ts"],"sourcesContent":["import { resolve, basename, dirname } from 'node:path';\nimport { existsSync, readFileSync, rmSync, readdirSync, rmdirSync } from 'node:fs';\nimport { generateOpenCollection, MANIFEST_FILENAME, parseManifest, mergePluginFile } from './codegen-bruno.js';\nimport type { BrunoSecurityScheme } from './codegen-bruno.js';\nimport type { ContractKitPlugin } from '@contractkit/core';\n\n/** Configuration accepted by the Bruno plugin, both via `contractkit.config.json` and `createBrunoPlugin`. */\nexport interface BrunoPluginConfig {\n baseDir?: string;\n output?: string;\n collectionName?: string;\n /**\n * When true (default), example values use Bruno's faker templates\n * (`{{$randomUUID}}`, `{{$randomEmail}}`, etc.) so each send produces\n * fresh data. Set to false for deterministic placeholders.\n */\n randomExamples?: boolean;\n /**\n * Whether to generate request files for operations marked `internal`. Defaults to\n * `true` — Bruno collections are typically used by the team that owns the API and\n * benefit from full coverage. Set to `false` to omit internal ops.\n */\n includeInternal?: boolean;\n /**\n * Directory containing YAML override files, resolved relative to `rootDir`.\n * The directory mirrors the generated output structure — a file at\n * `<overrideDir>/payments/get-payment.yml` is deep-merged into the generated\n * `payments/get-payment.yml`. Arrays in the override replace the generated\n * array entirely. Files with no matching override are emitted unchanged.\n */\n overrideDir?: string;\n}\n\n/** Full plugin options shape read from `ctx.options` — extends {@link BrunoPluginConfig} with the `auth` block. */\nexport interface BrunoPluginOptions extends BrunoPluginConfig {\n auth?: { defaultScheme: string; schemes?: Record<string, BrunoSecurityScheme> };\n}\n\n// ─── Default export: loaded via plugins array, reads config from ctx.options ─\n\nconst plugin: ContractKitPlugin = {\n name: 'bruno',\n cacheKey: 'bruno',\n async generateTargets({ opRoots, contractRoots }, ctx) {\n const { auth, ...config } = ctx.options as BrunoPluginOptions;\n const base = config.baseDir ? resolve(ctx.rootDir, config.baseDir) : ctx.rootDir;\n const outDir = resolve(base, config.output ?? 'bruno-collection');\n const collectionName = config.collectionName ?? basename(ctx.rootDir);\n\n cleanupTrackedFiles(outDir);\n\n const overrideDirAbs = config.overrideDir ? resolve(ctx.rootDir, config.overrideDir) : undefined;\n const files = generateOpenCollection(opRoots, {\n collectionName,\n contractRoots,\n auth,\n randomExamples: config.randomExamples ?? true,\n includeInternal: config.includeInternal,\n });\n for (const { relativePath, content } of files) {\n ctx.emitFile(resolve(outDir, relativePath), applyDirOverride(relativePath, content, overrideDirAbs));\n }\n },\n};\n\nexport default plugin;\n\n// ─── Factory: for programmatic use with explicit config ────────────────────\n\n/**\n * Creates a Bruno plugin instance with explicit configuration, for programmatic use.\n *\n * Prefer the default export when loading via `contractkit.config.json`. Use this\n * factory when constructing the plugin in code (e.g. in tests or custom build scripts).\n *\n * @param config - Plugin configuration (output paths, feature flags, overrides).\n * @param rootDir - Absolute path used to resolve relative paths in `config`.\n * @param auth - Optional auth scheme configuration mirroring the `auth` key in plugin options.\n */\nexport function createBrunoPlugin(\n config: BrunoPluginConfig,\n rootDir: string,\n auth?: { defaultScheme: string; schemes?: Record<string, BrunoSecurityScheme> },\n): ContractKitPlugin {\n return {\n name: 'bruno',\n cacheKey: `bruno:${JSON.stringify(config)}`,\n async generateTargets({ opRoots, contractRoots }, ctx) {\n const base = config.baseDir ? resolve(rootDir, config.baseDir) : rootDir;\n const outDir = resolve(base, config.output ?? 'bruno-collection');\n const collectionName = config.collectionName ?? basename(rootDir);\n\n cleanupTrackedFiles(outDir);\n\n const overrideDirAbs = config.overrideDir ? resolve(rootDir, config.overrideDir) : undefined;\n const files = generateOpenCollection(opRoots, {\n collectionName,\n contractRoots,\n auth,\n randomExamples: config.randomExamples ?? true,\n });\n for (const { relativePath, content } of files) {\n ctx.emitFile(resolve(outDir, relativePath), applyDirOverride(relativePath, content, overrideDirAbs));\n }\n },\n };\n}\n\nfunction applyDirOverride(relativePath: string, content: string, overrideDirAbs: string | undefined): string {\n if (!overrideDirAbs || relativePath === MANIFEST_FILENAME) return content;\n const overrideFile = resolve(overrideDirAbs, relativePath);\n if (!existsSync(overrideFile)) return content;\n return mergePluginFile(content, readFileSync(overrideFile, 'utf-8'));\n}\n\n/**\n * Delete files this plugin generated on the previous run, leaving anything\n * the user added (custom .bru files, scripts, secrets, etc.) untouched.\n *\n * On first run — or after manual deletion of the manifest — nothing is\n * removed; stale files from prior versions linger until manually cleaned.\n */\nfunction cleanupTrackedFiles(outDir: string): void {\n const manifestPath = resolve(outDir, MANIFEST_FILENAME);\n if (!existsSync(manifestPath)) return;\n\n let tracked: string[];\n try {\n tracked = parseManifest(readFileSync(manifestPath, 'utf-8'));\n } catch {\n return;\n }\n\n const removedDirs = new Set<string>();\n for (const rel of tracked) {\n const abs = resolve(outDir, rel);\n if (existsSync(abs)) {\n rmSync(abs, { force: true });\n removedDirs.add(dirname(abs));\n }\n }\n\n // Walk up from each affected directory and remove it if empty, stopping at outDir.\n for (const dir of removedDirs) {\n let current = dir;\n while (current.startsWith(outDir) && current !== outDir) {\n try {\n if (readdirSync(current).length === 0) {\n rmdirSync(current);\n current = dirname(current);\n } else {\n break;\n }\n } catch {\n break;\n }\n }\n }\n}\n","import type {\n OpRootNode,\n OpRouteNode,\n OpOperationNode,\n OpResponseNode,\n ParamSource,\n ContractTypeNode,\n ContractRootNode,\n ModelNode,\n FieldNode,\n} from '@contractkit/core';\nimport { resolveSecurity, resolveModifiers, SECURITY_NONE } from '@contractkit/core';\nimport { basename } from 'path';\nimport { parse as parseYaml, stringify as stringifyYaml } from 'yaml';\n\n/** A single file produced by the Bruno codegen — a relative output path and its YAML content. */\nexport interface OpenCollectionFile {\n relativePath: string;\n content: string;\n}\n\n/** Manifest filename — tracks which files this plugin previously generated so subsequent runs can clean up only those, leaving any user-added files alone. */\nexport const MANIFEST_FILENAME = '.contractkit-bruno-manifest.json';\n\n/** Subset of a security scheme sufficient for Bruno auth generation (non-HMAC). */\nexport interface BrunoSecurityScheme {\n type: string; // \"http\" | \"apiKey\" | \"oauth2\" | \"openIdConnect\"\n scheme?: string; // \"bearer\" | \"basic\" (when type === \"http\")\n name?: string; // header/query param name (when type === \"apiKey\")\n in?: string; // \"header\" | \"query\" (when type === \"apiKey\")\n}\n\n/** Auth configuration passed to the Bruno codegen; drives collection-level auth and per-operation auth blocks. */\nexport interface BrunoAuthOptions {\n /** Name of the default scheme (from config.security.default) */\n defaultScheme?: string;\n /** Scheme definitions keyed by name (non-HMAC only) */\n schemes?: Record<string, BrunoSecurityScheme>;\n}\n\n/** Options controlling what {@link generateOpenCollection} emits. */\nexport interface OpenCollectionOptions {\n collectionName: string;\n contractRoots?: ContractRootNode[];\n auth?: BrunoAuthOptions;\n /**\n * When true, emit Bruno faker template strings (e.g. `{{$randomUUID}}`,\n * `{{$randomEmail}}`) for compatible scalar types so each send produces\n * fresh data. When false (default), use deterministic placeholders.\n */\n randomExamples?: boolean;\n /**\n * Whether to generate request files for operations marked `internal`. Defaults to\n * `true` — Bruno collections are typically used by the team that owns the API and\n * benefit from full coverage. Set to `false` to omit internal ops.\n */\n includeInternal?: boolean;\n}\n\n/**\n * Generates an OpenCollection (https://spec.opencollection.com/) API collection\n * from a set of operation roots. Produces opencollection.yml, an environment\n * file, and one .yml request file per operation.\n */\nexport function generateOpenCollection(roots: OpRootNode[], options: OpenCollectionOptions): OpenCollectionFile[] {\n const files: OpenCollectionFile[] = [];\n\n const modelMap = buildModelMap(options.contractRoots ?? []);\n const authOpts = options.auth;\n const defaultScheme = authOpts?.defaultScheme ? authOpts.schemes?.[authOpts.defaultScheme] : undefined;\n const randomExamples = options.randomExamples ?? false;\n const includeInternal = options.includeInternal ?? true;\n\n files.push({ relativePath: 'opencollection.yml', content: generateCollectionRoot(options.collectionName, defaultScheme) });\n files.push({ relativePath: 'environments/local.yml', content: generateEnvFile(defaultScheme) });\n // Manifest is appended at the end so it lists every generated path including itself.\n\n for (let rootIdx = 0; rootIdx < roots.length; rootIdx++) {\n const root = roots[rootIdx]!;\n const folder = root.meta['area'] ? slugifyName(root.meta['area']) : deriveFolderName(root.file);\n const displayName = (root.meta['area'] ?? folder).charAt(0).toUpperCase() + (root.meta['area'] ?? folder).slice(1);\n\n files.push({ relativePath: `${folder}/folder.yml`, content: generateFolderFile(displayName, rootIdx + 1) });\n\n const subarea = root.meta['subarea'];\n const subareaSlug = subarea ? slugifyName(subarea) : undefined;\n const requestDir = subareaSlug ? `${folder}/${subareaSlug}` : folder;\n\n if (subareaSlug) {\n const subareaDisplayName = subarea!.charAt(0).toUpperCase() + subarea!.slice(1);\n files.push({ relativePath: `${requestDir}/folder.yml`, content: generateFolderFile(subareaDisplayName, 1) });\n }\n\n let seq = 1;\n for (const route of root.routes) {\n for (const op of route.operations) {\n if (!includeInternal && resolveModifiers(route, op).includes('internal')) continue;\n const requestName = op.name ?? route.path;\n const fileName = op.name ? `${slugifyName(op.name)}.yml` : `${op.method}-${sanitizePath(route.path)}.yml`;\n let content = generateRequestFile(route, op, requestName, seq, modelMap, root, defaultScheme, randomExamples);\n const pluginOverride = op.pluginFiles?.['bruno'];\n if (pluginOverride !== undefined) {\n content = mergePluginFile(content, pluginOverride);\n }\n files.push({ relativePath: `${requestDir}/${fileName}`, content });\n seq++;\n }\n }\n }\n\n const trackedPaths = [...files.map(f => f.relativePath), MANIFEST_FILENAME].sort();\n files.push({\n relativePath: MANIFEST_FILENAME,\n content: JSON.stringify({ files: trackedPaths }, null, 2) + '\\n',\n });\n\n return files;\n}\n\n/** 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. */\nexport function parseManifest(content: string): string[] {\n try {\n const parsed = JSON.parse(content);\n if (Array.isArray(parsed?.files) && parsed.files.every((f: unknown) => typeof f === 'string')) {\n return parsed.files as string[];\n }\n } catch {\n // fall through\n }\n return [];\n}\n\n// ─── Plugin file merge ─────────────────────────────────────────────────────\n\nfunction deepMerge(base: unknown, override: unknown): unknown {\n if (\n override !== null &&\n typeof override === 'object' &&\n !Array.isArray(override) &&\n base !== null &&\n typeof base === 'object' &&\n !Array.isArray(base)\n ) {\n const result: Record<string, unknown> = { ...(base as Record<string, unknown>) };\n for (const [key, val] of Object.entries(override as Record<string, unknown>)) {\n result[key] = deepMerge(result[key], val);\n }\n return result;\n }\n return override;\n}\n\n/**\n * Deep-merges a YAML override string into a generated YAML string.\n *\n * Objects are merged recursively; arrays and scalars in the override replace the\n * generated value entirely. If `pluginFileContent` is not a YAML mapping (e.g. it\n * is a scalar or a list), the generated content is returned unchanged.\n *\n * @param generatedYaml - The YAML string produced by the Bruno codegen.\n * @param pluginFileContent - The YAML override string to merge in.\n * @returns The merged YAML string, or `generatedYaml` if the override is not a mapping.\n */\nexport function mergePluginFile(generatedYaml: string, pluginFileContent: string): string {\n const overrideParsed = parseYaml(pluginFileContent);\n if (overrideParsed === null || typeof overrideParsed !== 'object' || Array.isArray(overrideParsed)) {\n return generatedYaml;\n }\n const merged = deepMerge(parseYaml(generatedYaml), overrideParsed);\n return stringifyYaml(merged, { lineWidth: 0 });\n}\n\n// ─── File generators ───────────────────────────────────────────────────────\n\nfunction generateCollectionRoot(name: string, scheme?: BrunoSecurityScheme): string {\n const lines = [`opencollection: \"1.0.0\"`, `info:`, ` name: ${yamlString(name)}`];\n if (scheme) {\n lines.push(``);\n lines.push(`request:`);\n lines.push(...renderAuthBlock(scheme, ' '));\n }\n lines.push(``);\n return lines.join('\\n');\n}\n\nfunction generateEnvFile(scheme?: BrunoSecurityScheme): string {\n const lines = [`name: Local`, `variables:`, ` - name: baseUrl`, ` value: \"http://localhost:3000\"`];\n if (scheme) {\n for (const varName of authEnvVarNames(scheme)) {\n lines.push(` - name: ${varName}`);\n lines.push(` value: \"\"`);\n }\n }\n lines.push(``);\n return lines.join('\\n');\n}\n\nfunction generateFolderFile(name: string, seq: number): string {\n return [`info:`, ` name: ${yamlString(name)}`, ` type: folder`, ` seq: ${seq}`, ``].join('\\n');\n}\n\nfunction generateRequestFile(\n route: OpRouteNode,\n op: OpOperationNode,\n name: string,\n seq: number,\n modelMap: Map<string, ModelNode>,\n root?: OpRootNode,\n defaultScheme?: BrunoSecurityScheme,\n randomExamples = false,\n): string {\n const lines: string[] = [];\n\n lines.push(`info:`);\n lines.push(` name: ${yamlString(name)}`);\n lines.push(` type: http`);\n lines.push(` seq: ${seq}`);\n lines.push(``);\n lines.push(`http:`);\n lines.push(` method: ${op.method.toUpperCase()}`);\n lines.push(` url: ${yamlString(`{{baseUrl}}${openCollectionPath(route.path)}`)}`);\n\n // Params — flat array with type: \"path\" | \"query\". Optional query params are\n // emitted with disabled: true so users opt in before sending.\n const pathParams: Array<ParamEntry & { kind: 'path' | 'query' }> = extractPathParamNames(route.path).map(n => ({\n name: n,\n type: findParamType(route.params, n, modelMap),\n optional: false,\n kind: 'path' as const,\n }));\n const queryParams: Array<ParamEntry & { kind: 'path' | 'query' }> = op.query\n ? expandParamSource(op.query, modelMap).map(e => ({ ...e, kind: 'query' as const }))\n : [];\n const allParams = [...pathParams, ...queryParams];\n\n if (allParams.length > 0) {\n lines.push(` params:`);\n for (const p of allParams) {\n lines.push(` - name: ${p.name}`);\n lines.push(` value: ${paramExampleValue(p.type, p.default, randomExamples)}`);\n lines.push(` type: ${p.kind}`);\n if (p.optional && p.kind === 'query') lines.push(` disabled: true`);\n }\n }\n\n // Headers\n if (op.headers) {\n const headerEntries = expandParamSource(op.headers, modelMap);\n if (headerEntries.length > 0) {\n lines.push(` headers:`);\n for (const h of headerEntries) {\n lines.push(` - name: ${h.name}`);\n lines.push(` value: ${paramExampleValue(h.type, h.default, randomExamples)}`);\n if (h.optional) lines.push(` disabled: true`);\n }\n }\n }\n\n // Auth — inside http block; inherit collection default unless this op is explicitly public\n if (defaultScheme) {\n const security = root ? resolveSecurity(route, op, root) : (op.security ?? route.security);\n if (security === SECURITY_NONE) {\n lines.push(` auth:`);\n lines.push(` type: none`);\n } else {\n lines.push(` auth: inherit`);\n }\n }\n\n // Body — Bruno supports a single body per request, so prefer JSON, then form-urlencoded, then multipart.\n if (op.request && op.request.bodies.length > 0) {\n const preferredOrder: Array<(typeof op.request.bodies)[number]['contentType']> = [\n 'application/json',\n 'application/x-www-form-urlencoded',\n 'multipart/form-data',\n ];\n const primary =\n preferredOrder.map(ct => op.request!.bodies.find(b => b.contentType === ct)).find(b => b !== undefined) ?? op.request.bodies[0]!;\n\n lines.push(` body:`);\n if (primary.contentType === 'multipart/form-data') {\n lines.push(` type: multipart-form`);\n lines.push(` data: []`);\n } else if (primary.contentType === 'application/x-www-form-urlencoded') {\n lines.push(` type: form-urlencoded`);\n lines.push(` data: []`);\n } else {\n const json = JSON.stringify(typeToExampleValue(primary.bodyType, modelMap, randomExamples), null, 2);\n lines.push(` type: json`);\n lines.push(` data: |`);\n for (const jsonLine of json.split('\\n')) {\n lines.push(` ${jsonLine}`);\n }\n }\n }\n\n // runtime.assertions — auto-generate a status-code check and presence checks for required response headers.\n const expectedStatus = pickAssertionStatus(op.responses);\n const assertedResponse = op.responses.find(r => r.statusCode === expectedStatus);\n const requiredHeaders = (assertedResponse?.headers ?? []).filter(h => !h.optional);\n if (expectedStatus !== undefined) {\n lines.push(``);\n lines.push(`runtime:`);\n lines.push(` assertions:`);\n lines.push(` - expression: res.status`);\n lines.push(` operator: eq`);\n // Always quote — the OpenCollection schema types `value` as a string,\n // so we must keep \"200\" from being parsed as YAML number 200.\n lines.push(` value: \"${expectedStatus}\"`);\n for (const h of requiredHeaders) {\n lines.push(` - expression: res.headers[\"${h.name.toLowerCase()}\"]`);\n lines.push(` operator: isDefined`);\n lines.push(` value: \"\"`);\n }\n }\n\n // docs — combine route- and operation-level descriptions plus the declared response-header summary.\n const docs = buildRequestDocs(route, op, assertedResponse);\n if (docs) {\n lines.push(``);\n lines.push(`docs: |-`);\n for (const docLine of docs.split('\\n')) {\n lines.push(` ${docLine}`);\n }\n }\n\n lines.push(``);\n return lines.join('\\n');\n}\n\n/** Pick the response whose status code we'll assert against. Prefers the first declared 2xx; otherwise falls back to the first declared response. Returns undefined if no responses are declared. */\nfunction pickAssertionStatus(responses: OpResponseNode[]): number | undefined {\n const success = responses.find(r => r.statusCode >= 200 && r.statusCode < 300);\n return success?.statusCode ?? responses[0]?.statusCode;\n}\n\n/** Build a markdown docs block from route- and operation-level descriptions, plus declared response-header summary. */\nfunction buildRequestDocs(route: OpRouteNode, op: OpOperationNode, assertedResponse?: OpResponseNode): string | undefined {\n const parts: string[] = [];\n if (route.description) parts.push(route.description.trim());\n if (op.description) parts.push(op.description.trim());\n const headers = assertedResponse?.headers ?? [];\n if (headers.length > 0) {\n const lines = ['**Response headers**', ''];\n for (const h of headers) {\n const tag = h.optional ? 'optional' : 'required';\n const desc = h.description ? ` — ${h.description}` : '';\n lines.push(`- \\`${h.name}\\` (${tag})${desc}`);\n }\n parts.push(lines.join('\\n'));\n }\n return parts.length > 0 ? parts.join('\\n\\n') : undefined;\n}\n\n// ─── Auth helpers ──────────────────────────────────────────────────────────\n\n/** Generate the YAML lines for an auth block (flat, per spec), indented by `indent`. */\nfunction renderAuthBlock(scheme: BrunoSecurityScheme, indent: string): string[] {\n const i = indent;\n if (scheme.type === 'http' && scheme.scheme === 'bearer') {\n return [`${i}auth:`, `${i} type: bearer`, `${i} token: \"{{token}}\"`];\n }\n if (scheme.type === 'http' && scheme.scheme === 'basic') {\n return [`${i}auth:`, `${i} type: basic`, `${i} username: \"{{username}}\"`, `${i} password: \"{{password}}\"`];\n }\n if (scheme.type === 'apiKey' && scheme.in === 'header') {\n const headerName = scheme.name ?? 'X-Api-Key';\n return [`${i}auth:`, `${i} type: apikey`, `${i} key: ${headerName}`, `${i} value: \"{{apiKey}}\"`, `${i} placement: header`];\n }\n return [];\n}\n\n/** Return the environment variable names needed for a given auth scheme. */\nfunction authEnvVarNames(scheme: BrunoSecurityScheme): string[] {\n if (scheme.type === 'http' && scheme.scheme === 'bearer') return ['token'];\n if (scheme.type === 'http' && scheme.scheme === 'basic') return ['username', 'password'];\n if (scheme.type === 'apiKey') return ['apiKey'];\n return [];\n}\n\n// ─── Model registry ────────────────────────────────────────────────────────\n\nfunction buildModelMap(contractRoots: ContractRootNode[]): Map<string, ModelNode> {\n const map = new Map<string, ModelNode>();\n for (const root of contractRoots) {\n for (const model of root.models) {\n map.set(model.name, model);\n }\n }\n return map;\n}\n\n/** Resolve all fields for a model, including inherited base fields (bases first, in declaration order). */\nfunction resolveModelFields(model: ModelNode, modelMap: Map<string, ModelNode>): FieldNode[] {\n const collected: FieldNode[] = [];\n if (model.bases) {\n for (const base of model.bases) {\n const baseModel = modelMap.get(base);\n if (baseModel) collected.push(...resolveModelFields(baseModel, modelMap));\n }\n }\n return [...collected, ...model.fields];\n}\n\n// ─── Param helpers ─────────────────────────────────────────────────────────\n\ninterface ParamEntry {\n name: string;\n type: ContractTypeNode | undefined;\n default?: string | number | boolean;\n optional: boolean;\n}\n\n/** Expand a ParamSource into a flat list of named entries with their types. */\nfunction expandParamSource(source: ParamSource, modelMap: Map<string, ModelNode>): ParamEntry[] {\n if (source.kind === 'params') {\n return source.nodes.map(n => ({ name: n.name, type: n.type, default: n.default, optional: n.optional }));\n }\n if (source.kind === 'ref') {\n const model = modelMap.get(source.name);\n if (model) {\n return resolveModelFields(model, modelMap)\n .filter(f => f.visibility !== 'readonly')\n .map(f => ({ name: f.name, type: f.type, default: f.default, optional: f.optional }));\n }\n // Fallback: single placeholder entry\n const name = source.name.charAt(0).toLowerCase() + source.name.slice(1);\n return [{ name, type: undefined, optional: false }];\n }\n // kind === 'type': if it's an inline object, expand its fields\n if (source.node.kind === 'inlineObject') {\n return source.node.fields.map(f => ({ name: f.name, type: f.type, default: f.default, optional: f.optional }));\n }\n return [];\n}\n\n/** Look up a named path param's type from route.params. */\nfunction findParamType(source: ParamSource | undefined, name: string, modelMap: Map<string, ModelNode>): ContractTypeNode | undefined {\n if (!source) return undefined;\n if (source.kind === 'params') return source.nodes.find(n => n.name === name)?.type;\n if (source.kind === 'ref') {\n const model = modelMap.get(source.name);\n if (model) return resolveModelFields(model, modelMap).find(f => f.name === name)?.type;\n }\n if (source.kind === 'type' && source.node.kind === 'inlineObject') {\n return source.node.fields.find(f => f.name === name)?.type;\n }\n return undefined;\n}\n\n/** Return a YAML-quoted example value string for a param, preferring a default value when provided. */\nfunction paramExampleValue(type: ContractTypeNode | undefined, defaultValue?: string | number | boolean, randomExamples = false): string {\n if (defaultValue !== undefined) return `\"${defaultValue}\"`;\n if (!type) return '\"\"';\n if (type.kind === 'enum') return type.values.length > 0 ? `\"${type.values[0]}\"` : '\"\"';\n if (type.kind === 'literal') return `\"${type.value}\"`;\n if (type.kind !== 'scalar') return '\"\"';\n if (randomExamples) {\n const random = randomScalarTemplate(type.name);\n if (random !== undefined) return `\"${random}\"`;\n }\n switch (type.name) {\n case 'uuid':\n return '\"00000000-0000-0000-0000-000000000000\"';\n case 'email':\n return '\"user@example.com\"';\n case 'url':\n return '\"https://example.com\"';\n case 'number':\n case 'int':\n case 'bigint':\n return '\"0\"';\n case 'boolean':\n return '\"true\"';\n case 'date':\n return '\"2024-01-01\"';\n case 'time':\n return '\"00:00:00\"';\n case 'datetime':\n return '\"2024-01-01T00:00:00Z\"';\n case 'duration':\n return '\"PT1H\"';\n default:\n return '\"\"';\n }\n}\n\n/** Bruno faker template for a scalar type, or undefined when no clean equivalent exists (date, time, duration, raw string). */\nfunction randomScalarTemplate(name: string): string | undefined {\n switch (name) {\n case 'uuid':\n return '{{$randomUUID}}';\n case 'email':\n return '{{$randomEmail}}';\n case 'url':\n return '{{$randomUrl}}';\n case 'number':\n case 'int':\n case 'bigint':\n return '{{$randomInt}}';\n case 'boolean':\n return '{{$randomBoolean}}';\n case 'datetime':\n return '{{$isoTimestamp}}';\n default:\n return undefined;\n }\n}\n\n// ─── Body helpers ──────────────────────────────────────────────────────────\n\n/**\n * Recursively build an example JSON value from a ContractTypeNode.\n *\n * When `randomExamples` is true we substitute Bruno faker templates only for\n * scalars whose JSON representation is a string (uuid/email/url/datetime).\n * Numbers and booleans stay deterministic — embedding `{{$randomInt}}` as a\n * bare JSON number would require sentinel-stripping the surrounding quotes,\n * and the body skeleton is meant as a starting point users edit anyway.\n */\nfunction typeToExampleValue(type: ContractTypeNode, modelMap: Map<string, ModelNode>, randomExamples = false): unknown {\n switch (type.kind) {\n case 'scalar':\n switch (type.name) {\n case 'string':\n return '';\n case 'email':\n return randomExamples ? '{{$randomEmail}}' : 'user@example.com';\n case 'url':\n return randomExamples ? '{{$randomUrl}}' : 'https://example.com';\n case 'uuid':\n return randomExamples ? '{{$randomUUID}}' : '00000000-0000-0000-0000-000000000000';\n case 'number':\n case 'int':\n case 'bigint':\n return 0;\n case 'boolean':\n return true;\n case 'date':\n return '2024-01-01';\n case 'time':\n return '00:00:00';\n case 'datetime':\n return randomExamples ? '{{$isoTimestamp}}' : '2024-01-01T00:00:00Z';\n case 'duration':\n return 'PT1H';\n case 'null':\n return null;\n default:\n return null;\n }\n case 'enum':\n return type.values[0] ?? '';\n case 'literal':\n return type.value;\n case 'array':\n return [typeToExampleValue(type.item, modelMap, randomExamples)];\n case 'tuple':\n return type.items.map(t => typeToExampleValue(t, modelMap, randomExamples));\n case 'record':\n return {};\n case 'union':\n return type.members.length > 0 ? typeToExampleValue(type.members[0]!, modelMap, randomExamples) : null;\n case 'discriminatedUnion':\n return type.members.length > 0 ? typeToExampleValue(type.members[0]!, modelMap, randomExamples) : null;\n case 'intersection':\n return {};\n case 'ref': {\n const model = modelMap.get(type.name);\n if (!model) return {};\n // Type alias — recurse into the aliased type\n if (model.type) return typeToExampleValue(model.type, modelMap, randomExamples);\n return modelToExampleObject(model, modelMap, randomExamples);\n }\n case 'lazy':\n return typeToExampleValue(type.inner, modelMap, randomExamples);\n case 'inlineObject':\n return fieldsToExampleObject(type.fields, modelMap, randomExamples);\n default:\n return null;\n }\n}\n\n/** Build an example object from a ModelNode's fields (including inherited base fields). */\nfunction modelToExampleObject(model: ModelNode, modelMap: Map<string, ModelNode>, randomExamples = false): Record<string, unknown> {\n return fieldsToExampleObject(resolveModelFields(model, modelMap), modelMap, randomExamples);\n}\n\n/** Build an example object from a list of FieldNodes. Excludes readonly fields; uses defaults when available; omits optional fields that have no default so they don't appear in the JSON output. */\nfunction fieldsToExampleObject(fields: FieldNode[], modelMap: Map<string, ModelNode>, randomExamples = false): Record<string, unknown> {\n const obj: Record<string, unknown> = {};\n for (const field of fields) {\n if (field.visibility === 'readonly') continue;\n if (field.default !== undefined) {\n obj[field.name] = field.default;\n } else if (!field.optional) {\n obj[field.name] = typeToExampleValue(field.type, modelMap, randomExamples);\n }\n }\n return obj;\n}\n\n// ─── Path helpers ──────────────────────────────────────────────────────────\n\n/** Convert /users/{id}/posts → /users/:id/posts (Bruno path parameter syntax) */\nfunction openCollectionPath(path: string): string {\n return path.replace(/\\{([a-zA-Z_][a-zA-Z0-9_]*)\\}/g, ':$1');\n}\n\n/** Convert \"Create an Offer\" → create-an-offer (for .yml file names) */\nexport function slugifyName(name: string): string {\n const result = name\n .toLowerCase()\n .replace(/[^a-z0-9]+/g, '-')\n .replace(/^-|-$/g, '');\n return result || 'request';\n}\n\n/** Convert /users/{id}/posts → users-id-posts (for .yml file names) */\nexport function sanitizePath(path: string): string {\n const result = path\n .replace(/^\\//, '')\n .replace(/\\{([a-zA-Z_][a-zA-Z0-9_]*)\\}/g, '$1')\n .replace(/\\//g, '-')\n .replace(/[^a-zA-Z0-9-]/g, '')\n .replace(/-+/g, '-')\n .replace(/^-|-$/g, '');\n return result || 'root';\n}\n\n/** Extract param names from a URL template, e.g. /users/{id} → ['id'] */\nfunction extractPathParamNames(path: string): string[] {\n return [...path.matchAll(/\\{([a-zA-Z_][a-zA-Z0-9_]*)\\}/g)].map(m => m[1]!);\n}\n\n/** Derive folder name from op file path, e.g. src/users.op → users */\nfunction deriveFolderName(file: string): string {\n return basename(file).replace(/\\.(op|ck)$/, '');\n}\n\n/**\n * Wrap a string in YAML double quotes if it contains characters that require quoting\n * (flow indicators, colons, braces, etc.).\n */\nfunction yamlString(value: string): string {\n if (/[:{}[\\],&*#?|<>=!%@`\"']/.test(value) || /^\\s|\\s$/.test(value)) {\n return `\"${value.replace(/\\\\/g, '\\\\\\\\').replace(/\"/g, '\\\\\"')}\"`;\n }\n return value;\n}\n"],"mappings":"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","names":["resolve","basename","dirname","existsSync","readFileSync","rmSync","readdirSync","rmdirSync","resolveSecurity","resolveModifiers","SECURITY_NONE","basename","parse","parseYaml","stringify","stringifyYaml","MANIFEST_FILENAME","generateOpenCollection","roots","options","files","modelMap","buildModelMap","contractRoots","authOpts","auth","defaultScheme","schemes","undefined","randomExamples","includeInternal","push","relativePath","content","generateCollectionRoot","collectionName","generateEnvFile","rootIdx","length","root","folder","meta","slugifyName","deriveFolderName","file","displayName","charAt","toUpperCase","slice","generateFolderFile","subarea","subareaSlug","requestDir","subareaDisplayName","seq","route","routes","op","operations","resolveModifiers","includes","requestName","name","path","fileName","method","sanitizePath","generateRequestFile","pluginOverride","pluginFiles","mergePluginFile","trackedPaths","map","f","sort","JSON","stringify","parseManifest","parsed","parse","Array","isArray","every","deepMerge","base","override","result","key","val","Object","entries","generatedYaml","pluginFileContent","overrideParsed","parseYaml","merged","stringifyYaml","lineWidth","scheme","lines","yamlString","renderAuthBlock","join","varName","authEnvVarNames","openCollectionPath","pathParams","extractPathParamNames","n","type","findParamType","params","optional","kind","queryParams","query","expandParamSource","e","allParams","p","paramExampleValue","default","headers","headerEntries","h","security","resolveSecurity","SECURITY_NONE","request","bodies","preferredOrder","primary","ct","find","b","contentType","json","typeToExampleValue","bodyType","jsonLine","split","expectedStatus","pickAssertionStatus","responses","assertedResponse","r","statusCode","requiredHeaders","filter","toLowerCase","docs","buildRequestDocs","docLine","success","parts","description","trim","tag","desc","indent","i","in","headerName","Map","model","models","set","resolveModelFields","collected","bases","baseModel","get","fields","source","nodes","visibility","node","defaultValue","values","value","random","randomScalarTemplate","item","items","t","members","modelToExampleObject","inner","fieldsToExampleObject","obj","field","replace","matchAll","m","basename","test","plugin","name","cacheKey","generateTargets","opRoots","contractRoots","ctx","auth","config","options","base","baseDir","resolve","rootDir","outDir","output","collectionName","basename","cleanupTrackedFiles","overrideDirAbs","overrideDir","undefined","files","generateOpenCollection","randomExamples","includeInternal","relativePath","content","emitFile","applyDirOverride","createBrunoPlugin","JSON","stringify","MANIFEST_FILENAME","overrideFile","existsSync","mergePluginFile","readFileSync","manifestPath","tracked","parseManifest","removedDirs","Set","rel","abs","rmSync","force","add","dirname","dir","current","startsWith","readdirSync","length","rmdirSync"]}
1
+ {"version":3,"sources":["../src/index.ts","../src/codegen-bruno.ts"],"sourcesContent":["import { resolve, basename, dirname } from 'node:path';\nimport { existsSync, readFileSync, rmSync, readdirSync, rmdirSync } from 'node:fs';\nimport { generateOpenCollection, MANIFEST_FILENAME, parseManifest } from './codegen-bruno.js';\nimport type { BrunoSecurityScheme } from './codegen-bruno.js';\nimport type { ContractKitPlugin } from '@contractkit/core';\n\n/** Configuration accepted by the Bruno plugin, both via `contractkit.config.json` and `createBrunoPlugin`. */\nexport interface BrunoPluginConfig {\n baseDir?: string;\n output?: string;\n collectionName?: string;\n /**\n * When true (default), example values use Bruno's faker templates\n * (`{{$randomUUID}}`, `{{$randomEmail}}`, etc.) so each send produces\n * fresh data. Set to false for deterministic placeholders.\n */\n randomExamples?: boolean;\n /**\n * Whether to generate request files for operations marked `internal`. Defaults to\n * `true` — Bruno collections are typically used by the team that owns the API and\n * benefit from full coverage. Set to `false` to omit internal ops.\n */\n includeInternal?: boolean;\n /**\n * Map of environment name → variables. Each entry produces a\n * `environments/<name>.yml` file. When omitted, a default `local.yml` is\n * emitted with `baseUrl=http://localhost:3000` and any auth env-var\n * placeholders. When provided, the default is replaced entirely; include\n * auth variables (e.g. `token`) explicitly if you need them.\n */\n environments?: Record<string, Record<string, unknown>>;\n}\n\n/** Full plugin options shape read from `ctx.options` — extends {@link BrunoPluginConfig} with the `auth` block. */\nexport interface BrunoPluginOptions extends BrunoPluginConfig {\n auth?: { defaultScheme: string; schemes?: Record<string, BrunoSecurityScheme> };\n}\n\n// ─── Default export: loaded via plugins array, reads config from ctx.options ─\n\nconst plugin: ContractKitPlugin = {\n name: 'bruno',\n cacheKey: 'bruno',\n async generateTargets({ opRoots, contractRoots }, ctx) {\n const { auth, ...config } = ctx.options as BrunoPluginOptions;\n const base = config.baseDir ? resolve(ctx.rootDir, config.baseDir) : ctx.rootDir;\n const outDir = resolve(base, config.output ?? 'bruno-collection');\n const collectionName = config.collectionName ?? basename(ctx.rootDir);\n\n cleanupTrackedFiles(outDir);\n\n const files = generateOpenCollection(opRoots, {\n collectionName,\n contractRoots,\n auth,\n randomExamples: config.randomExamples ?? true,\n includeInternal: config.includeInternal,\n environments: config.environments,\n });\n for (const { relativePath, content } of files) {\n ctx.emitFile(resolve(outDir, relativePath), content);\n }\n },\n};\n\nexport default plugin;\n\n// ─── Factory: for programmatic use with explicit config ────────────────────\n\n/**\n * Creates a Bruno plugin instance with explicit configuration, for programmatic use.\n *\n * Prefer the default export when loading via `contractkit.config.json`. Use this\n * factory when constructing the plugin in code (e.g. in tests or custom build scripts).\n *\n * @param config - Plugin configuration (output paths and feature flags).\n * @param rootDir - Absolute path used to resolve relative paths in `config`.\n * @param auth - Optional auth scheme configuration mirroring the `auth` key in plugin options.\n */\nexport function createBrunoPlugin(\n config: BrunoPluginConfig,\n rootDir: string,\n auth?: { defaultScheme: string; schemes?: Record<string, BrunoSecurityScheme> },\n): ContractKitPlugin {\n return {\n name: 'bruno',\n cacheKey: `bruno:${JSON.stringify(config)}`,\n async generateTargets({ opRoots, contractRoots }, ctx) {\n const base = config.baseDir ? resolve(rootDir, config.baseDir) : rootDir;\n const outDir = resolve(base, config.output ?? 'bruno-collection');\n const collectionName = config.collectionName ?? basename(rootDir);\n\n cleanupTrackedFiles(outDir);\n\n const files = generateOpenCollection(opRoots, {\n collectionName,\n contractRoots,\n auth,\n randomExamples: config.randomExamples ?? true,\n includeInternal: config.includeInternal,\n environments: config.environments,\n });\n for (const { relativePath, content } of files) {\n ctx.emitFile(resolve(outDir, relativePath), content);\n }\n },\n };\n}\n\n/**\n * Delete files this plugin generated on the previous run, leaving anything\n * the user added (custom .bru files, scripts, secrets, etc.) untouched.\n *\n * On first run — or after manual deletion of the manifest — nothing is\n * removed; stale files from prior versions linger until manually cleaned.\n */\nfunction cleanupTrackedFiles(outDir: string): void {\n const manifestPath = resolve(outDir, MANIFEST_FILENAME);\n if (!existsSync(manifestPath)) return;\n\n let tracked: string[];\n try {\n tracked = parseManifest(readFileSync(manifestPath, 'utf-8'));\n } catch {\n return;\n }\n\n const removedDirs = new Set<string>();\n for (const rel of tracked) {\n const abs = resolve(outDir, rel);\n if (existsSync(abs)) {\n rmSync(abs, { force: true });\n removedDirs.add(dirname(abs));\n }\n }\n\n // Walk up from each affected directory and remove it if empty, stopping at outDir.\n for (const dir of removedDirs) {\n let current = dir;\n while (current.startsWith(outDir) && current !== outDir) {\n try {\n if (readdirSync(current).length === 0) {\n rmdirSync(current);\n current = dirname(current);\n } else {\n break;\n }\n } catch {\n break;\n }\n }\n }\n}\n","import type {\n OpRootNode,\n OpRouteNode,\n OpOperationNode,\n OpResponseNode,\n ParamSource,\n ContractTypeNode,\n ContractRootNode,\n ModelNode,\n FieldNode,\n} from '@contractkit/core';\nimport { resolveSecurity, resolveModifiers, SECURITY_NONE } from '@contractkit/core';\nimport { basename } from 'path';\nimport { parse as parseYaml, stringify as stringifyYaml } from 'yaml';\n\n/** A single file produced by the Bruno codegen — a relative output path and its YAML content. */\nexport interface OpenCollectionFile {\n relativePath: string;\n content: string;\n}\n\n/** Manifest filename — tracks which files this plugin previously generated so subsequent runs can clean up only those, leaving any user-added files alone. */\nexport const MANIFEST_FILENAME = '.contractkit-bruno-manifest.json';\n\n/** Subset of a security scheme sufficient for Bruno auth generation (non-HMAC). */\nexport interface BrunoSecurityScheme {\n type: string; // \"http\" | \"apiKey\" | \"oauth2\" | \"openIdConnect\"\n scheme?: string; // \"bearer\" | \"basic\" (when type === \"http\")\n name?: string; // header/query param name (when type === \"apiKey\")\n in?: string; // \"header\" | \"query\" (when type === \"apiKey\")\n}\n\n/** Auth configuration passed to the Bruno codegen; drives collection-level auth and per-operation auth blocks. */\nexport interface BrunoAuthOptions {\n /** Name of the default scheme (from config.security.default) */\n defaultScheme?: string;\n /** Scheme definitions keyed by name (non-HMAC only) */\n schemes?: Record<string, BrunoSecurityScheme>;\n}\n\n/** Options controlling what {@link generateOpenCollection} emits. */\nexport interface OpenCollectionOptions {\n collectionName: string;\n contractRoots?: ContractRootNode[];\n auth?: BrunoAuthOptions;\n /**\n * When true, emit Bruno faker template strings (e.g. `{{$randomUUID}}`,\n * `{{$randomEmail}}`) for compatible scalar types so each send produces\n * fresh data. When false (default), use deterministic placeholders.\n */\n randomExamples?: boolean;\n /**\n * Whether to generate request files for operations marked `internal`. Defaults to\n * `true` — Bruno collections are typically used by the team that owns the API and\n * benefit from full coverage. Set to `false` to omit internal ops.\n */\n includeInternal?: boolean;\n /**\n * Map of environment name → variables. Each entry produces a\n * `environments/<name>.yml` file with the variables in declaration order.\n * Values are coerced to strings.\n *\n * When omitted, a default `environments/local.yml` is emitted with\n * `baseUrl=http://localhost:3000` plus any auth env-var placeholders the\n * default scheme requires. When provided, the default is replaced entirely\n * — auth vars are not auto-injected, so include them explicitly if needed.\n */\n environments?: Record<string, Record<string, unknown>>;\n}\n\n/**\n * Generates an OpenCollection (https://spec.opencollection.com/) API collection\n * from a set of operation roots. Produces opencollection.yml, an environment\n * file, and one .yml request file per operation.\n */\nexport function generateOpenCollection(roots: OpRootNode[], options: OpenCollectionOptions): OpenCollectionFile[] {\n const files: OpenCollectionFile[] = [];\n\n const modelMap = buildModelMap(options.contractRoots ?? []);\n const authOpts = options.auth;\n const defaultScheme = authOpts?.defaultScheme ? authOpts.schemes?.[authOpts.defaultScheme] : undefined;\n const randomExamples = options.randomExamples ?? false;\n const includeInternal = options.includeInternal ?? true;\n\n files.push({ relativePath: 'opencollection.yml', content: generateCollectionRoot(options.collectionName, defaultScheme) });\n for (const envFile of generateEnvFiles(options.environments, defaultScheme)) {\n files.push(envFile);\n }\n // Manifest is appended at the end so it lists every generated path including itself.\n\n for (let rootIdx = 0; rootIdx < roots.length; rootIdx++) {\n const root = roots[rootIdx]!;\n const folder = root.meta['area'] ? slugifyName(root.meta['area']) : deriveFolderName(root.file);\n const displayName = (root.meta['area'] ?? folder).charAt(0).toUpperCase() + (root.meta['area'] ?? folder).slice(1);\n\n files.push({ relativePath: `${folder}/folder.yml`, content: generateFolderFile(displayName, rootIdx + 1) });\n\n const subarea = root.meta['subarea'];\n const subareaSlug = subarea ? slugifyName(subarea) : undefined;\n const requestDir = subareaSlug ? `${folder}/${subareaSlug}` : folder;\n\n if (subareaSlug) {\n const subareaDisplayName = subarea!.charAt(0).toUpperCase() + subarea!.slice(1);\n files.push({ relativePath: `${requestDir}/folder.yml`, content: generateFolderFile(subareaDisplayName, 1) });\n }\n\n let seq = 1;\n for (const route of root.routes) {\n for (const op of route.operations) {\n if (!includeInternal && resolveModifiers(route, op).includes('internal')) continue;\n const requestName = op.name ?? route.path;\n const fileName = op.name ? `${slugifyName(op.name)}.yml` : `${op.method}-${sanitizePath(route.path)}.yml`;\n let content = generateRequestFile(route, op, requestName, seq, modelMap, root, defaultScheme, randomExamples);\n const pluginOverride = op.pluginFiles?.['bruno'];\n if (pluginOverride !== undefined) {\n content = mergePluginFile(content, pluginOverride);\n }\n files.push({ relativePath: `${requestDir}/${fileName}`, content });\n seq++;\n }\n }\n }\n\n const trackedPaths = [...files.map(f => f.relativePath), MANIFEST_FILENAME].sort();\n files.push({\n relativePath: MANIFEST_FILENAME,\n content: JSON.stringify({ files: trackedPaths }, null, 2) + '\\n',\n });\n\n return files;\n}\n\n/** 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. */\nexport function parseManifest(content: string): string[] {\n try {\n const parsed = JSON.parse(content);\n if (Array.isArray(parsed?.files) && parsed.files.every((f: unknown) => typeof f === 'string')) {\n return parsed.files as string[];\n }\n } catch {\n // fall through\n }\n return [];\n}\n\n// ─── Plugin file merge ─────────────────────────────────────────────────────\n\nfunction deepMerge(base: unknown, override: unknown): unknown {\n if (\n override !== null &&\n typeof override === 'object' &&\n !Array.isArray(override) &&\n base !== null &&\n typeof base === 'object' &&\n !Array.isArray(base)\n ) {\n const result: Record<string, unknown> = { ...(base as Record<string, unknown>) };\n for (const [key, val] of Object.entries(override as Record<string, unknown>)) {\n result[key] = deepMerge(result[key], val);\n }\n return result;\n }\n return override;\n}\n\n/**\n * Deep-merges a YAML override string into a generated YAML string.\n *\n * Objects are merged recursively; arrays and scalars in the override replace the\n * generated value entirely. If `pluginFileContent` is not a YAML mapping (e.g. it\n * is a scalar or a list), the generated content is returned unchanged.\n *\n * @param generatedYaml - The YAML string produced by the Bruno codegen.\n * @param pluginFileContent - The YAML override string to merge in.\n * @returns The merged YAML string, or `generatedYaml` if the override is not a mapping.\n */\nexport function mergePluginFile(generatedYaml: string, pluginFileContent: string): string {\n const overrideParsed = parseYaml(pluginFileContent);\n if (overrideParsed === null || typeof overrideParsed !== 'object' || Array.isArray(overrideParsed)) {\n return generatedYaml;\n }\n const merged = deepMerge(parseYaml(generatedYaml), overrideParsed);\n return stringifyYaml(merged, { lineWidth: 0 });\n}\n\n// ─── File generators ───────────────────────────────────────────────────────\n\nfunction generateCollectionRoot(name: string, scheme?: BrunoSecurityScheme): string {\n const lines = [`opencollection: \"1.0.0\"`, `info:`, ` name: ${yamlString(name)}`];\n if (scheme) {\n lines.push(``);\n lines.push(`request:`);\n lines.push(...renderAuthBlock(scheme, ' '));\n }\n lines.push(``);\n return lines.join('\\n');\n}\n\nfunction generateEnvFiles(\n environments: Record<string, Record<string, unknown>> | undefined,\n scheme: BrunoSecurityScheme | undefined,\n): OpenCollectionFile[] {\n if (environments && Object.keys(environments).length > 0) {\n return Object.entries(environments).map(([name, variables]) => ({\n relativePath: `environments/${name}.yml`,\n content: renderEnvFile(displayNameFor(name), variables),\n }));\n }\n const defaultVars: Record<string, string> = { baseUrl: 'http://localhost:3000' };\n if (scheme) {\n for (const varName of authEnvVarNames(scheme)) defaultVars[varName] = '';\n }\n return [{ relativePath: 'environments/local.yml', content: renderEnvFile('Local', defaultVars) }];\n}\n\nfunction renderEnvFile(name: string, variables: Record<string, unknown>): string {\n const lines = [`name: ${name}`, `variables:`];\n for (const [key, value] of Object.entries(variables)) {\n const escaped = String(value).replace(/\\\\/g, '\\\\\\\\').replace(/\"/g, '\\\\\"');\n lines.push(` - name: ${key}`);\n lines.push(` value: \"${escaped}\"`);\n }\n lines.push(``);\n return lines.join('\\n');\n}\n\nfunction displayNameFor(envKey: string): string {\n return envKey.charAt(0).toUpperCase() + envKey.slice(1);\n}\n\nfunction generateFolderFile(name: string, seq: number): string {\n return [`info:`, ` name: ${yamlString(name)}`, ` type: folder`, ` seq: ${seq}`, ``].join('\\n');\n}\n\nfunction generateRequestFile(\n route: OpRouteNode,\n op: OpOperationNode,\n name: string,\n seq: number,\n modelMap: Map<string, ModelNode>,\n root?: OpRootNode,\n defaultScheme?: BrunoSecurityScheme,\n randomExamples = false,\n): string {\n const lines: string[] = [];\n\n lines.push(`info:`);\n lines.push(` name: ${yamlString(name)}`);\n lines.push(` type: http`);\n lines.push(` seq: ${seq}`);\n lines.push(``);\n lines.push(`http:`);\n lines.push(` method: ${op.method.toUpperCase()}`);\n lines.push(` url: ${yamlString(`{{baseUrl}}${openCollectionPath(route.path)}`)}`);\n\n // Params — flat array with type: \"path\" | \"query\". Optional query params are\n // emitted with disabled: true so users opt in before sending.\n const pathParams: Array<ParamEntry & { kind: 'path' | 'query' }> = extractPathParamNames(route.path).map(n => ({\n name: n,\n type: findParamType(route.params, n, modelMap),\n optional: false,\n kind: 'path' as const,\n }));\n const queryParams: Array<ParamEntry & { kind: 'path' | 'query' }> = op.query\n ? expandParamSource(op.query, modelMap).map(e => ({ ...e, kind: 'query' as const }))\n : [];\n const allParams = [...pathParams, ...queryParams];\n\n if (allParams.length > 0) {\n lines.push(` params:`);\n for (const p of allParams) {\n lines.push(` - name: ${p.name}`);\n lines.push(` value: ${paramExampleValue(p.type, p.default, randomExamples)}`);\n lines.push(` type: ${p.kind}`);\n if (p.optional && p.kind === 'query') lines.push(` disabled: true`);\n }\n }\n\n // Headers\n if (op.headers) {\n const headerEntries = expandParamSource(op.headers, modelMap);\n if (headerEntries.length > 0) {\n lines.push(` headers:`);\n for (const h of headerEntries) {\n lines.push(` - name: ${h.name}`);\n lines.push(` value: ${paramExampleValue(h.type, h.default, randomExamples)}`);\n if (h.optional) lines.push(` disabled: true`);\n }\n }\n }\n\n // Auth — inside http block; inherit collection default unless this op is explicitly public\n if (defaultScheme) {\n const security = root ? resolveSecurity(route, op, root) : (op.security ?? route.security);\n if (security === SECURITY_NONE) {\n lines.push(` auth:`);\n lines.push(` type: none`);\n } else {\n lines.push(` auth: inherit`);\n }\n }\n\n // Body — Bruno supports a single body per request, so prefer JSON, then form-urlencoded, then multipart.\n if (op.request && op.request.bodies.length > 0) {\n const preferredOrder: Array<(typeof op.request.bodies)[number]['contentType']> = [\n 'application/json',\n 'application/x-www-form-urlencoded',\n 'multipart/form-data',\n ];\n const primary =\n preferredOrder.map(ct => op.request!.bodies.find(b => b.contentType === ct)).find(b => b !== undefined) ?? op.request.bodies[0]!;\n\n lines.push(` body:`);\n if (primary.contentType === 'multipart/form-data') {\n lines.push(` type: multipart-form`);\n lines.push(` data: []`);\n } else if (primary.contentType === 'application/x-www-form-urlencoded') {\n lines.push(` type: form-urlencoded`);\n lines.push(` data: []`);\n } else {\n const json = JSON.stringify(typeToExampleValue(primary.bodyType, modelMap, randomExamples), null, 2);\n lines.push(` type: json`);\n lines.push(` data: |`);\n for (const jsonLine of json.split('\\n')) {\n lines.push(` ${jsonLine}`);\n }\n }\n }\n\n // runtime.assertions — auto-generate a status-code check and presence checks for required response headers.\n const expectedStatus = pickAssertionStatus(op.responses);\n const assertedResponse = op.responses.find(r => r.statusCode === expectedStatus);\n const requiredHeaders = (assertedResponse?.headers ?? []).filter(h => !h.optional);\n if (expectedStatus !== undefined) {\n lines.push(``);\n lines.push(`runtime:`);\n lines.push(` assertions:`);\n lines.push(` - expression: res.status`);\n lines.push(` operator: eq`);\n // Always quote — the OpenCollection schema types `value` as a string,\n // so we must keep \"200\" from being parsed as YAML number 200.\n lines.push(` value: \"${expectedStatus}\"`);\n for (const h of requiredHeaders) {\n lines.push(` - expression: res.headers[\"${h.name.toLowerCase()}\"]`);\n lines.push(` operator: isDefined`);\n lines.push(` value: \"\"`);\n }\n }\n\n // docs — combine route- and operation-level descriptions plus the declared response-header summary.\n const docs = buildRequestDocs(route, op, assertedResponse);\n if (docs) {\n lines.push(``);\n lines.push(`docs: |-`);\n for (const docLine of docs.split('\\n')) {\n lines.push(` ${docLine}`);\n }\n }\n\n lines.push(``);\n return lines.join('\\n');\n}\n\n/** Pick the response whose status code we'll assert against. Prefers the first declared 2xx; otherwise falls back to the first declared response. Returns undefined if no responses are declared. */\nfunction pickAssertionStatus(responses: OpResponseNode[]): number | undefined {\n const success = responses.find(r => r.statusCode >= 200 && r.statusCode < 300);\n return success?.statusCode ?? responses[0]?.statusCode;\n}\n\n/** Build a markdown docs block from route- and operation-level descriptions, plus declared response-header summary. */\nfunction buildRequestDocs(route: OpRouteNode, op: OpOperationNode, assertedResponse?: OpResponseNode): string | undefined {\n const parts: string[] = [];\n if (route.description) parts.push(route.description.trim());\n if (op.description) parts.push(op.description.trim());\n const headers = assertedResponse?.headers ?? [];\n if (headers.length > 0) {\n const lines = ['**Response headers**', ''];\n for (const h of headers) {\n const tag = h.optional ? 'optional' : 'required';\n const desc = h.description ? ` — ${h.description}` : '';\n lines.push(`- \\`${h.name}\\` (${tag})${desc}`);\n }\n parts.push(lines.join('\\n'));\n }\n return parts.length > 0 ? parts.join('\\n\\n') : undefined;\n}\n\n// ─── Auth helpers ──────────────────────────────────────────────────────────\n\n/** Generate the YAML lines for an auth block (flat, per spec), indented by `indent`. */\nfunction renderAuthBlock(scheme: BrunoSecurityScheme, indent: string): string[] {\n const i = indent;\n if (scheme.type === 'http' && scheme.scheme === 'bearer') {\n return [`${i}auth:`, `${i} type: bearer`, `${i} token: \"{{token}}\"`];\n }\n if (scheme.type === 'http' && scheme.scheme === 'basic') {\n return [`${i}auth:`, `${i} type: basic`, `${i} username: \"{{username}}\"`, `${i} password: \"{{password}}\"`];\n }\n if (scheme.type === 'apiKey' && scheme.in === 'header') {\n const headerName = scheme.name ?? 'X-Api-Key';\n return [`${i}auth:`, `${i} type: apikey`, `${i} key: ${headerName}`, `${i} value: \"{{apiKey}}\"`, `${i} placement: header`];\n }\n return [];\n}\n\n/** Return the environment variable names needed for a given auth scheme. */\nfunction authEnvVarNames(scheme: BrunoSecurityScheme): string[] {\n if (scheme.type === 'http' && scheme.scheme === 'bearer') return ['token'];\n if (scheme.type === 'http' && scheme.scheme === 'basic') return ['username', 'password'];\n if (scheme.type === 'apiKey') return ['apiKey'];\n return [];\n}\n\n// ─── Model registry ────────────────────────────────────────────────────────\n\nfunction buildModelMap(contractRoots: ContractRootNode[]): Map<string, ModelNode> {\n const map = new Map<string, ModelNode>();\n for (const root of contractRoots) {\n for (const model of root.models) {\n map.set(model.name, model);\n }\n }\n return map;\n}\n\n/** Resolve all fields for a model, including inherited base fields (bases first, in declaration order). */\nfunction resolveModelFields(model: ModelNode, modelMap: Map<string, ModelNode>): FieldNode[] {\n const collected: FieldNode[] = [];\n if (model.bases) {\n for (const base of model.bases) {\n const baseModel = modelMap.get(base);\n if (baseModel) collected.push(...resolveModelFields(baseModel, modelMap));\n }\n }\n return [...collected, ...model.fields];\n}\n\n// ─── Param helpers ─────────────────────────────────────────────────────────\n\ninterface ParamEntry {\n name: string;\n type: ContractTypeNode | undefined;\n default?: string | number | boolean;\n optional: boolean;\n}\n\n/** Expand a ParamSource into a flat list of named entries with their types. */\nfunction expandParamSource(source: ParamSource, modelMap: Map<string, ModelNode>): ParamEntry[] {\n if (source.kind === 'params') {\n return source.nodes.map(n => ({ name: n.name, type: n.type, default: n.default, optional: n.optional }));\n }\n if (source.kind === 'ref') {\n const model = modelMap.get(source.name);\n if (model) {\n return resolveModelFields(model, modelMap)\n .filter(f => f.visibility !== 'readonly')\n .map(f => ({ name: f.name, type: f.type, default: f.default, optional: f.optional }));\n }\n // Fallback: single placeholder entry\n const name = source.name.charAt(0).toLowerCase() + source.name.slice(1);\n return [{ name, type: undefined, optional: false }];\n }\n // kind === 'type': if it's an inline object, expand its fields\n if (source.node.kind === 'inlineObject') {\n return source.node.fields.map(f => ({ name: f.name, type: f.type, default: f.default, optional: f.optional }));\n }\n return [];\n}\n\n/** Look up a named path param's type from route.params. */\nfunction findParamType(source: ParamSource | undefined, name: string, modelMap: Map<string, ModelNode>): ContractTypeNode | undefined {\n if (!source) return undefined;\n if (source.kind === 'params') return source.nodes.find(n => n.name === name)?.type;\n if (source.kind === 'ref') {\n const model = modelMap.get(source.name);\n if (model) return resolveModelFields(model, modelMap).find(f => f.name === name)?.type;\n }\n if (source.kind === 'type' && source.node.kind === 'inlineObject') {\n return source.node.fields.find(f => f.name === name)?.type;\n }\n return undefined;\n}\n\n/** Return a YAML-quoted example value string for a param, preferring a default value when provided. */\nfunction paramExampleValue(type: ContractTypeNode | undefined, defaultValue?: string | number | boolean, randomExamples = false): string {\n if (defaultValue !== undefined) return `\"${defaultValue}\"`;\n if (!type) return '\"\"';\n if (type.kind === 'enum') return type.values.length > 0 ? `\"${type.values[0]}\"` : '\"\"';\n if (type.kind === 'literal') return `\"${type.value}\"`;\n if (type.kind !== 'scalar') return '\"\"';\n if (randomExamples) {\n const random = randomScalarTemplate(type.name);\n if (random !== undefined) return `\"${random}\"`;\n }\n switch (type.name) {\n case 'uuid':\n return '\"00000000-0000-0000-0000-000000000000\"';\n case 'email':\n return '\"user@example.com\"';\n case 'url':\n return '\"https://example.com\"';\n case 'number':\n case 'int':\n case 'bigint':\n return '\"0\"';\n case 'boolean':\n return '\"true\"';\n case 'date':\n return '\"2024-01-01\"';\n case 'time':\n return '\"00:00:00\"';\n case 'datetime':\n return '\"2024-01-01T00:00:00Z\"';\n case 'duration':\n return '\"PT1H\"';\n default:\n return '\"\"';\n }\n}\n\n/** Bruno faker template for a scalar type, or undefined when no clean equivalent exists (date, time, duration, raw string). */\nfunction randomScalarTemplate(name: string): string | undefined {\n switch (name) {\n case 'uuid':\n return '{{$randomUUID}}';\n case 'email':\n return '{{$randomEmail}}';\n case 'url':\n return '{{$randomUrl}}';\n case 'number':\n case 'int':\n case 'bigint':\n return '{{$randomInt}}';\n case 'boolean':\n return '{{$randomBoolean}}';\n case 'datetime':\n return '{{$isoTimestamp}}';\n default:\n return undefined;\n }\n}\n\n// ─── Body helpers ──────────────────────────────────────────────────────────\n\n/**\n * Recursively build an example JSON value from a ContractTypeNode.\n *\n * When `randomExamples` is true we substitute Bruno faker templates only for\n * scalars whose JSON representation is a string (uuid/email/url/datetime).\n * Numbers and booleans stay deterministic — embedding `{{$randomInt}}` as a\n * bare JSON number would require sentinel-stripping the surrounding quotes,\n * and the body skeleton is meant as a starting point users edit anyway.\n */\nfunction typeToExampleValue(type: ContractTypeNode, modelMap: Map<string, ModelNode>, randomExamples = false): unknown {\n switch (type.kind) {\n case 'scalar':\n switch (type.name) {\n case 'string':\n return '';\n case 'email':\n return randomExamples ? '{{$randomEmail}}' : 'user@example.com';\n case 'url':\n return randomExamples ? '{{$randomUrl}}' : 'https://example.com';\n case 'uuid':\n return randomExamples ? '{{$randomUUID}}' : '00000000-0000-0000-0000-000000000000';\n case 'number':\n case 'int':\n case 'bigint':\n return 0;\n case 'boolean':\n return true;\n case 'date':\n return '2024-01-01';\n case 'time':\n return '00:00:00';\n case 'datetime':\n return randomExamples ? '{{$isoTimestamp}}' : '2024-01-01T00:00:00Z';\n case 'duration':\n return 'PT1H';\n case 'null':\n return null;\n default:\n return null;\n }\n case 'enum':\n return type.values[0] ?? '';\n case 'literal':\n return type.value;\n case 'array':\n return [typeToExampleValue(type.item, modelMap, randomExamples)];\n case 'tuple':\n return type.items.map(t => typeToExampleValue(t, modelMap, randomExamples));\n case 'record':\n return {};\n case 'union':\n return type.members.length > 0 ? typeToExampleValue(type.members[0]!, modelMap, randomExamples) : null;\n case 'discriminatedUnion':\n return type.members.length > 0 ? typeToExampleValue(type.members[0]!, modelMap, randomExamples) : null;\n case 'intersection':\n return {};\n case 'ref': {\n const model = modelMap.get(type.name);\n if (!model) return {};\n // Type alias — recurse into the aliased type\n if (model.type) return typeToExampleValue(model.type, modelMap, randomExamples);\n return modelToExampleObject(model, modelMap, randomExamples);\n }\n case 'lazy':\n return typeToExampleValue(type.inner, modelMap, randomExamples);\n case 'inlineObject':\n return fieldsToExampleObject(type.fields, modelMap, randomExamples);\n default:\n return null;\n }\n}\n\n/** Build an example object from a ModelNode's fields (including inherited base fields). */\nfunction modelToExampleObject(model: ModelNode, modelMap: Map<string, ModelNode>, randomExamples = false): Record<string, unknown> {\n return fieldsToExampleObject(resolveModelFields(model, modelMap), modelMap, randomExamples);\n}\n\n/** Build an example object from a list of FieldNodes. Excludes readonly fields; uses defaults when available; omits optional fields that have no default so they don't appear in the JSON output. */\nfunction fieldsToExampleObject(fields: FieldNode[], modelMap: Map<string, ModelNode>, randomExamples = false): Record<string, unknown> {\n const obj: Record<string, unknown> = {};\n for (const field of fields) {\n if (field.visibility === 'readonly') continue;\n if (field.default !== undefined) {\n obj[field.name] = field.default;\n } else if (!field.optional) {\n obj[field.name] = typeToExampleValue(field.type, modelMap, randomExamples);\n }\n }\n return obj;\n}\n\n// ─── Path helpers ──────────────────────────────────────────────────────────\n\n/** Convert /users/{id}/posts → /users/:id/posts (Bruno path parameter syntax) */\nfunction openCollectionPath(path: string): string {\n return path.replace(/\\{([a-zA-Z_][a-zA-Z0-9_]*)\\}/g, ':$1');\n}\n\n/** Convert \"Create an Offer\" → create-an-offer (for .yml file names) */\nexport function slugifyName(name: string): string {\n const result = name\n .toLowerCase()\n .replace(/[^a-z0-9]+/g, '-')\n .replace(/^-|-$/g, '');\n return result || 'request';\n}\n\n/** Convert /users/{id}/posts → users-id-posts (for .yml file names) */\nexport function sanitizePath(path: string): string {\n const result = path\n .replace(/^\\//, '')\n .replace(/\\{([a-zA-Z_][a-zA-Z0-9_]*)\\}/g, '$1')\n .replace(/\\//g, '-')\n .replace(/[^a-zA-Z0-9-]/g, '')\n .replace(/-+/g, '-')\n .replace(/^-|-$/g, '');\n return result || 'root';\n}\n\n/** Extract param names from a URL template, e.g. /users/{id} → ['id'] */\nfunction extractPathParamNames(path: string): string[] {\n return [...path.matchAll(/\\{([a-zA-Z_][a-zA-Z0-9_]*)\\}/g)].map(m => m[1]!);\n}\n\n/** Derive folder name from op file path, e.g. src/users.op → users */\nfunction deriveFolderName(file: string): string {\n return basename(file).replace(/\\.(op|ck)$/, '');\n}\n\n/**\n * Wrap a string in YAML double quotes if it contains characters that require quoting\n * (flow indicators, colons, braces, etc.).\n */\nfunction yamlString(value: string): string {\n if (/[:{}[\\],&*#?|<>=!%@`\"']/.test(value) || /^\\s|\\s$/.test(value)) {\n return `\"${value.replace(/\\\\/g, '\\\\\\\\').replace(/\"/g, '\\\\\"')}\"`;\n }\n return value;\n}\n"],"mappings":"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","names":["resolve","basename","dirname","existsSync","readFileSync","rmSync","readdirSync","rmdirSync","resolveSecurity","resolveModifiers","SECURITY_NONE","basename","parse","parseYaml","stringify","stringifyYaml","MANIFEST_FILENAME","generateOpenCollection","roots","options","files","modelMap","buildModelMap","contractRoots","authOpts","auth","defaultScheme","schemes","undefined","randomExamples","includeInternal","push","relativePath","content","generateCollectionRoot","collectionName","envFile","generateEnvFiles","environments","rootIdx","length","root","folder","meta","slugifyName","deriveFolderName","file","displayName","charAt","toUpperCase","slice","generateFolderFile","subarea","subareaSlug","requestDir","subareaDisplayName","seq","route","routes","op","operations","resolveModifiers","includes","requestName","name","path","fileName","method","sanitizePath","generateRequestFile","pluginOverride","pluginFiles","mergePluginFile","trackedPaths","map","f","sort","JSON","stringify","parseManifest","parsed","parse","Array","isArray","every","deepMerge","base","override","result","key","val","Object","entries","generatedYaml","pluginFileContent","overrideParsed","parseYaml","merged","stringifyYaml","lineWidth","scheme","lines","yamlString","renderAuthBlock","join","keys","variables","renderEnvFile","displayNameFor","defaultVars","baseUrl","varName","authEnvVarNames","value","escaped","String","replace","envKey","openCollectionPath","pathParams","extractPathParamNames","n","type","findParamType","params","optional","kind","queryParams","query","expandParamSource","e","allParams","p","paramExampleValue","default","headers","headerEntries","h","security","resolveSecurity","SECURITY_NONE","request","bodies","preferredOrder","primary","ct","find","b","contentType","json","typeToExampleValue","bodyType","jsonLine","split","expectedStatus","pickAssertionStatus","responses","assertedResponse","r","statusCode","requiredHeaders","filter","toLowerCase","docs","buildRequestDocs","docLine","success","parts","description","trim","tag","desc","indent","i","in","headerName","Map","model","models","set","resolveModelFields","collected","bases","baseModel","get","fields","source","nodes","visibility","node","defaultValue","values","random","randomScalarTemplate","item","items","t","members","modelToExampleObject","inner","fieldsToExampleObject","obj","field","matchAll","m","basename","test","plugin","name","cacheKey","generateTargets","opRoots","contractRoots","ctx","auth","config","options","base","baseDir","resolve","rootDir","outDir","output","collectionName","basename","cleanupTrackedFiles","files","generateOpenCollection","randomExamples","includeInternal","environments","relativePath","content","emitFile","createBrunoPlugin","JSON","stringify","manifestPath","MANIFEST_FILENAME","existsSync","tracked","parseManifest","readFileSync","removedDirs","Set","rel","abs","rmSync","force","add","dirname","dir","current","startsWith","readdirSync","length","rmdirSync"]}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@contractkit/plugin-bruno",
3
- "version": "0.10.0",
3
+ "version": "1.1.0",
4
4
  "description": "ContractKit built-in plugin: Bruno REST collection generation",
5
5
  "author": {
6
6
  "name": "Marooned Software",
@@ -27,7 +27,7 @@
27
27
  },
28
28
  "dependencies": {
29
29
  "yaml": "^2.8.3",
30
- "@contractkit/core": "0.12.0"
30
+ "@contractkit/core": "0.13.0"
31
31
  },
32
32
  "devDependencies": {
33
33
  "@repo/config-eslint": "0.3.1",
package/src/codegen-bruno.ts CHANGED
@@ -55,6 +55,17 @@ export interface OpenCollectionOptions {
55
55
  * benefit from full coverage. Set to `false` to omit internal ops.
56
56
  */
57
57
  includeInternal?: boolean;
58
+ /**
59
+ * Map of environment name → variables. Each entry produces a
60
+ * `environments/<name>.yml` file with the variables in declaration order.
61
+ * Values are coerced to strings.
62
+ *
63
+ * When omitted, a default `environments/local.yml` is emitted with
64
+ * `baseUrl=http://localhost:3000` plus any auth env-var placeholders the
65
+ * default scheme requires. When provided, the default is replaced entirely
66
+ * — auth vars are not auto-injected, so include them explicitly if needed.
67
+ */
68
+ environments?: Record<string, Record<string, unknown>>;
58
69
  }
59
70
 
60
71
  /**
@@ -72,7 +83,9 @@ export function generateOpenCollection(roots: OpRootNode[], options: OpenCollect
72
83
  const includeInternal = options.includeInternal ?? true;
73
84
 
74
85
  files.push({ relativePath: 'opencollection.yml', content: generateCollectionRoot(options.collectionName, defaultScheme) });
75
- files.push({ relativePath: 'environments/local.yml', content: generateEnvFile(defaultScheme) });
86
+ for (const envFile of generateEnvFiles(options.environments, defaultScheme)) {
87
+ files.push(envFile);
88
+ }
76
89
  // Manifest is appended at the end so it lists every generated path including itself.
77
90
 
78
91
  for (let rootIdx = 0; rootIdx < roots.length; rootIdx++) {
@@ -183,18 +196,38 @@ function generateCollectionRoot(name: string, scheme?: BrunoSecurityScheme): str
183
196
  return lines.join('\n');
184
197
  }
185
198
 
186
- function generateEnvFile(scheme?: BrunoSecurityScheme): string {
187
- const lines = [`name: Local`, `variables:`, ` - name: baseUrl`, ` value: "http://localhost:3000"`];
199
+ function generateEnvFiles(
200
+ environments: Record<string, Record<string, unknown>> | undefined,
201
+ scheme: BrunoSecurityScheme | undefined,
202
+ ): OpenCollectionFile[] {
203
+ if (environments && Object.keys(environments).length > 0) {
204
+ return Object.entries(environments).map(([name, variables]) => ({
205
+ relativePath: `environments/${name}.yml`,
206
+ content: renderEnvFile(displayNameFor(name), variables),
207
+ }));
208
+ }
209
+ const defaultVars: Record<string, string> = { baseUrl: 'http://localhost:3000' };
188
210
  if (scheme) {
189
- for (const varName of authEnvVarNames(scheme)) {
190
- lines.push(` - name: ${varName}`);
191
- lines.push(` value: ""`);
192
- }
211
+ for (const varName of authEnvVarNames(scheme)) defaultVars[varName] = '';
212
+ }
213
+ return [{ relativePath: 'environments/local.yml', content: renderEnvFile('Local', defaultVars) }];
214
+ }
215
+
216
+ function renderEnvFile(name: string, variables: Record<string, unknown>): string {
217
+ const lines = [`name: ${name}`, `variables:`];
218
+ for (const [key, value] of Object.entries(variables)) {
219
+ const escaped = String(value).replace(/\\/g, '\\\\').replace(/"/g, '\\"');
220
+ lines.push(` - name: ${key}`);
221
+ lines.push(` value: "${escaped}"`);
193
222
  }
194
223
  lines.push(``);
195
224
  return lines.join('\n');
196
225
  }
197
226
 
227
+ function displayNameFor(envKey: string): string {
228
+ return envKey.charAt(0).toUpperCase() + envKey.slice(1);
229
+ }
230
+
198
231
  function generateFolderFile(name: string, seq: number): string {
199
232
  return [`info:`, ` name: ${yamlString(name)}`, ` type: folder`, ` seq: ${seq}`, ``].join('\n');
200
233
  }
package/src/index.ts CHANGED
@@ -1,6 +1,6 @@
1
1
  import { resolve, basename, dirname } from 'node:path';
2
2
  import { existsSync, readFileSync, rmSync, readdirSync, rmdirSync } from 'node:fs';
3
- import { generateOpenCollection, MANIFEST_FILENAME, parseManifest, mergePluginFile } from './codegen-bruno.js';
3
+ import { generateOpenCollection, MANIFEST_FILENAME, parseManifest } from './codegen-bruno.js';
4
4
  import type { BrunoSecurityScheme } from './codegen-bruno.js';
5
5
  import type { ContractKitPlugin } from '@contractkit/core';
6
6
 
@@ -22,13 +22,13 @@ export interface BrunoPluginConfig {
22
22
  */
23
23
  includeInternal?: boolean;
24
24
  /**
25
- * Directory containing YAML override files, resolved relative to `rootDir`.
26
- * The directory mirrors the generated output structure — a file at
27
- * `<overrideDir>/payments/get-payment.yml` is deep-merged into the generated
28
- * `payments/get-payment.yml`. Arrays in the override replace the generated
29
- * array entirely. Files with no matching override are emitted unchanged.
25
+ * Map of environment name → variables. Each entry produces a
26
+ * `environments/<name>.yml` file. When omitted, a default `local.yml` is
27
+ * emitted with `baseUrl=http://localhost:3000` and any auth env-var
28
+ * placeholders. When provided, the default is replaced entirely; include
29
+ * auth variables (e.g. `token`) explicitly if you need them.
30
30
  */
31
- overrideDir?: string;
31
+ environments?: Record<string, Record<string, unknown>>;
32
32
  }
33
33
 
34
34
  /** Full plugin options shape read from `ctx.options` — extends {@link BrunoPluginConfig} with the `auth` block. */
@@ -49,16 +49,16 @@ const plugin: ContractKitPlugin = {
49
49
 
50
50
  cleanupTrackedFiles(outDir);
51
51
 
52
- const overrideDirAbs = config.overrideDir ? resolve(ctx.rootDir, config.overrideDir) : undefined;
53
52
  const files = generateOpenCollection(opRoots, {
54
53
  collectionName,
55
54
  contractRoots,
56
55
  auth,
57
56
  randomExamples: config.randomExamples ?? true,
58
57
  includeInternal: config.includeInternal,
58
+ environments: config.environments,
59
59
  });
60
60
  for (const { relativePath, content } of files) {
61
- ctx.emitFile(resolve(outDir, relativePath), applyDirOverride(relativePath, content, overrideDirAbs));
61
+ ctx.emitFile(resolve(outDir, relativePath), content);
62
62
  }
63
63
  },
64
64
  };
@@ -73,7 +73,7 @@ export default plugin;
73
73
  * Prefer the default export when loading via `contractkit.config.json`. Use this
74
74
  * factory when constructing the plugin in code (e.g. in tests or custom build scripts).
75
75
  *
76
- * @param config - Plugin configuration (output paths, feature flags, overrides).
76
+ * @param config - Plugin configuration (output paths and feature flags).
77
77
  * @param rootDir - Absolute path used to resolve relative paths in `config`.
78
78
  * @param auth - Optional auth scheme configuration mirroring the `auth` key in plugin options.
79
79
  */
@@ -92,27 +92,21 @@ export function createBrunoPlugin(
92
92
 
93
93
  cleanupTrackedFiles(outDir);
94
94
 
95
- const overrideDirAbs = config.overrideDir ? resolve(rootDir, config.overrideDir) : undefined;
96
95
  const files = generateOpenCollection(opRoots, {
97
96
  collectionName,
98
97
  contractRoots,
99
98
  auth,
100
99
  randomExamples: config.randomExamples ?? true,
100
+ includeInternal: config.includeInternal,
101
+ environments: config.environments,
101
102
  });
102
103
  for (const { relativePath, content } of files) {
103
- ctx.emitFile(resolve(outDir, relativePath), applyDirOverride(relativePath, content, overrideDirAbs));
104
+ ctx.emitFile(resolve(outDir, relativePath), content);
104
105
  }
105
106
  },
106
107
  };
107
108
  }
108
109
 
109
- function applyDirOverride(relativePath: string, content: string, overrideDirAbs: string | undefined): string {
110
- if (!overrideDirAbs || relativePath === MANIFEST_FILENAME) return content;
111
- const overrideFile = resolve(overrideDirAbs, relativePath);
112
- if (!existsSync(overrideFile)) return content;
113
- return mergePluginFile(content, readFileSync(overrideFile, 'utf-8'));
114
- }
115
-
116
110
  /**
117
111
  * Delete files this plugin generated on the previous run, leaving anything
118
112
  * the user added (custom .bru files, scripts, secrets, etc.) untouched.
package/tests/codegen-bruno.test.ts CHANGED
@@ -1,9 +1,5 @@
1
1
  import { describe, it, expect } from 'vitest';
2
- import { mkdirSync, writeFileSync, rmSync } from 'node:fs';
3
- import { join } from 'node:path';
4
- import { tmpdir } from 'node:os';
5
2
  import { generateOpenCollection, sanitizePath, MANIFEST_FILENAME, parseManifest, mergePluginFile } from '../src/codegen-bruno.js';
6
- import { createBrunoPlugin } from '../src/index.js';
7
3
  import {
8
4
  opRoot,
9
5
  opRoute,
@@ -675,6 +671,61 @@ describe('generateOpenCollection', () => {
675
671
  expect(env!.content).toContain('- name: token');
676
672
  });
677
673
 
674
+ describe('environments config', () => {
675
+ const root = opRoot([opRoute('/users', [opOperation('get')])], 'users.op');
676
+
677
+ it('emits one file per entry, replacing the default local.yml', () => {
678
+ const files = generateOpenCollection([root], {
679
+ collectionName: 'API',
680
+ environments: {
681
+ local: { baseUrl: 'http://localhost:3000', token: '' },
682
+ staging: { baseUrl: 'https://staging.example.com', token: 'secret' },
683
+ },
684
+ });
685
+ const local = files.find(f => f.relativePath === 'environments/local.yml');
686
+ const staging = files.find(f => f.relativePath === 'environments/staging.yml');
687
+ expect(local).toBeDefined();
688
+ expect(staging).toBeDefined();
689
+ expect(local!.content).toContain('name: Local');
690
+ expect(local!.content).toContain('- name: baseUrl');
691
+ expect(local!.content).toContain('value: "http://localhost:3000"');
692
+ expect(local!.content).toContain('- name: token');
693
+ expect(staging!.content).toContain('name: Staging');
694
+ expect(staging!.content).toContain('value: "https://staging.example.com"');
695
+ expect(staging!.content).toContain('value: "secret"');
696
+ });
697
+
698
+ it('does not auto-inject auth env vars when environments is provided', () => {
699
+ const files = generateOpenCollection([root], {
700
+ collectionName: 'API',
701
+ auth: bearerAuth,
702
+ environments: {
703
+ local: { baseUrl: 'http://localhost:3000' },
704
+ },
705
+ });
706
+ const local = files.find(f => f.relativePath === 'environments/local.yml');
707
+ expect(local!.content).not.toContain('- name: token');
708
+ });
709
+
710
+ it('falls back to the default local.yml when environments is empty', () => {
711
+ const files = generateOpenCollection([root], { collectionName: 'API', environments: {} });
712
+ const local = files.find(f => f.relativePath === 'environments/local.yml');
713
+ expect(local).toBeDefined();
714
+ expect(local!.content).toContain('name: Local');
715
+ expect(local!.content).toContain('value: "http://localhost:3000"');
716
+ });
717
+
718
+ it('coerces non-string values to strings', () => {
719
+ const files = generateOpenCollection([root], {
720
+ collectionName: 'API',
721
+ environments: { local: { port: 3000, debug: true } as unknown as Record<string, unknown> },
722
+ });
723
+ const local = files.find(f => f.relativePath === 'environments/local.yml');
724
+ expect(local!.content).toContain('value: "3000"');
725
+ expect(local!.content).toContain('value: "true"');
726
+ });
727
+ });
728
+
678
729
  it('does not add request or auth to opencollection.yml when no security config', () => {
679
730
  const root = opRoot([opRoute('/users', [opOperation('get')])], 'users.op');
680
731
  const files = generateOpenCollection([root], { collectionName: 'API' });
@@ -1160,66 +1211,3 @@ describe('mergePluginFile', () => {
1160
1211
  });
1161
1212
  });
1162
1213
 
1163
- describe('overrideDir', () => {
1164
- it('merges a file from overrideDir into the matching generated file', async () => {
1165
- const dir = join(tmpdir(), `ck-bruno-test-${Date.now()}`);
1166
- const overrideDir = join(dir, 'overrides');
1167
- const outDir = join(dir, 'out');
1168
- mkdirSync(join(overrideDir, 'users'), { recursive: true });
1169
- mkdirSync(outDir, { recursive: true });
1170
-
1171
- writeFileSync(join(overrideDir, 'users', 'get-users.yml'), 'runtime:\n script:\n req: |\n console.log("injected");\n');
1172
-
1173
- const emitted: Record<string, string> = {};
1174
- const ctx = {
1175
- rootDir: dir,
1176
- options: {},
1177
- emitFile(path: string, content: string) {
1178
- emitted[path] = content;
1179
- },
1180
- };
1181
-
1182
- const plugin = createBrunoPlugin({ output: 'out', overrideDir: 'overrides' }, dir);
1183
- const root = opRoot([opRoute('/users', [opOperation('get')])]);
1184
- await plugin.generateTargets!({ opRoots: [root], contractRoots: [], modelsWithInput: new Set(), modelsWithOutput: new Set() }, ctx);
1185
-
1186
- const requestPath = Object.keys(emitted).find(p => p.endsWith('get-users.yml'));
1187
- expect(requestPath).toBeDefined();
1188
- expect(emitted[requestPath!]).toContain('injected');
1189
-
1190
- rmSync(dir, { recursive: true, force: true });
1191
- });
1192
-
1193
- it('leaves generated files unchanged when no matching override file exists', async () => {
1194
- const dir = join(tmpdir(), `ck-bruno-test-${Date.now()}`);
1195
- const overrideDir = join(dir, 'overrides');
1196
- const outDir = join(dir, 'out');
1197
- mkdirSync(overrideDir, { recursive: true });
1198
- mkdirSync(outDir, { recursive: true });
1199
-
1200
- const emitted: Record<string, string> = {};
1201
- const ctx = {
1202
- rootDir: dir,
1203
- options: {},
1204
- emitFile(path: string, content: string) {
1205
- emitted[path] = content;
1206
- },
1207
- };
1208
-
1209
- const pluginWithOverride = createBrunoPlugin({ output: 'out', overrideDir: 'overrides' }, dir);
1210
- const pluginWithout = createBrunoPlugin({ output: 'out' }, dir);
1211
- const root = opRoot([opRoute('/users', [opOperation('get')])]);
1212
- const inputs = { opRoots: [root], contractRoots: [], modelsWithInput: new Set<string>(), modelsWithOutput: new Set<string>() };
1213
-
1214
- const emittedWith: Record<string, string> = {};
1215
- await pluginWithOverride.generateTargets!(inputs, { rootDir: dir, options: {}, emitFile: (p, c) => { emittedWith[p] = c; } });
1216
-
1217
- const emittedWithout: Record<string, string> = {};
1218
- await pluginWithout.generateTargets!(inputs, { rootDir: dir, options: {}, emitFile: (p, c) => { emittedWithout[p] = c; } });
1219
-
1220
- const requestPath = Object.keys(emittedWithout).find(p => p.endsWith('get-users.yml'))!;
1221
- expect(emittedWith[requestPath]).toBe(emittedWithout[requestPath]);
1222
-
1223
- rmSync(dir, { recursive: true, force: true });
1224
- });
1225
- });