feat: add bulk callback and async support for patch.schemas

[Copilot]

Large OpenAPI specs (e.g., DMTF Redfish with 1600+ schemas) require name-based transformations across all schemas. Current API forces explicit enumeration, which is impractical at scale.

Changes

• Type system: Extended patch.schemas to accept either Record<string, fn> (existing) or (name, schema) => void | Promise<void> (new bulk callback)
• Implementation: Added function type discrimination and iteration for both OpenAPI v2 (definitions) and v3 (components.schemas). All callbacks now properly awaited.
• Tests: Added coverage for bulk callbacks, async operations, version extraction pattern, and invalid schema handling for both spec versions.

Usage

// Before: enumerate every schema (impractical for 1600+ schemas)
patch: {
  schemas: {
    'ServiceRoot_v1_20_0': (schema) => { /* ... */ },
    // ... 1600+ more
  }
}

// After: single callback handles all, with async support
patch: {
  schemas: async (name, schema) => {
    const metadata = await fetchSchemaMetadata(name);
    const match = name.match(/_v(\d+)_(\d+)_(\d+)_/);
    if (match) {
      schema.description = `${schema.description}\n@version ${match[1]}.${match[2]}.${match[3]}`;
    }
  }
}

Backward compatible with existing Record-based usage.

Original prompt

---

This section details on the original issue you should resolve

<issue_title>patch.schemas — support bulk callback for all schemas</issue_title>
<issue_description>### Description

Use Case

When working with large specs like DMTF Redfish (~1600+ schemas), we need to apply transformations to every schema based on its name — not just to specific named schemas. For example, extracting version info from schema names and annotating descriptions:

// Current: must enumerate every schema by name (impractical for 1600+ schemas)
patch: {
  schemas: {
    'ServiceRoot_v1_20_0_ServiceRoot': (schema) => {
      schema.description += '\n@version 1.20.0';
    },
    // ... 1600+ more entries
  },
}

The only alternative today is patch.input, which works but is a much heavier tool for what is conceptually a per-schema operation.

Proposal

Allow patch.schemas to accept a function in addition to the existing Record<string, fn>. When a function is provided, it is called for every schema with (name, schema):

// Proposed: bulk callback receives (name, schema) for every schema
patch: {
  schemas: (name, schema) => {
    const match = name.match(/_v(\d+)_(\d+)_(\d+)_/);
    if (match) {
      schema.description = (schema.description || '') +
        `\n@version ${match[1]}.${match[2]}.${match[3]}`;
    }
  },
}

Suggested Implementation

In packages/shared/src/openApi/shared/utils/patch.ts, the existing schemas loop (line ~82) would add a function branch:

if (patchOptions.schemas && spec.components?.schemas) {
  if (typeof patchOptions.schemas === 'function') {
    for (const [key, schema] of Object.entries(spec.components.schemas)) {
      if (schema && typeof schema === 'object') {
        patchOptions.schemas(key, schema);
      }
    }
  } else {
    for (const key in patchOptions.schemas) {
      const schema = spec.components.schemas[key];
      if (!schema || typeof schema !== 'object') continue;
      patchOptions.schemas[key]!(schema);
    }
  }
}

The type in packages/shared/src/config/parser/patch.ts would become:

schemas?: Record<string, (schema: SchemaObject) => void>
  | ((name: string, schema: SchemaObject) => void);

Other Use Cases

This pattern is useful for any bulk per-schema transformation:

• Stripping vendor extensions (x-*) from all schemas
• Adding @deprecated based on naming conventions
• Injecting additionalProperties: false on all object schemas
• Normalizing description formatting

Applying the same pattern to patch.operations, patch.parameters, etc. would also be valuable.</issue_description>

<agent_instructions>Do as the man says</agent_instructions>

Comments on the Issue (you are @copilot in this section)

• Fixes patch.schemas — support bulk callback for all schemas #3413

---

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.

[bolt-new-by-stackblitz]

Run & review this pull request in StackBlitz Codeflow.

[changeset-bot]

🦋 Changeset detected

Latest commit: e494f4d

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 3 packages

Name	Type
@hey-api/shared	Patch
@hey-api/openapi-ts	Patch
@hey-api/openapi-python	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
hey-api-docs	Ready	Preview, Comment	Feb 18, 2026 10:38pm

[pullfrog]

Leaping into action...

  ^{｜ View workflow run ｜ Using OpenCode ｜ Triggered by Pullfrog ｜ pullfrog.com ｜ 𝕏}

[pkg-pr-new]

Open in StackBlitz

@hey-api/codegen-core

npm i https://pkg.pr.new/hey-api/openapi-ts/@hey-api/codegen-core@3415

@hey-api/json-schema-ref-parser

npm i https://pkg.pr.new/hey-api/openapi-ts/@hey-api/json-schema-ref-parser@3415

@hey-api/nuxt

npm i https://pkg.pr.new/hey-api/openapi-ts/@hey-api/nuxt@3415

@hey-api/openapi-ts

npm i https://pkg.pr.new/hey-api/openapi-ts/@hey-api/openapi-ts@3415

@hey-api/shared

npm i https://pkg.pr.new/hey-api/openapi-ts/@hey-api/shared@3415

@hey-api/types

npm i https://pkg.pr.new/hey-api/openapi-ts/@hey-api/types@3415

@hey-api/vite-plugin

npm i https://pkg.pr.new/hey-api/openapi-ts/@hey-api/vite-plugin@3415

commit: e494f4d

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 38.96%. Comparing base (ab6942f) to head (e494f4d).
⚠️ Report is 8 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #3415      +/-   ##
==========================================
+ Coverage   38.93%   38.96%   +0.03%     
==========================================
  Files         473      473              
  Lines       17292    17302      +10     
  Branches     5218     5218              
==========================================
+ Hits         6732     6742      +10     
  Misses       8480     8480              
  Partials     2080     2080              

Flag	Coverage Δ
unittests	38.96% <100.00%> (+0.03%)	⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.