Airbyte Connectors

This repository contains Airbyte connectors used in Faros and Faros Community Edition platforms as well as Airbyte Connector Development Kit (CDK) for JavaScript/TypeScript.

See the READMEs inside destinations/ and sources/ subfolders for more information on each connector.

Component	Code	Installation	Version
Airbyte CDK for JavaScript/TypeScript	faros-airbyte-cdk	npm i faros-airbyte-cdk
AgileAccelerator Source	sources/agileaccelerator-source	docker pull farosai/airbyte-agileaccelerator-source
Asana Source	sources/asana-source	docker pull farosai/airbyte-asana-source
AWS CloudWatch Metrics Source	sources/aws-cloudwatch-metrics-source	docker pull farosai/airbyte-aws-cloudwatch-metrics-source
Azure Active Directory Source	sources/azureactivedirectory-source	docker pull farosai/airbyte-azureactivedirectory-source
Azure Pipeline Source	sources/azurepipeline-source	docker pull farosai/airbyte-azurepipeline-source
Azure Repos Source	sources/azure-repos-source	docker pull farosai/airbyte-azure-repos-source
Azure Workitems Source	sources/azure-workitems-source	docker pull farosai/airbyte-azure-workitems-source
Backlog Source	sources/backlog-source	docker pull farosai/airbyte-backlog-source
BambooHR Source	sources/bamboohr-source	docker pull farosai/airbyte-bamboohr-source
Bitbucket Source	sources/bitbucket-source	docker pull farosai/airbyte-bitbucket-source
Bitbucket Server Source	sources/bitbucket-server-source	docker pull farosai/airbyte-bitbucket-server-source
Buildkite Source	sources/buildkite-source	docker pull farosai/airbyte-buildkite-source
Customer.IO Source	sources/customer-io-source	docker pull farosai/airbyte-customer-io-source
Cursor Source	sources/cursor-source	docker pull farosai/airbyte-cursor-source
CircleCI Source	sources/circleci-source	docker pull farosai/airbyte-circleci-source
Claude Source	sources/claude-source	docker pull farosai/airbyte-claude-source
ClickUp Source	sources/clickup-source	docker pull farosai/airbyte-clickup-source
Datadog Source	sources/datadog-source	docker pull farosai/airbyte-datadog-source
Docker Source	sources/docker-source	docker pull farosai/airbyte-docker-source
Faros Destination	destinations/airbyte-faros-destination	npm i airbyte-faros-destination or docker pull farosai/airbyte-faros-destination
Faros GraphQL Source	sources/faros-graphql-source	docker pull farosai/airbyte-faros-graphql-source
Faros Graph Doctor Source	sources/faros-graphdoctor-source	docker pull farosai/airbyte-faros-graphdoctor-source
Files Source	sources/files-source	docker pull farosai/airbyte-files-source
FireHydrant Source	sources/firehydrant-source	docker pull farosai/airbyte-firehydrant-source
GitHub Source	sources/github-source	docker pull farosai/airbyte-github-source
GitLab Source	sources/gitlab-source	docker pull farosai/airbyte-gitlab-source
Google Calendar Source	sources/googlecalendar-source	docker pull farosai/airbyte-googlecalendar-source
Google Drive Source	sources/googledrive-source	docker pull farosai/airbyte-googledrive-source
Harness Source	sources/harness-source	docker pull farosai/airbyte-harness-source
Jenkins Source	sources/jenkins-source	docker pull farosai/airbyte-jenkins-source
Jira Source	sources/jira-source	docker pull farosai/airbyte-jira-source
Okta Source	sources/okta-source	docker pull farosai/airbyte-okta-source
Octopus Source	sources/octopus-source	docker pull farosai/airbyte-octopus-source
OpsGenie Source	sources/opsgenie-source	docker pull farosai/airbyte-opsgenie-source
PagerDuty Source	sources/pagerduty-source	docker pull farosai/airbyte-pagerduty-source
Phabricator Source	sources/phabricator-source	docker pull farosai/airbyte-phabricator-source
ServiceNow Source	sources/servicenow-source	docker pull farosai/airbyte-servicenow-source
SemaphoreCI Source	sources/semaphoreci-source	docker pull farosai/airbyte-semaphoreci-source
Shortcut Source	sources/shortcut-source	docker pull farosai/airbyte-shortcut-source
Sheets Source	sources/sheets-source	docker pull farosai/airbyte-sheets-source
SquadCast Source	sources/squadcast-source	docker pull farosai/airbyte-squadcast-source
StatusPage Source	sources/statuspage-source	docker pull farosai/airbyte-statuspage-source
TestRails Source	sources/testrails-source	docker pull farosai/airbyte-testrails-source
Tromzo Source	sources/tromzo-source	docker pull farosai/airbyte-tromzo-source
Trello Source	sources/trello-source	docker pull farosai/airbyte-trello-source
Vanta Source	sources/vanta-source	docker pull farosai/airbyte-vanta-source
VictorOps Source	sources/victorops-source	docker pull farosai/airbyte-victorops-source
Windsurf Source	sources/windsurf-source	docker pull farosai/airbyte-windsurf-source
Workday Source	sources/workday-source	docker pull farosai/airbyte-workday-source
Wolken Source	sources/wolken-source	docker pull farosai/airbyte-wolken-source
Xray Source	sources/xray-source	docker pull farosai/airbyte-xray-source
Zephyr Source	sources/zephyr-source	docker pull farosai/airbyte-zephyr-source

Development

1. Install nvm
2. Install Node.js nvm install 22 && nvm use 22
3. Install Turborepo by running npm install turbo --global
4. Run npm i to install dependencies for all projects (turbo clean to clean all)
5. Run turbo build to build all projects (for a single project add scope, e.g turbo build --filter=airbyte-faros-destination)
6. Run turbo test to test all projects (for a single project add scope, e.g turbo test --filter=airbyte-faros-destination)
7. Run turbo lint to apply linter on all projects (for a single project add scope, e.g turbo lint --filter=airbyte-faros-destination)

👉 Follow our guide on how to develop a new source here.

Read more about Turborepo here.

Dependency Management

To manage dependencies in this project, you can use the following commands:

1. Install Dependencies: Run npm install to install all the necessary dependencies for the project.
2. Update Dependencies: Use npm update to update all the dependencies to their latest versions.
3. Check for Vulnerabilities: Run npm audit to check for any vulnerabilities in the dependencies.
4. Fix Vulnerabilities: Use npm audit fix to automatically fix any vulnerabilities that can be resolved.
5. Clean Dependencies: Run npm prune to remove any extraneous packages that are not listed in package.json.

Build Docker Images

In order to build a Docker image for a connector run the docker build command and set path and version arguments. For example for Faros Destination connector run:

docker build . --build-arg path=destinations/airbyte-faros-destination --build-arg version=0.0.1 -t airbyte-faros-destination

And then run it:

docker run airbyte-faros-destination

Troubleshoot

• If you encounter errors like ...: No such file or directory when running docker run commands on Windows, try to confirm all files in this repo are using LF end of line. If not, convert them all to use LF instead of CRLF.

Releasing

Create a new GitHub Release. The release workflow will automatically publish the packages to NPM and push Docker images to Docker Hub.