fetcher-openapi-types git:20260924.71dc2fbA

Immutable. This exact content never changes and is served at /api/v1/blob/f5db1b083af6de99.

---
name: fetcher-openapi-types
description: >
  Model OpenAPI 3.x documents with `@ahoo-wang/fetcher-openapi` types for schemas, operations, parameters, responses, security, components, references, and extensions. Use for the type layer or generator internals, not client generation execution.
---

# fetcher-openapi-types

## Workflow

1. Identify the OpenAPI object category first: document, path, operation, schema, parameter, response, security, component, or extension.
2. Use reference-aware types when values may be inline objects or `$ref` references.
3. Keep extension fields behind explicit extension types instead of broad untyped records when possible.
4. Use generator-focused types only when the task needs code generation metadata.
5. Load `references/api.md` for the full exported type map and quick reference.

## Key Practices

- Do not use this skill to generate clients; generation lives in `@ahoo-wang/wow-generator` and its `wow-generator` skill in the Wow repository.
- Prefer precise OpenAPI vocabulary over informal API terms when naming types.
- Keep schema composition and polymorphism explicit so generator behavior remains predictable.

## References

- `references/api.md`: Detailed package API, examples, and edge-case guidance. Load it only when the task needs complete exported type lists, schema variants, operation fields, parameter and response types, security types, components, references, and extension utilities.

## Related Skills

- $fetcher-integration: Use for runtime HTTP client behavior.