How swytchcodehq/wrekenfile-converter works
Wrekenfile Converter is a TypeScript library and CLI that turns OpenAPI v3, OpenAPI v2/Swagger, and Postman inputs into execution-oriented Wrekenfile YAML. Consumers select a spec-version API or CLI; converters build method, input, response, authentication, schema, and signing metadata, then serialize YAML. The library also validates v1 files and splits generated files into standalone per-method mini-wrekenfiles. The v2 conversion utilities are grouped as an internal layer. Edges reflect README descriptions and indexed imports; unsampled implementation details are not inferred.
Main entry points: openapi-to-wreken.ts OpenAPI v3 v2 · openapi-v2-to-wrekenfile.ts Swagger v2 · postman-to-wrekenfile.ts Postman v2 · index.ts v2 API
Components 22
Spec conversion
- OpenAPI v3 v1
src/v1/openapi-to-wreken.ts - Swagger v1
src/v1/openapi-v2-to-wrekenfile.ts - Postman v1
src/v1/postman-to-wrekenfile.ts - OpenAPI v3 v2
src/v2/openapi-to-wreken.ts - Swagger v2
src/v2/openapi-v2-to-wrekenfile.ts - Postman v2
src/v2/postman-to-wrekenfile.ts
Shared conversion utilities
- Conversion utilities
src/v2/utils - Canonical IDs
src/v2/utils/canonical-id.ts - Authentication mapping
src/v2/utils/auth-utils.ts - Request signing
src/v2/utils/signing-utils.ts - Conversion statistics
src/v2/utils/conversion-stats.ts - YAML serialization
src/v2/utils/yaml-utils.ts - Version constants
src/versions.ts
Wrekenfile outputs
- Wrekenfile validation
src/v1/wrekenfile-validator.ts - Mini files v1
src/v1/mini-wrekenfile-generator.ts - Mini files v2
src/v2/mini-wrekenfile-generator.ts
Other components
- Library consumer
- CLI user
Connections 40
- Library consumer → v1 API: selects v1
README.md - Library consumer → v2 API: selects v2
README.md - CLI user → v1 CLI: runs commands
src/v1/cli/cli-openapi-to-wrekenfile.ts - CLI user → v2 CLI: runs commands
src/v2/cli/cli-openapi-to-wrekenfile.ts - v1 API → OpenAPI v3 v1: exports converter
src/v1/index.ts - v1 API → Swagger v1: exports converter
src/v1/index.ts - v1 API → Postman v1: exports converter
src/v1/index.ts - v2 API → OpenAPI v3 v2: exports converter
src/v2/index.ts - v2 API → Swagger v2: exports converter
src/v2/index.ts - v2 API → Postman v2: exports converter
src/v2/index.ts - v1 CLI → OpenAPI v3 v1: invokes
src/v1/cli/cli-openapi-to-wrekenfile.ts - v1 CLI → Postman v1: invokes
src/v1/cli/cli-postman-to-wrekenfile.ts - v1 CLI → Mini files v1: invokes
src/v1/cli/cli-mini-wrekenfile-generator.ts - v2 CLI → OpenAPI v3 v2: invokes
src/v2/cli/cli-openapi-to-wrekenfile.ts - v2 CLI → Swagger v2: invokes
src/v2/cli/cli-openapi-v2-to-wrekenfile.ts - v2 CLI → Postman v2: invokes
src/v2/cli/cli-postman-to-wrekenfile.ts - v2 CLI → Mini files v2: invokes
src/v2/cli/cli-mini-wrekenfile-generator.ts - OpenAPI v3 v2 → Conversion utilities: uses helpers
src/v2/openapi-to-wreken.ts - Swagger v2 → Conversion utilities: uses helpers
src/v2/openapi-v2-to-wrekenfile.ts - Postman v2 → Conversion utilities: uses helpers
src/v2/postman-to-wrekenfile.ts - OpenAPI v3 v2 → Canonical IDs: resolves IDs
src/v2/openapi-to-wreken.ts - Swagger v2 → Canonical IDs: resolves IDs
src/v2/openapi-v2-to-wrekenfile.ts - Postman v2 → Canonical IDs: resolves IDs
src/v2/postman-to-wrekenfile.ts - OpenAPI v3 v2 → Authentication mapping: maps auth
src/v2/openapi-to-wreken.ts - Swagger v2 → Authentication mapping: maps auth
src/v2/openapi-v2-to-wrekenfile.ts - Postman v2 → Authentication mapping: maps auth
src/v2/postman-to-wrekenfile.ts - OpenAPI v3 v2 → Request signing: handles recipes
src/v2/openapi-to-wreken.ts - Swagger v2 → Request signing: handles recipes
src/v2/openapi-v2-to-wrekenfile.ts - Postman v2 → Request signing: handles recipes
src/v2/postman-to-wrekenfile.ts - OpenAPI v3 v2 → Conversion statistics: reports stats
src/v2/index.ts - v2 API → Version constants: exports versioning
src/v2/index.ts - Library consumer → Wrekenfile validation: validates file
README.md - Library consumer → Mini files v1: generates minis
README.md - Library consumer → Mini files v2: generates minis
README.md - OpenAPI v3 v1 → Mini files v1: produces YAML for
- OpenAPI v3 v2 → YAML serialization: serializes output
src/v2/openapi-to-wreken.ts - Swagger v2 → YAML serialization: serializes output
src/v2/openapi-v2-to-wrekenfile.ts - Postman v2 → YAML serialization: serializes output
src/v2/postman-to-wrekenfile.ts - v2 API → Mini files v2: exports generator
src/v2/index.ts - v1 API → Mini files v1: exposes generator
README.md