@contractkit/plugin-bruno 0.9.1 → 1.0.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 (23) hide show
  1. package/.turbo/turbo-build$colon$ci.log +19 -35
  2. package/.turbo/turbo-test$colon$ci.log +25 -128
  3. package/CHANGELOG.md +36 -0
  4. package/README.md +41 -0
  5. package/coverage/clover.xml +289 -275
  6. package/coverage/coverage-final.json +2 -2
  7. package/coverage/index.html +28 -28
  8. package/coverage/src/codegen-bruno.ts.html +242 -110
  9. package/coverage/src/index.html +18 -18
  10. package/coverage/tests/helpers.ts.html +28 -28
  11. package/coverage/tests/index.html +19 -19
  12. package/dist/codegen-bruno.d.ts +15 -0
  13. package/dist/codegen-bruno.d.ts.map +1 -1
  14. package/dist/index.d.ts +12 -0
  15. package/dist/index.d.ts.map +1 -1
  16. package/dist/index.js +32 -4
  17. package/dist/index.js.map +1 -1
  18. package/package.json +3 -2
  19. package/src/codegen-bruno.ts +52 -8
  20. package/src/index.ts +12 -0
  21. package/tests/codegen-bruno.test.ts +153 -3
  22. package/.turbo/turbo-build.log +0 -15
  23. package/.turbo/turbo-test.log +0 -14
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\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\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\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';\n\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\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\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 files.push({\n relativePath: `${requestDir}/${fileName}`,\n content: generateRequestFile(route, op, requestName, seq, modelMap, root, defaultScheme, randomExamples),\n });\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// ─── 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; uses defaults when available, null for optional fields without one. */\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] = null;\n } else {\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","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","trackedPaths","map","f","sort","JSON","stringify","parseManifest","parsed","parse","Array","isArray","every","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","base","baseModel","get","fields","source","nodes","visibility","node","defaultValue","values","value","random","randomScalarTemplate","item","items","t","members","modelToExampleObject","inner","fieldsToExampleObject","obj","field","replace","result","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\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"]}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@contractkit/plugin-bruno",
3
- "version": "0.9.1",
3
+ "version": "1.0.0",
4
4
  "description": "ContractKit built-in plugin: Bruno REST collection generation",
5
5
  "author": {
6
6
  "name": "Marooned Software",
@@ -26,7 +26,8 @@
26
26
  ".": "./dist/index.js"
27
27
  },
28
28
  "dependencies": {
29
- "@contractkit/core": "0.11.0"
29
+ "yaml": "^2.8.3",
30
+ "@contractkit/core": "0.13.0"
30
31
  },
31
32
  "devDependencies": {
32
33
  "@repo/config-eslint": "0.3.1",
package/src/codegen-bruno.ts CHANGED
@@ -11,7 +11,9 @@ import type {
11
11
  } from '@contractkit/core';
12
12
  import { resolveSecurity, resolveModifiers, SECURITY_NONE } from '@contractkit/core';
13
13
  import { basename } from 'path';
14
+ import { parse as parseYaml, stringify as stringifyYaml } from 'yaml';
14
15
 
16
+ /** A single file produced by the Bruno codegen — a relative output path and its YAML content. */
15
17
  export interface OpenCollectionFile {
16
18
  relativePath: string;
17
19
  content: string;
@@ -28,6 +30,7 @@ export interface BrunoSecurityScheme {
28
30
  in?: string; // "header" | "query" (when type === "apiKey")
29
31
  }
30
32
 
33
+ /** Auth configuration passed to the Bruno codegen; drives collection-level auth and per-operation auth blocks. */
31
34
  export interface BrunoAuthOptions {
32
35
  /** Name of the default scheme (from config.security.default) */
33
36
  defaultScheme?: string;
@@ -35,6 +38,7 @@ export interface BrunoAuthOptions {
35
38
  schemes?: Record<string, BrunoSecurityScheme>;
36
39
  }
37
40
 
41
+ /** Options controlling what {@link generateOpenCollection} emits. */
38
42
  export interface OpenCollectionOptions {
39
43
  collectionName: string;
40
44
  contractRoots?: ContractRootNode[];
@@ -93,10 +97,12 @@ export function generateOpenCollection(roots: OpRootNode[], options: OpenCollect
93
97
  if (!includeInternal && resolveModifiers(route, op).includes('internal')) continue;
94
98
  const requestName = op.name ?? route.path;
95
99
  const fileName = op.name ? `${slugifyName(op.name)}.yml` : `${op.method}-${sanitizePath(route.path)}.yml`;
96
- files.push({
97
- relativePath: `${requestDir}/${fileName}`,
98
- content: generateRequestFile(route, op, requestName, seq, modelMap, root, defaultScheme, randomExamples),
99
- });
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 });
100
106
  seq++;
101
107
  }
102
108
  }
@@ -124,6 +130,46 @@ export function parseManifest(content: string): string[] {
124
130
  return [];
125
131
  }
126
132
 
133
+ // ─── Plugin file merge ─────────────────────────────────────────────────────
134
+
135
+ function deepMerge(base: unknown, override: unknown): unknown {
136
+ if (
137
+ override !== null &&
138
+ typeof override === 'object' &&
139
+ !Array.isArray(override) &&
140
+ base !== null &&
141
+ typeof base === 'object' &&
142
+ !Array.isArray(base)
143
+ ) {
144
+ const result: Record<string, unknown> = { ...(base as Record<string, unknown>) };
145
+ for (const [key, val] of Object.entries(override as Record<string, unknown>)) {
146
+ result[key] = deepMerge(result[key], val);
147
+ }
148
+ return result;
149
+ }
150
+ return override;
151
+ }
152
+
153
+ /**
154
+ * Deep-merges a YAML override string into a generated YAML string.
155
+ *
156
+ * Objects are merged recursively; arrays and scalars in the override replace the
157
+ * generated value entirely. If `pluginFileContent` is not a YAML mapping (e.g. it
158
+ * is a scalar or a list), the generated content is returned unchanged.
159
+ *
160
+ * @param generatedYaml - The YAML string produced by the Bruno codegen.
161
+ * @param pluginFileContent - The YAML override string to merge in.
162
+ * @returns The merged YAML string, or `generatedYaml` if the override is not a mapping.
163
+ */
164
+ export function mergePluginFile(generatedYaml: string, pluginFileContent: string): string {
165
+ const overrideParsed = parseYaml(pluginFileContent);
166
+ if (overrideParsed === null || typeof overrideParsed !== 'object' || Array.isArray(overrideParsed)) {
167
+ return generatedYaml;
168
+ }
169
+ const merged = deepMerge(parseYaml(generatedYaml), overrideParsed);
170
+ return stringifyYaml(merged, { lineWidth: 0 });
171
+ }
172
+
127
173
  // ─── File generators ───────────────────────────────────────────────────────
128
174
 
129
175
  function generateCollectionRoot(name: string, scheme?: BrunoSecurityScheme): string {
@@ -540,16 +586,14 @@ function modelToExampleObject(model: ModelNode, modelMap: Map<string, ModelNode>
540
586
  return fieldsToExampleObject(resolveModelFields(model, modelMap), modelMap, randomExamples);
541
587
  }
542
588
 
543
- /** Build an example object from a list of FieldNodes. Excludes readonly; uses defaults when available, null for optional fields without one. */
589
+ /** 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. */
544
590
  function fieldsToExampleObject(fields: FieldNode[], modelMap: Map<string, ModelNode>, randomExamples = false): Record<string, unknown> {
545
591
  const obj: Record<string, unknown> = {};
546
592
  for (const field of fields) {
547
593
  if (field.visibility === 'readonly') continue;
548
594
  if (field.default !== undefined) {
549
595
  obj[field.name] = field.default;
550
- } else if (field.optional) {
551
- obj[field.name] = null;
552
- } else {
596
+ } else if (!field.optional) {
553
597
  obj[field.name] = typeToExampleValue(field.type, modelMap, randomExamples);
554
598
  }
555
599
  }
package/src/index.ts CHANGED
@@ -4,6 +4,7 @@ import { generateOpenCollection, MANIFEST_FILENAME, parseManifest } from './code
4
4
  import type { BrunoSecurityScheme } from './codegen-bruno.js';
5
5
  import type { ContractKitPlugin } from '@contractkit/core';
6
6
 
7
+ /** Configuration accepted by the Bruno plugin, both via `contractkit.config.json` and `createBrunoPlugin`. */
7
8
  export interface BrunoPluginConfig {
8
9
  baseDir?: string;
9
10
  output?: string;
@@ -22,6 +23,7 @@ export interface BrunoPluginConfig {
22
23
  includeInternal?: boolean;
23
24
  }
24
25
 
26
+ /** Full plugin options shape read from `ctx.options` — extends {@link BrunoPluginConfig} with the `auth` block. */
25
27
  export interface BrunoPluginOptions extends BrunoPluginConfig {
26
28
  auth?: { defaultScheme: string; schemes?: Record<string, BrunoSecurityScheme> };
27
29
  }
@@ -56,6 +58,16 @@ export default plugin;
56
58
 
57
59
  // ─── Factory: for programmatic use with explicit config ────────────────────
58
60
 
61
+ /**
62
+ * Creates a Bruno plugin instance with explicit configuration, for programmatic use.
63
+ *
64
+ * Prefer the default export when loading via `contractkit.config.json`. Use this
65
+ * factory when constructing the plugin in code (e.g. in tests or custom build scripts).
66
+ *
67
+ * @param config - Plugin configuration (output paths and feature flags).
68
+ * @param rootDir - Absolute path used to resolve relative paths in `config`.
69
+ * @param auth - Optional auth scheme configuration mirroring the `auth` key in plugin options.
70
+ */
59
71
  export function createBrunoPlugin(
60
72
  config: BrunoPluginConfig,
61
73
  rootDir: string,
package/tests/codegen-bruno.test.ts CHANGED
@@ -1,5 +1,5 @@
1
1
  import { describe, it, expect } from 'vitest';
2
- import { generateOpenCollection, sanitizePath, MANIFEST_FILENAME, parseManifest } from '../src/codegen-bruno.js';
2
+ import { generateOpenCollection, sanitizePath, MANIFEST_FILENAME, parseManifest, mergePluginFile } from '../src/codegen-bruno.js';
3
3
  import {
4
4
  opRoot,
5
5
  opRoute,
@@ -483,7 +483,7 @@ describe('generateOpenCollection', () => {
483
483
  expect(yml!.content).toContain('"name": ""');
484
484
  });
485
485
 
486
- it('sets optional fields to null in expanded ref body', () => {
486
+ it('omits optional fields with no default from body', () => {
487
487
  const userModel = model('CreateUserInput', [
488
488
  field('name', scalarType('string')),
489
489
  field('nickname', scalarType('string'), { optional: true }),
@@ -495,7 +495,7 @@ describe('generateOpenCollection', () => {
495
495
  const files = generateOpenCollection([root], { collectionName: 'API', contractRoots: [contractRoot([userModel])] });
496
496
  const yml = files.find(f => f.relativePath === 'users/post-users.yml');
497
497
  expect(yml!.content).toContain('"name": ""');
498
- expect(yml!.content).toContain('"nickname": null');
498
+ expect(yml!.content).not.toContain('"nickname"');
499
499
  });
500
500
 
501
501
  it('expands inherited fields from base model in ref body', () => {
@@ -1006,3 +1006,153 @@ describe('sanitizePath', () => {
1006
1006
  expect(sanitizePath('/users//posts')).toBe('users-posts');
1007
1007
  });
1008
1008
  });
1009
+
1010
+ describe('plugin file merges', () => {
1011
+ function getRequestFile(files: ReturnType<typeof generateOpenCollection>): { relativePath: string; content: string } {
1012
+ const f = files.find(f => !['opencollection.yml', 'environments/local.yml', MANIFEST_FILENAME].includes(f.relativePath) && !f.relativePath.endsWith('folder.yml'));
1013
+ if (!f) throw new Error('no request file found');
1014
+ return f;
1015
+ }
1016
+
1017
+ it('deep-merges object override into generated request file', () => {
1018
+ const root = opRoot([
1019
+ opRoute('/users', [
1020
+ opOperation('get', {
1021
+ responses: [opResponse(200, 'User')],
1022
+ pluginFiles: { bruno: 'runtime:\n script:\n req: |\n console.log("pre");\n' },
1023
+ }),
1024
+ ]),
1025
+ ]);
1026
+ const files = generateOpenCollection([root], { collectionName: 'API' });
1027
+ const req = getRequestFile(files);
1028
+ // injected key from override
1029
+ expect(req.content).toContain('script:');
1030
+ expect(req.content).toContain('console.log("pre")');
1031
+ // generated key survives (assertions from the 200 response)
1032
+ expect(req.content).toContain('assertions:');
1033
+ });
1034
+
1035
+ it('replaces arrays in override rather than appending', () => {
1036
+ const root = opRoot([
1037
+ opRoute('/users', [
1038
+ opOperation('get', {
1039
+ responses: [opResponse(200)],
1040
+ pluginFiles: {
1041
+ bruno: [
1042
+ 'runtime:',
1043
+ ' assertions:',
1044
+ ' - expression: res.status',
1045
+ ' operator: eq',
1046
+ ' value: "200"',
1047
+ ' - expression: res.headers["x-request-id"]',
1048
+ ' operator: isDefined',
1049
+ ' value: ""',
1050
+ ].join('\n'),
1051
+ },
1052
+ }),
1053
+ ]),
1054
+ ]);
1055
+ const files = generateOpenCollection([root], { collectionName: 'API' });
1056
+ const req = getRequestFile(files);
1057
+ // Count assertion blocks — should be exactly 2 (override replaces, not appends)
1058
+ const matches = req.content.match(/operator:/g);
1059
+ expect(matches).toHaveLength(2);
1060
+ });
1061
+
1062
+ it('preserves sibling keys not touched by override', () => {
1063
+ const root = opRoot([
1064
+ opRoute('/users', [
1065
+ opOperation('get', {
1066
+ responses: [opResponse(200)],
1067
+ pluginFiles: { bruno: 'runtime:\n script:\n req: |\n // pre\n' },
1068
+ }),
1069
+ ]),
1070
+ ]);
1071
+ const files = generateOpenCollection([root], { collectionName: 'API' });
1072
+ const req = getRequestFile(files);
1073
+ // Original http block must still be present
1074
+ expect(req.content).toContain('method: GET');
1075
+ expect(req.content).toContain('url:');
1076
+ });
1077
+
1078
+ it('leaves generated content unchanged when pluginFiles is absent', () => {
1079
+ const withoutOverride = opRoot([opRoute('/users', [opOperation('get', { responses: [opResponse(200)] })])]);
1080
+ const withOverride = opRoot([
1081
+ opRoute('/users', [
1082
+ opOperation('get', {
1083
+ responses: [opResponse(200)],
1084
+ pluginFiles: {},
1085
+ }),
1086
+ ]),
1087
+ ]);
1088
+ const filesWithout = generateOpenCollection([withoutOverride], { collectionName: 'API' });
1089
+ const filesWith = generateOpenCollection([withOverride], { collectionName: 'API' });
1090
+ expect(getRequestFile(filesWithout).content).toBe(getRequestFile(filesWith).content);
1091
+ });
1092
+
1093
+ it('ignores a malformed (non-mapping) plugin file and returns generated content unchanged', () => {
1094
+ const withoutOverride = opRoot([opRoute('/users', [opOperation('get', { responses: [opResponse(200)] })])]);
1095
+ const withBadOverride = opRoot([
1096
+ opRoute('/users', [
1097
+ opOperation('get', {
1098
+ responses: [opResponse(200)],
1099
+ pluginFiles: { bruno: 'just a scalar string' },
1100
+ }),
1101
+ ]),
1102
+ ]);
1103
+ const filesWithout = generateOpenCollection([withoutOverride], { collectionName: 'API' });
1104
+ const filesWith = generateOpenCollection([withBadOverride], { collectionName: 'API' });
1105
+ expect(getRequestFile(filesWithout).content).toBe(getRequestFile(filesWith).content);
1106
+ });
1107
+
1108
+ it('scalar override value replaces generated value', () => {
1109
+ const root = opRoot([
1110
+ opRoute('/users', [
1111
+ opOperation('get', {
1112
+ pluginFiles: { bruno: 'info:\n name: Custom Name\n' },
1113
+ }),
1114
+ ]),
1115
+ ]);
1116
+ const files = generateOpenCollection([root], { collectionName: 'API' });
1117
+ const req = getRequestFile(files);
1118
+ expect(req.content).toContain('name: Custom Name');
1119
+ });
1120
+ });
1121
+
1122
+ describe('mergePluginFile', () => {
1123
+ it('merges override object keys into generated YAML', () => {
1124
+ const base = 'info:\n name: Original\n type: http\n';
1125
+ const override = 'info:\n name: Overridden\n';
1126
+ const result = mergePluginFile(base, override);
1127
+ expect(result).toContain('name: Overridden');
1128
+ expect(result).toContain('type: http');
1129
+ });
1130
+
1131
+ it('replaces arrays in the override rather than appending', () => {
1132
+ const base = 'runtime:\n assertions:\n - expression: res.status\n operator: eq\n value: "200"\n';
1133
+ const override = 'runtime:\n assertions:\n - expression: res.status\n operator: eq\n value: "201"\n - expression: res.status\n operator: eq\n value: "202"\n';
1134
+ const result = mergePluginFile(base, override);
1135
+ const matches = result.match(/operator:/g);
1136
+ expect(matches).toHaveLength(2);
1137
+ expect(result).not.toContain('"200"');
1138
+ });
1139
+
1140
+ it('returns generated YAML unchanged when override is a scalar', () => {
1141
+ const base = 'info:\n name: Original\n';
1142
+ expect(mergePluginFile(base, 'just a scalar')).toBe(base);
1143
+ });
1144
+
1145
+ it('returns generated YAML unchanged when override is an array', () => {
1146
+ const base = 'info:\n name: Original\n';
1147
+ expect(mergePluginFile(base, '- a\n- b\n')).toBe(base);
1148
+ });
1149
+
1150
+ it('adds keys from override that are absent in the generated YAML', () => {
1151
+ const base = 'http:\n method: GET\n';
1152
+ const override = 'runtime:\n script:\n req: |\n console.log("hi");\n';
1153
+ const result = mergePluginFile(base, override);
1154
+ expect(result).toContain('method: GET');
1155
+ expect(result).toContain('script:');
1156
+ });
1157
+ });
1158
+
package/.turbo/turbo-build.log DELETED
@@ -1,15 +0,0 @@
1
-
2
- > @contractkit/plugin-bruno@0.9.0 build /Users/robert/projects/contractkit/packages/plugin-bruno
3
- > tsup src/index.ts --format esm --sourcemap --dts && tsc --emitDeclarationOnly --declaration
4
-
5
- CLI Building entry: src/index.ts
6
- CLI Using tsconfig: tsconfig.json
7
- CLI tsup v8.5.1
8
- CLI Target: esnext
9
- ESM Build start
10
- ESM dist/index.js 19.94 KB
11
- ESM dist/index.js.map 46.49 KB
12
- ESM ⚡️ Build success in 69ms
13
- DTS Build start
14
- DTS ⚡️ Build success in 594ms
15
- DTS dist/index.d.ts 1.37 KB
package/.turbo/turbo-test.log DELETED
@@ -1,14 +0,0 @@
1
-
2
- > @contractkit/plugin-bruno@0.9.0 test /Users/robert/projects/contractkit/packages/plugin-bruno
3
- > vitest run
4
-
5
-
6
-  RUN  v4.1.5 /Users/robert/projects/contractkit/packages/plugin-bruno
7
-
8
- ✓ tests/codegen-bruno.test.ts (85 tests) 9ms
9
-
10
-  Test Files  1 passed (1)
11
-  Tests  85 passed (85)
12
-  Start at  08:51:33
13
-  Duration  414ms (transform 136ms, setup 0ms, import 255ms, tests 9ms, environment 0ms)
14
-