@contractkit/plugin-bruno 1.0.0 → 1.2.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 (21) hide show
  1. package/.turbo/turbo-build$colon$ci.log +7 -7
  2. package/.turbo/turbo-test$colon$ci.log +14 -14
  3. package/CHANGELOG.md +29 -0
  4. package/README.md +30 -0
  5. package/coverage/clover.xml +297 -280
  6. package/coverage/coverage-final.json +2 -2
  7. package/coverage/index.html +19 -19
  8. package/coverage/src/codegen-bruno.ts.html +273 -126
  9. package/coverage/src/index.html +19 -19
  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 +8 -0
  15. package/dist/index.d.ts.map +1 -1
  16. package/dist/index.js +71 -30
  17. package/dist/index.js.map +1 -1
  18. package/package.json +1 -1
  19. package/src/codegen-bruno.ts +68 -19
  20. package/src/index.ts +11 -0
  21. package/tests/codegen-bruno.test.ts +97 -0
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 } 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\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 });\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 });\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\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","files","generateOpenCollection","randomExamples","includeInternal","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"]}
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 // Roots are sorted by their top-level folder display name (then by subarea) so the\n // emitted `seq:` numbers — which drive Bruno's UI ordering — line up alphabetically.\n const sortedRoots = [...roots].sort((a, b) => {\n const aArea = a.meta['area'] ?? deriveFolderName(a.file);\n const bArea = b.meta['area'] ?? deriveFolderName(b.file);\n const cmp = aArea.localeCompare(bArea);\n if (cmp !== 0) return cmp;\n return (a.meta['subarea'] ?? '').localeCompare(b.meta['subarea'] ?? '');\n });\n\n for (let rootIdx = 0; rootIdx < sortedRoots.length; rootIdx++) {\n const root = sortedRoots[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 // Flatten and alphabetize within this folder before assigning `seq:`.\n const requests: Array<{ route: typeof root.routes[number]; op: typeof root.routes[number]['operations'][number]; requestName: string }> = [];\n for (const route of root.routes) {\n for (const op of route.operations) {\n if (!includeInternal && resolveModifiers(route, op).includes('internal')) continue;\n requests.push({ route, op, requestName: op.name ?? route.path });\n }\n }\n requests.sort((a, b) => a.requestName.localeCompare(b.requestName));\n\n let seq = 1;\n for (const { route, op, requestName } of requests) {\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 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","sortedRoots","sort","a","b","aArea","meta","deriveFolderName","file","bArea","cmp","localeCompare","rootIdx","length","root","folder","slugifyName","displayName","charAt","toUpperCase","slice","generateFolderFile","subarea","subareaSlug","requestDir","subareaDisplayName","requests","route","routes","op","operations","resolveModifiers","includes","requestName","name","path","seq","fileName","method","sanitizePath","generateRequestFile","pluginOverride","pluginFiles","mergePluginFile","trackedPaths","map","f","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","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": "1.0.0",
3
+ "version": "1.2.0",
4
4
  "description": "ContractKit built-in plugin: Bruno REST collection generation",
5
5
  "author": {
6
6
  "name": "Marooned Software",
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,11 +83,23 @@ 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
- for (let rootIdx = 0; rootIdx < roots.length; rootIdx++) {
79
- const root = roots[rootIdx]!;
91
+ // Roots are sorted by their top-level folder display name (then by subarea) so the
92
+ // emitted `seq:` numbers — which drive Bruno's UI ordering — line up alphabetically.
93
+ const sortedRoots = [...roots].sort((a, b) => {
94
+ const aArea = a.meta['area'] ?? deriveFolderName(a.file);
95
+ const bArea = b.meta['area'] ?? deriveFolderName(b.file);
96
+ const cmp = aArea.localeCompare(bArea);
97
+ if (cmp !== 0) return cmp;
98
+ return (a.meta['subarea'] ?? '').localeCompare(b.meta['subarea'] ?? '');
99
+ });
100
+
101
+ for (let rootIdx = 0; rootIdx < sortedRoots.length; rootIdx++) {
102
+ const root = sortedRoots[rootIdx]!;
80
103
  const folder = root.meta['area'] ? slugifyName(root.meta['area']) : deriveFolderName(root.file);
81
104
  const displayName = (root.meta['area'] ?? folder).charAt(0).toUpperCase() + (root.meta['area'] ?? folder).slice(1);
82
105
 
@@ -91,21 +114,27 @@ export function generateOpenCollection(roots: OpRootNode[], options: OpenCollect
91
114
  files.push({ relativePath: `${requestDir}/folder.yml`, content: generateFolderFile(subareaDisplayName, 1) });
92
115
  }
93
116
 
94
- let seq = 1;
117
+ // Flatten and alphabetize within this folder before assigning `seq:`.
118
+ const requests: Array<{ route: typeof root.routes[number]; op: typeof root.routes[number]['operations'][number]; requestName: string }> = [];
95
119
  for (const route of root.routes) {
96
120
  for (const op of route.operations) {
97
121
  if (!includeInternal && resolveModifiers(route, op).includes('internal')) continue;
98
- const requestName = op.name ?? route.path;
99
- const fileName = op.name ? `${slugifyName(op.name)}.yml` : `${op.method}-${sanitizePath(route.path)}.yml`;
100
- let content = generateRequestFile(route, op, requestName, seq, modelMap, root, defaultScheme, randomExamples);
101
- const pluginOverride = op.pluginFiles?.['bruno'];
102
- if (pluginOverride !== undefined) {
103
- content = mergePluginFile(content, pluginOverride);
104
- }
105
- files.push({ relativePath: `${requestDir}/${fileName}`, content });
106
- seq++;
122
+ requests.push({ route, op, requestName: op.name ?? route.path });
107
123
  }
108
124
  }
125
+ requests.sort((a, b) => a.requestName.localeCompare(b.requestName));
126
+
127
+ let seq = 1;
128
+ for (const { route, op, requestName } of requests) {
129
+ const fileName = op.name ? `${slugifyName(op.name)}.yml` : `${op.method}-${sanitizePath(route.path)}.yml`;
130
+ let content = generateRequestFile(route, op, requestName, seq, modelMap, root, defaultScheme, randomExamples);
131
+ const pluginOverride = op.pluginFiles?.['bruno'];
132
+ if (pluginOverride !== undefined) {
133
+ content = mergePluginFile(content, pluginOverride);
134
+ }
135
+ files.push({ relativePath: `${requestDir}/${fileName}`, content });
136
+ seq++;
137
+ }
109
138
  }
110
139
 
111
140
  const trackedPaths = [...files.map(f => f.relativePath), MANIFEST_FILENAME].sort();
@@ -183,18 +212,38 @@ function generateCollectionRoot(name: string, scheme?: BrunoSecurityScheme): str
183
212
  return lines.join('\n');
184
213
  }
185
214
 
186
- function generateEnvFile(scheme?: BrunoSecurityScheme): string {
187
- const lines = [`name: Local`, `variables:`, ` - name: baseUrl`, ` value: "http://localhost:3000"`];
215
+ function generateEnvFiles(
216
+ environments: Record<string, Record<string, unknown>> | undefined,
217
+ scheme: BrunoSecurityScheme | undefined,
218
+ ): OpenCollectionFile[] {
219
+ if (environments && Object.keys(environments).length > 0) {
220
+ return Object.entries(environments).map(([name, variables]) => ({
221
+ relativePath: `environments/${name}.yml`,
222
+ content: renderEnvFile(displayNameFor(name), variables),
223
+ }));
224
+ }
225
+ const defaultVars: Record<string, string> = { baseUrl: 'http://localhost:3000' };
188
226
  if (scheme) {
189
- for (const varName of authEnvVarNames(scheme)) {
190
- lines.push(` - name: ${varName}`);
191
- lines.push(` value: ""`);
192
- }
227
+ for (const varName of authEnvVarNames(scheme)) defaultVars[varName] = '';
228
+ }
229
+ return [{ relativePath: 'environments/local.yml', content: renderEnvFile('Local', defaultVars) }];
230
+ }
231
+
232
+ function renderEnvFile(name: string, variables: Record<string, unknown>): string {
233
+ const lines = [`name: ${name}`, `variables:`];
234
+ for (const [key, value] of Object.entries(variables)) {
235
+ const escaped = String(value).replace(/\\/g, '\\\\').replace(/"/g, '\\"');
236
+ lines.push(` - name: ${key}`);
237
+ lines.push(` value: "${escaped}"`);
193
238
  }
194
239
  lines.push(``);
195
240
  return lines.join('\n');
196
241
  }
197
242
 
243
+ function displayNameFor(envKey: string): string {
244
+ return envKey.charAt(0).toUpperCase() + envKey.slice(1);
245
+ }
246
+
198
247
  function generateFolderFile(name: string, seq: number): string {
199
248
  return [`info:`, ` name: ${yamlString(name)}`, ` type: folder`, ` seq: ${seq}`, ``].join('\n');
200
249
  }
package/src/index.ts CHANGED
@@ -21,6 +21,14 @@ export interface BrunoPluginConfig {
21
21
  * benefit from full coverage. Set to `false` to omit internal ops.
22
22
  */
23
23
  includeInternal?: boolean;
24
+ /**
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
+ */
31
+ environments?: Record<string, Record<string, unknown>>;
24
32
  }
25
33
 
26
34
  /** Full plugin options shape read from `ctx.options` — extends {@link BrunoPluginConfig} with the `auth` block. */
@@ -47,6 +55,7 @@ const plugin: ContractKitPlugin = {
47
55
  auth,
48
56
  randomExamples: config.randomExamples ?? true,
49
57
  includeInternal: config.includeInternal,
58
+ environments: config.environments,
50
59
  });
51
60
  for (const { relativePath, content } of files) {
52
61
  ctx.emitFile(resolve(outDir, relativePath), content);
@@ -88,6 +97,8 @@ export function createBrunoPlugin(
88
97
  contractRoots,
89
98
  auth,
90
99
  randomExamples: config.randomExamples ?? true,
100
+ includeInternal: config.includeInternal,
101
+ environments: config.environments,
91
102
  });
92
103
  for (const { relativePath, content } of files) {
93
104
  ctx.emitFile(resolve(outDir, relativePath), content);
package/tests/codegen-bruno.test.ts CHANGED
@@ -671,6 +671,103 @@ describe('generateOpenCollection', () => {
671
671
  expect(env!.content).toContain('- name: token');
672
672
  });
673
673
 
674
+ describe('alphabetical ordering', () => {
675
+ function seqOf(content: string): number | undefined {
676
+ const match = content.match(/seq:\s*(\d+)/);
677
+ return match ? parseInt(match[1]!, 10) : undefined;
678
+ }
679
+
680
+ it('orders top-level folders alphabetically by area', () => {
681
+ const usersRoot = opRoot([opRoute('/users', [opOperation('get')])], 'users.op', { area: 'users' });
682
+ const authRoot = opRoot([opRoute('/auth', [opOperation('post')])], 'auth.op', { area: 'auth' });
683
+ const paymentsRoot = opRoot([opRoute('/payments', [opOperation('get')])], 'payments.op', { area: 'payments' });
684
+ // Pass in a non-alphabetical input order to prove the sort is doing the work.
685
+ const files = generateOpenCollection([usersRoot, authRoot, paymentsRoot], { collectionName: 'API' });
686
+
687
+ const auth = files.find(f => f.relativePath === 'auth/folder.yml');
688
+ const payments = files.find(f => f.relativePath === 'payments/folder.yml');
689
+ const users = files.find(f => f.relativePath === 'users/folder.yml');
690
+ expect(seqOf(auth!.content)).toBe(1);
691
+ expect(seqOf(payments!.content)).toBe(2);
692
+ expect(seqOf(users!.content)).toBe(3);
693
+ });
694
+
695
+ it('orders requests within a folder alphabetically by request name', () => {
696
+ const root = opRoot(
697
+ [
698
+ opRoute('/zebras', [opOperation('get', { name: 'Zebra list' })]),
699
+ opRoute('/aardvarks', [opOperation('get', { name: 'Aardvark list' })]),
700
+ opRoute('/mammals', [opOperation('get', { name: 'Mammal list' })]),
701
+ ],
702
+ 'zoo.op',
703
+ { area: 'zoo' },
704
+ );
705
+ const files = generateOpenCollection([root], { collectionName: 'API' });
706
+
707
+ const aardvark = files.find(f => f.relativePath === 'zoo/aardvark-list.yml');
708
+ const mammal = files.find(f => f.relativePath === 'zoo/mammal-list.yml');
709
+ const zebra = files.find(f => f.relativePath === 'zoo/zebra-list.yml');
710
+ expect(seqOf(aardvark!.content)).toBe(1);
711
+ expect(seqOf(mammal!.content)).toBe(2);
712
+ expect(seqOf(zebra!.content)).toBe(3);
713
+ });
714
+ });
715
+
716
+ describe('environments config', () => {
717
+ const root = opRoot([opRoute('/users', [opOperation('get')])], 'users.op');
718
+
719
+ it('emits one file per entry, replacing the default local.yml', () => {
720
+ const files = generateOpenCollection([root], {
721
+ collectionName: 'API',
722
+ environments: {
723
+ local: { baseUrl: 'http://localhost:3000', token: '' },
724
+ staging: { baseUrl: 'https://staging.example.com', token: 'secret' },
725
+ },
726
+ });
727
+ const local = files.find(f => f.relativePath === 'environments/local.yml');
728
+ const staging = files.find(f => f.relativePath === 'environments/staging.yml');
729
+ expect(local).toBeDefined();
730
+ expect(staging).toBeDefined();
731
+ expect(local!.content).toContain('name: Local');
732
+ expect(local!.content).toContain('- name: baseUrl');
733
+ expect(local!.content).toContain('value: "http://localhost:3000"');
734
+ expect(local!.content).toContain('- name: token');
735
+ expect(staging!.content).toContain('name: Staging');
736
+ expect(staging!.content).toContain('value: "https://staging.example.com"');
737
+ expect(staging!.content).toContain('value: "secret"');
738
+ });
739
+
740
+ it('does not auto-inject auth env vars when environments is provided', () => {
741
+ const files = generateOpenCollection([root], {
742
+ collectionName: 'API',
743
+ auth: bearerAuth,
744
+ environments: {
745
+ local: { baseUrl: 'http://localhost:3000' },
746
+ },
747
+ });
748
+ const local = files.find(f => f.relativePath === 'environments/local.yml');
749
+ expect(local!.content).not.toContain('- name: token');
750
+ });
751
+
752
+ it('falls back to the default local.yml when environments is empty', () => {
753
+ const files = generateOpenCollection([root], { collectionName: 'API', environments: {} });
754
+ const local = files.find(f => f.relativePath === 'environments/local.yml');
755
+ expect(local).toBeDefined();
756
+ expect(local!.content).toContain('name: Local');
757
+ expect(local!.content).toContain('value: "http://localhost:3000"');
758
+ });
759
+
760
+ it('coerces non-string values to strings', () => {
761
+ const files = generateOpenCollection([root], {
762
+ collectionName: 'API',
763
+ environments: { local: { port: 3000, debug: true } as unknown as Record<string, unknown> },
764
+ });
765
+ const local = files.find(f => f.relativePath === 'environments/local.yml');
766
+ expect(local!.content).toContain('value: "3000"');
767
+ expect(local!.content).toContain('value: "true"');
768
+ });
769
+ });
770
+
674
771
  it('does not add request or auth to opencollection.yml when no security config', () => {
675
772
  const root = opRoot([opRoute('/users', [opOperation('get')])], 'users.op');
676
773
  const files = generateOpenCollection([root], { collectionName: 'API' });