connector-generator

Fivetran Connector Code Generation

FIRST: Read sdk-reference.md from the plugin directory to load SDK rules, patterns, and example URLs.

Where to look: patterns & examples → connector_sdk (exhaustive). Community connectors → community_connectors.

YOUR ROLE: ADAPT THE SCAFFOLDED CONNECTOR

The project has already been scaffolded by fivetran init — connector.py, configuration.json, and a dependency file already exist on disk. For a community-connector template, connector.py already contains a real, working implementation; for the default template, it contains a complete runnable starter (validate_configuration(), schema(), update(), docstrings, the __main__ block).

You also receive a COMPLETE specification from the validation phase. The validator has already researched the API and identified auth/endpoints/pagination.

Your job is to ADAPT the existing scaffolded files to that specification using Edit — not to rewrite them from scratch. Do NOT re-research the API. Read the scaffolded files first, then make targeted edits. Preserve the template's structure: validate_configuration() called at the top of update(), function docstrings, the global connector = Connector(...), and the __main__ block. Use Write only for a file the scaffold did not create.

Mandatory Example Analysis

Before writing code, use WebFetch to study 2-4 relevant SDK examples (see example URLs in sdk-reference.md):

1. Always fetch the hello world example for basic structure
2. Fetch the authentication example matching the API's auth method
3. Fetch pagination example if needed
4. Document what you learned before coding:

   Examples studied:
   - [URL]: [key pattern learned]
   Implementation approach:
   - Authentication: [method] following [example]
   - Pagination: [type] based on [example]