diff --git a/docs/README.md b/docs/README.md
index 6f71a56d..9950332d 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -47,6 +47,7 @@ Each input has its own limitations, corner cases, and features; thus, each has s
 - [AsyncAPI](./inputs/asyncapi.md)
 - [OpenAPI](./inputs/openapi.md)
 - [JSON Schema](./inputs/jsonschema.md)
+- [EventCatalog](./inputs/eventcatalog.md)
 
 ### Protocols
 Each protocol has its own limitations, corner cases, and features; thus, each has separate documentation.
diff --git a/docs/configurations.md b/docs/configurations.md
index 2e2d4ba1..d04b0c5c 100644
--- a/docs/configurations.md
+++ b/docs/configurations.md
@@ -58,6 +58,15 @@ If no explicit configuration file is sat, it will be looked for in the following
 - codegen.mjs
 - codegen.cjs
 
+## Input Types
+
+The `inputType` field selects which input pipeline drives generation. Supported values:
+
+- `'asyncapi'` — AsyncAPI 2.x / 3.x documents. See [AsyncAPI input](./inputs/asyncapi.md).
+- `'openapi'` — Swagger 2.0 / OpenAPI 3.0 / 3.1 documents. See [OpenAPI input](./inputs/openapi.md).
+- `'jsonschema'` — Standalone JSON Schema documents. See [JSON Schema input](./inputs/jsonschema.md).
+- `'eventcatalog'` — An [EventCatalog](https://eventcatalog.dev) directory; the loader picks one service via the required `service` field and forwards generation through the AsyncAPI or OpenAPI pipeline. See [EventCatalog input](./inputs/eventcatalog.md).
+
 ## TypeScript Configuration
 
 When generating TypeScript code, you can configure global options that apply to all generators. These options can be overridden per-generator if needed.
diff --git a/docs/getting-started/README.md b/docs/getting-started/README.md
index ed898735..7508bdff 100644
--- a/docs/getting-started/README.md
+++ b/docs/getting-started/README.md
@@ -192,6 +192,6 @@ Discover how The Codegen Project supports various messaging protocols like NATS,
 ### Explore Further
 - **[Generator Documentation](../generators/README.md)** - Detailed documentation for each generator type
 - **[Protocol Documentation](../protocols/)** - Complete protocol reference and implementation details
-- **[Input Types](../inputs/)** - Learn about AsyncAPI, OpenAPI, and JSON Schema support
+- **[Input Types](../inputs/)** - Learn about AsyncAPI, OpenAPI, JSON Schema, and EventCatalog support
 - **[Examples](../../examples/)** - Real-world examples and integration patterns
 
diff --git a/docs/inputs/eventcatalog.md b/docs/inputs/eventcatalog.md
new file mode 100644
index 00000000..8492b065
--- /dev/null
+++ b/docs/inputs/eventcatalog.md
@@ -0,0 +1,146 @@
+---
+sidebar_position: 99
+---
+
+# EventCatalog
+
+[EventCatalog](https://eventcatalog.dev) is a documentation tool that organizes events, services, and domains in a single browsable catalog. The Codegen Project can read an EventCatalog directory directly and generate code for a chosen service — no need to maintain a separate AsyncAPI/OpenAPI file alongside the catalog.
+
+The loader is a translation layer: it picks the requested service, follows its `specifications` block (or its `sends`/`receives` events for native mode), and routes the run through the existing AsyncAPI or OpenAPI pipeline. As a result, every preset that works for those input types works here too.
+
+## Supported Generators
+
+| **Presets** | EventCatalog |
+|---|---|
+| [`payloads`](../generators/payloads.md) | ✅ |
+| [`parameters`](../generators/parameters.md) | ✅ |
+| [`headers`](../generators/headers.md) | ✅ |
+| [`types`](../generators/types.md) | ✅ |
+| [`channels`](../generators/channels.md) | ✅ |
+| [`client`](../generators/client.md) | ✅ * |
+| [`custom`](../generators/custom.md) | ✅ |
+| [`models`](../generators/models.md) | ✅ |
+
+\* The `client` preset is currently only generated when the resolved spec is AsyncAPI; OpenAPI services do not produce a client wrapper.
+
+## Configuration
+
+| Field | Required | Description |
+|---|---|---|
+| `inputType` | yes | Must be `'eventcatalog'`. |
+| `inputPath` | yes | Path (or remote URL) to the EventCatalog root — the directory that contains `services/`. |
+| `service` | yes | The `id` of the service inside `services/<id>/index.md` to generate from. |
+| `specType` | no | Set to `'asyncapi'` or `'openapi'` to disambiguate when a service declares both `asyncapiPath` and `openapiPath`. |
+| `auth` | no | Bearer / apiKey / custom auth used when the service's spec path is a remote URL. See [configurations guide](../configurations.md#remote-url-inputs). |
+
+```js
+export default {
+  inputType: 'eventcatalog',
+  inputPath: './eventcatalog',
+  service: 'user-service',
+  language: 'typescript',
+  generators: [
+    { preset: 'payloads', outputPath: './src/payloads' },
+    { preset: 'channels', outputPath: './src/channels', protocols: ['nats'] },
+    { preset: 'client', outputPath: './src/client', protocols: ['nats'] }
+  ]
+};
+```
+
+## The three modes
+
+The loader picks one of three modes based on the selected service's `index.md` frontmatter.
+
+### 1. AsyncAPI service
+
+The service declares an `asyncapiPath` under `specifications`. The loader reads that file and runs the AsyncAPI pipeline.
+
+```yaml
+---
+id: user-service
+name: User Service
+specifications:
+  asyncapiPath: asyncapi.yaml
+---
+```
+
+### 2. OpenAPI service
+
+The service declares an `openapiPath` under `specifications`. The loader reads that file and runs the OpenAPI pipeline.
+
+```yaml
+---
+id: petstore-api
+name: Petstore API
+specifications:
+  openapiPath: openapi.json
+---
+```
+
+### 3. Native service (no `specifications`)
+
+The service has no spec file but does list `sends` / `receives` events. The loader walks each referenced event under `events/<event-id>/`, reads its `schema.json` (or whatever `schemaPath` is set in the event's frontmatter), and **synthesizes an AsyncAPI 3.0 document** from the result. That synthesized document then drives every downstream generator, so presets like `channels` and `client` work seamlessly without you authoring an AsyncAPI file.
+
+```yaml
+---
+id: order-service
+name: Order Service
+sends:
+  - id: OrderCreated
+    version: 1.0.0
+receives:
+  - id: OrderShipped
+    version: 1.0.0
+---
+```
+
+#### Native-mode synthesis rules
+
+For each `sends[i]` event the synthesized document contains:
+- a channel keyed by the event id, with a single message whose payload is the event's schema content
+- an operation `send<EventId>` with `action: 'send'` referring to that channel
+
+Each `receives[i]` event produces the same channel/message pair but with `action: 'receive'`. The synthesized `info` block uses:
+- `info.title` = `service.name` (falls back to `service.id`)
+- `info.version` = `service.version` (falls back to `'1.0.0'`)
+- `info.description` = `service.summary` when present
+
+If you need richer mappings — multi-message channels, parameters, status-code variants, etc. — author a real AsyncAPI document and reference it via `specifications.asyncapiPath` instead.
+
+## Both-specs services
+
+If a service declares **both** `asyncapiPath` and `openapiPath`, the loader needs to know which one to follow. Set `specType` on the configuration:
+
+```js
+export default {
+  inputType: 'eventcatalog',
+  inputPath: './eventcatalog',
+  service: 'order-service',
+  specType: 'openapi',
+  language: 'typescript',
+  generators: [/* … */]
+};
+```
+
+If `specType` is missing the loader throws a descriptive error so the run fails early with a clear next step. Generating from both specs in a single run is **not supported** in this version (see the limitations section). The recommended workaround is to keep two separate config files — one with `specType: 'asyncapi'`, one with `specType: 'openapi'` — and run them independently.
+
+## Remote URLs in `asyncapiPath` / `openapiPath`
+
+If your service frontmatter points to a remote URL instead of a local file, the loader fetches it the same way the underlying input pipeline does. The `auth` field on your codegen configuration is passed through unchanged. See the [remote URL inputs section](../configurations.md#remote-url-inputs) of the configurations guide for the full set of auth options and security considerations.
+
+## Examples
+
+The repository ships three end-to-end examples under `examples/`:
+
+- `examples/eventcatalog-asyncapi/` — a service backed by a real AsyncAPI 3.0 document
+- `examples/eventcatalog-openapi/` — a service backed by an OpenAPI 3.0 document
+- `examples/eventcatalog-native/` — a service with no spec file, demonstrating the native-mode synthesis
+
+Each example contains an `eventcatalog/` directory plus a `codegen.config.mjs` that mirrors the snippets above. Running `npx codegen generate` inside any of the three produces the generated TypeScript directly.
+
+## Limitations
+
+- **Dual-spec generation in one run is not supported.** Use two configs and run them sequentially.
+- **`domains/` and `flows/` are ignored.** Only the selected service plus the events it directly references are read.
+- **Cross-service event references aren't resolved.** Events referenced via `receives` are loaded from the catalog's `events/<id>/` directory, not from the producing service.
+- **Browser mode is not supported.** EventCatalog is filesystem-bound; the browser bundle returns a clear error when invoked with `specFormat: 'eventcatalog'`. Use AsyncAPI / OpenAPI / JSON Schema directly in the browser.
diff --git a/docs/telemetry.md b/docs/telemetry.md
index 0550dee6..c5f19372 100644
--- a/docs/telemetry.md
+++ b/docs/telemetry.md
@@ -245,7 +245,7 @@ Example configuration:
 {
   event: 'generator_used',
   generator_type: 'payloads',
-  input_type: 'asyncapi',          // Can be: asyncapi, openapi, jsonschema
+  input_type: 'asyncapi',          // Can be: asyncapi, openapi, jsonschema, eventcatalog
   input_source: 'remote_url',      // Not the actual URL!
   language: 'typescript',
   options: '{"includeValidation":true,"serializationType":"json"}',
diff --git a/docs/usage.md b/docs/usage.md
index dbf0687c..d35d1a7b 100644
--- a/docs/usage.md
+++ b/docs/usage.md
@@ -140,9 +140,10 @@ Initialize The Codegen Project in your project
 ```
 USAGE
   $ codegen init [--json] [--no-color] [--debug |  | [--silent | -v | -q]] [--help] [--input-file <value>]
-    [--config-name <value>] [--input-type asyncapi|openapi] [--output-directory <value>] [--config-type
-    esm|json|yaml|ts] [--languages typescript] [--no-tty] [--include-payloads] [--include-headers] [--include-client]
-    [--include-parameters] [--include-channels] [--gitignore-generated]
+    [--config-name <value>] [--input-type asyncapi|openapi|jsonschema|eventcatalog] [--service <value>]
+    [--output-directory <value>] [--config-type esm|json|yaml|ts] [--languages typescript] [--no-tty]
+    [--include-payloads] [--include-headers] [--include-client] [--include-parameters] [--include-channels]
+    [--gitignore-generated]
 
 FLAGS
   -q, --quiet                     Only show errors and warnings
@@ -163,7 +164,7 @@ FLAGS
       --include-payloads          Include payloads generation, available for TypeScript
       --input-file=<value>        File path for the code generation input such as AsyncAPI document
       --input-type=<option>       Input file type
-                                  <options: asyncapi|openapi>
+                                  <options: asyncapi|openapi|jsonschema|eventcatalog>
       --json                      Output results as JSON for scripting
       --languages=<option>        Which languages do you wish to generate code for?
                                   <options: typescript>
@@ -172,6 +173,8 @@ FLAGS
       --output-directory=<value>  [default: ./] Output configuration location, path to where the configuration file
                                   should be located. If relative path, the current working directory of the terminal
                                   will be used
+      --service=<value>           Service ID inside the EventCatalog directory (only used with
+                                  --input-type=eventcatalog)
       --silent                    Suppress all output except fatal errors
 
 DESCRIPTION
diff --git a/examples/README.md b/examples/README.md
index 14f15714..bc2e15ce 100644
--- a/examples/README.md
+++ b/examples/README.md
@@ -28,6 +28,15 @@ An example demonstrating how to generate complete, type-safe client SDKs for NAT
 ### [E-commerce AsyncAPI Types](./ecommerce-asyncapi-types/)
 A comprehensive example showing how to generate TypeScript types from AsyncAPI specifications for an e-commerce messaging system.
 
+### [EventCatalog + AsyncAPI](./eventcatalog-asyncapi/)
+An example demonstrating how to generate TypeScript code from AsyncAPI specifications stored in an [EventCatalog](https://eventcatalog.dev/). Shows how to use The Codegen Project with EventCatalog's service documentation structure.
+
+### [EventCatalog + OpenAPI](./eventcatalog-openapi/)
+An example demonstrating how to generate a TypeScript HTTP client from OpenAPI specifications stored in an [EventCatalog](https://eventcatalog.dev/). Shows how to use The Codegen Project with EventCatalog's API documentation structure.
+
+### [EventCatalog Native](./eventcatalog-native/)
+An example showing the native EventCatalog structure with markdown documentation and JSON Schema files, without AsyncAPI or OpenAPI specifications. Demonstrates generating models directly from EventCatalog event schemas.
+
 ## Getting Started
 
 1. Choose an example that matches your use case
diff --git a/examples/eventcatalog-asyncapi/.gitignore b/examples/eventcatalog-asyncapi/.gitignore
new file mode 100644
index 00000000..69aa5535
--- /dev/null
+++ b/examples/eventcatalog-asyncapi/.gitignore
@@ -0,0 +1,9 @@
+# Generated code
+src/
+
+# Dependencies
+node_modules/
+eventcatalog/node_modules/
+
+# Build artifacts
+.eventcatalog/
diff --git a/examples/eventcatalog-asyncapi/README.md b/examples/eventcatalog-asyncapi/README.md
new file mode 100644
index 00000000..01418323
--- /dev/null
+++ b/examples/eventcatalog-asyncapi/README.md
@@ -0,0 +1,72 @@
+# EventCatalog + AsyncAPI Example
+
+This example demonstrates the **proposed** EventCatalog integration where a service has an AsyncAPI specification attached.
+
+> **Note**: This is a showcase of the proposed `inputType: 'eventcatalog'` configuration. This feature does not exist yet.
+
+## Configuration
+
+```javascript
+// codegen.config.mjs
+export default {
+  inputType: 'eventcatalog',
+  inputPath: './eventcatalog',
+  service: 'user-service',  // Service with asyncapiPath
+  language: 'typescript',
+  generators: [
+    { preset: 'payloads', outputPath: './src/payloads' },
+    { preset: 'channels', outputPath: './src/channels', protocols: ['nats'] },
+    { preset: 'client', outputPath: './src/client', protocols: ['nats'] },
+  ],
+};
+```
+
+## How It Works
+
+1. Read EventCatalog at `./eventcatalog`
+2. Find `user-service` in `services/`
+3. Detect `asyncapiPath: asyncapi.yaml` in service metadata
+4. Load and parse the AsyncAPI spec
+5. Generate code using AsyncAPI processing
+
+## Service Metadata
+
+The service's `index.md` declares its AsyncAPI spec:
+
+```yaml
+---
+id: user-service
+name: User Service
+version: 1.0.0
+specifications:
+  asyncapiPath: asyncapi.yaml  # <-- Auto-detected
+---
+```
+
+## Project Structure
+
+```
+eventcatalog-asyncapi/
+├── codegen.config.mjs
+├── eventcatalog/
+│   ├── eventcatalog.config.js
+│   ├── domains/user-domain/index.md
+│   ├── services/user-service/
+│   │   ├── index.md            # Has asyncapiPath in metadata
+│   │   └── asyncapi.yaml       # AsyncAPI 3.0 spec
+│   └── events/UserSignedUp/index.md
+└── src/                        # Generated code
+```
+
+## Auto-Detection Logic
+
+| Service Metadata | Processing |
+|------------------|------------|
+| `asyncapiPath: ...` | AsyncAPI processing |
+| `openapiPath: ...` | OpenAPI processing |
+| Neither (just `sends`/`receives`) | Native JSON Schema |
+
+## Related Examples
+
+- [eventcatalog-openapi](../eventcatalog-openapi/) - Service with OpenAPI spec
+- [eventcatalog-native](../eventcatalog-native/) - Service with native JSON Schema events
diff --git a/examples/eventcatalog-asyncapi/codegen.config.mjs b/examples/eventcatalog-asyncapi/codegen.config.mjs
new file mode 100644
index 00000000..2c89b9db
--- /dev/null
+++ b/examples/eventcatalog-asyncapi/codegen.config.mjs
@@ -0,0 +1,47 @@
+/**
+ * Codegen configuration for EventCatalog with an AsyncAPI service.
+ *
+ * The loader reads the selected service's frontmatter, sees that
+ * user-service declares `specifications.asyncapiPath: asyncapi.yaml`,
+ * and routes generation through the AsyncAPI pipeline.
+ *
+ * @type {import("@the-codegen-project/cli").TheCodegenConfiguration}
+ */
+export default {
+  inputType: 'eventcatalog',
+  inputPath: './eventcatalog',
+  language: 'typescript',
+
+  // Select which service to generate code for
+  service: 'user-service',
+
+  generators: [
+    {
+      preset: 'payloads',
+      outputPath: './src/payloads',
+      serializationType: 'json',
+    },
+    {
+      preset: 'parameters',
+      outputPath: './src/parameters',
+    },
+    {
+      preset: 'headers',
+      outputPath: './src/headers',
+    },
+    {
+      preset: 'types',
+      outputPath: './src',
+    },
+    {
+      preset: 'channels',
+      outputPath: './src/channels',
+      protocols: ['nats'],
+    },
+    {
+      preset: 'client',
+      outputPath: './src/client',
+      protocols: ['nats'],
+    },
+  ],
+};
diff --git a/examples/eventcatalog-asyncapi/eventcatalog/domains/user-domain/index.md b/examples/eventcatalog-asyncapi/eventcatalog/domains/user-domain/index.md
new file mode 100644
index 00000000..89fa92bc
--- /dev/null
+++ b/examples/eventcatalog-asyncapi/eventcatalog/domains/user-domain/index.md
@@ -0,0 +1,41 @@
+---
+id: user-domain
+name: User Domain
+version: 1.0.0
+summary: Domain responsible for all user-related functionality
+owners:
+  - platform-team
+services:
+  - id: user-service
+    version: 1.0.0
+badges:
+  - content: Core Domain
+    backgroundColor: blue
+    textColor: white
+---
+
+## Overview
+
+The User Domain encompasses all functionality related to user management, including:
+
+- User registration and authentication
+- Profile management
+- User preferences
+- Account lifecycle
+
+## Bounded Context
+
+This domain owns the concept of a "User" and is the source of truth for user identity and profile information.
+
+## Services
+
+| Service | Description |
+|---------|-------------|
+| User Service | Core service for user operations |
+
+## Events
+
+| Event | Published By | Description |
+|-------|--------------|-------------|
+| UserSignedUp | User Service | New user registration |
+| UserProfileUpdated | User Service | Profile changes |
diff --git a/examples/eventcatalog-asyncapi/eventcatalog/eventcatalog.config.js b/examples/eventcatalog-asyncapi/eventcatalog/eventcatalog.config.js
new file mode 100644
index 00000000..c0c0f52f
--- /dev/null
+++ b/examples/eventcatalog-asyncapi/eventcatalog/eventcatalog.config.js
@@ -0,0 +1,28 @@
+/** @type {import('@eventcatalog/core/bin/eventcatalog.config').Config} */
+export default {
+  title: 'User Domain Catalog',
+  tagline: 'Event-driven architecture documentation for the user domain',
+  organizationName: 'Acme Corp',
+  homepageLink: 'https://eventcatalog.dev/',
+  landingPage: '',
+  editUrl: 'https://github.com/acme-corp/eventcatalog/edit/main',
+  trailingSlash: false,
+  base: '/',
+  logo: {
+    alt: 'EventCatalog Logo',
+    src: '/logo.png',
+  },
+  docs: {
+    sidebar: {
+      showPageHeadings: true,
+    },
+  },
+  generators: [
+    // AsyncAPI generator can auto-populate the catalog from spec files
+    // ['@eventcatalog/generator-asyncapi', {
+    //   services: [
+    //     { path: './services/user-service/asyncapi.yaml' }
+    //   ]
+    // }]
+  ],
+};
diff --git a/examples/eventcatalog-asyncapi/eventcatalog/events/UserSignedUp/index.md b/examples/eventcatalog-asyncapi/eventcatalog/events/UserSignedUp/index.md
new file mode 100644
index 00000000..ab3fa4f6
--- /dev/null
+++ b/examples/eventcatalog-asyncapi/eventcatalog/events/UserSignedUp/index.md
@@ -0,0 +1,48 @@
+---
+id: UserSignedUp
+name: User Signed Up
+version: 1.0.0
+summary: Event published when a new user successfully registers
+badges:
+  - content: Core Event
+    backgroundColor: green
+    textColor: white
+owners:
+  - user-team
+schemaPath: schema.json
+---
+
+## Overview
+
+The `UserSignedUp` event is published by the User Service whenever a new user successfully completes the registration process. This event is a key integration point for downstream services.
+
+## Consumers
+
+| Service | Purpose |
+|---------|---------|
+| Notification Service | Send welcome email |
+| Analytics Service | Track signup metrics |
+| Onboarding Service | Initialize user onboarding flow |
+
+## Payload Example
+
+```json
+{
+  "userId": "550e8400-e29b-41d4-a716-446655440000",
+  "email": "john.doe@example.com",
+  "displayName": "John Doe",
+  "signupTimestamp": "2024-01-15T10:30:00Z",
+  "signupSource": "web",
+  "metadata": {
+    "referralCode": "FRIEND123"
+  }
+}
+```
+
+## Headers
+
+| Header | Type | Description |
+|--------|------|-------------|
+| correlationId | UUID | Request tracing ID |
+| timestamp | ISO 8601 | Event timestamp |
+| version | String | Schema version |
diff --git a/examples/eventcatalog-asyncapi/eventcatalog/package.json b/examples/eventcatalog-asyncapi/eventcatalog/package.json
new file mode 100644
index 00000000..1adbe422
--- /dev/null
+++ b/examples/eventcatalog-asyncapi/eventcatalog/package.json
@@ -0,0 +1,19 @@
+{
+  "name": "user-domain-eventcatalog",
+  "version": "1.0.0",
+  "description": "EventCatalog for user domain services",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "eventcatalog dev",
+    "build": "eventcatalog build",
+    "preview": "eventcatalog preview",
+    "generate": "eventcatalog generate"
+  },
+  "dependencies": {
+    "@eventcatalog/core": "^2.0.0"
+  },
+  "devDependencies": {
+    "@eventcatalog/sdk": "^1.0.0"
+  }
+}
diff --git a/examples/eventcatalog-asyncapi/eventcatalog/services/user-service/asyncapi.yaml b/examples/eventcatalog-asyncapi/eventcatalog/services/user-service/asyncapi.yaml
new file mode 100644
index 00000000..6e6cccdf
--- /dev/null
+++ b/examples/eventcatalog-asyncapi/eventcatalog/services/user-service/asyncapi.yaml
@@ -0,0 +1,170 @@
+asyncapi: 3.0.0
+info:
+  title: User Service
+  version: 1.0.0
+  description: |
+    The User Service handles user registration, authentication, and profile management.
+    It publishes events to notify other services about user-related activities.
+  contact:
+    name: User Team
+    email: user-team@acme.com
+  license:
+    name: Apache 2.0
+    url: https://www.apache.org/licenses/LICENSE-2.0
+
+servers:
+  production:
+    host: nats.acme.com:4222
+    protocol: nats
+    description: Production NATS server
+  development:
+    host: localhost:4222
+    protocol: nats
+    description: Local development NATS server
+
+channels:
+  userSignedup:
+    address: user/signedup/{region}
+    description: Channel for user signup events
+    parameters:
+      region:
+        description: The region where the user signed up
+        enum:
+          - us-east
+          - us-west
+          - eu-west
+          - ap-south
+    messages:
+      UserSignedUp:
+        $ref: '#/components/messages/UserSignedUp'
+
+  userProfileUpdated:
+    address: user/profile/updated
+    description: Channel for user profile update events
+    messages:
+      UserProfileUpdated:
+        $ref: '#/components/messages/UserProfileUpdated'
+
+operations:
+  publishUserSignedup:
+    action: send
+    summary: Publish user signup event
+    description: |
+      Publishes an event when a new user successfully completes registration.
+      This event is consumed by notification, analytics, and onboarding services.
+    channel:
+      $ref: '#/channels/userSignedup'
+    messages:
+      - $ref: '#/channels/userSignedup/messages/UserSignedUp'
+
+  publishUserProfileUpdated:
+    action: send
+    summary: Publish user profile updated event
+    description: Publishes an event when a user updates their profile information.
+    channel:
+      $ref: '#/channels/userProfileUpdated'
+    messages:
+      - $ref: '#/channels/userProfileUpdated/messages/UserProfileUpdated'
+
+components:
+  messages:
+    UserSignedUp:
+      name: UserSignedUp
+      title: User Signed Up Event
+      summary: Event published when a new user registers
+      contentType: application/json
+      payload:
+        $ref: '#/components/schemas/UserSignedUpPayload'
+      headers:
+        $ref: '#/components/schemas/EventHeaders'
+
+    UserProfileUpdated:
+      name: UserProfileUpdated
+      title: User Profile Updated Event
+      summary: Event published when a user updates their profile
+      contentType: application/json
+      payload:
+        $ref: '#/components/schemas/UserProfileUpdatedPayload'
+      headers:
+        $ref: '#/components/schemas/EventHeaders'
+
+  schemas:
+    UserSignedUpPayload:
+      type: object
+      description: Payload for user signup events
+      required:
+        - userId
+        - email
+        - signupTimestamp
+      properties:
+        userId:
+          type: string
+          format: uuid
+          description: Unique identifier for the user
+          example: '550e8400-e29b-41d4-a716-446655440000'
+        email:
+          type: string
+          format: email
+          description: User's email address
+          example: 'john.doe@example.com'
+        displayName:
+          type: string
+          description: User's display name
+          example: 'John Doe'
+        signupTimestamp:
+          type: string
+          format: date-time
+          description: Timestamp when the user signed up
+          example: '2024-01-15T10:30:00Z'
+        signupSource:
+          type: string
+          enum:
+            - web
+            - mobile
+            - api
+          description: Source of the signup
+          example: 'web'
+        metadata:
+          type: object
+          additionalProperties: true
+          description: Additional metadata about the signup
+
+    UserProfileUpdatedPayload:
+      type: object
+      description: Payload for user profile update events
+      required:
+        - userId
+        - updatedFields
+        - updateTimestamp
+      properties:
+        userId:
+          type: string
+          format: uuid
+          description: Unique identifier for the user
+        updatedFields:
+          type: array
+          items:
+            type: string
+          description: List of fields that were updated
+          example: ['displayName', 'avatar']
+        updateTimestamp:
+          type: string
+          format: date-time
+          description: Timestamp when the profile was updated
+
+    EventHeaders:
+      type: object
+      description: Common headers for all events
+      properties:
+        correlationId:
+          type: string
+          format: uuid
+          description: Correlation ID for request tracing
+        timestamp:
+          type: string
+          format: date-time
+          description: Event timestamp
+        version:
+          type: string
+          description: Event schema version
+          example: '1.0.0'
diff --git a/examples/eventcatalog-asyncapi/eventcatalog/services/user-service/index.md b/examples/eventcatalog-asyncapi/eventcatalog/services/user-service/index.md
new file mode 100644
index 00000000..b541e169
--- /dev/null
+++ b/examples/eventcatalog-asyncapi/eventcatalog/services/user-service/index.md
@@ -0,0 +1,61 @@
+---
+id: user-service
+name: User Service
+version: 1.0.0
+summary: Handles user registration, authentication, and profile management
+owners:
+  - user-team
+badges:
+  - content: AsyncAPI
+    backgroundColor: purple
+    textColor: white
+  - content: Production
+    backgroundColor: green
+    textColor: white
+sends:
+  - id: UserSignedUp
+    version: 1.0.0
+receives: []
+repository:
+  language: TypeScript
+  url: https://github.com/acme-corp/user-service
+specifications:
+  asyncapiPath: asyncapi.yaml
+---
+
+## Overview
+
+The User Service is responsible for all user-related operations in the platform. It publishes events when users perform actions like signing up, updating their profile, or changing their preferences.
+
+## Architecture
+
+```mermaid
+graph LR
+    A[Client] --> B[User Service]
+    B --> C[NATS]
+    C --> D[Notification Service]
+    C --> E[Analytics Service]
+```
+
+## Events Published
+
+| Event | Description |
+|-------|-------------|
+| UserSignedUp | Published when a new user registers |
+
+## Getting Started
+
+```bash
+# Install dependencies
+npm install
+
+# Start the service
+npm run start
+```
+
+## Configuration
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `NATS_URL` | NATS server URL | `nats://localhost:4222` |
+| `DATABASE_URL` | PostgreSQL connection string | - |
diff --git a/examples/eventcatalog-asyncapi/package.json b/examples/eventcatalog-asyncapi/package.json
new file mode 100644
index 00000000..0c691a96
--- /dev/null
+++ b/examples/eventcatalog-asyncapi/package.json
@@ -0,0 +1,18 @@
+{
+  "name": "eventcatalog-asyncapi-example",
+  "version": "1.0.0",
+  "description": "Example: Generate TypeScript code from EventCatalog AsyncAPI specs",
+  "type": "module",
+  "scripts": {
+    "generate": "codegen generate",
+    "generate:watch": "codegen generate --watch",
+    "catalog:dev": "cd eventcatalog && npm run dev",
+    "catalog:build": "cd eventcatalog && npm run build"
+  },
+  "devDependencies": {
+    "@the-codegen-project/cli": "latest"
+  },
+  "dependencies": {
+    "nats": "^2.18.0"
+  }
+}
diff --git a/examples/eventcatalog-native/.gitignore b/examples/eventcatalog-native/.gitignore
new file mode 100644
index 00000000..69aa5535
--- /dev/null
+++ b/examples/eventcatalog-native/.gitignore
@@ -0,0 +1,9 @@
+# Generated code
+src/
+
+# Dependencies
+node_modules/
+eventcatalog/node_modules/
+
+# Build artifacts
+.eventcatalog/
diff --git a/examples/eventcatalog-native/README.md b/examples/eventcatalog-native/README.md
new file mode 100644
index 00000000..b7c0625b
--- /dev/null
+++ b/examples/eventcatalog-native/README.md
@@ -0,0 +1,93 @@
+# EventCatalog Native Example
+
+This example demonstrates the **proposed** EventCatalog integration where a service uses native EventCatalog events with JSON Schema (no AsyncAPI or OpenAPI specs).
+
+> **Note**: This is a showcase of the proposed `inputType: 'eventcatalog'` configuration. This feature does not exist yet.
+
+## Configuration
+
+```javascript
+// codegen.config.mjs
+export default {
+  inputType: 'eventcatalog',
+  inputPath: './eventcatalog',
+  service: 'order-service',  // Service with sends/receives only
+  language: 'typescript',
+  generators: [
+    { preset: 'payloads', outputPath: './src/payloads' },
+    { preset: 'channels', outputPath: './src/channels', protocols: ['nats'] },
+    { preset: 'client', outputPath: './src/client', protocols: ['nats'] },
+  ],
+};
+```
+
+## How It Works
+
+1. Read EventCatalog at `./eventcatalog`
+2. Find `order-service` in `services/`
+3. No `asyncapiPath` or `openapiPath` → use native processing
+4. Read `sends: [OrderCreated, OrderShipped]` from service metadata
+5. Load `schema.json` from each event
+6. Generate code from JSON Schemas
+
+## Service Metadata
+
+The service's `index.md` declares which events it sends/receives:
+
+```yaml
+---
+id: order-service
+name: Order Service
+version: 1.0.0
+sends:
+  - id: OrderCreated
+    version: 1.0.0
+  - id: OrderShipped
+    version: 1.0.0
+receives: []
+# No asyncapiPath or openapiPath → native processing
+---
+```
+
+## Project Structure
+
+```
+eventcatalog-native/
+├── codegen.config.mjs
+├── eventcatalog/
+│   ├── eventcatalog.config.js
+│   ├── domains/ecommerce/index.md
+│   ├── services/
+│   │   ├── order-service/index.md      # sends: [OrderCreated, OrderShipped]
+│   │   └── inventory-service/index.md  # sends: [StockUpdated]
+│   └── events/
+│       ├── OrderCreated/
+│       │   ├── index.md
+│       │   └── schema.json             # JSON Schema for payload
+│       ├── OrderShipped/
+│       │   ├── index.md
+│       │   └── schema.json
+│       └── StockUpdated/
+│           ├── index.md
+│           └── schema.json
+└── src/                                # Generated code
+```
+
+## Auto-Detection Logic
+
+| Service Metadata | Processing |
+|------------------|------------|
+| `asyncapiPath: ...` | AsyncAPI processing |
+| `openapiPath: ...` | OpenAPI processing |
+| Neither (just `sends`/`receives`) | **Native JSON Schema** |
+
+## Benefits of Native
+
+- **No spec duplication** - EventCatalog is the source of truth
+- **Simpler setup** - Just markdown + JSON Schema
+- **Service-centric** - Events discovered from service relationships
+
+## Related Examples
+
+- [eventcatalog-asyncapi](../eventcatalog-asyncapi/) - Service with AsyncAPI spec
+- [eventcatalog-openapi](../eventcatalog-openapi/) - Service with OpenAPI spec
diff --git a/examples/eventcatalog-native/codegen.config.mjs b/examples/eventcatalog-native/codegen.config.mjs
new file mode 100644
index 00000000..dc054fbd
--- /dev/null
+++ b/examples/eventcatalog-native/codegen.config.mjs
@@ -0,0 +1,35 @@
+/**
+ * Codegen configuration for a native EventCatalog service.
+ *
+ * The order-service has no specifications block, so the loader walks the
+ * `sends`/`receives` references and synthesizes an AsyncAPI 3.0 document
+ * (one channel per event) which then drives the AsyncAPI generators.
+ *
+ * @type {import("@the-codegen-project/cli").TheCodegenConfiguration}
+ */
+export default {
+  inputType: 'eventcatalog',
+  inputPath: './eventcatalog',
+  language: 'typescript',
+
+  // Select which service to generate code for
+  service: 'order-service',
+
+  generators: [
+    {
+      preset: 'payloads',
+      outputPath: './src/payloads',
+      serializationType: 'json',
+    },
+    {
+      preset: 'channels',
+      outputPath: './src/channels',
+      protocols: ['nats'],
+    },
+    {
+      preset: 'client',
+      outputPath: './src/client',
+      protocols: ['nats'],
+    },
+  ],
+};
diff --git a/examples/eventcatalog-native/eventcatalog/domains/ecommerce/index.md b/examples/eventcatalog-native/eventcatalog/domains/ecommerce/index.md
new file mode 100644
index 00000000..9367e6e8
--- /dev/null
+++ b/examples/eventcatalog-native/eventcatalog/domains/ecommerce/index.md
@@ -0,0 +1,15 @@
+---
+id: ecommerce
+name: E-Commerce Domain
+version: 1.0.0
+summary: Core e-commerce functionality
+owners:
+  - platform-team
+services:
+  - id: order-service
+    version: 1.0.0
+  - id: inventory-service
+    version: 1.0.0
+---
+
+The E-Commerce Domain handles orders and inventory management.
diff --git a/examples/eventcatalog-native/eventcatalog/eventcatalog.config.js b/examples/eventcatalog-native/eventcatalog/eventcatalog.config.js
new file mode 100644
index 00000000..15df2dc3
--- /dev/null
+++ b/examples/eventcatalog-native/eventcatalog/eventcatalog.config.js
@@ -0,0 +1,10 @@
+/** @type {import('@eventcatalog/core/bin/eventcatalog.config').Config} */
+export default {
+  title: 'E-Commerce Platform',
+  tagline: 'Native EventCatalog documentation',
+  organizationName: 'Acme Corp',
+  homepageLink: 'https://eventcatalog.dev/',
+  editUrl: 'https://github.com/acme/eventcatalog/edit/main',
+  trailingSlash: false,
+  base: '/',
+};
diff --git a/examples/eventcatalog-native/eventcatalog/events/OrderCreated/index.md b/examples/eventcatalog-native/eventcatalog/events/OrderCreated/index.md
new file mode 100644
index 00000000..32a5abf0
--- /dev/null
+++ b/examples/eventcatalog-native/eventcatalog/events/OrderCreated/index.md
@@ -0,0 +1,11 @@
+---
+id: OrderCreated
+name: Order Created
+version: 1.0.0
+summary: Published when a new order is placed
+owners:
+  - orders-team
+schemaPath: schema.json
+---
+
+Event published when a customer places a new order.
diff --git a/examples/eventcatalog-native/eventcatalog/events/OrderCreated/schema.json b/examples/eventcatalog-native/eventcatalog/events/OrderCreated/schema.json
new file mode 100644
index 00000000..61f5e7a6
--- /dev/null
+++ b/examples/eventcatalog-native/eventcatalog/events/OrderCreated/schema.json
@@ -0,0 +1,34 @@
+{
+  "$id": "OrderCreated",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "required": ["orderId", "customerId", "items", "totalAmount"],
+  "properties": {
+    "orderId": {
+      "type": "string",
+      "format": "uuid"
+    },
+    "customerId": {
+      "type": "string",
+      "format": "uuid"
+    },
+    "items": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "productId": { "type": "string" },
+          "quantity": { "type": "integer" },
+          "price": { "type": "number" }
+        }
+      }
+    },
+    "totalAmount": {
+      "type": "number"
+    },
+    "createdAt": {
+      "type": "string",
+      "format": "date-time"
+    }
+  }
+}
diff --git a/examples/eventcatalog-native/eventcatalog/events/OrderShipped/index.md b/examples/eventcatalog-native/eventcatalog/events/OrderShipped/index.md
new file mode 100644
index 00000000..91558109
--- /dev/null
+++ b/examples/eventcatalog-native/eventcatalog/events/OrderShipped/index.md
@@ -0,0 +1,11 @@
+---
+id: OrderShipped
+name: Order Shipped
+version: 1.0.0
+summary: Published when an order is shipped
+owners:
+  - orders-team
+schemaPath: schema.json
+---
+
+Event published when an order has been shipped to the customer.
diff --git a/examples/eventcatalog-native/eventcatalog/events/OrderShipped/schema.json b/examples/eventcatalog-native/eventcatalog/events/OrderShipped/schema.json
new file mode 100644
index 00000000..1980d6f7
--- /dev/null
+++ b/examples/eventcatalog-native/eventcatalog/events/OrderShipped/schema.json
@@ -0,0 +1,23 @@
+{
+  "$id": "OrderShipped",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "required": ["orderId", "trackingNumber", "carrier"],
+  "properties": {
+    "orderId": {
+      "type": "string",
+      "format": "uuid"
+    },
+    "trackingNumber": {
+      "type": "string"
+    },
+    "carrier": {
+      "type": "string",
+      "enum": ["ups", "fedex", "dhl", "usps"]
+    },
+    "shippedAt": {
+      "type": "string",
+      "format": "date-time"
+    }
+  }
+}
diff --git a/examples/eventcatalog-native/eventcatalog/events/StockUpdated/index.md b/examples/eventcatalog-native/eventcatalog/events/StockUpdated/index.md
new file mode 100644
index 00000000..fba6cba2
--- /dev/null
+++ b/examples/eventcatalog-native/eventcatalog/events/StockUpdated/index.md
@@ -0,0 +1,11 @@
+---
+id: StockUpdated
+name: Stock Updated
+version: 1.0.0
+summary: Published when inventory stock level changes
+owners:
+  - inventory-team
+schemaPath: schema.json
+---
+
+Event published when product stock levels are updated.
diff --git a/examples/eventcatalog-native/eventcatalog/events/StockUpdated/schema.json b/examples/eventcatalog-native/eventcatalog/events/StockUpdated/schema.json
new file mode 100644
index 00000000..e677056b
--- /dev/null
+++ b/examples/eventcatalog-native/eventcatalog/events/StockUpdated/schema.json
@@ -0,0 +1,25 @@
+{
+  "$id": "StockUpdated",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "required": ["productId", "previousQuantity", "newQuantity"],
+  "properties": {
+    "productId": {
+      "type": "string"
+    },
+    "previousQuantity": {
+      "type": "integer"
+    },
+    "newQuantity": {
+      "type": "integer"
+    },
+    "reason": {
+      "type": "string",
+      "enum": ["sale", "restock", "adjustment", "return"]
+    },
+    "updatedAt": {
+      "type": "string",
+      "format": "date-time"
+    }
+  }
+}
diff --git a/examples/eventcatalog-native/eventcatalog/package.json b/examples/eventcatalog-native/eventcatalog/package.json
new file mode 100644
index 00000000..ea2d9a07
--- /dev/null
+++ b/examples/eventcatalog-native/eventcatalog/package.json
@@ -0,0 +1,13 @@
+{
+  "name": "ecommerce-eventcatalog",
+  "version": "1.0.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "eventcatalog dev",
+    "build": "eventcatalog build"
+  },
+  "dependencies": {
+    "@eventcatalog/core": "^2.0.0"
+  }
+}
diff --git a/examples/eventcatalog-native/eventcatalog/services/inventory-service/index.md b/examples/eventcatalog-native/eventcatalog/services/inventory-service/index.md
new file mode 100644
index 00000000..597c24bd
--- /dev/null
+++ b/examples/eventcatalog-native/eventcatalog/services/inventory-service/index.md
@@ -0,0 +1,16 @@
+---
+id: inventory-service
+name: Inventory Service
+version: 1.0.0
+summary: Tracks product stock levels
+owners:
+  - inventory-team
+sends:
+  - id: StockUpdated
+    version: 1.0.0
+receives:
+  - id: OrderCreated
+    version: 1.0.0
+---
+
+The Inventory Service manages product stock and alerts.
diff --git a/examples/eventcatalog-native/eventcatalog/services/order-service/index.md b/examples/eventcatalog-native/eventcatalog/services/order-service/index.md
new file mode 100644
index 00000000..a881234d
--- /dev/null
+++ b/examples/eventcatalog-native/eventcatalog/services/order-service/index.md
@@ -0,0 +1,16 @@
+---
+id: order-service
+name: Order Service
+version: 1.0.0
+summary: Manages order lifecycle
+owners:
+  - orders-team
+sends:
+  - id: OrderCreated
+    version: 1.0.0
+  - id: OrderShipped
+    version: 1.0.0
+receives: []
+---
+
+The Order Service handles order creation and fulfillment.
diff --git a/examples/eventcatalog-native/package.json b/examples/eventcatalog-native/package.json
new file mode 100644
index 00000000..7995193a
--- /dev/null
+++ b/examples/eventcatalog-native/package.json
@@ -0,0 +1,14 @@
+{
+  "name": "eventcatalog-native-example",
+  "version": "1.0.0",
+  "description": "Example: Native EventCatalog structure with JSON Schema events",
+  "type": "module",
+  "scripts": {
+    "generate": "codegen generate",
+    "catalog:dev": "cd eventcatalog && npm run dev"
+  },
+  "devDependencies": {
+    "@eventcatalog/sdk": "^1.0.0",
+    "@the-codegen-project/cli": "latest"
+  }
+}
diff --git a/examples/eventcatalog-openapi/.gitignore b/examples/eventcatalog-openapi/.gitignore
new file mode 100644
index 00000000..69aa5535
--- /dev/null
+++ b/examples/eventcatalog-openapi/.gitignore
@@ -0,0 +1,9 @@
+# Generated code
+src/
+
+# Dependencies
+node_modules/
+eventcatalog/node_modules/
+
+# Build artifacts
+.eventcatalog/
diff --git a/examples/eventcatalog-openapi/README.md b/examples/eventcatalog-openapi/README.md
new file mode 100644
index 00000000..4065da71
--- /dev/null
+++ b/examples/eventcatalog-openapi/README.md
@@ -0,0 +1,70 @@
+# EventCatalog + OpenAPI Example
+
+This example demonstrates the **proposed** EventCatalog integration where a service has an OpenAPI specification attached.
+
+> **Note**: This is a showcase of the proposed `inputType: 'eventcatalog'` configuration. This feature does not exist yet.
+
+## Configuration
+
+```javascript
+// codegen.config.mjs
+export default {
+  inputType: 'eventcatalog',
+  inputPath: './eventcatalog',
+  service: 'petstore-api',  // Service with openapiPath
+  language: 'typescript',
+  generators: [
+    { preset: 'payloads', outputPath: './src/payloads' },
+    { preset: 'channels', outputPath: './src/channels', protocols: ['http_client'] },
+  ],
+};
+```
+
+## How It Works
+
+1. Read EventCatalog at `./eventcatalog`
+2. Find `petstore-api` in `services/`
+3. Detect `openapiPath: openapi.json` in service metadata
+4. Load and parse the OpenAPI spec
+5. Generate code using OpenAPI processing
+
+## Service Metadata
+
+The service's `index.md` declares its OpenAPI spec:
+
+```yaml
+---
+id: petstore-api
+name: Petstore API
+version: 1.0.0
+specifications:
+  openapiPath: openapi.json  # <-- Auto-detected
+---
+```
+
+## Project Structure
+
+```
+eventcatalog-openapi/
+├── codegen.config.mjs
+├── eventcatalog/
+│   ├── eventcatalog.config.js
+│   ├── domains/ecommerce-domain/index.md
+│   └── services/petstore-api/
+│       ├── index.md            # Has openapiPath in metadata
+│       └── openapi.json        # OpenAPI 3.0 spec
+└── src/                        # Generated code
+```
+
+## Auto-Detection Logic
+
+| Service Metadata | Processing |
+|------------------|------------|
+| `asyncapiPath: ...` | AsyncAPI processing |
+| `openapiPath: ...` | OpenAPI processing |
+| Neither (just `sends`/`receives`) | Native JSON Schema |
+
+## Related Examples
+
+- [eventcatalog-asyncapi](../eventcatalog-asyncapi/) - Service with AsyncAPI spec
+- [eventcatalog-native](../eventcatalog-native/) - Service with native JSON Schema events
diff --git a/examples/eventcatalog-openapi/codegen.config.mjs b/examples/eventcatalog-openapi/codegen.config.mjs
new file mode 100644
index 00000000..0fa1ad5f
--- /dev/null
+++ b/examples/eventcatalog-openapi/codegen.config.mjs
@@ -0,0 +1,42 @@
+/**
+ * Codegen configuration for EventCatalog with an OpenAPI service.
+ *
+ * The loader reads the selected service's frontmatter, sees that
+ * petstore-api declares `specifications.openapiPath: openapi.json`,
+ * and routes generation through the OpenAPI pipeline.
+ *
+ * @type {import("@the-codegen-project/cli").TheCodegenConfiguration}
+ */
+export default {
+  inputType: 'eventcatalog',
+  inputPath: './eventcatalog',
+  language: 'typescript',
+
+  // Select which service to generate code for
+  service: 'petstore-api',
+
+  generators: [
+    {
+      preset: 'payloads',
+      outputPath: './src/payloads',
+      serializationType: 'json',
+    },
+    {
+      preset: 'parameters',
+      outputPath: './src/parameters',
+    },
+    {
+      preset: 'headers',
+      outputPath: './src/headers',
+    },
+    {
+      preset: 'types',
+      outputPath: './src',
+    },
+    {
+      preset: 'channels',
+      outputPath: './src/channels',
+      protocols: ['http_client'],
+    },
+  ],
+};
diff --git a/examples/eventcatalog-openapi/eventcatalog/domains/ecommerce-domain/index.md b/examples/eventcatalog-openapi/eventcatalog/domains/ecommerce-domain/index.md
new file mode 100644
index 00000000..7dfbff9c
--- /dev/null
+++ b/examples/eventcatalog-openapi/eventcatalog/domains/ecommerce-domain/index.md
@@ -0,0 +1,42 @@
+---
+id: ecommerce-domain
+name: E-Commerce Domain
+version: 1.0.0
+summary: Domain encompassing all e-commerce functionality
+owners:
+  - platform-team
+services:
+  - id: petstore-api
+    version: 1.0.0
+badges:
+  - content: Core Domain
+    backgroundColor: blue
+    textColor: white
+---
+
+## Overview
+
+The E-Commerce Domain encompasses all functionality related to the online pet store, including:
+
+- Pet inventory management
+- Order processing
+- Customer management
+- Payment processing
+
+## Bounded Context
+
+This domain owns the concepts of Pet, Order, and Store operations. It is the source of truth for product catalog and order lifecycle.
+
+## Services
+
+| Service | Type | Description |
+|---------|------|-------------|
+| Petstore API | REST | Main API for pet and order management |
+
+## Integration Points
+
+| System | Direction | Description |
+|--------|-----------|-------------|
+| Payment Gateway | Outbound | Process payments |
+| Shipping Service | Outbound | Fulfill orders |
+| Inventory System | Bidirectional | Sync stock levels |
diff --git a/examples/eventcatalog-openapi/eventcatalog/eventcatalog.config.js b/examples/eventcatalog-openapi/eventcatalog/eventcatalog.config.js
new file mode 100644
index 00000000..896cb7cc
--- /dev/null
+++ b/examples/eventcatalog-openapi/eventcatalog/eventcatalog.config.js
@@ -0,0 +1,28 @@
+/** @type {import('@eventcatalog/core/bin/eventcatalog.config').Config} */
+export default {
+  title: 'E-Commerce API Catalog',
+  tagline: 'API documentation for the e-commerce platform',
+  organizationName: 'Petstore Inc',
+  homepageLink: 'https://eventcatalog.dev/',
+  landingPage: '',
+  editUrl: 'https://github.com/petstore/eventcatalog/edit/main',
+  trailingSlash: false,
+  base: '/',
+  logo: {
+    alt: 'EventCatalog Logo',
+    src: '/logo.png',
+  },
+  docs: {
+    sidebar: {
+      showPageHeadings: true,
+    },
+  },
+  generators: [
+    // OpenAPI generator can auto-populate the catalog from spec files
+    // ['@eventcatalog/generator-openapi', {
+    //   services: [
+    //     { path: './services/petstore-api/openapi.json' }
+    //   ]
+    // }]
+  ],
+};
diff --git a/examples/eventcatalog-openapi/eventcatalog/package.json b/examples/eventcatalog-openapi/eventcatalog/package.json
new file mode 100644
index 00000000..94c45a27
--- /dev/null
+++ b/examples/eventcatalog-openapi/eventcatalog/package.json
@@ -0,0 +1,19 @@
+{
+  "name": "ecommerce-api-eventcatalog",
+  "version": "1.0.0",
+  "description": "EventCatalog for e-commerce API services",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "eventcatalog dev",
+    "build": "eventcatalog build",
+    "preview": "eventcatalog preview",
+    "generate": "eventcatalog generate"
+  },
+  "dependencies": {
+    "@eventcatalog/core": "^2.0.0"
+  },
+  "devDependencies": {
+    "@eventcatalog/sdk": "^1.0.0"
+  }
+}
diff --git a/examples/eventcatalog-openapi/eventcatalog/services/petstore-api/index.md b/examples/eventcatalog-openapi/eventcatalog/services/petstore-api/index.md
new file mode 100644
index 00000000..3a328886
--- /dev/null
+++ b/examples/eventcatalog-openapi/eventcatalog/services/petstore-api/index.md
@@ -0,0 +1,76 @@
+---
+id: petstore-api
+name: Petstore API
+version: 1.0.0
+summary: REST API for managing pets in the pet store
+owners:
+  - api-team
+badges:
+  - content: OpenAPI 3.0
+    backgroundColor: green
+    textColor: white
+  - content: Production
+    backgroundColor: blue
+    textColor: white
+sends: []
+receives: []
+repository:
+  language: TypeScript
+  url: https://github.com/petstore/api
+specifications:
+  openapiPath: openapi.json
+---
+
+## Overview
+
+The Petstore API provides RESTful endpoints for managing pets, orders, and users in the pet store application. It's the main interface for all client applications.
+
+## Architecture
+
+```mermaid
+graph LR
+    A[Web App] --> B[Petstore API]
+    C[Mobile App] --> B
+    B --> D[PostgreSQL]
+    B --> E[Redis Cache]
+```
+
+## Endpoints
+
+| Method | Path | Description |
+|--------|------|-------------|
+| POST | /pet | Add a new pet |
+| PUT | /pet | Update an existing pet |
+| GET | /pet/findByStatus/{status}/{categoryId} | Find pets by status and category |
+
+## Authentication
+
+The API supports two authentication methods:
+
+1. **OAuth2** - For user-facing applications
+2. **API Key** - For service-to-service communication
+
+## Getting Started
+
+```bash
+# Using the generated client
+import { PetstoreClient } from './src/client';
+
+const client = new PetstoreClient({
+  baseUrl: 'https://api.petstore.com',
+  apiKey: 'your-api-key',
+});
+
+const pets = await client.findPetsByStatusAndCategory({
+  status: 'available',
+  categoryId: 1,
+});
+```
+
+## Rate Limits
+
+| Tier | Requests/min | Requests/day |
+|------|--------------|--------------|
+| Free | 60 | 1,000 |
+| Pro | 600 | 50,000 |
+| Enterprise | Unlimited | Unlimited |
diff --git a/examples/eventcatalog-openapi/eventcatalog/services/petstore-api/openapi.json b/examples/eventcatalog-openapi/eventcatalog/services/petstore-api/openapi.json
new file mode 100644
index 00000000..071393c5
--- /dev/null
+++ b/examples/eventcatalog-openapi/eventcatalog/services/petstore-api/openapi.json
@@ -0,0 +1,467 @@
+{
+  "openapi": "3.0.0",
+  "info": {
+    "title": "Petstore API",
+    "version": "1.0.0",
+    "description": "REST API for managing pets in the pet store. This API allows you to add, update, and search for pets.",
+    "contact": {
+      "name": "API Team",
+      "email": "api-team@petstore.com"
+    },
+    "license": {
+      "name": "Apache 2.0",
+      "url": "https://www.apache.org/licenses/LICENSE-2.0.html"
+    }
+  },
+  "servers": [
+    {
+      "url": "https://api.petstore.com/v1",
+      "description": "Production server"
+    },
+    {
+      "url": "http://localhost:3000/v1",
+      "description": "Local development server"
+    }
+  ],
+  "tags": [
+    {
+      "name": "pet",
+      "description": "Pet management operations"
+    },
+    {
+      "name": "store",
+      "description": "Store order operations"
+    }
+  ],
+  "paths": {
+    "/pet": {
+      "post": {
+        "tags": ["pet"],
+        "summary": "Add a new pet to the store",
+        "description": "Creates a new pet in the store inventory",
+        "operationId": "addPet",
+        "requestBody": {
+          "description": "Pet object to be added",
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/Pet"
+              }
+            }
+          }
+        },
+        "responses": {
+          "201": {
+            "description": "Pet created successfully",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Pet"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid input",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Error"
+                }
+              }
+            }
+          }
+        },
+        "security": [
+          {
+            "api_key": []
+          }
+        ]
+      },
+      "put": {
+        "tags": ["pet"],
+        "summary": "Update an existing pet",
+        "description": "Updates a pet in the store by ID",
+        "operationId": "updatePet",
+        "requestBody": {
+          "description": "Pet object with updated information",
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/Pet"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Pet updated successfully",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Pet"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid ID supplied"
+          },
+          "404": {
+            "description": "Pet not found"
+          }
+        },
+        "security": [
+          {
+            "api_key": []
+          }
+        ]
+      }
+    },
+    "/pet/{petId}": {
+      "get": {
+        "tags": ["pet"],
+        "summary": "Find pet by ID",
+        "description": "Returns a single pet by its ID",
+        "operationId": "getPetById",
+        "parameters": [
+          {
+            "name": "petId",
+            "in": "path",
+            "description": "ID of the pet to retrieve",
+            "required": true,
+            "schema": {
+              "type": "integer",
+              "format": "int64"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful operation",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Pet"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Pet not found"
+          }
+        },
+        "security": [
+          {
+            "api_key": []
+          }
+        ]
+      },
+      "delete": {
+        "tags": ["pet"],
+        "summary": "Delete a pet",
+        "description": "Deletes a pet from the store",
+        "operationId": "deletePet",
+        "parameters": [
+          {
+            "name": "petId",
+            "in": "path",
+            "description": "ID of the pet to delete",
+            "required": true,
+            "schema": {
+              "type": "integer",
+              "format": "int64"
+            }
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "Pet deleted successfully"
+          },
+          "404": {
+            "description": "Pet not found"
+          }
+        },
+        "security": [
+          {
+            "api_key": []
+          }
+        ]
+      }
+    },
+    "/pet/findByStatus": {
+      "get": {
+        "tags": ["pet"],
+        "summary": "Find pets by status",
+        "description": "Returns pets filtered by their status",
+        "operationId": "findPetsByStatus",
+        "parameters": [
+          {
+            "name": "status",
+            "in": "query",
+            "description": "Status value to filter by",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "enum": ["available", "pending", "sold"]
+            }
+          },
+          {
+            "name": "limit",
+            "in": "query",
+            "description": "Maximum number of pets to return",
+            "required": false,
+            "schema": {
+              "type": "integer",
+              "default": 20,
+              "minimum": 1,
+              "maximum": 100
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful operation",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/Pet"
+                  }
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid status value"
+          }
+        },
+        "security": [
+          {
+            "api_key": []
+          }
+        ]
+      }
+    },
+    "/store/order": {
+      "post": {
+        "tags": ["store"],
+        "summary": "Place an order for a pet",
+        "description": "Creates a new order in the store",
+        "operationId": "placeOrder",
+        "requestBody": {
+          "description": "Order to be placed",
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/Order"
+              }
+            }
+          }
+        },
+        "responses": {
+          "201": {
+            "description": "Order placed successfully",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Order"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid order"
+          }
+        },
+        "security": [
+          {
+            "api_key": []
+          }
+        ]
+      }
+    },
+    "/store/order/{orderId}": {
+      "get": {
+        "tags": ["store"],
+        "summary": "Find order by ID",
+        "description": "Returns an order by its ID",
+        "operationId": "getOrderById",
+        "parameters": [
+          {
+            "name": "orderId",
+            "in": "path",
+            "description": "ID of the order to retrieve",
+            "required": true,
+            "schema": {
+              "type": "integer",
+              "format": "int64"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful operation",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Order"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Order not found"
+          }
+        },
+        "security": [
+          {
+            "api_key": []
+          }
+        ]
+      }
+    }
+  },
+  "components": {
+    "schemas": {
+      "Pet": {
+        "type": "object",
+        "required": ["name", "status"],
+        "properties": {
+          "id": {
+            "type": "integer",
+            "format": "int64",
+            "description": "Unique identifier for the pet"
+          },
+          "name": {
+            "type": "string",
+            "description": "Name of the pet",
+            "example": "Buddy"
+          },
+          "category": {
+            "$ref": "#/components/schemas/Category"
+          },
+          "photoUrls": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "format": "uri"
+            },
+            "description": "URLs to pet photos"
+          },
+          "tags": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/Tag"
+            },
+            "description": "Tags associated with the pet"
+          },
+          "status": {
+            "type": "string",
+            "enum": ["available", "pending", "sold"],
+            "description": "Pet availability status"
+          }
+        }
+      },
+      "Category": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "name": {
+            "type": "string",
+            "example": "Dogs"
+          }
+        }
+      },
+      "Tag": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "name": {
+            "type": "string",
+            "example": "friendly"
+          }
+        }
+      },
+      "Order": {
+        "type": "object",
+        "required": ["petId", "quantity"],
+        "properties": {
+          "id": {
+            "type": "integer",
+            "format": "int64",
+            "description": "Unique identifier for the order"
+          },
+          "petId": {
+            "type": "integer",
+            "format": "int64",
+            "description": "ID of the pet being ordered"
+          },
+          "quantity": {
+            "type": "integer",
+            "format": "int32",
+            "minimum": 1,
+            "description": "Number of pets ordered"
+          },
+          "shipDate": {
+            "type": "string",
+            "format": "date-time",
+            "description": "Expected shipping date"
+          },
+          "status": {
+            "type": "string",
+            "enum": ["placed", "approved", "delivered"],
+            "description": "Order status"
+          },
+          "complete": {
+            "type": "boolean",
+            "default": false,
+            "description": "Whether the order is complete"
+          }
+        }
+      },
+      "Error": {
+        "type": "object",
+        "required": ["code", "message"],
+        "properties": {
+          "code": {
+            "type": "integer",
+            "format": "int32"
+          },
+          "message": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "securitySchemes": {
+      "api_key": {
+        "type": "apiKey",
+        "name": "X-API-Key",
+        "in": "header"
+      },
+      "oauth2": {
+        "type": "oauth2",
+        "flows": {
+          "implicit": {
+            "authorizationUrl": "https://petstore.com/oauth/authorize",
+            "scopes": {
+              "read:pets": "Read your pets",
+              "write:pets": "Modify pets in your account"
+            }
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/examples/eventcatalog-openapi/package.json b/examples/eventcatalog-openapi/package.json
new file mode 100644
index 00000000..e2f9420e
--- /dev/null
+++ b/examples/eventcatalog-openapi/package.json
@@ -0,0 +1,16 @@
+{
+  "name": "eventcatalog-openapi-example",
+  "version": "1.0.0",
+  "description": "Example: Generate TypeScript HTTP client from EventCatalog OpenAPI specs",
+  "type": "module",
+  "scripts": {
+    "generate": "codegen generate",
+    "generate:watch": "codegen generate --watch",
+    "catalog:dev": "cd eventcatalog && npm run dev",
+    "catalog:build": "cd eventcatalog && npm run build"
+  },
+  "devDependencies": {
+    "@the-codegen-project/cli": "latest"
+  },
+  "dependencies": {}
+}
diff --git a/schemas/configuration-schema-0-with-docs.json b/schemas/configuration-schema-0-with-docs.json
index 67d272f6..fd3bdf15 100644
--- a/schemas/configuration-schema-0-with-docs.json
+++ b/schemas/configuration-schema-0-with-docs.json
@@ -111,6 +111,62 @@
                 "generators"
             ],
             "additionalProperties": false
+        },
+        {
+            "type": "object",
+            "properties": {
+                "$schema": {
+                    "type": "string",
+                    "markdownDescription": "JSON Schema reference used by IDEs to enable auto-completion and validation in JSON and YAML configuration files. [Read more about configurations here](https://the-codegen-project.org/docs/configurations)"
+                },
+                "inputType": {
+                    "type": "string",
+                    "const": "eventcatalog",
+                    "markdownDescription": "The type of input document being processed (asyncapi, openapi, or jsonschema). [Read more about inputs here](https://the-codegen-project.org/docs/configurations)"
+                },
+                "inputPath": {
+                    "type": "string",
+                    "markdownDescription": "Path or URL to the input document used as the source for code generation. [Read more about configurations here](https://the-codegen-project.org/docs/configurations)"
+                },
+                "auth": {
+                    "$ref": "#/definitions/AsyncAPICodegenConfiguration/properties/auth"
+                },
+                "service": {
+                    "type": "string",
+                    "markdownDescription": "Service ID inside the EventCatalog directory to generate code for. Matches services/<id>/index.md."
+                },
+                "specType": {
+                    "type": "string",
+                    "enum": [
+                        "asyncapi",
+                        "openapi"
+                    ],
+                    "markdownDescription": "Disambiguator used when the selected service declares both asyncapiPath and openapiPath. Set to \"asyncapi\" or \"openapi\" to choose which spec drives generation."
+                },
+                "language": {
+                    "$ref": "#/definitions/AsyncAPICodegenConfiguration/properties/language"
+                },
+                "importExtension": {
+                    "$ref": "#/definitions/AsyncAPICodegenConfiguration/properties/importExtension"
+                },
+                "generators": {
+                    "type": "array",
+                    "items": {
+                        "$ref": "#/definitions/AsyncAPICodegenConfiguration/properties/generators/items"
+                    },
+                    "markdownDescription": "The list of generators to run as part of this configuration. [Read more about generators here](https://the-codegen-project.org/docs/generators)"
+                },
+                "telemetry": {
+                    "$ref": "#/definitions/AsyncAPICodegenConfiguration/properties/telemetry"
+                }
+            },
+            "required": [
+                "inputType",
+                "inputPath",
+                "service",
+                "generators"
+            ],
+            "additionalProperties": false
         }
     ],
     "definitions": {
diff --git a/schemas/configuration-schema-0.json b/schemas/configuration-schema-0.json
index 5c09fa6b..7ea142da 100644
--- a/schemas/configuration-schema-0.json
+++ b/schemas/configuration-schema-0.json
@@ -111,6 +111,62 @@
                 "generators"
             ],
             "additionalProperties": false
+        },
+        {
+            "type": "object",
+            "properties": {
+                "$schema": {
+                    "type": "string",
+                    "description": "JSON Schema reference used by IDEs to enable auto-completion and validation in JSON and YAML configuration files. Read more about configurations here"
+                },
+                "inputType": {
+                    "type": "string",
+                    "const": "eventcatalog",
+                    "description": "The type of input document being processed (asyncapi, openapi, or jsonschema). Read more about inputs here"
+                },
+                "inputPath": {
+                    "type": "string",
+                    "description": "Path or URL to the input document used as the source for code generation. Read more about configurations here"
+                },
+                "auth": {
+                    "$ref": "#/definitions/AsyncAPICodegenConfiguration/properties/auth"
+                },
+                "service": {
+                    "type": "string",
+                    "description": "Service ID inside the EventCatalog directory to generate code for. Matches services/<id>/index.md."
+                },
+                "specType": {
+                    "type": "string",
+                    "enum": [
+                        "asyncapi",
+                        "openapi"
+                    ],
+                    "description": "Disambiguator used when the selected service declares both asyncapiPath and openapiPath. Set to \"asyncapi\" or \"openapi\" to choose which spec drives generation."
+                },
+                "language": {
+                    "$ref": "#/definitions/AsyncAPICodegenConfiguration/properties/language"
+                },
+                "importExtension": {
+                    "$ref": "#/definitions/AsyncAPICodegenConfiguration/properties/importExtension"
+                },
+                "generators": {
+                    "type": "array",
+                    "items": {
+                        "$ref": "#/definitions/AsyncAPICodegenConfiguration/properties/generators/items"
+                    },
+                    "description": "The list of generators to run as part of this configuration. Read more about generators here"
+                },
+                "telemetry": {
+                    "$ref": "#/definitions/AsyncAPICodegenConfiguration/properties/telemetry"
+                }
+            },
+            "required": [
+                "inputType",
+                "inputPath",
+                "service",
+                "generators"
+            ],
+            "additionalProperties": false
         }
     ],
     "definitions": {
diff --git a/src/browser/generate.ts b/src/browser/generate.ts
index 27c68b7c..fc5df9f9 100644
--- a/src/browser/generate.ts
+++ b/src/browser/generate.ts
@@ -29,7 +29,7 @@ export interface BrowserGenerateInput {
   /** The API specification as a string (YAML or JSON) */
   spec: string;
   /** The format of the specification */
-  specFormat: 'asyncapi' | 'openapi' | 'jsonschema';
+  specFormat: 'asyncapi' | 'openapi' | 'jsonschema' | 'eventcatalog';
   /** The codegen configuration */
   config: TheCodegenConfiguration;
 }
@@ -122,6 +122,12 @@ export async function generate(
         }
         break;
 
+      case 'eventcatalog':
+        errors.push(
+          `EventCatalog input is not supported in browser mode. EventCatalog is filesystem-bound; use 'asyncapi', 'openapi', or 'jsonschema' directly in the browser.`
+        );
+        return {files, errors};
+
       default:
         errors.push(`Unknown spec format: ${input.specFormat}`);
         return {files, errors};
diff --git a/src/codegen/configurations.ts b/src/codegen/configurations.ts
index b1d3a03f..2f1c4eef 100644
--- a/src/codegen/configurations.ts
+++ b/src/codegen/configurations.ts
@@ -28,6 +28,7 @@ import path from 'path';
 import {loadAsyncapi} from './inputs/asyncapi';
 import {loadOpenapi} from './inputs/openapi';
 import {loadJsonSchema} from './inputs/jsonschema';
+import {loadEventCatalog} from './inputs/eventcatalog';
 import {
   defaultTypeScriptHeadersOptions,
   defaultTypeScriptTypesOptions
@@ -311,6 +312,20 @@ export async function realizeGeneratorContext(
   } else if (config.inputType === 'jsonschema') {
     const document = await loadJsonSchema(context);
     context.jsonSchemaDocument = document;
+  } else if (config.inputType === 'eventcatalog') {
+    const result = await loadEventCatalog(context);
+    if (result.asyncapiDocument) {
+      context.asyncapiDocument = result.asyncapiDocument;
+    }
+    if (result.openapiDocument) {
+      context.openapiDocument = result.openapiDocument;
+    }
+    // Mutate the runtime inputType so the rest of the pipeline (renderer
+    // guards, generator switches) sees the effective spec discriminator.
+    // Telemetry callers should capture the original `'eventcatalog'`
+    // value before invoking this function.
+    (context.configuration as {inputType: string}).inputType =
+      result.effectiveInputType;
   }
 
   return context;
diff --git a/src/codegen/errors.ts b/src/codegen/errors.ts
index aeee97f5..d6ca8f22 100644
--- a/src/codegen/errors.ts
+++ b/src/codegen/errors.ts
@@ -145,7 +145,7 @@ export function createInvalidInputTypeError(options: {
   inputType: string;
 }): CodegenError {
   const {inputType} = options;
-  const validTypes = ['asyncapi', 'openapi', 'jsonschema'];
+  const validTypes = ['asyncapi', 'openapi', 'jsonschema', 'eventcatalog'];
   const typeList = validTypes.map((t) => `  - ${t}`).join('\n');
 
   return new CodegenError({
@@ -311,7 +311,7 @@ export function createUnsupportedLanguageError(options: {
 }
 
 export function createMissingInputDocumentError(options: {
-  expectedType: 'asyncapi' | 'openapi' | 'jsonschema';
+  expectedType: 'asyncapi' | 'openapi' | 'jsonschema' | 'eventcatalog';
   generatorPreset?: string;
 }): CodegenError {
   const {expectedType, generatorPreset} = options;
diff --git a/src/codegen/inputs/eventcatalog/eventLoader.ts b/src/codegen/inputs/eventcatalog/eventLoader.ts
new file mode 100644
index 00000000..6b75ba12
--- /dev/null
+++ b/src/codegen/inputs/eventcatalog/eventLoader.ts
@@ -0,0 +1,176 @@
+/**
+ * Loads native-mode EventCatalog events (an event directory holding an
+ * index.md with frontmatter plus a JSON Schema file) and synthesizes an
+ * AsyncAPI 3.0 document so the existing AsyncAPI generators can consume
+ * the result without any per-input branching.
+ */
+import fs from 'fs';
+import path from 'path';
+import {parse as parseYaml} from 'yaml';
+import {AsyncAPIDocumentInterface} from '@asyncapi/parser';
+import {createInputDocumentError} from '../../errors';
+import {loadAsyncapiFromMemory} from '../asyncapi';
+import {EventReference, ServiceMetadata} from './types';
+
+const FRONTMATTER_DELIMITER = '---';
+
+interface EventFrontmatter {
+  id?: string;
+  name?: string;
+  version?: string;
+  summary?: string;
+  schemaPath?: string;
+}
+
+export interface LoadedEvent {
+  id: string;
+  schema: Record<string, unknown>;
+  schemaPath: string;
+}
+
+function readEventFrontmatter(filePath: string): EventFrontmatter {
+  const content = fs.readFileSync(filePath, 'utf8').trimStart();
+  if (!content.startsWith(FRONTMATTER_DELIMITER)) {
+    return {};
+  }
+  const afterFirst = content.slice(FRONTMATTER_DELIMITER.length);
+  const closingIndex = afterFirst.indexOf(`\n${FRONTMATTER_DELIMITER}`);
+  if (closingIndex === -1) {
+    return {};
+  }
+  const raw = afterFirst.slice(0, closingIndex);
+  const parsed = parseYaml(raw);
+  return parsed && typeof parsed === 'object'
+    ? (parsed as EventFrontmatter)
+    : {};
+}
+
+/**
+ * Load a single event from the catalog by its `EventReference`. Reads the
+ * event's `index.md` frontmatter to find `schemaPath`, falling back to a
+ * sibling `schema.json` if no schemaPath is set.
+ */
+export function loadEvent(
+  catalogRoot: string,
+  ref: EventReference
+): LoadedEvent {
+  const eventDir = path.join(catalogRoot, 'events', ref.id);
+  if (!fs.existsSync(eventDir)) {
+    throw createInputDocumentError({
+      inputPath: eventDir,
+      inputType: 'eventcatalog',
+      errorMessage: `Event '${ref.id}' has no directory under events/.`
+    });
+  }
+
+  const indexPath = path.join(eventDir, 'index.md');
+  let frontmatter: EventFrontmatter = {};
+  if (fs.existsSync(indexPath)) {
+    try {
+      frontmatter = readEventFrontmatter(indexPath);
+    } catch (error) {
+      throw createInputDocumentError({
+        inputPath: indexPath,
+        inputType: 'eventcatalog',
+        errorMessage: `Invalid frontmatter for event '${ref.id}': ${
+          error instanceof Error ? error.message : String(error)
+        }`
+      });
+    }
+  }
+
+  const schemaPathRelative = frontmatter.schemaPath ?? 'schema.json';
+  const schemaPath = path.resolve(eventDir, schemaPathRelative);
+
+  if (!fs.existsSync(schemaPath)) {
+    throw createInputDocumentError({
+      inputPath: schemaPath,
+      inputType: 'eventcatalog',
+      errorMessage: `Schema file for event '${ref.id}' could not be resolved at ${schemaPath}.`
+    });
+  }
+
+  let schema: Record<string, unknown>;
+  try {
+    const raw = fs.readFileSync(schemaPath, 'utf8');
+    schema = JSON.parse(raw);
+  } catch (error) {
+    throw createInputDocumentError({
+      inputPath: schemaPath,
+      inputType: 'eventcatalog',
+      errorMessage: `Could not read schema for event '${ref.id}': ${
+        error instanceof Error ? error.message : String(error)
+      }`
+    });
+  }
+
+  return {
+    id: ref.id,
+    schema,
+    schemaPath
+  };
+}
+
+interface SynthesisInput {
+  sends: LoadedEvent[];
+  receives: LoadedEvent[];
+}
+
+/**
+ * Build an AsyncAPI 3.0 document from the loaded events. Each event becomes
+ * a channel with the event id as the channel name and a single message whose
+ * payload is the event schema. The operation `action` is `'send'` for events
+ * in `sends` and `'receive'` for events in `receives`.
+ */
+export async function synthesizeAsyncAPIDocument(
+  service: ServiceMetadata,
+  events: SynthesisInput
+): Promise<AsyncAPIDocumentInterface> {
+  const channels: Record<string, unknown> = {};
+  const operations: Record<string, unknown> = {};
+
+  const addChannel = (event: LoadedEvent, action: 'send' | 'receive'): void => {
+    channels[event.id] = {
+      address: event.id,
+      messages: {
+        [event.id]: {
+          name: event.id,
+          payload: event.schema
+        }
+      }
+    };
+    operations[`${action}${event.id}`] = {
+      action,
+      channel: {$ref: `#/channels/${event.id}`},
+      messages: [{$ref: `#/channels/${event.id}/messages/${event.id}`}]
+    };
+  };
+
+  for (const event of events.sends) {
+    addChannel(event, 'send');
+  }
+  for (const event of events.receives) {
+    addChannel(event, 'receive');
+  }
+
+  const document = {
+    asyncapi: '3.0.0',
+    info: {
+      title: service.name ?? service.id,
+      version: service.version ?? '1.0.0',
+      ...(service.summary ? {description: service.summary} : {})
+    },
+    channels,
+    operations
+  };
+
+  const parsed = await loadAsyncapiFromMemory(JSON.stringify(document));
+  if (!parsed) {
+    throw createInputDocumentError({
+      inputPath: service.serviceDir,
+      inputType: 'eventcatalog',
+      errorMessage: `Failed to synthesize an AsyncAPI document for service '${service.id}'.`
+    });
+  }
+  return parsed;
+}
diff --git a/src/codegen/inputs/eventcatalog/index.ts b/src/codegen/inputs/eventcatalog/index.ts
new file mode 100644
index 00000000..3e770ef4
--- /dev/null
+++ b/src/codegen/inputs/eventcatalog/index.ts
@@ -0,0 +1,10 @@
+export {loadEventCatalog} from './parser';
+export type {EventCatalogLoadResult} from './parser';
+export {loadServiceMetadata} from './serviceLoader';
+export {loadEvent, synthesizeAsyncAPIDocument} from './eventLoader';
+export type {LoadedEvent} from './eventLoader';
+export type {
+  ServiceMetadata,
+  EventReference,
+  EventCatalogSpecType
+} from './types';
diff --git a/src/codegen/inputs/eventcatalog/parser.ts b/src/codegen/inputs/eventcatalog/parser.ts
new file mode 100644
index 00000000..9465d579
--- /dev/null
+++ b/src/codegen/inputs/eventcatalog/parser.ts
@@ -0,0 +1,104 @@
+/**
+ * Top-level EventCatalog input loader. Reads a service from the catalog,
+ * decides which underlying spec drives generation (AsyncAPI, OpenAPI, or
+ * a synthesized AsyncAPI document for native services), and returns the
+ * loaded document so the dispatch site in `realizeGeneratorContext` can
+ * populate the matching field on `RunGeneratorContext`.
+ */
+import {AsyncAPIDocumentInterface} from '@asyncapi/parser';
+import {OpenAPIV2, OpenAPIV3, OpenAPIV3_1} from 'openapi-types';
+import {RunGeneratorContext} from '../../types';
+import {CodegenError, ErrorType, createInputDocumentError} from '../../errors';
+import {loadAsyncapiDocument} from '../asyncapi';
+import {loadOpenapiDocument} from '../openapi';
+import {loadServiceMetadata} from './serviceLoader';
+import {loadEvent, synthesizeAsyncAPIDocument} from './eventLoader';
+import {EventCatalogSpecType} from './types';
+
+export interface EventCatalogLoadResult {
+  effectiveInputType: 'asyncapi' | 'openapi';
+  asyncapiDocument?: AsyncAPIDocumentInterface;
+  openapiDocument?:
+    | OpenAPIV3.Document
+    | OpenAPIV2.Document
+    | OpenAPIV3_1.Document;
+}
+
+interface EventCatalogConfigurationShape {
+  inputType: 'eventcatalog';
+  service: string;
+  specType?: EventCatalogSpecType;
+}
+
+/**
+ * Resolve the EventCatalog input declared in `context.configuration` and
+ * return the effective input type plus the loaded document. The caller
+ * is responsible for populating the corresponding field on the context
+ * and mutating `context.configuration.inputType` so downstream generators
+ * see a familiar `'asyncapi'` or `'openapi'` discriminator.
+ */
+export async function loadEventCatalog(
+  context: RunGeneratorContext
+): Promise<EventCatalogLoadResult> {
+  const config =
+    context.configuration as unknown as EventCatalogConfigurationShape;
+  const catalogRoot = context.documentPath;
+  const service = loadServiceMetadata(catalogRoot, config.service);
+
+  const hasAsync = Boolean(service.specifications?.asyncapiPath);
+  const hasOpen = Boolean(service.specifications?.openapiPath);
+
+  if (hasAsync && !hasOpen) {
+    const doc = await loadAsyncapiDocument(
+      service.specifications!.asyncapiPath!,
+      context.inputAuth
+    );
+    return {effectiveInputType: 'asyncapi', asyncapiDocument: doc};
+  }
+
+  if (hasOpen && !hasAsync) {
+    const doc = await loadOpenapiDocument(
+      service.specifications!.openapiPath!,
+      context.inputAuth
+    );
+    return {effectiveInputType: 'openapi', openapiDocument: doc};
+  }
+
+  if (hasAsync && hasOpen) {
+    if (!config.specType) {
+      throw new CodegenError({
+        type: ErrorType.INPUT_DOCUMENT_ERROR,
+        message: `EventCatalog service '${config.service}' declares both asyncapiPath and openapiPath. Set 'specType: "asyncapi"' or 'specType: "openapi"' on the configuration to choose which spec to generate from.`,
+        help: `Add 'specType: "asyncapi"' or 'specType: "openapi"' to your codegen configuration. Generating from both specs in a single run is not supported.`
+      });
+    }
+    if (config.specType === 'asyncapi') {
+      const doc = await loadAsyncapiDocument(
+        service.specifications!.asyncapiPath!,
+        context.inputAuth
+      );
+      return {effectiveInputType: 'asyncapi', asyncapiDocument: doc};
+    }
+    const doc = await loadOpenapiDocument(
+      service.specifications!.openapiPath!,
+      context.inputAuth
+    );
+    return {effectiveInputType: 'openapi', openapiDocument: doc};
+  }
+
+  // Native mode — synthesize an AsyncAPI document from the service's events.
+  if (service.sends.length === 0 && service.receives.length === 0) {
+    throw createInputDocumentError({
+      inputPath: service.serviceDir,
+      inputType: 'eventcatalog',
+      errorMessage: `Service '${config.service}' declares neither specifications nor any sends/receives events. Provide either an asyncapiPath/openapiPath in the service frontmatter or list events in 'sends'/'receives'.`
+    });
+  }
+  const sends = service.sends.map((ref) => loadEvent(catalogRoot, ref));
+  const receives = service.receives.map((ref) => loadEvent(catalogRoot, ref));
+  const synthesized = await synthesizeAsyncAPIDocument(service, {
+    sends,
+    receives
+  });
+  return {effectiveInputType: 'asyncapi', asyncapiDocument: synthesized};
+}
diff --git a/src/codegen/inputs/eventcatalog/serviceLoader.ts b/src/codegen/inputs/eventcatalog/serviceLoader.ts
new file mode 100644
index 00000000..dda8bc0d
--- /dev/null
+++ b/src/codegen/inputs/eventcatalog/serviceLoader.ts
@@ -0,0 +1,162 @@
+/**
+ * Loads service metadata from an EventCatalog directory by parsing
+ * the YAML frontmatter of the service's index.md.
+ */
+import fs from 'fs';
+import path from 'path';
+import {parse as parseYaml} from 'yaml';
+import {CodegenError, ErrorType, createInputDocumentError} from '../../errors';
+import {isRemoteUrl} from '../../../utils/inputSource';
+import {EventReference, ServiceMetadata} from './types';
+
+interface ServiceFrontmatter {
+  id?: string;
+  name?: string;
+  version?: string;
+  summary?: string;
+  sends?: EventReference[];
+  receives?: EventReference[];
+  specifications?: {
+    asyncapiPath?: string;
+    openapiPath?: string;
+  };
+}
+
+const FRONTMATTER_DELIMITER = '---';
+
+function readFrontmatter(filePath: string): ServiceFrontmatter {
+  let content: string;
+  try {
+    content = fs.readFileSync(filePath, 'utf8');
+  } catch (error) {
+    throw createInputDocumentError({
+      inputPath: filePath,
+      inputType: 'eventcatalog',
+      errorMessage: `Could not read file: ${error instanceof Error ? error.message : String(error)}`
+    });
+  }
+
+  const trimmed = content.trimStart();
+  if (!trimmed.startsWith(FRONTMATTER_DELIMITER)) {
+    throw createInputDocumentError({
+      inputPath: filePath,
+      inputType: 'eventcatalog',
+      errorMessage: `Missing YAML frontmatter (expected the file to start with '---').`
+    });
+  }
+  const afterFirst = trimmed.slice(FRONTMATTER_DELIMITER.length);
+  const closingIndex = afterFirst.indexOf(`\n${FRONTMATTER_DELIMITER}`);
+  if (closingIndex === -1) {
+    throw createInputDocumentError({
+      inputPath: filePath,
+      inputType: 'eventcatalog',
+      errorMessage: `Missing closing YAML frontmatter delimiter ('---').`
+    });
+  }
+  const rawFrontmatter = afterFirst.slice(0, closingIndex);
+  try {
+    const parsed = parseYaml(rawFrontmatter);
+    if (parsed && typeof parsed === 'object') {
+      return parsed as ServiceFrontmatter;
+    }
+    return {};
+  } catch (error) {
+    throw createInputDocumentError({
+      inputPath: filePath,
+      inputType: 'eventcatalog',
+      errorMessage: `Invalid YAML frontmatter: ${error instanceof Error ? error.message : String(error)}`
+    });
+  }
+}
+
+function listAvailableServices(servicesDir: string): string[] {
+  try {
+    return fs
+      .readdirSync(servicesDir, {withFileTypes: true})
+      .filter((entry) => entry.isDirectory())
+      .map((entry) => entry.name);
+  } catch {
+    return [];
+  }
+}
+
+function resolveSpecPath(specPath: string, serviceDir: string): string {
+  if (isRemoteUrl(specPath)) {
+    return specPath;
+  }
+  return path.resolve(serviceDir, specPath);
+}
+
+function normalizeEventReferences(
+  refs: EventReference[] | undefined
+): EventReference[] {
+  if (!Array.isArray(refs)) {
+    return [];
+  }
+  return refs
+    .filter(
+      (ref): ref is EventReference => Boolean(ref) && typeof ref.id === 'string'
+    )
+    .map((ref) => ({id: ref.id, version: ref.version}));
+}
+
+/**
+ * Resolve a service inside an EventCatalog directory and parse its metadata.
+ *
+ * @param catalogRoot Absolute path to the EventCatalog root (the directory
+ *   that contains the `services/` folder).
+ * @param serviceId The `id` of the service to load. Matches the directory
+ *   name under `services/`.
+ */
+export function loadServiceMetadata(
+  catalogRoot: string,
+  serviceId: string
+): ServiceMetadata {
+  const servicesDir = path.join(catalogRoot, 'services');
+  const serviceDir = path.join(servicesDir, serviceId);
+  const indexPath = path.join(serviceDir, 'index.md');
+
+  if (!fs.existsSync(serviceDir)) {
+    const available = listAvailableServices(servicesDir);
+    const availableHint = available.length
+      ? ` Available services: ${available.join(', ')}.`
+      : ' No services were found in the catalog.';
+    throw new CodegenError({
+      type: ErrorType.INPUT_DOCUMENT_ERROR,
+      message: `EventCatalog service '${serviceId}' was not found at ${serviceDir}.${availableHint}`,
+      help: `Check that 'service' in your codegen configuration matches a directory under '<inputPath>/services/'.`
+    });
+  }
+
+  if (!fs.existsSync(indexPath)) {
+    throw createInputDocumentError({
+      inputPath: indexPath,
+      inputType: 'eventcatalog',
+      errorMessage: `Service '${serviceId}' is missing an index.md file.`
+    });
+  }
+
+  const frontmatter = readFrontmatter(indexPath);
+
+  const specifications = frontmatter.specifications
+    ? {
+        asyncapiPath: frontmatter.specifications.asyncapiPath
+          ? resolveSpecPath(frontmatter.specifications.asyncapiPath, serviceDir)
+          : undefined,
+        openapiPath: frontmatter.specifications.openapiPath
+          ? resolveSpecPath(frontmatter.specifications.openapiPath, serviceDir)
+          : undefined
+      }
+    : undefined;
+
+  return {
+    id: frontmatter.id ?? serviceId,
+    name: frontmatter.name,
+    version: frontmatter.version,
+    summary: frontmatter.summary,
+    serviceDir,
+    specifications,
+    sends: normalizeEventReferences(frontmatter.sends),
+    receives: normalizeEventReferences(frontmatter.receives)
+  };
+}
diff --git a/src/codegen/inputs/eventcatalog/types.ts b/src/codegen/inputs/eventcatalog/types.ts
new file mode 100644
index 00000000..b2aaafd1
--- /dev/null
+++ b/src/codegen/inputs/eventcatalog/types.ts
@@ -0,0 +1,29 @@
+/**
+ * Internal types for the EventCatalog input loader.
+ */
+
+export interface EventReference {
+  id: string;
+  version?: string;
+}
+
+export interface ServiceMetadata {
+  id: string;
+  name?: string;
+  version?: string;
+  summary?: string;
+  /** Absolute path to the service's directory. */
+  serviceDir: string;
+  /**
+   * Resolved absolute paths to the service's spec files (or remote URLs
+   * if the frontmatter declared one).
+   */
+  specifications?: {
+    asyncapiPath?: string;
+    openapiPath?: string;
+  };
+  sends: EventReference[];
+  receives: EventReference[];
+}
+
+export type EventCatalogSpecType = 'asyncapi' | 'openapi';
diff --git a/src/codegen/inputs/index.ts b/src/codegen/inputs/index.ts
index 9fd69971..326d9a03 100644
--- a/src/codegen/inputs/index.ts
+++ b/src/codegen/inputs/index.ts
@@ -1,3 +1,4 @@
 export * from './asyncapi';
 export * from './openapi';
 export * from './jsonschema';
+export * from './eventcatalog';
diff --git a/src/codegen/renderer.ts b/src/codegen/renderer.ts
index ccdcaef1..20d35cee 100644
--- a/src/codegen/renderer.ts
+++ b/src/codegen/renderer.ts
@@ -232,7 +232,10 @@ export async function renderGenerator(
               outputPath
             },
             config: configuration,
-            inputType: configuration.inputType,
+            inputType: configuration.inputType as
+              | 'asyncapi'
+              | 'openapi'
+              | 'jsonschema',
             dependencyOutputs: renderedContext
           });
         }
@@ -252,7 +255,10 @@ export async function renderGenerator(
           asyncapiDocument,
           openapiDocument,
           jsonSchemaDocument,
-          inputType: configuration.inputType,
+          inputType: configuration.inputType as
+            | 'asyncapi'
+            | 'openapi'
+            | 'jsonschema',
           dependencyOutputs: renderedContext,
           generator
         },
diff --git a/src/codegen/types.ts b/src/codegen/types.ts
index f10a3cf3..7e1def34 100644
--- a/src/codegen/types.ts
+++ b/src/codegen/types.ts
@@ -369,17 +369,56 @@ export const zodJsonSchemaTypescriptConfig = z.object({
 // For now, only TypeScript is supported
 export const zodJsonSchemaCodegenConfiguration = zodJsonSchemaTypescriptConfig;
 
+// =============================================================================
+// EventCatalog Configuration
+// =============================================================================
+
+const EVENTCATALOG_SERVICE_DESCRIPTION =
+  'Service ID inside the EventCatalog directory to generate code for. Matches services/<id>/index.md.';
+const EVENTCATALOG_SPECTYPE_DESCRIPTION =
+  'Disambiguator used when the selected service declares both asyncapiPath and openapiPath. Set to "asyncapi" or "openapi" to choose which spec drives generation.';
+
+/**
+ * TypeScript configuration for EventCatalog input.
+ * The loader translates the selected service into one of the existing
+ * input flows (AsyncAPI or OpenAPI) before downstream generators run.
+ * The full AsyncAPI generator union is allowed since AsyncAPI is the
+ * most permissive of the existing inputs.
+ */
+export const zodEventCatalogTypescriptConfig = z.object({
+  $schema: z.string().optional().describe(SCHEMA_DESCRIPTION),
+  inputType: z.literal('eventcatalog').describe(DOCUMENT_TYPE_DESCRIPTION),
+  inputPath: z.string().describe(INPUT_PATH_DESCRIPTION),
+  auth: zodInputAuth,
+  service: z.string().describe(EVENTCATALOG_SERVICE_DESCRIPTION),
+  specType: z
+    .enum(['asyncapi', 'openapi'])
+    .optional()
+    .describe(EVENTCATALOG_SPECTYPE_DESCRIPTION),
+  ...zodTypeScriptConfigOptions,
+  generators: z
+    .array(zodAsyncAPITypeScriptGenerators)
+    .describe(GENERATORS_DESCRIPTION),
+  telemetry: zodProjectTelemetryConfig
+});
+
+// For now, only TypeScript is supported
+export const zodEventCatalogCodegenConfiguration =
+  zodEventCatalogTypescriptConfig;
+
 export const zodTheCodegenConfiguration: z.ZodDiscriminatedUnion<
   'inputType',
   [
     typeof zodAsyncAPICodegenConfiguration,
     typeof zodOpenAPICodegenConfiguration,
-    typeof zodJsonSchemaCodegenConfiguration
+    typeof zodJsonSchemaCodegenConfiguration,
+    typeof zodEventCatalogCodegenConfiguration
   ]
 > = z.discriminatedUnion('inputType', [
   zodAsyncAPICodegenConfiguration,
   zodOpenAPICodegenConfiguration,
-  zodJsonSchemaCodegenConfiguration
+  zodJsonSchemaCodegenConfiguration,
+  zodEventCatalogCodegenConfiguration
 ]);
 
 export type TheCodegenConfiguration = z.input<
diff --git a/src/commands/init.ts b/src/commands/init.ts
index 11cb14e7..88134274 100644
--- a/src/commands/init.ts
+++ b/src/commands/init.ts
@@ -44,6 +44,7 @@ const map = {
 interface FlagTypes {
   inputFile: string;
   inputType: string;
+  service?: string;
   configName: string;
   configType: (typeof ConfigOptions)[number];
   outputDirectory: string;
@@ -60,7 +61,8 @@ interface FlagTypes {
 interface InquirerAnswers {
   configName?: string;
   inputFile?: string;
-  inputType?: 'asyncapi' | 'openapi';
+  inputType?: 'asyncapi' | 'openapi' | 'jsonschema' | 'eventcatalog';
+  service?: string;
   configType?: (typeof ConfigOptions)[number];
   languages?: (typeof LanguageOptions)[number];
   includeClient?: boolean;
@@ -96,7 +98,11 @@ export default class Init extends BaseCommand {
     }),
     'input-type': Flags.string({
       description: 'Input file type',
-      options: ['asyncapi', 'openapi']
+      options: ['asyncapi', 'openapi', 'jsonschema', 'eventcatalog']
+    }),
+    service: Flags.string({
+      description:
+        'Service ID inside the EventCatalog directory (only used with --input-type=eventcatalog)'
     }),
     'output-directory': Flags.string({
       description: map.outputDirectory.description,
@@ -242,6 +248,7 @@ export default class Init extends BaseCommand {
   realizeFlags(flags: any): FlagTypes {
     const inputFile = flags['input-file'];
     const inputType = flags['input-type'];
+    const service = flags['service'];
     const configName = flags['config-name'];
     const configType = flags['config-type'];
     const outputDirectory = flags['output-directory'];
@@ -263,6 +270,7 @@ export default class Init extends BaseCommand {
       configName,
       inputFile,
       inputType,
+      service,
       configType,
       languages,
       noOutput,
@@ -285,6 +293,7 @@ export default class Init extends BaseCommand {
       outputDirectory,
       inputFile,
       inputType,
+      service,
       configType,
       languages,
       noOutput,
@@ -323,10 +332,30 @@ export default class Init extends BaseCommand {
             checked: false,
             value: 'openapi',
             line: 'OpenAPI document'
+          },
+          {
+            name: 'jsonschema',
+            checked: false,
+            value: 'jsonschema',
+            line: 'JSON Schema document'
+          },
+          {
+            name: 'eventcatalog',
+            checked: false,
+            value: 'eventcatalog',
+            line: 'EventCatalog directory'
           }
         ]
       });
     }
+    if (!service) {
+      questions.push({
+        name: 'service',
+        message: 'Which EventCatalog service do you want to generate code for?',
+        type: 'input',
+        when: (answers: InquirerAnswers) => answers.inputType === 'eventcatalog'
+      });
+    }
     questions.push({
       name: 'configType',
       message: 'Type of configuration?',
@@ -378,7 +407,9 @@ export default class Init extends BaseCommand {
         message: 'Do you want to include client wrapper?',
         type: 'confirm',
         when: (answers: InquirerAnswers) =>
-          answers.languages === 'typescript' && answers.inputType === 'asyncapi'
+          answers.languages === 'typescript' &&
+          (answers.inputType === 'asyncapi' ||
+            answers.inputType === 'eventcatalog')
       });
     }
     if (!includePayloads) {
@@ -387,7 +418,9 @@ export default class Init extends BaseCommand {
         message: 'Do you want to include payload structures?',
         type: 'confirm',
         when: (answers: InquirerAnswers) =>
-          answers.languages === 'typescript' && answers.inputType === 'asyncapi'
+          answers.languages === 'typescript' &&
+          (answers.inputType === 'asyncapi' ||
+            answers.inputType === 'eventcatalog')
       });
     }
     if (!includeHeaders) {
@@ -396,7 +429,9 @@ export default class Init extends BaseCommand {
         message: 'Do you want to include headers structures?',
         type: 'confirm',
         when: (answers: InquirerAnswers) =>
-          answers.languages === 'typescript' && answers.inputType === 'asyncapi'
+          answers.languages === 'typescript' &&
+          (answers.inputType === 'asyncapi' ||
+            answers.inputType === 'eventcatalog')
       });
     }
     if (!includeParameters) {
@@ -405,7 +440,9 @@ export default class Init extends BaseCommand {
         message: 'Do you want to include parameters structures?',
         type: 'confirm',
         when: (answers: InquirerAnswers) =>
-          answers.languages === 'typescript' && answers.inputType === 'asyncapi'
+          answers.languages === 'typescript' &&
+          (answers.inputType === 'asyncapi' ||
+            answers.inputType === 'eventcatalog')
       });
     }
     if (!includeChannels) {
@@ -415,7 +452,9 @@ export default class Init extends BaseCommand {
           'Do you want to include helper functions for interacting with channels?',
         type: 'confirm',
         when: (answers: InquirerAnswers) =>
-          answers.languages === 'typescript' && answers.inputType === 'asyncapi'
+          answers.languages === 'typescript' &&
+          (answers.inputType === 'asyncapi' ||
+            answers.inputType === 'eventcatalog')
       });
     }
 
@@ -437,6 +476,7 @@ export default class Init extends BaseCommand {
       includeClient ??= answers.includeClient;
       inputFile ??= answers.inputFile;
       inputType ??= answers.inputType;
+      service ??= answers.service;
       configName ??= answers.configName;
       languages ??= answers.languages;
       gitignoreGenerated ??= answers.gitignoreGenerated;
@@ -451,6 +491,7 @@ export default class Init extends BaseCommand {
       includeClient,
       inputFile,
       inputType,
+      service,
       languages,
       noOutput,
       configName,
@@ -470,8 +511,13 @@ export default class Init extends BaseCommand {
       language: flags.languages,
       generators: []
     };
+    if (flags.inputType === 'eventcatalog' && flags.service) {
+      configuration.service = flags.service;
+    }
+    const isAsyncapiClass =
+      flags.inputType === 'asyncapi' || flags.inputType === 'eventcatalog';
     if (flags.includeChannels) {
-      if (flags.languages === 'typescript' && flags.inputType === 'asyncapi') {
+      if (flags.languages === 'typescript' && isAsyncapiClass) {
         const generator: any = {...defaultTypeScriptChannelsGenerator};
         delete generator.dependencies;
         delete generator.id;
@@ -482,7 +528,7 @@ export default class Init extends BaseCommand {
       }
     }
     if (flags.includePayloads) {
-      if (flags.languages === 'typescript' && flags.inputType === 'asyncapi') {
+      if (flags.languages === 'typescript' && isAsyncapiClass) {
         const generator: any = {...defaultTypeScriptPayloadGenerator};
         delete generator.dependencies;
         delete generator.id;
@@ -491,7 +537,7 @@ export default class Init extends BaseCommand {
       }
     }
     if (flags.includeHeaders) {
-      if (flags.languages === 'typescript' && flags.inputType === 'asyncapi') {
+      if (flags.languages === 'typescript' && isAsyncapiClass) {
         const generator: any = {...defaultTypeScriptHeadersOptions};
         delete generator.dependencies;
         delete generator.id;
@@ -500,7 +546,7 @@ export default class Init extends BaseCommand {
       }
     }
     if (flags.includeClient) {
-      if (flags.languages === 'typescript' && flags.inputType === 'asyncapi') {
+      if (flags.languages === 'typescript' && isAsyncapiClass) {
         const generator: any = {...defaultTypeScriptClientGenerator};
         delete generator.dependencies;
         delete generator.id;
@@ -511,7 +557,7 @@ export default class Init extends BaseCommand {
     }
     // eslint-disable-next-line sonarjs/no-collapsible-if
     if (flags.includeParameters) {
-      if (flags.languages === 'typescript' && flags.inputType === 'asyncapi') {
+      if (flags.languages === 'typescript' && isAsyncapiClass) {
         const generator: any = {...defaultTypeScriptParametersOptions};
         delete generator.dependencies;
         delete generator.id;
diff --git a/src/telemetry/events.ts b/src/telemetry/events.ts
index 7cbc475c..30b8c13a 100644
--- a/src/telemetry/events.ts
+++ b/src/telemetry/events.ts
@@ -18,7 +18,7 @@ export interface CommandExecutedEvent extends TelemetryEvent {
   command: string;
   flags: string[];
   input_source?: 'remote_url' | 'local_relative' | 'local_absolute';
-  input_type?: 'asyncapi' | 'openapi' | 'jsonschema';
+  input_type?: 'asyncapi' | 'openapi' | 'jsonschema' | 'eventcatalog';
   generators?: string[]; // List of generator presets used together
   generator_count?: number; // Number of generators used
   duration: number;
@@ -36,7 +36,7 @@ export interface CommandExecutedEvent extends TelemetryEvent {
 export interface GeneratorUsedEvent extends TelemetryEvent {
   event: 'generator_used';
   generator_type: string;
-  input_type: 'asyncapi' | 'openapi' | 'jsonschema';
+  input_type: 'asyncapi' | 'openapi' | 'jsonschema' | 'eventcatalog';
   input_source?: 'remote_url' | 'local_relative' | 'local_absolute';
   language: string;
   options: Record<string, any>;
diff --git a/test/codegen/configurations.spec.ts b/test/codegen/configurations.spec.ts
index 5a1a6d6e..4ac9b128 100644
--- a/test/codegen/configurations.spec.ts
+++ b/test/codegen/configurations.spec.ts
@@ -418,4 +418,71 @@ describe('configuration manager', () => {
       ).not.toThrow();
     });
   });
+
+  describe('eventcatalog input branch', () => {
+    it('accepts a minimal eventcatalog config', () => {
+      expect(() =>
+        zodTheCodegenConfiguration.parse({
+          inputType: 'eventcatalog',
+          inputPath: './eventcatalog',
+          service: 'user-service',
+          language: 'typescript',
+          generators: []
+        })
+      ).not.toThrow();
+    });
+
+    it('rejects an eventcatalog config without service', () => {
+      expect(() =>
+        zodTheCodegenConfiguration.parse({
+          inputType: 'eventcatalog',
+          inputPath: './eventcatalog',
+          language: 'typescript',
+          generators: []
+        })
+      ).toThrow();
+    });
+
+    it('rejects an invalid specType value', () => {
+      expect(() =>
+        zodTheCodegenConfiguration.parse({
+          inputType: 'eventcatalog',
+          inputPath: './eventcatalog',
+          service: 'user-service',
+          specType: 'something-else',
+          language: 'typescript',
+          generators: []
+        })
+      ).toThrow();
+    });
+
+    it('accepts asyncapi-class generator presets (channels, client, payloads)', () => {
+      expect(() =>
+        zodTheCodegenConfiguration.parse({
+          inputType: 'eventcatalog',
+          inputPath: './eventcatalog',
+          service: 'user-service',
+          language: 'typescript',
+          generators: [
+            { preset: 'payloads', outputPath: './out/payloads' },
+            { preset: 'channels', outputPath: './out/channels', protocols: ['nats'] },
+            { preset: 'client', outputPath: './out/client', protocols: ['nats'] }
+          ]
+        })
+      ).not.toThrow();
+    });
+
+    it('accepts auth on the eventcatalog branch', () => {
+      expect(() =>
+        zodTheCodegenConfiguration.parse({
+          inputType: 'eventcatalog',
+          inputPath: 'https://example.com/eventcatalog',
+          service: 'user-service',
+          language: 'typescript',
+          auth: { type: 'bearer', token: 'tok' },
+          generators: []
+        })
+      ).not.toThrow();
+    });
+  });
 });
diff --git a/test/codegen/inputs/eventcatalog/__fixtures__/asyncapi-service/eventcatalog/services/user-service/asyncapi.yaml b/test/codegen/inputs/eventcatalog/__fixtures__/asyncapi-service/eventcatalog/services/user-service/asyncapi.yaml
new file mode 100644
index 00000000..bd1b8665
--- /dev/null
+++ b/test/codegen/inputs/eventcatalog/__fixtures__/asyncapi-service/eventcatalog/services/user-service/asyncapi.yaml
@@ -0,0 +1,27 @@
+asyncapi: 3.0.0
+info:
+  title: User Service
+  version: 1.0.0
+channels:
+  userSignedup:
+    address: user/signedup
+    messages:
+      UserSignedUp:
+        $ref: '#/components/messages/UserSignedUp'
+operations:
+  publishUserSignedup:
+    action: send
+    channel:
+      $ref: '#/channels/userSignedup'
+    messages:
+      - $ref: '#/channels/userSignedup/messages/UserSignedUp'
+components:
+  messages:
+    UserSignedUp:
+      payload:
+        type: object
+        properties:
+          userId:
+            type: string
+          email:
+            type: string
diff --git a/test/codegen/inputs/eventcatalog/__fixtures__/asyncapi-service/eventcatalog/services/user-service/index.md b/test/codegen/inputs/eventcatalog/__fixtures__/asyncapi-service/eventcatalog/services/user-service/index.md
new file mode 100644
index 00000000..d11ddae2
--- /dev/null
+++ b/test/codegen/inputs/eventcatalog/__fixtures__/asyncapi-service/eventcatalog/services/user-service/index.md
@@ -0,0 +1,14 @@
+---
+id: user-service
+name: User Service
+version: 1.0.0
+summary: Handles user signup
+sends:
+  - id: UserSignedUp
+    version: 1.0.0
+receives: []
+specifications:
+  asyncapiPath: asyncapi.yaml
+---
+
+User service docs.
diff --git a/test/codegen/inputs/eventcatalog/__fixtures__/both-specs-service/eventcatalog/services/order-service/asyncapi.yaml b/test/codegen/inputs/eventcatalog/__fixtures__/both-specs-service/eventcatalog/services/order-service/asyncapi.yaml
new file mode 100644
index 00000000..431a041c
--- /dev/null
+++ b/test/codegen/inputs/eventcatalog/__fixtures__/both-specs-service/eventcatalog/services/order-service/asyncapi.yaml
@@ -0,0 +1,19 @@
+asyncapi: 3.0.0
+info:
+  title: Order Service
+  version: 1.0.0
+channels:
+  orderCreated:
+    address: order/created
+    messages:
+      OrderCreated:
+        payload:
+          type: object
+          properties:
+            orderId:
+              type: string
+operations:
+  publishOrderCreated:
+    action: send
+    channel:
+      $ref: '#/channels/orderCreated'
diff --git a/test/codegen/inputs/eventcatalog/__fixtures__/both-specs-service/eventcatalog/services/order-service/index.md b/test/codegen/inputs/eventcatalog/__fixtures__/both-specs-service/eventcatalog/services/order-service/index.md
new file mode 100644
index 00000000..37835c3c
--- /dev/null
+++ b/test/codegen/inputs/eventcatalog/__fixtures__/both-specs-service/eventcatalog/services/order-service/index.md
@@ -0,0 +1,13 @@
+---
+id: order-service
+name: Order Service
+version: 1.0.0
+summary: Has both specs
+sends: []
+receives: []
+specifications:
+  asyncapiPath: asyncapi.yaml
+  openapiPath: openapi.json
+---
+
+A service with both AsyncAPI and OpenAPI specs.
diff --git a/test/codegen/inputs/eventcatalog/__fixtures__/both-specs-service/eventcatalog/services/order-service/openapi.json b/test/codegen/inputs/eventcatalog/__fixtures__/both-specs-service/eventcatalog/services/order-service/openapi.json
new file mode 100644
index 00000000..f9b08d2f
--- /dev/null
+++ b/test/codegen/inputs/eventcatalog/__fixtures__/both-specs-service/eventcatalog/services/order-service/openapi.json
@@ -0,0 +1,19 @@
+{
+  "openapi": "3.0.0",
+  "info": {
+    "title": "Order API",
+    "version": "1.0.0"
+  },
+  "paths": {
+    "/orders": {
+      "get": {
+        "operationId": "listOrders",
+        "responses": {
+          "200": {
+            "description": "OK"
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/test/codegen/inputs/eventcatalog/__fixtures__/invalid/missing-event-schema/eventcatalog/events/MissingSchemaEvent/index.md b/test/codegen/inputs/eventcatalog/__fixtures__/invalid/missing-event-schema/eventcatalog/events/MissingSchemaEvent/index.md
new file mode 100644
index 00000000..bc73017d
--- /dev/null
+++ b/test/codegen/inputs/eventcatalog/__fixtures__/invalid/missing-event-schema/eventcatalog/events/MissingSchemaEvent/index.md
@@ -0,0 +1,8 @@
+---
+id: MissingSchemaEvent
+name: Missing Schema Event
+version: 1.0.0
+schemaPath: nonexistent.json
+---
+
+This event references a schema that does not exist.
diff --git a/test/codegen/inputs/eventcatalog/__fixtures__/invalid/missing-event-schema/eventcatalog/services/broken-service/index.md b/test/codegen/inputs/eventcatalog/__fixtures__/invalid/missing-event-schema/eventcatalog/services/broken-service/index.md
new file mode 100644
index 00000000..7d7a824a
--- /dev/null
+++ b/test/codegen/inputs/eventcatalog/__fixtures__/invalid/missing-event-schema/eventcatalog/services/broken-service/index.md
@@ -0,0 +1,11 @@
+---
+id: broken-service
+name: Broken Service
+version: 1.0.0
+sends:
+  - id: MissingSchemaEvent
+    version: 1.0.0
+receives: []
+---
+
+Service references an event whose schema cannot be found.
diff --git a/test/codegen/inputs/eventcatalog/__fixtures__/invalid/missing-frontmatter/eventcatalog/services/broken-service/index.md b/test/codegen/inputs/eventcatalog/__fixtures__/invalid/missing-frontmatter/eventcatalog/services/broken-service/index.md
new file mode 100644
index 00000000..372c7dcd
--- /dev/null
+++ b/test/codegen/inputs/eventcatalog/__fixtures__/invalid/missing-frontmatter/eventcatalog/services/broken-service/index.md
@@ -0,0 +1,3 @@
+No frontmatter at all here.
+
+Just markdown content.
diff --git a/test/codegen/inputs/eventcatalog/__fixtures__/invalid/missing-service/eventcatalog/services/.gitkeep b/test/codegen/inputs/eventcatalog/__fixtures__/invalid/missing-service/eventcatalog/services/.gitkeep
new file mode 100644
index 00000000..e69de29b
diff --git a/test/codegen/inputs/eventcatalog/__fixtures__/native-service/eventcatalog/events/OrderCreated/index.md b/test/codegen/inputs/eventcatalog/__fixtures__/native-service/eventcatalog/events/OrderCreated/index.md
new file mode 100644
index 00000000..b23c3704
--- /dev/null
+++ b/test/codegen/inputs/eventcatalog/__fixtures__/native-service/eventcatalog/events/OrderCreated/index.md
@@ -0,0 +1,9 @@
+---
+id: OrderCreated
+name: Order Created
+version: 1.0.0
+summary: Published when a new order is placed
+schemaPath: schema.json
+---
+
+Event published when a customer places a new order.
diff --git a/test/codegen/inputs/eventcatalog/__fixtures__/native-service/eventcatalog/events/OrderCreated/schema.json b/test/codegen/inputs/eventcatalog/__fixtures__/native-service/eventcatalog/events/OrderCreated/schema.json
new file mode 100644
index 00000000..34cb0c24
--- /dev/null
+++ b/test/codegen/inputs/eventcatalog/__fixtures__/native-service/eventcatalog/events/OrderCreated/schema.json
@@ -0,0 +1,11 @@
+{
+  "$id": "OrderCreated",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "required": ["orderId", "customerId"],
+  "properties": {
+    "orderId": { "type": "string", "format": "uuid" },
+    "customerId": { "type": "string", "format": "uuid" },
+    "totalAmount": { "type": "number" }
+  }
+}
diff --git a/test/codegen/inputs/eventcatalog/__fixtures__/native-service/eventcatalog/events/OrderShipped/index.md b/test/codegen/inputs/eventcatalog/__fixtures__/native-service/eventcatalog/events/OrderShipped/index.md
new file mode 100644
index 00000000..38fc3cde
--- /dev/null
+++ b/test/codegen/inputs/eventcatalog/__fixtures__/native-service/eventcatalog/events/OrderShipped/index.md
@@ -0,0 +1,9 @@
+---
+id: OrderShipped
+name: Order Shipped
+version: 1.0.0
+summary: Published when an order ships
+schemaPath: schema.json
+---
+
+Event published when the order ships.
diff --git a/test/codegen/inputs/eventcatalog/__fixtures__/native-service/eventcatalog/events/OrderShipped/schema.json b/test/codegen/inputs/eventcatalog/__fixtures__/native-service/eventcatalog/events/OrderShipped/schema.json
new file mode 100644
index 00000000..21864809
--- /dev/null
+++ b/test/codegen/inputs/eventcatalog/__fixtures__/native-service/eventcatalog/events/OrderShipped/schema.json
@@ -0,0 +1,10 @@
+{
+  "$id": "OrderShipped",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "required": ["orderId", "trackingNumber"],
+  "properties": {
+    "orderId": { "type": "string", "format": "uuid" },
+    "trackingNumber": { "type": "string" }
+  }
+}
diff --git a/test/codegen/inputs/eventcatalog/__fixtures__/native-service/eventcatalog/services/order-service/index.md b/test/codegen/inputs/eventcatalog/__fixtures__/native-service/eventcatalog/services/order-service/index.md
new file mode 100644
index 00000000..fda3e6e2
--- /dev/null
+++ b/test/codegen/inputs/eventcatalog/__fixtures__/native-service/eventcatalog/services/order-service/index.md
@@ -0,0 +1,14 @@
+---
+id: order-service
+name: Order Service
+version: 1.2.3
+summary: Manages order lifecycle
+sends:
+  - id: OrderCreated
+    version: 1.0.0
+receives:
+  - id: OrderShipped
+    version: 1.0.0
+---
+
+The Order Service handles order creation and fulfillment.
diff --git a/test/codegen/inputs/eventcatalog/__fixtures__/openapi-service/eventcatalog/services/petstore-api/index.md b/test/codegen/inputs/eventcatalog/__fixtures__/openapi-service/eventcatalog/services/petstore-api/index.md
new file mode 100644
index 00000000..0230f9ea
--- /dev/null
+++ b/test/codegen/inputs/eventcatalog/__fixtures__/openapi-service/eventcatalog/services/petstore-api/index.md
@@ -0,0 +1,12 @@
+---
+id: petstore-api
+name: Petstore API
+version: 1.0.0
+summary: REST API for petstore
+sends: []
+receives: []
+specifications:
+  openapiPath: openapi.json
+---
+
+Petstore docs.
diff --git a/test/codegen/inputs/eventcatalog/__fixtures__/openapi-service/eventcatalog/services/petstore-api/openapi.json b/test/codegen/inputs/eventcatalog/__fixtures__/openapi-service/eventcatalog/services/petstore-api/openapi.json
new file mode 100644
index 00000000..5da1cf5c
--- /dev/null
+++ b/test/codegen/inputs/eventcatalog/__fixtures__/openapi-service/eventcatalog/services/petstore-api/openapi.json
@@ -0,0 +1,39 @@
+{
+  "openapi": "3.0.0",
+  "info": {
+    "title": "Petstore",
+    "version": "1.0.0"
+  },
+  "paths": {
+    "/pets": {
+      "get": {
+        "operationId": "listPets",
+        "responses": {
+          "200": {
+            "description": "OK",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": { "$ref": "#/components/schemas/Pet" }
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  },
+  "components": {
+    "schemas": {
+      "Pet": {
+        "type": "object",
+        "required": ["id", "name"],
+        "properties": {
+          "id": { "type": "integer" },
+          "name": { "type": "string" }
+        }
+      }
+    }
+  }
+}
diff --git a/test/codegen/inputs/eventcatalog/eventLoader.spec.ts b/test/codegen/inputs/eventcatalog/eventLoader.spec.ts
new file mode 100644
index 00000000..85f229ea
--- /dev/null
+++ b/test/codegen/inputs/eventcatalog/eventLoader.spec.ts
@@ -0,0 +1,93 @@
+import path from 'path';
+import {loadServiceMetadata} from '../../../../src/codegen/inputs/eventcatalog/serviceLoader';
+import {
+  loadEvent,
+  synthesizeAsyncAPIDocument
+} from '../../../../src/codegen/inputs/eventcatalog/eventLoader';
+
+const FIXTURES = path.resolve(__dirname, './__fixtures__');
+const nativeCatalog = path.join(FIXTURES, 'native-service/eventcatalog');
+const missingEventSchema = path.join(
+  FIXTURES,
+  'invalid/missing-event-schema/eventcatalog'
+);
+
+describe('EventCatalog eventLoader', () => {
+  describe('loadEvent', () => {
+    it('loads an event schema from events/<id>/schema.json', () => {
+      const event = loadEvent(nativeCatalog, {
+        id: 'OrderCreated',
+        version: '1.0.0'
+      });
+      expect(event.id).toBe('OrderCreated');
+      expect(event.schema.$id).toBe('OrderCreated');
+      expect(event.schema.type).toBe('object');
+      expect(event.schema.properties).toHaveProperty('orderId');
+    });
+
+    it('throws when the event directory does not exist', () => {
+      expect(() =>
+        loadEvent(nativeCatalog, {id: 'NonExistentEvent', version: '1.0.0'})
+      ).toThrow(/NonExistentEvent/);
+    });
+
+    it('throws when schemaPath cannot be resolved', () => {
+      expect(() =>
+        loadEvent(missingEventSchema, {
+          id: 'MissingSchemaEvent',
+          version: '1.0.0'
+        })
+      ).toThrow(/MissingSchemaEvent|nonexistent/);
+    });
+  });
+
+  describe('synthesizeAsyncAPIDocument', () => {
+    it('synthesizes an AsyncAPI 3.0 document with one channel per send + receive event', async () => {
+      const service = loadServiceMetadata(nativeCatalog, 'order-service');
+      const sends = service.sends.map((ref) => loadEvent(nativeCatalog, ref));
+      const receives = service.receives.map((ref) =>
+        loadEvent(nativeCatalog, ref)
+      );
+
+      const doc = await synthesizeAsyncAPIDocument(service, {sends, receives});
+      const json = doc.json() as any;
+
+      expect(json.asyncapi).toBe('3.0.0');
+      expect(json.info.title).toBe('Order Service');
+      expect(json.info.version).toBe('1.2.3');
+
+      const channels = json.channels ?? {};
+      expect(Object.keys(channels)).toEqual(
+        expect.arrayContaining(['OrderCreated', 'OrderShipped'])
+      );
+
+      const operations = json.operations ?? {};
+      const ops = Object.values(operations) as Array<{action: string}>;
+      const sendActions = ops.filter((op) => op.action === 'send');
+      const receiveActions = ops.filter((op) => op.action === 'receive');
+      expect(sendActions.length).toBe(1);
+      expect(receiveActions.length).toBe(1);
+    });
+
+    it('falls back to service.id when name is missing', async () => {
+      const service = loadServiceMetadata(nativeCatalog, 'order-service');
+      const minimalService = {
+        ...service,
+        name: undefined,
+        version: undefined
+      };
+      const sends = service.sends.map((ref) => loadEvent(nativeCatalog, ref));
+      const receives = service.receives.map((ref) =>
+        loadEvent(nativeCatalog, ref)
+      );
+
+      const doc = await synthesizeAsyncAPIDocument(minimalService as any, {
+        sends,
+        receives
+      });
+      const json = doc.json() as any;
+      expect(json.info.title).toBe('order-service');
+      expect(json.info.version).toBe('1.0.0');
+    });
+  });
+});
diff --git a/test/codegen/inputs/eventcatalog/parser.spec.ts b/test/codegen/inputs/eventcatalog/parser.spec.ts
new file mode 100644
index 00000000..b9373212
--- /dev/null
+++ b/test/codegen/inputs/eventcatalog/parser.spec.ts
@@ -0,0 +1,89 @@
+import path from 'path';
+import {loadEventCatalog} from '../../../../src/codegen/inputs/eventcatalog';
+import {RunGeneratorContext} from '../../../../src/codegen/types';
+
+const FIXTURES = path.resolve(__dirname, './__fixtures__');
+
+function buildContext(catalogPath: string, overrides: any = {}): RunGeneratorContext {
+  return {
+    configuration: {
+      inputType: 'eventcatalog' as any,
+      inputPath: catalogPath,
+      service: 'user-service',
+      language: 'typescript',
+      generators: [],
+      ...overrides
+    } as any,
+    configFilePath: 'codegen.json',
+    documentPath: catalogPath
+  };
+}
+
+describe('EventCatalog parser (loadEventCatalog)', () => {
+  it('returns asyncapi for a service that only has asyncapiPath', async () => {
+    const ctx = buildContext(
+      path.join(FIXTURES, 'asyncapi-service/eventcatalog'),
+      {service: 'user-service'}
+    );
+    const result = await loadEventCatalog(ctx);
+    expect(result.effectiveInputType).toBe('asyncapi');
+    expect(result.asyncapiDocument).toBeDefined();
+    expect(result.openapiDocument).toBeUndefined();
+  });
+
+  it('returns openapi for a service that only has openapiPath', async () => {
+    const ctx = buildContext(
+      path.join(FIXTURES, 'openapi-service/eventcatalog'),
+      {service: 'petstore-api'}
+    );
+    const result = await loadEventCatalog(ctx);
+    expect(result.effectiveInputType).toBe('openapi');
+    expect(result.openapiDocument).toBeDefined();
+    expect(result.asyncapiDocument).toBeUndefined();
+  });
+
+  it('synthesizes asyncapi for a native service', async () => {
+    const ctx = buildContext(
+      path.join(FIXTURES, 'native-service/eventcatalog'),
+      {service: 'order-service'}
+    );
+    const result = await loadEventCatalog(ctx);
+    expect(result.effectiveInputType).toBe('asyncapi');
+    expect(result.asyncapiDocument).toBeDefined();
+    const json = (result.asyncapiDocument as any).json() as any;
+    expect(json.asyncapi).toBe('3.0.0');
+    expect(Object.keys(json.channels ?? {})).toEqual(
+      expect.arrayContaining(['OrderCreated', 'OrderShipped'])
+    );
+  });
+
+  it('throws when both specs exist and specType is missing', async () => {
+    const ctx = buildContext(
+      path.join(FIXTURES, 'both-specs-service/eventcatalog'),
+      {service: 'order-service'}
+    );
+    await expect(loadEventCatalog(ctx)).rejects.toThrow(/specType/);
+  });
+
+  it('honors specType: "openapi" when both specs exist', async () => {
+    const ctx = buildContext(
+      path.join(FIXTURES, 'both-specs-service/eventcatalog'),
+      {service: 'order-service', specType: 'openapi'}
+    );
+    const result = await loadEventCatalog(ctx);
+    expect(result.effectiveInputType).toBe('openapi');
+    expect(result.openapiDocument).toBeDefined();
+    expect(result.asyncapiDocument).toBeUndefined();
+  });
+
+  it('honors specType: "asyncapi" when both specs exist', async () => {
+    const ctx = buildContext(
+      path.join(FIXTURES, 'both-specs-service/eventcatalog'),
+      {service: 'order-service', specType: 'asyncapi'}
+    );
+    const result = await loadEventCatalog(ctx);
+    expect(result.effectiveInputType).toBe('asyncapi');
+    expect(result.asyncapiDocument).toBeDefined();
+    expect(result.openapiDocument).toBeUndefined();
+  });
+});
diff --git a/test/codegen/inputs/eventcatalog/serviceLoader.spec.ts b/test/codegen/inputs/eventcatalog/serviceLoader.spec.ts
new file mode 100644
index 00000000..899daf2f
--- /dev/null
+++ b/test/codegen/inputs/eventcatalog/serviceLoader.spec.ts
@@ -0,0 +1,85 @@
+import path from 'path';
+import {loadServiceMetadata} from '../../../../src/codegen/inputs/eventcatalog/serviceLoader';
+
+const FIXTURES = path.resolve(__dirname, './__fixtures__');
+
+const asyncapiCatalog = path.join(FIXTURES, 'asyncapi-service/eventcatalog');
+const openapiCatalog = path.join(FIXTURES, 'openapi-service/eventcatalog');
+const nativeCatalog = path.join(FIXTURES, 'native-service/eventcatalog');
+const bothSpecsCatalog = path.join(FIXTURES, 'both-specs-service/eventcatalog');
+const missingServiceCatalog = path.join(
+  FIXTURES,
+  'invalid/missing-service/eventcatalog'
+);
+const missingFrontmatterCatalog = path.join(
+  FIXTURES,
+  'invalid/missing-frontmatter/eventcatalog'
+);
+
+describe('EventCatalog serviceLoader', () => {
+  it('resolves service metadata for an AsyncAPI service', () => {
+    const metadata = loadServiceMetadata(asyncapiCatalog, 'user-service');
+    expect(metadata.id).toBe('user-service');
+    expect(metadata.name).toBe('User Service');
+    expect(metadata.version).toBe('1.0.0');
+    expect(metadata.specifications?.asyncapiPath).toMatch(/asyncapi\.yaml$/);
+    expect(metadata.specifications?.openapiPath).toBeUndefined();
+    expect(metadata.sends.map((e) => e.id)).toEqual(['UserSignedUp']);
+    expect(metadata.receives).toEqual([]);
+  });
+
+  it('resolves service metadata for an OpenAPI service', () => {
+    const metadata = loadServiceMetadata(openapiCatalog, 'petstore-api');
+    expect(metadata.id).toBe('petstore-api');
+    expect(metadata.specifications?.openapiPath).toMatch(/openapi\.json$/);
+    expect(metadata.specifications?.asyncapiPath).toBeUndefined();
+  });
+
+  it('parses native services without specifications', () => {
+    const metadata = loadServiceMetadata(nativeCatalog, 'order-service');
+    expect(metadata.specifications).toBeUndefined();
+    expect(metadata.sends.map((e) => e.id)).toEqual(['OrderCreated']);
+    expect(metadata.receives.map((e) => e.id)).toEqual(['OrderShipped']);
+  });
+
+  it('parses both asyncapiPath and openapiPath when provided', () => {
+    const metadata = loadServiceMetadata(bothSpecsCatalog, 'order-service');
+    expect(metadata.specifications?.asyncapiPath).toMatch(/asyncapi\.yaml$/);
+    expect(metadata.specifications?.openapiPath).toMatch(/openapi\.json$/);
+  });
+
+  it('resolves service paths to absolute paths inside the service directory', () => {
+    const metadata = loadServiceMetadata(asyncapiCatalog, 'user-service');
+    expect(path.isAbsolute(metadata.serviceDir)).toBe(true);
+    expect(path.isAbsolute(metadata.specifications!.asyncapiPath!)).toBe(true);
+  });
+
+  it('throws when the service directory does not exist and lists known services', () => {
+    expect(() =>
+      loadServiceMetadata(asyncapiCatalog, 'unknown-service')
+    ).toThrow(/unknown-service/);
+    expect(() =>
+      loadServiceMetadata(asyncapiCatalog, 'unknown-service')
+    ).toThrow(/user-service/);
+  });
+
+  it('throws when services/<id>/index.md is missing', () => {
+    expect(() =>
+      loadServiceMetadata(missingServiceCatalog, 'whatever')
+    ).toThrow(/whatever/);
+  });
+
+  it('throws when index.md has no frontmatter', () => {
+    expect(() =>
+      loadServiceMetadata(missingFrontmatterCatalog, 'broken-service')
+    ).toThrow(/frontmatter|YAML/i);
+  });
+
+  it('uses the exact service ID supplied by the user when looking up the directory', () => {
+    // We can't reliably assert case-sensitivity because Windows + macOS
+    // filesystems are case-insensitive by default. Instead we assert that
+    // the service ID we asked for is preserved in the returned metadata.
+    const metadata = loadServiceMetadata(asyncapiCatalog, 'user-service');
+    expect(metadata.id).toBe('user-service');
+  });
+});
diff --git a/test/runtime/typescript/codegen-eventcatalog.mjs b/test/runtime/typescript/codegen-eventcatalog.mjs
new file mode 100644
index 00000000..9dd79b95
--- /dev/null
+++ b/test/runtime/typescript/codegen-eventcatalog.mjs
@@ -0,0 +1,24 @@
+/** @type {import("../../../dist").TheCodegenConfiguration} **/
+export default {
+	inputType: 'eventcatalog',
+	inputPath: './eventcatalog',
+	service: 'test-service',
+	language: 'typescript',
+	generators: [
+		{
+			preset: 'payloads',
+			outputPath: './src/eventcatalog/payloads',
+			serializationType: 'json',
+		},
+		{
+			preset: 'channels',
+			outputPath: './src/eventcatalog/channels',
+			protocols: ['nats']
+		},
+		{
+			preset: 'client',
+			outputPath: './src/eventcatalog/client',
+			protocols: ['nats']
+		}
+	]
+};
diff --git a/test/runtime/typescript/eventcatalog/services/test-service/asyncapi.yaml b/test/runtime/typescript/eventcatalog/services/test-service/asyncapi.yaml
new file mode 100644
index 00000000..2cc1b878
--- /dev/null
+++ b/test/runtime/typescript/eventcatalog/services/test-service/asyncapi.yaml
@@ -0,0 +1,29 @@
+asyncapi: 3.0.0
+info:
+  title: EventCatalog Runtime Test
+  version: 1.0.0
+channels:
+  eventcatalogPing:
+    address: eventcatalog/ping
+    messages:
+      EventCatalogPing:
+        payload:
+          type: object
+          required:
+            - message
+          properties:
+            message:
+              type: string
+operations:
+  sendEventcatalogPing:
+    action: send
+    channel:
+      $ref: '#/channels/eventcatalogPing'
+    messages:
+      - $ref: '#/channels/eventcatalogPing/messages/EventCatalogPing'
+  receiveEventcatalogPing:
+    action: receive
+    channel:
+      $ref: '#/channels/eventcatalogPing'
+    messages:
+      - $ref: '#/channels/eventcatalogPing/messages/EventCatalogPing'
diff --git a/test/runtime/typescript/eventcatalog/services/test-service/index.md b/test/runtime/typescript/eventcatalog/services/test-service/index.md
new file mode 100644
index 00000000..9ed4b8d0
--- /dev/null
+++ b/test/runtime/typescript/eventcatalog/services/test-service/index.md
@@ -0,0 +1,12 @@
+---
+id: test-service
+name: Test Service
+version: 1.0.0
+summary: Service used by the EventCatalog runtime smoke test
+sends: []
+receives: []
+specifications:
+  asyncapiPath: asyncapi.yaml
+---
+
+Used by the EventCatalog runtime smoke test.
diff --git a/test/runtime/typescript/package.json b/test/runtime/typescript/package.json
index 6210ca80..f409ab27 100644
--- a/test/runtime/typescript/package.json
+++ b/test/runtime/typescript/package.json
@@ -1,6 +1,7 @@
 {
   "scripts": {
-    "test": "npm run test:kafka && npm run test:nats && npm run test:mqtt && npm run test:amqp && npm run test:eventsource && npm run test:websocket && npm run test:http",
+    "test": "npm run test:kafka && npm run test:nats && npm run test:mqtt && npm run test:amqp && npm run test:eventsource && npm run test:websocket && npm run test:http && npm run test:eventcatalog",
+    "test:eventcatalog": "jest -- ./test/inputs/eventcatalog.spec.ts",
     "test:regular": "jest -- ./test/headers.spec.ts ./test/parameters.spec.ts ./test/payloads.spec.ts ./test/types.spec.ts",
     "test:kafka": "jest -- ./test/channels/regular/kafka.spec.ts",
     "test:nats": "npm run test:nats:client && npm run test:nats:channels",
@@ -12,11 +13,12 @@
     "test:websocket": "jest -- ./test/channels/regular/websocket.spec.ts",
     "test:http": "jest -- ./test/channels/request_reply/http_client/",
     "test:payload-types": "jest -- ./test/payload-types/",
-    "generate": "npm run generate:regular && npm run generate:request:reply && npm run generate:openapi && npm run generate:payload-types",
+    "generate": "npm run generate:regular && npm run generate:request:reply && npm run generate:openapi && npm run generate:payload-types && npm run generate:eventcatalog",
     "generate:request:reply": "cross-env CODEGEN_TELEMETRY_DISABLED=1 node ../../../bin/run.mjs generate ./codegen-request-reply.mjs",
     "generate:regular": "cross-env CODEGEN_TELEMETRY_DISABLED=1 node ../../../bin/run.mjs generate ./codegen-regular.mjs",
     "generate:openapi": "cross-env CODEGEN_TELEMETRY_DISABLED=1 node ../../../bin/run.mjs generate ./codegen-openapi.mjs",
     "generate:payload-types": "cross-env CODEGEN_TELEMETRY_DISABLED=1 node ../../../bin/run.mjs generate ./codegen-payload-types.mjs",
+    "generate:eventcatalog": "cross-env CODEGEN_TELEMETRY_DISABLED=1 node ../../../bin/run.mjs generate ./codegen-eventcatalog.mjs",
     "debug:generate": "node --inspect-brk ../../../bin/run.mjs generate"
   },
   "dependencies": {
diff --git a/test/runtime/typescript/src/eventcatalog/channels/index.ts b/test/runtime/typescript/src/eventcatalog/channels/index.ts
new file mode 100644
index 00000000..ae7a1464
--- /dev/null
+++ b/test/runtime/typescript/src/eventcatalog/channels/index.ts
@@ -0,0 +1,3 @@
+import * as nats from './nats';
+
+export {nats};
diff --git a/test/runtime/typescript/src/eventcatalog/channels/nats.ts b/test/runtime/typescript/src/eventcatalog/channels/nats.ts
new file mode 100644
index 00000000..083ae87c
--- /dev/null
+++ b/test/runtime/typescript/src/eventcatalog/channels/nats.ts
@@ -0,0 +1,233 @@
+import {EventCatalogPing} from './../payloads/EventCatalogPing';
+import * as Nats from 'nats';
+
+/**
+ * NATS publish operation for `eventcatalog.ping`
+ *
+ * @param message to publish
+ * @param nc the NATS client to publish from
+ * @param codec the serialization codec to use while transmitting the message
+ * @param options to use while publishing the message
+ */
+function publishToSendEventcatalogPing({
+  message, 
+  nc, 
+  codec = Nats.JSONCodec(), 
+  options
+}: {
+  message: EventCatalogPing, 
+  nc: Nats.NatsConnection, 
+  codec?: Nats.Codec<any>, 
+  options?: Nats.PublishOptions
+}): Promise<void> {
+  return new Promise<void>(async (resolve, reject) => {
+    try {
+      let dataToSend: any = message.marshal();
+      
+dataToSend = codec.encode(dataToSend);
+nc.publish('eventcatalog.ping', dataToSend, options);
+      resolve();
+    } catch (e: any) {
+      reject(e);
+    }
+  });
+}
+
+/**
+ * JetStream publish operation for `eventcatalog.ping`
+ *
+ * @param message to publish over jetstream
+ * @param js the JetStream client to publish from
+ * @param codec the serialization codec to use while transmitting the message
+ * @param options to use while publishing the message
+ */
+function jetStreamPublishToSendEventcatalogPing({
+  message, 
+  js, 
+  codec = Nats.JSONCodec(), 
+  options = {}
+}: {
+  message: EventCatalogPing, 
+  js: Nats.JetStreamClient, 
+  codec?: Nats.Codec<any>, 
+  options?: Partial<Nats.JetStreamPublishOptions>
+}): Promise<void> {
+  return new Promise<void>(async (resolve, reject) => {
+    try {
+      let dataToSend: any = message.marshal();
+      
+dataToSend = codec.encode(dataToSend);
+await js.publish('eventcatalog.ping', dataToSend, options);
+      resolve();
+    } catch (e: any) {
+      reject(e);
+    }
+  });
+}
+
+/**
+ * Callback for when receiving messages
+ *
+ * @callback subscribeToReceiveEventcatalogPingCallback
+ * @param err if any error occurred this will be sat
+ * @param msg that was received
+ * @param natsMsg
+ */
+
+/**
+ * Core subscription for `eventcatalog.ping`
+ *
+ * @param {subscribeToReceiveEventcatalogPingCallback} onDataCallback to call when messages are received
+ * @param nc the nats client to setup the subscribe for
+ * @param codec the serialization codec to use while receiving the message
+ * @param options when setting up the subscription
+ * @param skipMessageValidation turn off runtime validation of incoming messages
+ */
+function subscribeToReceiveEventcatalogPing({
+  onDataCallback, 
+  nc, 
+  codec = Nats.JSONCodec(), 
+  options, 
+  skipMessageValidation = false
+}: {
+  onDataCallback: (err?: Error, msg?: EventCatalogPing, natsMsg?: Nats.Msg) => void, 
+  nc: Nats.NatsConnection, 
+  codec?: Nats.Codec<any>, 
+  options?: Nats.SubscriptionOptions, 
+  skipMessageValidation?: boolean
+}): Promise<Nats.Subscription> {
+  return new Promise(async (resolve, reject) => {
+    try {
+      const subscription = nc.subscribe('eventcatalog.ping', options);
+      const validator = EventCatalogPing.createValidator();
+      (async () => {
+        for await (const msg of subscription) {
+          
+          let receivedData: any = codec.decode(msg.data);
+if(!skipMessageValidation) {
+    const {valid, errors} = EventCatalogPing.validate({data: receivedData, ajvValidatorFunction: validator});
+    if(!valid) {
+      onDataCallback(new Error(`Invalid message payload received; ${JSON.stringify({cause: errors})}`), undefined, msg); continue;
+    }
+  }
+onDataCallback(undefined, EventCatalogPing.unmarshal(receivedData), msg);
+        }
+      })();
+      resolve(subscription);
+    } catch (e: any) {
+      reject(e);
+    }
+  });
+}
+
+/**
+ * Callback for when receiving messages
+ *
+ * @callback jetStreamPullSubscribeToReceiveEventcatalogPingCallback
+  * @param err if any error occurred this will be sat
+ * @param msg that was received
+ * @param jetstreamMsg
+ */
+
+/**
+ * JetStream pull subscription for `eventcatalog.ping`
+ *
+ * @param {jetStreamPullSubscribeToReceiveEventcatalogPingCallback} onDataCallback to call when messages are received
+ * @param js the JetStream client to pull subscribe through
+ * @param options when setting up the subscription
+ * @param codec the serialization codec to use while transmitting the message
+ * @param skipMessageValidation turn off runtime validation of incoming messages
+ */
+function jetStreamPullSubscribeToReceiveEventcatalogPing({
+  onDataCallback, 
+  js, 
+  options, 
+  codec = Nats.JSONCodec(), 
+  skipMessageValidation = false
+}: {
+  onDataCallback: (err?: Error, msg?: EventCatalogPing, jetstreamMsg?: Nats.JsMsg) => void, 
+  js: Nats.JetStreamClient, 
+  options: Nats.ConsumerOptsBuilder | Partial<Nats.ConsumerOpts>, 
+  codec?: Nats.Codec<any>, 
+  skipMessageValidation?: boolean
+}): Promise<Nats.JetStreamPullSubscription> {
+  return new Promise(async (resolve, reject) => {
+    try {
+      const subscription = await js.pullSubscribe('eventcatalog.ping', options);
+      const validator = EventCatalogPing.createValidator();
+      (async () => {
+        for await (const msg of subscription) {
+          
+          let receivedData: any = codec.decode(msg.data);
+if(!skipMessageValidation) {
+    const {valid, errors} = EventCatalogPing.validate({data: receivedData, ajvValidatorFunction: validator});
+    if(!valid) {
+      onDataCallback(new Error(`Invalid message payload received; ${JSON.stringify({cause: errors})}`), undefined, msg); continue;
+    }
+  }
+onDataCallback(undefined, EventCatalogPing.unmarshal(receivedData), msg);
+        }
+      })();
+      resolve(subscription);
+    } catch (e: any) {
+      reject(e);
+    }
+  });
+}
+
+/**
+ * Callback for when receiving messages
+ *
+ * @callback jetStreamPushSubscriptionFromReceiveEventcatalogPingCallback
+  * @param err if any error occurred this will be sat
+ * @param msg that was received
+ * @param jetstreamMsg
+ */
+
+/**
+ * JetStream push subscription for `eventcatalog.ping`
+ *
+ * @param {jetStreamPushSubscriptionFromReceiveEventcatalogPingCallback} onDataCallback to call when messages are received
+ * @param js the JetStream client to pull subscribe through
+ * @param options when setting up the subscription
+ * @param codec the serialization codec to use while transmitting the message
+ * @param skipMessageValidation turn off runtime validation of incoming messages
+ */
+function jetStreamPushSubscriptionFromReceiveEventcatalogPing({
+  onDataCallback, 
+  js, 
+  options, 
+  codec = Nats.JSONCodec(), 
+  skipMessageValidation = false
+}: {
+  onDataCallback: (err?: Error, msg?: EventCatalogPing, jetstreamMsg?: Nats.JsMsg) => void, 
+  js: Nats.JetStreamClient, 
+  options: Nats.ConsumerOptsBuilder | Partial<Nats.ConsumerOpts>, 
+  codec?: Nats.Codec<any>, 
+  skipMessageValidation?: boolean
+}): Promise<Nats.JetStreamSubscription> {
+  return new Promise(async (resolve, reject) => {
+    try {
+      const subscription = await js.subscribe('eventcatalog.ping', options);
+      const validator = EventCatalogPing.createValidator();
+      (async () => {
+        for await (const msg of subscription) {
+          
+          let receivedData: any = codec.decode(msg.data);
+if(!skipMessageValidation) {
+    const {valid, errors} = EventCatalogPing.validate({data: receivedData, ajvValidatorFunction: validator});
+    if(!valid) {
+      onDataCallback(new Error(`Invalid message payload received; ${JSON.stringify({cause: errors})}`), undefined, msg); continue;
+    }
+  }
+onDataCallback(undefined, EventCatalogPing.unmarshal(receivedData), msg);
+        }
+      })();
+      resolve(subscription);
+    } catch (e: any) {
+      reject(e);
+    }
+  });
+}
+
+export { publishToSendEventcatalogPing, jetStreamPublishToSendEventcatalogPing, subscribeToReceiveEventcatalogPing, jetStreamPullSubscribeToReceiveEventcatalogPing, jetStreamPushSubscriptionFromReceiveEventcatalogPing };
diff --git a/test/runtime/typescript/src/eventcatalog/client/NatsClient.ts b/test/runtime/typescript/src/eventcatalog/client/NatsClient.ts
new file mode 100644
index 00000000..598b4828
--- /dev/null
+++ b/test/runtime/typescript/src/eventcatalog/client/NatsClient.ts
@@ -0,0 +1,254 @@
+import {EventCatalogPing} from './../payloads/EventCatalogPing';
+export {EventCatalogPing};
+
+//Import channel functions
+import * as nats from './../channels/nats';
+
+import * as Nats from 'nats';
+
+/**
+ * @class NatsClient
+ */
+export class NatsClient {
+  public nc?: Nats.NatsConnection;
+  public js?: Nats.JetStreamClient;
+  public codec?: Nats.Codec<any>;
+  public options?: Nats.ConnectionOptions;
+
+  /**
+   * Disconnect all clients from the server and drain subscriptions.
+   * 
+   * This is a gentle disconnect and make take a little.
+   */
+  async disconnect() {
+    if (!this.isClosed() && this.nc !== undefined) {
+      await this.nc.drain();
+    }
+  }
+  /**
+   * Returns whether or not any of the clients are closed
+   */
+  isClosed() {
+    if (!this.nc || this.nc.isClosed()) {
+      return true;
+    }
+    return false;
+  }
+  /**
+   * Try to connect to the NATS server with user credentials
+   *
+   * @param userCreds to use
+   * @param options to connect with
+   */
+  async connectWithUserCreds(userCreds: string, options?: Nats.ConnectionOptions, codec?: Nats.Codec<any> ) {
+    return await this.connect({
+      user: userCreds,
+      ...options
+    }, codec);
+  }
+  /**
+   * Try to connect to the NATS server with user and password
+   * 
+   * @param user username to use
+   * @param pass password to use
+   * @param options to connect with
+   */
+  async connectWithUserPass(user: string, pass: string, options?: Nats.ConnectionOptions, codec?: Nats.Codec<any> ) {
+    return await this.connect({
+      user: user,
+      pass: pass,
+      ...options
+    }, codec);
+  }
+  /**
+   * Try to connect to the NATS server which has no authentication
+   
+    * @param host to connect to
+    * @param options to connect with
+    */
+  async connectToHost(host: string, options?: Nats.ConnectionOptions, codec?: Nats.Codec<any> ) {
+    return await this.connect({
+      servers: [host],
+      ...options
+    }, codec);
+  }
+
+  /**
+   * Try to connect to the NATS server with the different payloads.
+   * @param options to use, payload is omitted if sat in the AsyncAPI document.
+   */
+  connect(options: Nats.ConnectionOptions, codec?: Nats.Codec<any>): Promise<{nc: Nats.NatsConnection, js: Nats.JetStreamClient}> {
+    return new Promise(async (resolve, reject: (error: any) => void) => {
+      if (!this.isClosed()) {
+        return reject('Client is still connected, please close it first.');
+      }
+      this.options = options;
+      if (codec) {
+        this.codec = codec;
+      } else {
+        this.codec = Nats.JSONCodec();
+      }
+      try {
+        this.nc = await Nats.connect(this.options);
+        this.js = this.nc.jetstream();
+        resolve({nc: this.nc, js: this.js});
+      } catch (e: any) {
+        reject('Could not connect to NATS server');
+      }
+    })
+  }
+  
+  /**
+   * 
+   * 
+   * @param message to publish
+   * @param options to use while publishing the message
+   */
+  public async publishToSendEventcatalogPing({
+    message, 
+    options
+  }: {
+    message: EventCatalogPing, 
+    options?: Nats.PublishOptions
+  }): Promise<void> {
+    if (!this.isClosed() && this.nc !== undefined && this.codec !== undefined) {
+      await nats.publishToSendEventcatalogPing({
+        message, 
+        nc: this.nc, 
+        codec: this.codec, 
+        options
+      });
+    } else {
+      Promise.reject('Nats client not available yet, please connect or set the client');
+    }
+  }
+
+  /**
+   * 
+   * 
+   * @param message to publish
+ * @param options to use while publishing the message
+   */
+  public async jetStreamPublishToSendEventcatalogPing({
+    message, 
+    options = {}
+  }: {
+    message: EventCatalogPing, 
+    options?: Partial<Nats.JetStreamPublishOptions>
+  }): Promise<void> {
+    if (!this.isClosed() && this.nc !== undefined && this.codec !== undefined && this.js !== undefined) {
+      return nats.jetStreamPublishToSendEventcatalogPing({
+        message, 
+        js: this.js, 
+        codec: this.codec, 
+        options
+      });
+    } else {
+      Promise.reject('Nats client not available yet, please connect or set the client');
+    }
+  }
+  
+
+  /** 
+   * 
+   * 
+    * @param {subscribeToReceiveEventcatalogPingCallback} onDataCallback to call when messages are received
+    * @param options when setting up the subscription
+    * @param options when setting up the subscription
+   */
+  public subscribeToReceiveEventcatalogPing({
+    onDataCallback, 
+    options, 
+    flush
+  }: {
+    onDataCallback: (err?: Error, msg?: EventCatalogPing, natsMsg?: Nats.Msg) => void, 
+    options?: Nats.SubscriptionOptions, 
+    flush?: boolean
+  }): Promise<Nats.Subscription> {
+  return new Promise(async (resolve, reject) => {
+    if(!this.isClosed() && this.nc !== undefined && this.codec !== undefined){
+      try {
+        const sub = await nats.subscribeToReceiveEventcatalogPing({
+          onDataCallback, 
+          nc: this.nc, 
+          codec: this.codec, 
+          options
+        });
+        if(flush){
+          await this.nc.flush();
+        }
+        resolve(sub);
+      }catch(e: any){
+        reject(e);
+      }
+    } else {
+      Promise.reject('Nats client not available yet, please connect or set the client');
+    }
+  });
+}
+
+  /**
+  * 
+  * 
+   * @param {jetStreamPullSubscribeToReceiveEventcatalogPingCallback} onDataCallback to call when messages are received
+   * @param options when setting up the subscription
+  */
+  public jetStreamPullSubscribeToReceiveEventcatalogPing({
+    onDataCallback, 
+    options = {}
+  }: {
+    onDataCallback: (err?: Error, msg?: EventCatalogPing, jetstreamMsg?: Nats.JsMsg) => void, 
+    options: Nats.ConsumerOptsBuilder | Partial<Nats.ConsumerOpts>
+  }): Promise<Nats.JetStreamPullSubscription> {
+      return new Promise(async (resolve, reject) => {
+        if (!this.isClosed() && this.nc !== undefined && this.codec !== undefined && this.js !== undefined) {
+          try {
+            const sub = await nats.jetStreamPullSubscribeToReceiveEventcatalogPing({
+              onDataCallback, 
+              js: this.js, 
+              codec: this.codec, 
+              options
+            });
+            resolve(sub);
+          } catch (e: any) {
+            reject(e);
+          }
+        } else {
+          Promise.reject('Nats client not available yet, please connect or set the client');
+        }
+      });
+    }
+  
+
+  /**
+  * 
+  * 
+   * @param {jetStreamPushSubscriptionFromReceiveEventcatalogPingCallback} onDataCallback to call when messages are received
+   * @param options when setting up the subscription
+  */
+  public jetStreamPushSubscriptionFromReceiveEventcatalogPing({
+    onDataCallback, 
+    options = {}
+  }: {
+    onDataCallback: (err?: Error, msg?: EventCatalogPing, jetstreamMsg?: Nats.JsMsg) => void, 
+    options: Nats.ConsumerOptsBuilder | Partial<Nats.ConsumerOpts>
+  }): Promise<Nats.JetStreamSubscription> {
+    return new Promise(async (resolve, reject) => {
+      if (!this.isClosed() && this.nc !== undefined && this.codec !== undefined && this.js !== undefined) {
+        try {
+          const sub = await nats.jetStreamPushSubscriptionFromReceiveEventcatalogPing({
+            onDataCallback, 
+            js: this.js, 
+            codec: this.codec, 
+            options
+          });
+          resolve(sub);
+        } catch (e: any) {
+          reject(e);
+        }
+      } else {
+        Promise.reject('Nats client not available yet, please connect or set the client');
+      }
+    });
+  }
+}
\ No newline at end of file
diff --git a/test/runtime/typescript/src/eventcatalog/payloads/EventCatalogPing.ts b/test/runtime/typescript/src/eventcatalog/payloads/EventCatalogPing.ts
new file mode 100644
index 00000000..dd75c4fb
--- /dev/null
+++ b/test/runtime/typescript/src/eventcatalog/payloads/EventCatalogPing.ts
@@ -0,0 +1,74 @@
+import {Ajv, Options as AjvOptions, ErrorObject, ValidateFunction} from 'ajv';
+import {default as addFormats} from 'ajv-formats';
+class EventCatalogPing {
+  private _message: string;
+  private _additionalProperties?: Record<string, any>;
+
+  constructor(input: {
+    message: string,
+    additionalProperties?: Record<string, any>,
+  }) {
+    this._message = input.message;
+    this._additionalProperties = input.additionalProperties;
+  }
+
+  get message(): string { return this._message; }
+  set message(message: string) { this._message = message; }
+
+  get additionalProperties(): Record<string, any> | undefined { return this._additionalProperties; }
+  set additionalProperties(additionalProperties: Record<string, any> | undefined) { this._additionalProperties = additionalProperties; }
+
+  public marshal() : string {
+    let json = '{'
+    if(this.message !== undefined) {
+      json += `"message": ${typeof this.message === 'number' || typeof this.message === 'boolean' ? this.message : JSON.stringify(this.message)},`;
+    }
+    if(this.additionalProperties !== undefined) { 
+      for (const [key, value] of this.additionalProperties.entries()) {
+        //Only unwrap those that are not already a property in the JSON object
+        if(["message","additionalProperties"].includes(String(key))) continue;
+        json += `"${key}": ${typeof value === 'number' || typeof value === 'boolean' ? value : JSON.stringify(value)},`;
+      }
+    }
+    //Remove potential last comma 
+    return `${json.charAt(json.length-1) === ',' ? json.slice(0, json.length-1) : json}}`;
+  }
+
+  public static unmarshal(json: string | object): EventCatalogPing {
+    const obj = typeof json === "object" ? json : JSON.parse(json);
+    const instance = new EventCatalogPing({} as any);
+
+    if (obj["message"] !== undefined) {
+      instance.message = obj["message"];
+    }
+  
+    instance.additionalProperties = new Map();
+    const propsToCheck = Object.entries(obj).filter((([key,]) => {return !["message","additionalProperties"].includes(key);}));
+    for (const [key, value] of propsToCheck) {
+      instance.additionalProperties.set(key, value as any);
+    }
+    return instance;
+  }
+  public static theCodeGenSchema = {"type":"object","$schema":"http://json-schema.org/draft-07/schema","required":["message"],"properties":{"message":{"type":"string"}},"$id":"EventCatalogPing"};
+  public static validate(context?: {data: any, ajvValidatorFunction?: ValidateFunction, ajvInstance?: Ajv, ajvOptions?: AjvOptions}): { valid: boolean; errors?: ErrorObject[]; } {
+    const {data, ajvValidatorFunction} = context ?? {};
+    // Intentionally parse JSON strings to support validation of marshalled output.
+    // Example: validate({data: marshal(obj)}) works because marshal returns JSON string.
+    // Note: String 'true' will be coerced to boolean true due to JSON.parse.
+    const parsedData = typeof data === 'string' ? JSON.parse(data) : data;
+    const validate = ajvValidatorFunction ?? this.createValidator(context)
+    return {
+      valid: validate(parsedData),
+      errors: validate.errors ?? undefined,
+    };
+  }
+  public static createValidator(context?: {ajvInstance?: Ajv, ajvOptions?: AjvOptions}): ValidateFunction {
+    const {ajvInstance} = {...context ?? {}, ajvInstance: new Ajv(context?.ajvOptions ?? {})};
+    addFormats(ajvInstance);
+  
+    const validate = ajvInstance.compile(this.theCodeGenSchema);
+    return validate;
+  }
+
+}
+export { EventCatalogPing };
\ No newline at end of file
diff --git a/test/runtime/typescript/test/inputs/eventcatalog.spec.ts b/test/runtime/typescript/test/inputs/eventcatalog.spec.ts
new file mode 100644
index 00000000..6fe4e056
--- /dev/null
+++ b/test/runtime/typescript/test/inputs/eventcatalog.spec.ts
@@ -0,0 +1,43 @@
+/* eslint-disable no-console */
+import { connect, NatsConnection } from 'nats';
+import { EventCatalogPing } from '../../src/eventcatalog/payloads/EventCatalogPing';
+import {
+  publishToSendEventcatalogPing,
+  subscribeToReceiveEventcatalogPing
+} from '../../src/eventcatalog/channels/nats';
+
+describe('EventCatalog input (asyncapi mode)', () => {
+  let nc: NatsConnection;
+  beforeAll(async () => {
+    nc = await connect({ servers: 'nats://localhost:4443' });
+  });
+  afterAll(async () => {
+    const done = nc.closed();
+    await nc.close();
+    const err = await done;
+    if (err) {
+      console.log('error closing nats:', err);
+    }
+  });
+
+  it('publishes and subscribes via generated NATS channels', async () => {
+    const message = new EventCatalogPing({ message: 'hello from eventcatalog' });
+
+    await new Promise<void>(async (resolve, reject) => {
+      const subscription = await subscribeToReceiveEventcatalogPing({
+        onDataCallback: async (err, received) => {
+          try {
+            expect(err).toBeUndefined();
+            expect(received?.marshal()).toEqual(message.marshal());
+            await subscription.drain();
+            resolve();
+          } catch (error) {
+            reject(error);
+          }
+        },
+        nc
+      });
+      await publishToSendEventcatalogPing({ message, nc });
+    });
+  });
+});