@zimic/http 1.1.2 → 1.1.3-canary.0

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../package.json","../src/utils/time.ts","../src/cli/cli.ts","../src/cli/index.ts"],"names":["yargs","hideBin","generate_default","color","logger"],"mappings":"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","file":"cli.js","sourcesContent":["{\n  \"name\": \"@zimic/http\",\n  \"description\": \"Next-gen TypeScript-first HTTP utilities\",\n  \"keywords\": [\n    \"zimic\",\n    \"typescript\",\n    \"types\",\n    \"typegen\",\n    \"validation\",\n    \"inference\",\n    \"http\",\n    \"api\",\n    \"static\"\n  ],\n  \"version\": \"1.1.2\",\n  \"homepage\": \"https://zimic.dev/docs/http\",\n  \"repository\": {\n    \"type\": \"git\",\n    \"url\": \"https://github.com/zimicjs/zimic.git\",\n    \"directory\": \"packages/zimic-http\"\n  },\n  \"author\": {\n    \"name\": \"Diego Aquino\",\n    \"url\": \"https://github.com/diego-aquino\"\n  },\n  \"funding\": {\n    \"type\": \"github\",\n    \"url\": \"https://github.com/sponsors/zimicjs\"\n  },\n  \"private\": false,\n  \"publishConfig\": {\n    \"access\": \"public\",\n    \"provenance\": true\n  },\n  \"engines\": {\n    \"node\": \">=20.0.0\"\n  },\n  \"license\": \"MIT\",\n  \"files\": [\n    \"package.json\",\n    \"README.md\",\n    \"LICENSE.md\",\n    \"src\",\n    \"!src/**/tests\",\n    \"!src/**/__tests__\",\n    \"!src/**/*.test.ts\",\n    \"dist\",\n    \"index.d.ts\",\n    \"typegen.d.ts\"\n  ],\n  \"sideEffects\": false,\n  \"main\": \"./dist/index.js\",\n  \"module\": \"./dist/index.mjs\",\n  \"types\": \"index.d.ts\",\n  \"bin\": {\n    \"zimic-http\": \"./dist/cli.js\"\n  },\n  \"exports\": {\n    \".\": {\n      \"types\": \"./index.d.ts\",\n      \"import\": \"./dist/index.mjs\",\n      \"require\": \"./dist/index.js\",\n      \"default\": \"./dist/index.js\"\n    },\n    \"./typegen\": {\n      \"types\": \"./typegen.d.ts\",\n      \"import\": \"./dist/typegen.mjs\",\n      \"require\": \"./dist/typegen.js\",\n      \"default\": \"./dist/typegen.js\"\n    },\n    \"./package.json\": \"./package.json\"\n  },\n  \"scripts\": {\n    \"dev\": \"tsup --watch\",\n    \"cli\": \"node --enable-source-maps ./dist/cli.js\",\n    \"build\": \"tsup\",\n    \"lint\": \"eslint --cache --no-error-on-unmatched-pattern --no-warn-ignored --fix\",\n    \"lint:turbo\": \"pnpm lint . --max-warnings 0\",\n    \"style\": \"prettier --log-level warn --ignore-unknown --no-error-on-unmatched-pattern --cache\",\n    \"style:check\": \"pnpm style --check\",\n    \"style:format\": \"pnpm style --write\",\n    \"test\": \"dotenv -v NODE_ENV=test -- vitest\",\n    \"test:turbo\": \"dotenv -v CI=true -- pnpm run test run --coverage\",\n    \"types:check\": \"tsc --noEmit\",\n    \"typegen:fixtures\": \"tsx ./scripts/typegen/generateFixtureTypes.ts\",\n    \"deps:prepare\": \"playwright install chromium\"\n  },\n  \"dependencies\": {\n    \"openapi-typescript\": \"7.9.1\",\n    \"picocolors\": \"^1.1.1\",\n    \"yargs\": \"18.0.0\"\n  },\n  \"devDependencies\": {\n    \"@types/js-yaml\": \"^4.0.9\",\n    \"@types/node\": \"^24.5.2\",\n    \"@types/yargs\": \"^17.0.33\",\n    \"@vitest/browser\": \"^3.2.4\",\n    \"@vitest/coverage-istanbul\": \"^3.2.4\",\n    \"@zimic/eslint-config-node\": \"workspace:*\",\n    \"@zimic/interceptor\": \"workspace:*\",\n    \"@zimic/lint-staged-config\": \"workspace:*\",\n    \"@zimic/tsconfig\": \"workspace:*\",\n    \"@zimic/utils\": \"workspace:*\",\n    \"dotenv-cli\": \"^10.0.0\",\n    \"eslint\": \"^9.36.0\",\n    \"execa\": \"9.6.0\",\n    \"js-yaml\": \"^4.1.0\",\n    \"playwright\": \"^1.55.1\",\n    \"prettier\": \"^3.6.2\",\n    \"tsup\": \"^8.4.0\",\n    \"tsx\": \"^4.20.6\",\n    \"typescript\": \"^5.9.2\",\n    \"vitest\": \"^3.2.4\"\n  },\n  \"peerDependencies\": {\n    \"typescript\": \">=5.0.0\"\n  },\n  \"peerDependenciesMeta\": {\n    \"typescript\": {\n      \"optional\": true\n    }\n  }\n}\n","import { PossiblePromise } from '@zimic/utils/types';\n\nexport async function usingElapsedTime<ReturnType>(callback: () => PossiblePromise<ReturnType>) {\n  const startTimeInMilliseconds = performance.now();\n\n  const result = await callback();\n\n  const endTimeInMilliseconds = performance.now();\n  const elapsedTimeInMilliseconds = endTimeInMilliseconds - startTimeInMilliseconds;\n\n  return {\n    startTime: startTimeInMilliseconds,\n    elapsedTime: elapsedTimeInMilliseconds,\n    endTime: endTimeInMilliseconds,\n    result,\n  };\n}\n\nexport function formatElapsedTime(elapsedTimeInMilliseconds: number) {\n  if (elapsedTimeInMilliseconds < 1000) {\n    return `${elapsedTimeInMilliseconds.toFixed(0)}ms`;\n  } else {\n    return `${(elapsedTimeInMilliseconds / 1000).toFixed(2)}s`;\n  }\n}\n","import color from 'picocolors';\nimport yargs from 'yargs';\nimport { hideBin } from 'yargs/helpers';\n\nimport { version } from '@@/package.json';\n\nimport { generateTypesFromOpenAPI } from '@/typegen';\nimport { logger } from '@/utils/logging';\nimport { usingElapsedTime, formatElapsedTime } from '@/utils/time';\n\nasync function runCLI() {\n  await yargs(hideBin(process.argv))\n    .scriptName('zimic-http')\n    .version(version)\n    .showHelpOnFail(false)\n    .strict()\n\n    .command('typegen', 'Generate types from schema sources.', (yargs) =>\n      yargs.demandCommand().command(\n        'openapi <input>',\n        'Generate types from an OpenAPI schema.',\n        (yargs) =>\n          yargs\n            .positional('input', {\n              type: 'string',\n              description:\n                'The path to a local OpenAPI schema file or an URL to fetch it. ' +\n                'Version 3 is supported as YAML or JSON.',\n              demandOption: true,\n            })\n            .option('output', {\n              type: 'string',\n              description:\n                'The path to write the generated types to. If not provided, the types will be written to stdout.',\n              alias: 'o',\n            })\n            .option('service-name', {\n              type: 'string',\n              description: 'The name of the service to use in the generated types.',\n              alias: 's',\n              demandOption: true,\n            })\n            .option('comments', {\n              type: 'boolean',\n              description: 'Whether to include comments in the generated types.',\n              alias: 'c',\n              default: true,\n            })\n            .option('prune', {\n              type: 'boolean',\n              description:\n                'Whether to remove unused operations and components from the generated types. This is useful for ' +\n                'reducing the size of the output file.',\n              alias: 'p',\n              default: true,\n            })\n            .option('filter', {\n              type: 'string',\n              array: true,\n              description: [\n                'One or more expressions filtering which endpoints to include. Filters must follow the format `<method> ' +\n                  '<path>`, where:',\n                '- `<method>`: one HTTP method, a list of HTTP methods separated by commas, or `*` to match any HTTP ' +\n                  'method;',\n                '- `<path>`: a literal path or a glob. `*` matches zero or more characters in a segment (except `/`), ' +\n                  'while `**` matches zero or more characters across segments (may include `/`). For example, ' +\n                  '`GET /users` matches a single method and path, while `* /users` matches any method to the `/users` ' +\n                  'path; `GET /users*` matches any `GET` request whose path starts with `/users`, and `GET /users/**/*` ' +\n                  'matches any `GET` request to any sub-path of `/users`.',\n\n                'Negative filters can be created by prefixing the expression with `!`. For example, `!GET /users` will ' +\n                  'exclude paths matching `GET /users`.',\n              ].join('\\n'),\n              alias: 'f',\n            })\n            .option('filter-file', {\n              type: 'string',\n              description:\n                'A path to a file containing filter expressions. One expression is expected per line and the format ' +\n                'is the same as used in a `--filter` option. Comments are prefixed with `#`. A filter file can be ' +\n                'used alongside additional `--filter` expressions.',\n              alias: 'F',\n            }),\n        async (cliArguments) => {\n          const executionSummary = await usingElapsedTime(async () => {\n            await generateTypesFromOpenAPI({\n              input: cliArguments.input,\n              output: cliArguments.output,\n              serviceName: cliArguments.serviceName,\n              includeComments: cliArguments.comments,\n              prune: cliArguments.prune,\n              filters: cliArguments.filter,\n              filterFile: cliArguments.filterFile,\n            });\n          });\n\n          const outputFilePath = cliArguments.output;\n\n          const successMessage =\n            `${color.green(color.bold('✔'))} Generated ` +\n            `${outputFilePath ? color.green(outputFilePath) : `to ${color.yellow('stdout')}`} ${color.dim(\n              `(${formatElapsedTime(executionSummary.elapsedTime)})`,\n            )}`;\n\n          const hasWrittenToStdout = outputFilePath === undefined;\n          logger[hasWrittenToStdout ? 'warn' : 'info'](successMessage);\n        },\n      ),\n    )\n\n    .parse();\n}\n\nexport default runCLI;\n","#!/usr/bin/env node\nimport runCLI from './cli';\n\nvoid runCLI();\n"]}
+{"version":3,"sources":["../package.json","../src/utils/time.ts","../src/cli/cli.ts","../src/cli/index.ts"],"names":["yargs","hideBin","generate_default","color","logger"],"mappings":"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","file":"cli.js","sourcesContent":["{\n  \"name\": \"@zimic/http\",\n  \"description\": \"Next-gen TypeScript-first HTTP utilities\",\n  \"keywords\": [\n    \"zimic\",\n    \"typescript\",\n    \"types\",\n    \"typegen\",\n    \"validation\",\n    \"inference\",\n    \"http\",\n    \"api\",\n    \"static\"\n  ],\n  \"version\": \"1.1.3-canary.0\",\n  \"homepage\": \"https://zimic.dev/docs/http\",\n  \"repository\": {\n    \"type\": \"git\",\n    \"url\": \"https://github.com/zimicjs/zimic.git\",\n    \"directory\": \"packages/zimic-http\"\n  },\n  \"author\": {\n    \"name\": \"Diego Aquino\",\n    \"url\": \"https://github.com/diego-aquino\"\n  },\n  \"funding\": {\n    \"type\": \"github\",\n    \"url\": \"https://github.com/sponsors/zimicjs\"\n  },\n  \"private\": false,\n  \"publishConfig\": {\n    \"access\": \"public\",\n    \"provenance\": true\n  },\n  \"engines\": {\n    \"node\": \">=20.0.0\"\n  },\n  \"license\": \"MIT\",\n  \"files\": [\n    \"package.json\",\n    \"README.md\",\n    \"LICENSE.md\",\n    \"src\",\n    \"!src/**/tests\",\n    \"!src/**/__tests__\",\n    \"!src/**/*.test.ts\",\n    \"dist\",\n    \"index.d.ts\",\n    \"typegen.d.ts\"\n  ],\n  \"sideEffects\": false,\n  \"main\": \"./dist/index.js\",\n  \"module\": \"./dist/index.mjs\",\n  \"types\": \"index.d.ts\",\n  \"bin\": {\n    \"zimic-http\": \"./dist/cli.js\"\n  },\n  \"exports\": {\n    \".\": {\n      \"types\": \"./index.d.ts\",\n      \"import\": \"./dist/index.mjs\",\n      \"require\": \"./dist/index.js\",\n      \"default\": \"./dist/index.js\"\n    },\n    \"./typegen\": {\n      \"types\": \"./typegen.d.ts\",\n      \"import\": \"./dist/typegen.mjs\",\n      \"require\": \"./dist/typegen.js\",\n      \"default\": \"./dist/typegen.js\"\n    },\n    \"./package.json\": \"./package.json\"\n  },\n  \"scripts\": {\n    \"dev\": \"tsup --watch\",\n    \"cli\": \"node --enable-source-maps ./dist/cli.js\",\n    \"build\": \"tsup\",\n    \"lint\": \"eslint --cache --no-error-on-unmatched-pattern --no-warn-ignored --fix\",\n    \"lint:turbo\": \"pnpm lint . --max-warnings 0\",\n    \"style\": \"prettier --log-level warn --ignore-unknown --no-error-on-unmatched-pattern --cache\",\n    \"style:check\": \"pnpm style --check\",\n    \"style:format\": \"pnpm style --write\",\n    \"test\": \"dotenv -v NODE_ENV=test -v FORCE_COLOR=1 -- vitest\",\n    \"test:turbo\": \"dotenv -v CI=true -- pnpm run test run --coverage\",\n    \"types:check\": \"tsc --noEmit\",\n    \"typegen:fixtures\": \"tsx ./scripts/typegen/generateFixtureTypes.ts\",\n    \"deps:prepare\": \"playwright install chromium\"\n  },\n  \"dependencies\": {\n    \"openapi-typescript\": \"7.9.1\",\n    \"picocolors\": \"^1.1.1\",\n    \"yargs\": \"18.0.0\"\n  },\n  \"devDependencies\": {\n    \"@types/js-yaml\": \"^4.0.9\",\n    \"@types/node\": \"^24.5.2\",\n    \"@types/yargs\": \"^17.0.33\",\n    \"@vitest/browser\": \"^3.2.4\",\n    \"@vitest/coverage-istanbul\": \"^3.2.4\",\n    \"@zimic/eslint-config-node\": \"workspace:*\",\n    \"@zimic/interceptor\": \"workspace:*\",\n    \"@zimic/lint-staged-config\": \"workspace:*\",\n    \"@zimic/tsconfig\": \"workspace:*\",\n    \"@zimic/utils\": \"workspace:*\",\n    \"dotenv-cli\": \"^10.0.0\",\n    \"eslint\": \"^9.36.0\",\n    \"execa\": \"9.6.0\",\n    \"js-yaml\": \"^4.1.0\",\n    \"playwright\": \"^1.55.1\",\n    \"prettier\": \"^3.6.2\",\n    \"tsup\": \"^8.4.0\",\n    \"tsx\": \"^4.20.6\",\n    \"typescript\": \"^5.9.2\",\n    \"vitest\": \"^3.2.4\"\n  },\n  \"peerDependencies\": {\n    \"typescript\": \">=5.0.0\"\n  },\n  \"peerDependenciesMeta\": {\n    \"typescript\": {\n      \"optional\": true\n    }\n  }\n}\n","import { PossiblePromise } from '@zimic/utils/types';\n\nexport async function usingElapsedTime<ReturnType>(callback: () => PossiblePromise<ReturnType>) {\n  const startTimeInMilliseconds = performance.now();\n\n  const result = await callback();\n\n  const endTimeInMilliseconds = performance.now();\n  const elapsedTimeInMilliseconds = endTimeInMilliseconds - startTimeInMilliseconds;\n\n  return {\n    startTime: startTimeInMilliseconds,\n    elapsedTime: elapsedTimeInMilliseconds,\n    endTime: endTimeInMilliseconds,\n    result,\n  };\n}\n\nexport function formatElapsedTime(elapsedTimeInMilliseconds: number) {\n  if (elapsedTimeInMilliseconds < 1000) {\n    return `${elapsedTimeInMilliseconds.toFixed(0)}ms`;\n  } else {\n    return `${(elapsedTimeInMilliseconds / 1000).toFixed(2)}s`;\n  }\n}\n","import color from 'picocolors';\nimport yargs from 'yargs';\nimport { hideBin } from 'yargs/helpers';\n\nimport { version } from '@@/package.json';\n\nimport { generateTypesFromOpenAPI } from '@/typegen';\nimport { logger } from '@/utils/logging';\nimport { usingElapsedTime, formatElapsedTime } from '@/utils/time';\n\nasync function runCLI() {\n  await yargs(hideBin(process.argv))\n    .scriptName('zimic-http')\n    .version(version)\n    .showHelpOnFail(false)\n    .strict()\n\n    .command('typegen', 'Generate types from schema sources.', (yargs) =>\n      yargs.demandCommand().command(\n        'openapi <input>',\n        'Generate types from an OpenAPI schema.',\n        (yargs) =>\n          yargs\n            .positional('input', {\n              type: 'string',\n              description:\n                'The path to a local OpenAPI schema file or an URL to fetch it. ' +\n                'Version 3 is supported as YAML or JSON.',\n              demandOption: true,\n            })\n            .option('output', {\n              type: 'string',\n              description:\n                'The path to write the generated types to. If not provided, the types will be written to stdout.',\n              alias: 'o',\n            })\n            .option('service-name', {\n              type: 'string',\n              description: 'The name of the service to use in the generated types.',\n              alias: 's',\n              demandOption: true,\n            })\n            .option('comments', {\n              type: 'boolean',\n              description: 'Whether to include comments in the generated types.',\n              alias: 'c',\n              default: true,\n            })\n            .option('prune', {\n              type: 'boolean',\n              description:\n                'Whether to remove unused operations and components from the generated types. This is useful for ' +\n                'reducing the size of the output file.',\n              alias: 'p',\n              default: true,\n            })\n            .option('filter', {\n              type: 'string',\n              array: true,\n              description: [\n                'One or more expressions filtering which endpoints to include. Filters must follow the format `<method> ' +\n                  '<path>`, where:',\n                '- `<method>`: one HTTP method, a list of HTTP methods separated by commas, or `*` to match any HTTP ' +\n                  'method;',\n                '- `<path>`: a literal path or a glob. `*` matches zero or more characters in a segment (except `/`), ' +\n                  'while `**` matches zero or more characters across segments (may include `/`). For example, ' +\n                  '`GET /users` matches a single method and path, while `* /users` matches any method to the `/users` ' +\n                  'path; `GET /users*` matches any `GET` request whose path starts with `/users`, and `GET /users/**/*` ' +\n                  'matches any `GET` request to any sub-path of `/users`.',\n\n                'Negative filters can be created by prefixing the expression with `!`. For example, `!GET /users` will ' +\n                  'exclude paths matching `GET /users`.',\n              ].join('\\n'),\n              alias: 'f',\n            })\n            .option('filter-file', {\n              type: 'string',\n              description:\n                'A path to a file containing filter expressions. One expression is expected per line and the format ' +\n                'is the same as used in a `--filter` option. Comments are prefixed with `#`. A filter file can be ' +\n                'used alongside additional `--filter` expressions.',\n              alias: 'F',\n            }),\n        async (cliArguments) => {\n          const executionSummary = await usingElapsedTime(async () => {\n            await generateTypesFromOpenAPI({\n              input: cliArguments.input,\n              output: cliArguments.output,\n              serviceName: cliArguments.serviceName,\n              includeComments: cliArguments.comments,\n              prune: cliArguments.prune,\n              filters: cliArguments.filter,\n              filterFile: cliArguments.filterFile,\n            });\n          });\n\n          const outputFilePath = cliArguments.output;\n\n          const successMessage =\n            `${color.green(color.bold('✔'))} Generated ` +\n            `${outputFilePath ? color.green(outputFilePath) : `to ${color.yellow('stdout')}`} ${color.dim(\n              `(${formatElapsedTime(executionSummary.elapsedTime)})`,\n            )}`;\n\n          const hasWrittenToStdout = outputFilePath === undefined;\n          logger[hasWrittenToStdout ? 'warn' : 'info'](successMessage);\n        },\n      ),\n    )\n\n    .parse();\n}\n\nexport default runCLI;\n","#!/usr/bin/env node\nimport runCLI from './cli';\n\nvoid runCLI();\n"]}

package/dist/cli.mjs

@@ -1,11 +1,11 @@
 #!/usr/bin/env node
-import { logger, generate_default } from './chunk-ZPOGWLJW.mjs';
+import { logger, generate_default } from './chunk-CGLPJU2K.mjs';
 import color from 'picocolors';
 import yargs from 'yargs';
 import { hideBin } from 'yargs/helpers';
 
 // package.json
-var version = "1.1.2";
+var version = "1.1.3-canary.0";
 
 // src/utils/time.ts
 async function usingElapsedTime(callback) {

package/dist/cli.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../package.json","../src/utils/time.ts","../src/cli/cli.ts","../src/cli/index.ts"],"names":["yargs"],"mappings":"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","file":"cli.mjs","sourcesContent":["{\n  \"name\": \"@zimic/http\",\n  \"description\": \"Next-gen TypeScript-first HTTP utilities\",\n  \"keywords\": [\n    \"zimic\",\n    \"typescript\",\n    \"types\",\n    \"typegen\",\n    \"validation\",\n    \"inference\",\n    \"http\",\n    \"api\",\n    \"static\"\n  ],\n  \"version\": \"1.1.2\",\n  \"homepage\": \"https://zimic.dev/docs/http\",\n  \"repository\": {\n    \"type\": \"git\",\n    \"url\": \"https://github.com/zimicjs/zimic.git\",\n    \"directory\": \"packages/zimic-http\"\n  },\n  \"author\": {\n    \"name\": \"Diego Aquino\",\n    \"url\": \"https://github.com/diego-aquino\"\n  },\n  \"funding\": {\n    \"type\": \"github\",\n    \"url\": \"https://github.com/sponsors/zimicjs\"\n  },\n  \"private\": false,\n  \"publishConfig\": {\n    \"access\": \"public\",\n    \"provenance\": true\n  },\n  \"engines\": {\n    \"node\": \">=20.0.0\"\n  },\n  \"license\": \"MIT\",\n  \"files\": [\n    \"package.json\",\n    \"README.md\",\n    \"LICENSE.md\",\n    \"src\",\n    \"!src/**/tests\",\n    \"!src/**/__tests__\",\n    \"!src/**/*.test.ts\",\n    \"dist\",\n    \"index.d.ts\",\n    \"typegen.d.ts\"\n  ],\n  \"sideEffects\": false,\n  \"main\": \"./dist/index.js\",\n  \"module\": \"./dist/index.mjs\",\n  \"types\": \"index.d.ts\",\n  \"bin\": {\n    \"zimic-http\": \"./dist/cli.js\"\n  },\n  \"exports\": {\n    \".\": {\n      \"types\": \"./index.d.ts\",\n      \"import\": \"./dist/index.mjs\",\n      \"require\": \"./dist/index.js\",\n      \"default\": \"./dist/index.js\"\n    },\n    \"./typegen\": {\n      \"types\": \"./typegen.d.ts\",\n      \"import\": \"./dist/typegen.mjs\",\n      \"require\": \"./dist/typegen.js\",\n      \"default\": \"./dist/typegen.js\"\n    },\n    \"./package.json\": \"./package.json\"\n  },\n  \"scripts\": {\n    \"dev\": \"tsup --watch\",\n    \"cli\": \"node --enable-source-maps ./dist/cli.js\",\n    \"build\": \"tsup\",\n    \"lint\": \"eslint --cache --no-error-on-unmatched-pattern --no-warn-ignored --fix\",\n    \"lint:turbo\": \"pnpm lint . --max-warnings 0\",\n    \"style\": \"prettier --log-level warn --ignore-unknown --no-error-on-unmatched-pattern --cache\",\n    \"style:check\": \"pnpm style --check\",\n    \"style:format\": \"pnpm style --write\",\n    \"test\": \"dotenv -v NODE_ENV=test -- vitest\",\n    \"test:turbo\": \"dotenv -v CI=true -- pnpm run test run --coverage\",\n    \"types:check\": \"tsc --noEmit\",\n    \"typegen:fixtures\": \"tsx ./scripts/typegen/generateFixtureTypes.ts\",\n    \"deps:prepare\": \"playwright install chromium\"\n  },\n  \"dependencies\": {\n    \"openapi-typescript\": \"7.9.1\",\n    \"picocolors\": \"^1.1.1\",\n    \"yargs\": \"18.0.0\"\n  },\n  \"devDependencies\": {\n    \"@types/js-yaml\": \"^4.0.9\",\n    \"@types/node\": \"^24.5.2\",\n    \"@types/yargs\": \"^17.0.33\",\n    \"@vitest/browser\": \"^3.2.4\",\n    \"@vitest/coverage-istanbul\": \"^3.2.4\",\n    \"@zimic/eslint-config-node\": \"workspace:*\",\n    \"@zimic/interceptor\": \"workspace:*\",\n    \"@zimic/lint-staged-config\": \"workspace:*\",\n    \"@zimic/tsconfig\": \"workspace:*\",\n    \"@zimic/utils\": \"workspace:*\",\n    \"dotenv-cli\": \"^10.0.0\",\n    \"eslint\": \"^9.36.0\",\n    \"execa\": \"9.6.0\",\n    \"js-yaml\": \"^4.1.0\",\n    \"playwright\": \"^1.55.1\",\n    \"prettier\": \"^3.6.2\",\n    \"tsup\": \"^8.4.0\",\n    \"tsx\": \"^4.20.6\",\n    \"typescript\": \"^5.9.2\",\n    \"vitest\": \"^3.2.4\"\n  },\n  \"peerDependencies\": {\n    \"typescript\": \">=5.0.0\"\n  },\n  \"peerDependenciesMeta\": {\n    \"typescript\": {\n      \"optional\": true\n    }\n  }\n}\n","import { PossiblePromise } from '@zimic/utils/types';\n\nexport async function usingElapsedTime<ReturnType>(callback: () => PossiblePromise<ReturnType>) {\n  const startTimeInMilliseconds = performance.now();\n\n  const result = await callback();\n\n  const endTimeInMilliseconds = performance.now();\n  const elapsedTimeInMilliseconds = endTimeInMilliseconds - startTimeInMilliseconds;\n\n  return {\n    startTime: startTimeInMilliseconds,\n    elapsedTime: elapsedTimeInMilliseconds,\n    endTime: endTimeInMilliseconds,\n    result,\n  };\n}\n\nexport function formatElapsedTime(elapsedTimeInMilliseconds: number) {\n  if (elapsedTimeInMilliseconds < 1000) {\n    return `${elapsedTimeInMilliseconds.toFixed(0)}ms`;\n  } else {\n    return `${(elapsedTimeInMilliseconds / 1000).toFixed(2)}s`;\n  }\n}\n","import color from 'picocolors';\nimport yargs from 'yargs';\nimport { hideBin } from 'yargs/helpers';\n\nimport { version } from '@@/package.json';\n\nimport { generateTypesFromOpenAPI } from '@/typegen';\nimport { logger } from '@/utils/logging';\nimport { usingElapsedTime, formatElapsedTime } from '@/utils/time';\n\nasync function runCLI() {\n  await yargs(hideBin(process.argv))\n    .scriptName('zimic-http')\n    .version(version)\n    .showHelpOnFail(false)\n    .strict()\n\n    .command('typegen', 'Generate types from schema sources.', (yargs) =>\n      yargs.demandCommand().command(\n        'openapi <input>',\n        'Generate types from an OpenAPI schema.',\n        (yargs) =>\n          yargs\n            .positional('input', {\n              type: 'string',\n              description:\n                'The path to a local OpenAPI schema file or an URL to fetch it. ' +\n                'Version 3 is supported as YAML or JSON.',\n              demandOption: true,\n            })\n            .option('output', {\n              type: 'string',\n              description:\n                'The path to write the generated types to. If not provided, the types will be written to stdout.',\n              alias: 'o',\n            })\n            .option('service-name', {\n              type: 'string',\n              description: 'The name of the service to use in the generated types.',\n              alias: 's',\n              demandOption: true,\n            })\n            .option('comments', {\n              type: 'boolean',\n              description: 'Whether to include comments in the generated types.',\n              alias: 'c',\n              default: true,\n            })\n            .option('prune', {\n              type: 'boolean',\n              description:\n                'Whether to remove unused operations and components from the generated types. This is useful for ' +\n                'reducing the size of the output file.',\n              alias: 'p',\n              default: true,\n            })\n            .option('filter', {\n              type: 'string',\n              array: true,\n              description: [\n                'One or more expressions filtering which endpoints to include. Filters must follow the format `<method> ' +\n                  '<path>`, where:',\n                '- `<method>`: one HTTP method, a list of HTTP methods separated by commas, or `*` to match any HTTP ' +\n                  'method;',\n                '- `<path>`: a literal path or a glob. `*` matches zero or more characters in a segment (except `/`), ' +\n                  'while `**` matches zero or more characters across segments (may include `/`). For example, ' +\n                  '`GET /users` matches a single method and path, while `* /users` matches any method to the `/users` ' +\n                  'path; `GET /users*` matches any `GET` request whose path starts with `/users`, and `GET /users/**/*` ' +\n                  'matches any `GET` request to any sub-path of `/users`.',\n\n                'Negative filters can be created by prefixing the expression with `!`. For example, `!GET /users` will ' +\n                  'exclude paths matching `GET /users`.',\n              ].join('\\n'),\n              alias: 'f',\n            })\n            .option('filter-file', {\n              type: 'string',\n              description:\n                'A path to a file containing filter expressions. One expression is expected per line and the format ' +\n                'is the same as used in a `--filter` option. Comments are prefixed with `#`. A filter file can be ' +\n                'used alongside additional `--filter` expressions.',\n              alias: 'F',\n            }),\n        async (cliArguments) => {\n          const executionSummary = await usingElapsedTime(async () => {\n            await generateTypesFromOpenAPI({\n              input: cliArguments.input,\n              output: cliArguments.output,\n              serviceName: cliArguments.serviceName,\n              includeComments: cliArguments.comments,\n              prune: cliArguments.prune,\n              filters: cliArguments.filter,\n              filterFile: cliArguments.filterFile,\n            });\n          });\n\n          const outputFilePath = cliArguments.output;\n\n          const successMessage =\n            `${color.green(color.bold('✔'))} Generated ` +\n            `${outputFilePath ? color.green(outputFilePath) : `to ${color.yellow('stdout')}`} ${color.dim(\n              `(${formatElapsedTime(executionSummary.elapsedTime)})`,\n            )}`;\n\n          const hasWrittenToStdout = outputFilePath === undefined;\n          logger[hasWrittenToStdout ? 'warn' : 'info'](successMessage);\n        },\n      ),\n    )\n\n    .parse();\n}\n\nexport default runCLI;\n","#!/usr/bin/env node\nimport runCLI from './cli';\n\nvoid runCLI();\n"]}
+{"version":3,"sources":["../package.json","../src/utils/time.ts","../src/cli/cli.ts","../src/cli/index.ts"],"names":["yargs"],"mappings":"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","file":"cli.mjs","sourcesContent":["{\n  \"name\": \"@zimic/http\",\n  \"description\": \"Next-gen TypeScript-first HTTP utilities\",\n  \"keywords\": [\n    \"zimic\",\n    \"typescript\",\n    \"types\",\n    \"typegen\",\n    \"validation\",\n    \"inference\",\n    \"http\",\n    \"api\",\n    \"static\"\n  ],\n  \"version\": \"1.1.3-canary.0\",\n  \"homepage\": \"https://zimic.dev/docs/http\",\n  \"repository\": {\n    \"type\": \"git\",\n    \"url\": \"https://github.com/zimicjs/zimic.git\",\n    \"directory\": \"packages/zimic-http\"\n  },\n  \"author\": {\n    \"name\": \"Diego Aquino\",\n    \"url\": \"https://github.com/diego-aquino\"\n  },\n  \"funding\": {\n    \"type\": \"github\",\n    \"url\": \"https://github.com/sponsors/zimicjs\"\n  },\n  \"private\": false,\n  \"publishConfig\": {\n    \"access\": \"public\",\n    \"provenance\": true\n  },\n  \"engines\": {\n    \"node\": \">=20.0.0\"\n  },\n  \"license\": \"MIT\",\n  \"files\": [\n    \"package.json\",\n    \"README.md\",\n    \"LICENSE.md\",\n    \"src\",\n    \"!src/**/tests\",\n    \"!src/**/__tests__\",\n    \"!src/**/*.test.ts\",\n    \"dist\",\n    \"index.d.ts\",\n    \"typegen.d.ts\"\n  ],\n  \"sideEffects\": false,\n  \"main\": \"./dist/index.js\",\n  \"module\": \"./dist/index.mjs\",\n  \"types\": \"index.d.ts\",\n  \"bin\": {\n    \"zimic-http\": \"./dist/cli.js\"\n  },\n  \"exports\": {\n    \".\": {\n      \"types\": \"./index.d.ts\",\n      \"import\": \"./dist/index.mjs\",\n      \"require\": \"./dist/index.js\",\n      \"default\": \"./dist/index.js\"\n    },\n    \"./typegen\": {\n      \"types\": \"./typegen.d.ts\",\n      \"import\": \"./dist/typegen.mjs\",\n      \"require\": \"./dist/typegen.js\",\n      \"default\": \"./dist/typegen.js\"\n    },\n    \"./package.json\": \"./package.json\"\n  },\n  \"scripts\": {\n    \"dev\": \"tsup --watch\",\n    \"cli\": \"node --enable-source-maps ./dist/cli.js\",\n    \"build\": \"tsup\",\n    \"lint\": \"eslint --cache --no-error-on-unmatched-pattern --no-warn-ignored --fix\",\n    \"lint:turbo\": \"pnpm lint . --max-warnings 0\",\n    \"style\": \"prettier --log-level warn --ignore-unknown --no-error-on-unmatched-pattern --cache\",\n    \"style:check\": \"pnpm style --check\",\n    \"style:format\": \"pnpm style --write\",\n    \"test\": \"dotenv -v NODE_ENV=test -v FORCE_COLOR=1 -- vitest\",\n    \"test:turbo\": \"dotenv -v CI=true -- pnpm run test run --coverage\",\n    \"types:check\": \"tsc --noEmit\",\n    \"typegen:fixtures\": \"tsx ./scripts/typegen/generateFixtureTypes.ts\",\n    \"deps:prepare\": \"playwright install chromium\"\n  },\n  \"dependencies\": {\n    \"openapi-typescript\": \"7.9.1\",\n    \"picocolors\": \"^1.1.1\",\n    \"yargs\": \"18.0.0\"\n  },\n  \"devDependencies\": {\n    \"@types/js-yaml\": \"^4.0.9\",\n    \"@types/node\": \"^24.5.2\",\n    \"@types/yargs\": \"^17.0.33\",\n    \"@vitest/browser\": \"^3.2.4\",\n    \"@vitest/coverage-istanbul\": \"^3.2.4\",\n    \"@zimic/eslint-config-node\": \"workspace:*\",\n    \"@zimic/interceptor\": \"workspace:*\",\n    \"@zimic/lint-staged-config\": \"workspace:*\",\n    \"@zimic/tsconfig\": \"workspace:*\",\n    \"@zimic/utils\": \"workspace:*\",\n    \"dotenv-cli\": \"^10.0.0\",\n    \"eslint\": \"^9.36.0\",\n    \"execa\": \"9.6.0\",\n    \"js-yaml\": \"^4.1.0\",\n    \"playwright\": \"^1.55.1\",\n    \"prettier\": \"^3.6.2\",\n    \"tsup\": \"^8.4.0\",\n    \"tsx\": \"^4.20.6\",\n    \"typescript\": \"^5.9.2\",\n    \"vitest\": \"^3.2.4\"\n  },\n  \"peerDependencies\": {\n    \"typescript\": \">=5.0.0\"\n  },\n  \"peerDependenciesMeta\": {\n    \"typescript\": {\n      \"optional\": true\n    }\n  }\n}\n","import { PossiblePromise } from '@zimic/utils/types';\n\nexport async function usingElapsedTime<ReturnType>(callback: () => PossiblePromise<ReturnType>) {\n  const startTimeInMilliseconds = performance.now();\n\n  const result = await callback();\n\n  const endTimeInMilliseconds = performance.now();\n  const elapsedTimeInMilliseconds = endTimeInMilliseconds - startTimeInMilliseconds;\n\n  return {\n    startTime: startTimeInMilliseconds,\n    elapsedTime: elapsedTimeInMilliseconds,\n    endTime: endTimeInMilliseconds,\n    result,\n  };\n}\n\nexport function formatElapsedTime(elapsedTimeInMilliseconds: number) {\n  if (elapsedTimeInMilliseconds < 1000) {\n    return `${elapsedTimeInMilliseconds.toFixed(0)}ms`;\n  } else {\n    return `${(elapsedTimeInMilliseconds / 1000).toFixed(2)}s`;\n  }\n}\n","import color from 'picocolors';\nimport yargs from 'yargs';\nimport { hideBin } from 'yargs/helpers';\n\nimport { version } from '@@/package.json';\n\nimport { generateTypesFromOpenAPI } from '@/typegen';\nimport { logger } from '@/utils/logging';\nimport { usingElapsedTime, formatElapsedTime } from '@/utils/time';\n\nasync function runCLI() {\n  await yargs(hideBin(process.argv))\n    .scriptName('zimic-http')\n    .version(version)\n    .showHelpOnFail(false)\n    .strict()\n\n    .command('typegen', 'Generate types from schema sources.', (yargs) =>\n      yargs.demandCommand().command(\n        'openapi <input>',\n        'Generate types from an OpenAPI schema.',\n        (yargs) =>\n          yargs\n            .positional('input', {\n              type: 'string',\n              description:\n                'The path to a local OpenAPI schema file or an URL to fetch it. ' +\n                'Version 3 is supported as YAML or JSON.',\n              demandOption: true,\n            })\n            .option('output', {\n              type: 'string',\n              description:\n                'The path to write the generated types to. If not provided, the types will be written to stdout.',\n              alias: 'o',\n            })\n            .option('service-name', {\n              type: 'string',\n              description: 'The name of the service to use in the generated types.',\n              alias: 's',\n              demandOption: true,\n            })\n            .option('comments', {\n              type: 'boolean',\n              description: 'Whether to include comments in the generated types.',\n              alias: 'c',\n              default: true,\n            })\n            .option('prune', {\n              type: 'boolean',\n              description:\n                'Whether to remove unused operations and components from the generated types. This is useful for ' +\n                'reducing the size of the output file.',\n              alias: 'p',\n              default: true,\n            })\n            .option('filter', {\n              type: 'string',\n              array: true,\n              description: [\n                'One or more expressions filtering which endpoints to include. Filters must follow the format `<method> ' +\n                  '<path>`, where:',\n                '- `<method>`: one HTTP method, a list of HTTP methods separated by commas, or `*` to match any HTTP ' +\n                  'method;',\n                '- `<path>`: a literal path or a glob. `*` matches zero or more characters in a segment (except `/`), ' +\n                  'while `**` matches zero or more characters across segments (may include `/`). For example, ' +\n                  '`GET /users` matches a single method and path, while `* /users` matches any method to the `/users` ' +\n                  'path; `GET /users*` matches any `GET` request whose path starts with `/users`, and `GET /users/**/*` ' +\n                  'matches any `GET` request to any sub-path of `/users`.',\n\n                'Negative filters can be created by prefixing the expression with `!`. For example, `!GET /users` will ' +\n                  'exclude paths matching `GET /users`.',\n              ].join('\\n'),\n              alias: 'f',\n            })\n            .option('filter-file', {\n              type: 'string',\n              description:\n                'A path to a file containing filter expressions. One expression is expected per line and the format ' +\n                'is the same as used in a `--filter` option. Comments are prefixed with `#`. A filter file can be ' +\n                'used alongside additional `--filter` expressions.',\n              alias: 'F',\n            }),\n        async (cliArguments) => {\n          const executionSummary = await usingElapsedTime(async () => {\n            await generateTypesFromOpenAPI({\n              input: cliArguments.input,\n              output: cliArguments.output,\n              serviceName: cliArguments.serviceName,\n              includeComments: cliArguments.comments,\n              prune: cliArguments.prune,\n              filters: cliArguments.filter,\n              filterFile: cliArguments.filterFile,\n            });\n          });\n\n          const outputFilePath = cliArguments.output;\n\n          const successMessage =\n            `${color.green(color.bold('✔'))} Generated ` +\n            `${outputFilePath ? color.green(outputFilePath) : `to ${color.yellow('stdout')}`} ${color.dim(\n              `(${formatElapsedTime(executionSummary.elapsedTime)})`,\n            )}`;\n\n          const hasWrittenToStdout = outputFilePath === undefined;\n          logger[hasWrittenToStdout ? 'warn' : 'info'](successMessage);\n        },\n      ),\n    )\n\n    .parse();\n}\n\nexport default runCLI;\n","#!/usr/bin/env node\nimport runCLI from './cli';\n\nvoid runCLI();\n"]}

package/dist/typegen.js

@@ -1,12 +1,12 @@
 'use strict';
 
-var chunkOFNBRVSF_js = require('./chunk-OFNBRVSF.js');
+var chunkB2CEMX5F_js = require('./chunk-B2CEMX5F.js');
 
 
 
 Object.defineProperty(exports, "generateTypesFromOpenAPI", {
   enumerable: true,
-  get: function () { return chunkOFNBRVSF_js.generate_default; }
+  get: function () { return chunkB2CEMX5F_js.generate_default; }
 });
 //# sourceMappingURL=typegen.js.map
 //# sourceMappingURL=typegen.js.map

package/dist/typegen.mjs

@@ -1,3 +1,3 @@
-export { generate_default as generateTypesFromOpenAPI } from './chunk-ZPOGWLJW.mjs';
+export { generate_default as generateTypesFromOpenAPI } from './chunk-CGLPJU2K.mjs';
 //# sourceMappingURL=typegen.mjs.map
 //# sourceMappingURL=typegen.mjs.map

package/package.json

@@ -12,7 +12,7 @@
     "api",
     "static"
   ],
-  "version": "1.1.2",
+  "version": "1.1.3-canary.0",
   "homepage": "https://zimic.dev/docs/http",
   "repository": {
     "type": "git",
@@ -92,10 +92,10 @@
     "typescript": "^5.9.2",
     "vitest": "^3.2.4",
     "@zimic/eslint-config-node": "0.0.0",
-    "@zimic/lint-staged-config": "0.0.0",
+    "@zimic/interceptor": "1.1.2",
     "@zimic/tsconfig": "0.0.0",
-    "@zimic/interceptor": "1.1.2-canary.6",
-    "@zimic/utils": "0.0.0"
+    "@zimic/utils": "0.0.0",
+    "@zimic/lint-staged-config": "0.0.0"
   },
   "peerDependencies": {
     "typescript": ">=5.0.0"
@@ -114,7 +114,7 @@
     "style": "prettier --log-level warn --ignore-unknown --no-error-on-unmatched-pattern --cache",
     "style:check": "pnpm style --check",
     "style:format": "pnpm style --write",
-    "test": "dotenv -v NODE_ENV=test -- vitest",
+    "test": "dotenv -v NODE_ENV=test -v FORCE_COLOR=1 -- vitest",
     "test:turbo": "dotenv -v CI=true -- pnpm run test run --coverage",
     "types:check": "tsc --noEmit",
     "typegen:fixtures": "tsx ./scripts/typegen/generateFixtureTypes.ts",

package/src/typegen/openapi/generate.ts

@@ -1,5 +1,4 @@
 import isDefined from '@zimic/utils/data/isDefined';
-import filesystem from 'fs/promises';
 import path from 'path';
 import ts from 'typescript';
 
@@ -15,8 +14,9 @@ import { createImportDeclarations } from './transform/imports';
 import {
   convertTypesToString,
   importTypesFromOpenAPI,
-  prepareTypeOutputToSave,
-  writeTypeOutputToStandardOutput,
+  formatTypegenResultToOutput,
+  writeTypegenResultToStandardOutput,
+  writeTypegenResultToFile,
 } from './transform/io';
 import { isOperationsDeclaration, normalizeOperations, removeUnreferencedOperations } from './transform/operations';
 import { isPathsDeclaration, normalizePaths } from './transform/paths';
@@ -97,7 +97,7 @@ async function generateTypesFromOpenAPI({
   filters: filtersFromArguments = [],
   filterFile,
 }: OpenAPITypegenOptions) {
-  const filtersFromFile = filterFile ? await readPathFiltersFromFile(filterFile) : [];
+  const filtersFromFile = filterFile ? await readPathFiltersFromFile(path.resolve(filterFile)) : [];
   const filters = ignoreEmptyFilters([...filtersFromFile, ...filtersFromArguments]);
 
   const rawNodes = await importTypesFromOpenAPI(inputFilePathOrURL);
@@ -110,14 +110,15 @@ async function generateTypesFromOpenAPI({
     nodes.unshift(declaration);
   }
 
-  const typeOutput = await convertTypesToString(nodes, { includeComments });
-  const formattedOutput = prepareTypeOutputToSave(typeOutput);
+  const typegenResult = await convertTypesToString(nodes, { includeComments });
+  const formattedTypegenResult = formatTypegenResultToOutput(typegenResult);
 
-  const shouldWriteToStdout = outputFilePath === undefined;
-  if (shouldWriteToStdout) {
-    await writeTypeOutputToStandardOutput(formattedOutput);
+  const shouldWriteToStandardOutput = outputFilePath === undefined;
+
+  if (shouldWriteToStandardOutput) {
+    await writeTypegenResultToStandardOutput(formattedTypegenResult);
   } else {
-    await filesystem.writeFile(path.resolve(outputFilePath), formattedOutput);
+    await writeTypegenResultToFile(path.resolve(outputFilePath), formattedTypegenResult);
   }
 }
 

package/src/typegen/openapi/transform/filters.ts

@@ -1,10 +1,10 @@
 import isNonEmpty from '@zimic/utils/data/isNonEmpty';
 import createWildcardRegexFromPath from '@zimic/utils/url/createWildcardRegexFromPath';
-import filesystem from 'fs/promises';
-import path from 'path';
+import fs from 'fs';
 import color from 'picocolors';
 
 import { HTTP_METHODS } from '@/types/schema';
+import { ensurePathExists } from '@/utils/files';
 import { logger } from '@/utils/logging';
 
 import { TypePathFilter, TypePathFilters } from './context';
@@ -51,7 +51,11 @@ export function groupParsedFiltersByMatch(parsedFilters: (TypePathFilter | undef
 }
 
 export async function readPathFiltersFromFile(filePath: string) {
-  const fileContent = await filesystem.readFile(path.resolve(filePath), 'utf-8');
+  await ensurePathExists(filePath, {
+    errorMessage: `Could not read filter file: ${color.yellow(filePath)}`,
+  });
+
+  const fileContent = await fs.promises.readFile(filePath, 'utf-8');
   const fileContentWithoutComments = fileContent.replace(/#.*$/gm, '');
 
   const filters = fileContentWithoutComments.split('\n');

package/src/typegen/openapi/transform/io.ts

@@ -1,4 +1,5 @@
 import createCachedDynamicImport from '@zimic/utils/import/createCachedDynamicImport';
+import fs from 'fs';
 import type { SchemaObject } from 'openapi-typescript';
 import path from 'path';
 import ts from 'typescript';
@@ -56,29 +57,34 @@ export async function importTypesFromOpenAPI(filePathOrURL: string) {
 export async function convertTypesToString(nodes: ts.Node[], options: { includeComments: boolean }) {
   const { astToString: convertTypeASTToString } = await importOpenapiTypeScript();
 
-  const typeOutput = convertTypeASTToString(nodes, {
+  const typegenResult = convertTypeASTToString(nodes, {
     formatOptions: { removeComments: !options.includeComments },
   });
 
-  return typeOutput;
+  return typegenResult;
 }
 
-export function prepareTypeOutputToSave(output: string) {
-  const formattedOutput = output
+export function formatTypegenResultToOutput(typegenResult: string) {
+  const formattedResult = typegenResult
     .replace(/^export (\w+)/gm, '\nexport $1')
     .replace(/^( {4})+/gm, (match) => match.replace(/ {4}/g, '  '));
 
-  const formattedOutputWithPrefix = [
+  return [
     '// Auto-generated by @zimic/http.',
     '// NOTE: Do not manually edit this file. Changes will be overridden.\n',
-    formattedOutput,
+    formattedResult,
   ].join('\n');
-
-  return formattedOutputWithPrefix;
 }
 
-export async function writeTypeOutputToStandardOutput(formattedOutput: string) {
+export async function writeTypegenResultToStandardOutput(typegenResult: string) {
   await new Promise((resolve) => {
-    process.stdout.write(formattedOutput, 'utf-8', resolve);
+    process.stdout.write(typegenResult, 'utf-8', resolve);
   });
 }
+
+export async function writeTypegenResultToFile(outputFilePath: string, formattedResult: string) {
+  const outputDirectory = path.dirname(outputFilePath);
+  await fs.promises.mkdir(outputDirectory, { recursive: true });
+
+  await fs.promises.writeFile(outputFilePath, formattedResult);
+}

package/src/utils/files.ts

@@ -1,4 +1,6 @@
 import createCachedDynamicImport from '@zimic/utils/import/createCachedDynamicImport';
+import fs from 'fs';
+import path from 'path';
 
 export const importFile = createCachedDynamicImport(
   /* istanbul ignore next -- @preserve
@@ -6,3 +8,27 @@ export const importFile = createCachedDynamicImport(
   // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
   async () => globalThis.File ?? (await import('buffer')).File,
 );
+
+export function replaceFileExtension(filePath: string, newExtension: string) {
+  const parsedFilePath = path.parse(filePath);
+  return path.join(parsedFilePath.dir, `${parsedFilePath.name}.${newExtension}`);
+}
+
+export async function pathExists(path: string) {
+  try {
+    await fs.promises.access(path, fs.constants.R_OK);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+export async function ensurePathExists(path: string, options: { errorMessage: string }) {
+  try {
+    await fs.promises.access(path, fs.constants.R_OK);
+  } catch (accessError) {
+    const error = new Error(options.errorMessage);
+    error.cause = accessError;
+    throw error;
+  }
+}