@hookdeck/eventcatalog-generator

Hookdeck EventCatalog Generator

Generated the following from a Hookdeck Project:

• Services: based on Hookdeck Sources and Destinations
• Events: based on Hookdeck Requests to Sources and Events sent to Destinations

Install the Hookdeck Generator in EventCatalog

Navigate to your EventCatalog directory, then install the package.

[!WARNING] The package is not yet in NPM

npm i @hookdeck/eventcatalog-generator

Configure your EventCatalog to use your generator

Edit your eventcatalog.config.js file and add the generator

...
generators: [
    [
        "@hookdeck/eventcatalog-generator",
        {
            logLevel: "fatal" | "error" | "warn" | "info" | "debug" | "trace",
            connectionSourcedMatch: "regular expression string to match source names",
            hookdeckApiKey: "Hookdeck Project API Key. Hookdeck -> Project -> Settings -> Secrets"
        }
    ]
]
...

Run the generator in Event Catalog

In the EventCatalog directory run:

npm run generate

This will run the generator code and interact with your Catalog.

Development

Run the generation

npm run generate -- {flags}

Supported flags are:

• log-level: The level to log at - "fatal" | "error" | "warn" | "info" | "debug" | "trace"
• match: Regular expression match for Source names on Connections
• dir: Path the the Event Catalog install directory
• api-key: Hookdeck Project API Key
• max-events: The maximum number of Requests/Events to process per Source/Destination

Example:

npm run generate -- --log-level debug --match "stripe-production" --domain Payments

The generate script will also use the following environment variables:

• PROJECT_DIR: Path the the Event Catalog install directory
• HOOKDECK_PROJECT_API_KEY: Hookdeck Project API Key

The environment variables can be within a .env file that will automatically be detected.

Compile and watch your plugin

In the plugin directory run:

# Just build the plugin once
npm run build

# Watch changes (recommended for dev)
npm run build -- -- watch

Contributing back to EventCatalog eco-system

Building a plugin? We would love to add it our integrations and/or GitHub org. If this is something you are interested in you can reach out on Discord or create an issue in this project.