mirror of
https://github.com/n8n-io/n8n.git
synced 2024-12-26 21:19:43 -08:00
640 lines
18 KiB
TypeScript
640 lines
18 KiB
TypeScript
import type {
|
|
IHookFunctions,
|
|
IWebhookFunctions,
|
|
IDataObject,
|
|
INodeType,
|
|
INodeTypeDescription,
|
|
IWebhookResponseData,
|
|
JsonObject,
|
|
} from 'n8n-workflow';
|
|
import { NodeConnectionType, NodeApiError, NodeOperationError } from 'n8n-workflow';
|
|
|
|
import { githubApiRequest } from './GenericFunctions';
|
|
import { getRepositories, getUsers } from './SearchFunctions';
|
|
|
|
export class GithubTrigger implements INodeType {
|
|
description: INodeTypeDescription = {
|
|
displayName: 'Github Trigger',
|
|
name: 'githubTrigger',
|
|
icon: { light: 'file:github.svg', dark: 'file:github.dark.svg' },
|
|
group: ['trigger'],
|
|
version: 1,
|
|
subtitle:
|
|
'={{$parameter["owner"] + "/" + $parameter["repository"] + ": " + $parameter["events"].join(", ")}}',
|
|
description: 'Starts the workflow when Github events occur',
|
|
defaults: {
|
|
name: 'Github Trigger',
|
|
},
|
|
inputs: [],
|
|
outputs: [NodeConnectionType.Main],
|
|
credentials: [
|
|
{
|
|
name: 'githubApi',
|
|
required: true,
|
|
displayOptions: {
|
|
show: {
|
|
authentication: ['accessToken'],
|
|
},
|
|
},
|
|
},
|
|
{
|
|
name: 'githubOAuth2Api',
|
|
required: true,
|
|
displayOptions: {
|
|
show: {
|
|
authentication: ['oAuth2'],
|
|
},
|
|
},
|
|
},
|
|
],
|
|
webhooks: [
|
|
{
|
|
name: 'default',
|
|
httpMethod: 'POST',
|
|
responseMode: 'onReceived',
|
|
path: 'webhook',
|
|
},
|
|
],
|
|
properties: [
|
|
{
|
|
displayName:
|
|
'Only members with owner privileges for an organization or admin privileges for a repository can set up the webhooks this node requires.',
|
|
name: 'notice',
|
|
type: 'notice',
|
|
default: '',
|
|
},
|
|
{
|
|
displayName: 'Authentication',
|
|
name: 'authentication',
|
|
type: 'options',
|
|
options: [
|
|
{
|
|
name: 'Access Token',
|
|
value: 'accessToken',
|
|
},
|
|
{
|
|
name: 'OAuth2',
|
|
value: 'oAuth2',
|
|
},
|
|
],
|
|
default: 'accessToken',
|
|
},
|
|
{
|
|
displayName: 'Repository Owner',
|
|
name: 'owner',
|
|
type: 'resourceLocator',
|
|
default: { mode: 'list', value: '' },
|
|
required: true,
|
|
modes: [
|
|
{
|
|
displayName: 'Repository Owner',
|
|
name: 'list',
|
|
type: 'list',
|
|
placeholder: 'Select an owner...',
|
|
typeOptions: {
|
|
searchListMethod: 'getUsers',
|
|
searchable: true,
|
|
searchFilterRequired: true,
|
|
},
|
|
},
|
|
{
|
|
displayName: 'Link',
|
|
name: 'url',
|
|
type: 'string',
|
|
placeholder: 'e.g. https://github.com/n8n-io',
|
|
extractValue: {
|
|
type: 'regex',
|
|
regex: 'https:\\/\\/github.com\\/([-_0-9a-zA-Z]+)',
|
|
},
|
|
validation: [
|
|
{
|
|
type: 'regex',
|
|
properties: {
|
|
regex: 'https:\\/\\/github.com\\/([-_0-9a-zA-Z]+)(?:.*)',
|
|
errorMessage: 'Not a valid Github URL',
|
|
},
|
|
},
|
|
],
|
|
},
|
|
{
|
|
displayName: 'By Name',
|
|
name: 'name',
|
|
type: 'string',
|
|
placeholder: 'e.g. n8n-io',
|
|
validation: [
|
|
{
|
|
type: 'regex',
|
|
properties: {
|
|
regex: '[-_a-zA-Z0-9]+',
|
|
errorMessage: 'Not a valid Github Owner Name',
|
|
},
|
|
},
|
|
],
|
|
url: '=https://github.com/{{$value}}',
|
|
},
|
|
],
|
|
},
|
|
{
|
|
displayName: 'Repository Name',
|
|
name: 'repository',
|
|
type: 'resourceLocator',
|
|
default: { mode: 'list', value: '' },
|
|
required: true,
|
|
modes: [
|
|
{
|
|
displayName: 'Repository Name',
|
|
name: 'list',
|
|
type: 'list',
|
|
placeholder: 'Select an Repository...',
|
|
typeOptions: {
|
|
searchListMethod: 'getRepositories',
|
|
searchable: true,
|
|
},
|
|
},
|
|
{
|
|
displayName: 'Link',
|
|
name: 'url',
|
|
type: 'string',
|
|
placeholder: 'e.g. https://github.com/n8n-io/n8n',
|
|
extractValue: {
|
|
type: 'regex',
|
|
regex: 'https:\\/\\/github.com\\/(?:[-_0-9a-zA-Z]+)\\/([-_.0-9a-zA-Z]+)',
|
|
},
|
|
validation: [
|
|
{
|
|
type: 'regex',
|
|
properties: {
|
|
regex: 'https:\\/\\/github.com\\/(?:[-_0-9a-zA-Z]+)\\/([-_.0-9a-zA-Z]+)(?:.*)',
|
|
errorMessage: 'Not a valid Github Repository URL',
|
|
},
|
|
},
|
|
],
|
|
},
|
|
{
|
|
displayName: 'By Name',
|
|
name: 'name',
|
|
type: 'string',
|
|
placeholder: 'e.g. n8n',
|
|
validation: [
|
|
{
|
|
type: 'regex',
|
|
properties: {
|
|
regex: '[-_.0-9a-zA-Z]+',
|
|
errorMessage: 'Not a valid Github Repository Name',
|
|
},
|
|
},
|
|
],
|
|
url: '=https://github.com/{{$parameter["owner"]}}/{{$value}}',
|
|
},
|
|
],
|
|
},
|
|
{
|
|
displayName: 'Events',
|
|
name: 'events',
|
|
type: 'multiOptions',
|
|
options: [
|
|
{
|
|
name: '*',
|
|
value: '*',
|
|
description: 'Any time any event is triggered (Wildcard Event)',
|
|
},
|
|
{
|
|
name: 'Check Run',
|
|
value: 'check_run',
|
|
description:
|
|
'Triggered when a check run is created, rerequested, completed, or has a requested_action',
|
|
},
|
|
{
|
|
name: 'Check Suite',
|
|
value: 'check_suite',
|
|
description: 'Triggered when a check suite is completed, requested, or rerequested',
|
|
},
|
|
{
|
|
name: 'Commit Comment',
|
|
value: 'commit_comment',
|
|
description: 'Triggered when a commit comment is created',
|
|
},
|
|
{
|
|
name: 'Create',
|
|
value: 'create',
|
|
description: 'Represents a created repository, branch, or tag',
|
|
},
|
|
{
|
|
name: 'Delete',
|
|
value: 'delete',
|
|
description: 'Represents a deleted branch or tag',
|
|
},
|
|
{
|
|
name: 'Deploy Key',
|
|
value: 'deploy_key',
|
|
description: 'Triggered when a deploy key is added or removed from a repository',
|
|
},
|
|
{
|
|
name: 'Deployment',
|
|
value: 'deployment',
|
|
description: 'Represents a deployment',
|
|
},
|
|
{
|
|
name: 'Deployment Status',
|
|
value: 'deployment_status',
|
|
description: 'Represents a deployment status',
|
|
},
|
|
{
|
|
name: 'Fork',
|
|
value: 'fork',
|
|
description: 'Triggered when a user forks a repository',
|
|
},
|
|
{
|
|
name: 'Github App Authorization',
|
|
value: 'github_app_authorization',
|
|
description: 'Triggered when someone revokes their authorization of a GitHub App',
|
|
},
|
|
{
|
|
name: 'Gollum',
|
|
value: 'gollum',
|
|
description: 'Triggered when a Wiki page is created or updated',
|
|
},
|
|
{
|
|
name: 'Installation',
|
|
value: 'installation',
|
|
description:
|
|
'Triggered when someone installs (created), uninstalls (deleted), or accepts new permissions (new_permissions_accepted) for a GitHub App. When a GitHub App owner requests new permissions, the person who installed the GitHub App must accept the new permissions request.',
|
|
},
|
|
{
|
|
name: 'Installation Repositories',
|
|
value: 'installation_repositories',
|
|
description: 'Triggered when a repository is added or removed from an installation',
|
|
},
|
|
{
|
|
name: 'Issue Comment',
|
|
value: 'issue_comment',
|
|
description: 'Triggered when an issue comment is created, edited, or deleted',
|
|
},
|
|
{
|
|
name: 'Issues',
|
|
value: 'issues',
|
|
description:
|
|
'Triggered when an issue is opened, edited, deleted, transferred, pinned, unpinned, closed, reopened, assigned, unassigned, labeled, unlabeled, locked, unlocked, milestoned, or demilestoned',
|
|
},
|
|
{
|
|
name: 'Label',
|
|
value: 'label',
|
|
description: "Triggered when a repository's label is created, edited, or deleted",
|
|
},
|
|
{
|
|
name: 'Marketplace Purchase',
|
|
value: 'marketplace_purchase',
|
|
description:
|
|
'Triggered when someone purchases a GitHub Marketplace plan, cancels their plan, upgrades their plan (effective immediately), downgrades a plan that remains pending until the end of the billing cycle, or cancels a pending plan change',
|
|
},
|
|
{
|
|
name: 'Member',
|
|
value: 'member',
|
|
description:
|
|
'Triggered when a user accepts an invitation or is removed as a collaborator to a repository, or has their permissions changed',
|
|
},
|
|
{
|
|
name: 'Membership',
|
|
value: 'membership',
|
|
description:
|
|
'Triggered when a user is added or removed from a team. Organization hooks only.',
|
|
},
|
|
{
|
|
name: 'Meta',
|
|
value: 'meta',
|
|
description: 'Triggered when the webhook that this event is configured on is deleted',
|
|
},
|
|
{
|
|
name: 'Milestone',
|
|
value: 'milestone',
|
|
description:
|
|
'Triggered when a milestone is created, closed, opened, edited, or deleted',
|
|
},
|
|
{
|
|
name: 'Org Block',
|
|
value: 'org_block',
|
|
description:
|
|
'Triggered when an organization blocks or unblocks a user. Organization hooks only.',
|
|
},
|
|
{
|
|
name: 'Organization',
|
|
value: 'organization',
|
|
description:
|
|
'Triggered when an organization is deleted and renamed, and when a user is added, removed, or invited to an organization. Organization hooks only.',
|
|
},
|
|
{
|
|
name: 'Page Build',
|
|
value: 'page_build',
|
|
description:
|
|
'Triggered on push to a GitHub Pages enabled branch (gh-pages for project pages, master for user and organization pages)',
|
|
},
|
|
{
|
|
name: 'Project',
|
|
value: 'project',
|
|
description:
|
|
'Triggered when a project is created, updated, closed, reopened, or deleted',
|
|
},
|
|
{
|
|
name: 'Project Card',
|
|
value: 'project_card',
|
|
description:
|
|
'Triggered when a project card is created, edited, moved, converted to an issue, or deleted',
|
|
},
|
|
{
|
|
name: 'Project Column',
|
|
value: 'project_column',
|
|
description: 'Triggered when a project column is created, updated, moved, or deleted',
|
|
},
|
|
{
|
|
name: 'Public',
|
|
value: 'public',
|
|
description: 'Triggered when a private repository is open sourced',
|
|
},
|
|
{
|
|
name: 'Pull Request',
|
|
value: 'pull_request',
|
|
description:
|
|
'Triggered when a pull request is assigned, unassigned, labeled, unlabeled, opened, edited, closed, reopened, synchronize, ready_for_review, locked, unlocked, a pull request review is requested, or a review request is removed',
|
|
},
|
|
{
|
|
name: 'Pull Request Review',
|
|
value: 'pull_request_review',
|
|
description:
|
|
'Triggered when a pull request review is submitted into a non-pending state, the body is edited, or the review is dismissed',
|
|
},
|
|
{
|
|
name: 'Pull Request Review Comment',
|
|
value: 'pull_request_review_comment',
|
|
description:
|
|
"Triggered when a comment on a pull request's unified diff is created, edited, or deleted (in the Files Changed tab)",
|
|
},
|
|
{
|
|
name: 'Push',
|
|
value: 'push',
|
|
description:
|
|
'Triggered on a push to a repository branch. Branch pushes and repository tag pushes also trigger webhook push events. This is the default event.',
|
|
},
|
|
{
|
|
name: 'Release',
|
|
value: 'release',
|
|
description:
|
|
'Triggered when a release is published, unpublished, created, edited, deleted, or prereleased',
|
|
},
|
|
{
|
|
name: 'Repository',
|
|
value: 'repository',
|
|
description:
|
|
'Triggered when a repository is created, archived, unarchived, renamed, edited, transferred, made public, or made private. Organization hooks are also triggered when a repository is deleted.',
|
|
},
|
|
{
|
|
name: 'Repository Import',
|
|
value: 'repository_import',
|
|
description:
|
|
'Triggered when a successful, cancelled, or failed repository import finishes for a GitHub organization or a personal repository',
|
|
},
|
|
{
|
|
name: 'Repository Vulnerability Alert',
|
|
value: 'repository_vulnerability_alert',
|
|
description: 'Triggered when a security alert is created, dismissed, or resolved',
|
|
},
|
|
{
|
|
name: 'Security Advisory',
|
|
value: 'security_advisory',
|
|
description:
|
|
'Triggered when a new security advisory is published, updated, or withdrawn',
|
|
},
|
|
{
|
|
name: 'Star',
|
|
value: 'star',
|
|
description: 'Triggered when a star is added or removed from a repository',
|
|
},
|
|
{
|
|
name: 'Status',
|
|
value: 'status',
|
|
description: 'Triggered when the status of a Git commit changes',
|
|
},
|
|
{
|
|
name: 'Team',
|
|
value: 'team',
|
|
description:
|
|
"Triggered when an organization's team is created, deleted, edited, added_to_repository, or removed_from_repository. Organization hooks only.",
|
|
},
|
|
{
|
|
name: 'Team Add',
|
|
value: 'team_add',
|
|
description: 'Triggered when a repository is added to a team',
|
|
},
|
|
{
|
|
name: 'Watch',
|
|
value: 'watch',
|
|
description: 'Triggered when someone stars a repository',
|
|
},
|
|
],
|
|
required: true,
|
|
default: [],
|
|
description: 'The events to listen to',
|
|
},
|
|
{
|
|
displayName: 'Options',
|
|
name: 'options',
|
|
type: 'collection',
|
|
placeholder: 'Add option',
|
|
default: {},
|
|
options: [
|
|
{
|
|
displayName: 'Insecure SSL',
|
|
name: 'insecureSSL',
|
|
type: 'boolean',
|
|
default: false,
|
|
description:
|
|
'Whether the SSL certificate of the n8n host be verified by GitHub when delivering payloads',
|
|
},
|
|
],
|
|
},
|
|
],
|
|
};
|
|
|
|
webhookMethods = {
|
|
default: {
|
|
async checkExists(this: IHookFunctions): Promise<boolean> {
|
|
const webhookData = this.getWorkflowStaticData('node');
|
|
|
|
if (webhookData.webhookId === undefined) {
|
|
// No webhook id is set so no webhook can exist
|
|
return false;
|
|
}
|
|
|
|
// Webhook got created before so check if it still exists
|
|
const owner = this.getNodeParameter('owner', '', { extractValue: true }) as string;
|
|
const repository = this.getNodeParameter('repository', '', {
|
|
extractValue: true,
|
|
}) as string;
|
|
const endpoint = `/repos/${owner}/${repository}/hooks/${webhookData.webhookId}`;
|
|
|
|
try {
|
|
await githubApiRequest.call(this, 'GET', endpoint, {});
|
|
} catch (error) {
|
|
if (error.cause.httpCode === '404') {
|
|
// Webhook does not exist
|
|
delete webhookData.webhookId;
|
|
delete webhookData.webhookEvents;
|
|
|
|
return false;
|
|
}
|
|
|
|
// Some error occurred
|
|
throw error;
|
|
}
|
|
// If it did not error then the webhook exists
|
|
return true;
|
|
},
|
|
async create(this: IHookFunctions): Promise<boolean> {
|
|
const webhookUrl = this.getNodeWebhookUrl('default') as string;
|
|
|
|
if (webhookUrl.includes('//localhost')) {
|
|
throw new NodeOperationError(
|
|
this.getNode(),
|
|
'The Webhook can not work on "localhost". Please, either setup n8n on a custom domain or start with "--tunnel"!',
|
|
);
|
|
}
|
|
|
|
const owner = this.getNodeParameter('owner', '', { extractValue: true }) as string;
|
|
const repository = this.getNodeParameter('repository', '', {
|
|
extractValue: true,
|
|
}) as string;
|
|
const events = this.getNodeParameter('events', []);
|
|
|
|
const endpoint = `/repos/${owner}/${repository}/hooks`;
|
|
const options = this.getNodeParameter('options') as { insecureSSL: boolean };
|
|
|
|
const body = {
|
|
name: 'web',
|
|
config: {
|
|
url: webhookUrl,
|
|
content_type: 'json',
|
|
insecure_ssl: options.insecureSSL ? '1' : '0',
|
|
},
|
|
events,
|
|
active: true,
|
|
};
|
|
|
|
const webhookData = this.getWorkflowStaticData('node');
|
|
|
|
let responseData;
|
|
try {
|
|
responseData = await githubApiRequest.call(this, 'POST', endpoint, body);
|
|
} catch (error) {
|
|
if (error.cause.httpCode === '422') {
|
|
// Webhook exists already
|
|
|
|
// Get the data of the already registered webhook
|
|
responseData = await githubApiRequest.call(this, 'GET', endpoint, body);
|
|
|
|
for (const webhook of responseData as IDataObject[]) {
|
|
if ((webhook.config! as IDataObject).url! === webhookUrl) {
|
|
// Webhook got found
|
|
if (JSON.stringify(webhook.events) === JSON.stringify(events)) {
|
|
// Webhook with same events exists already so no need to
|
|
// create it again simply save the webhook-id
|
|
webhookData.webhookId = webhook.id as string;
|
|
webhookData.webhookEvents = webhook.events as string[];
|
|
return true;
|
|
}
|
|
}
|
|
}
|
|
|
|
throw new NodeOperationError(
|
|
this.getNode(),
|
|
'A webhook with the identical URL probably exists already. Please delete it manually on Github!',
|
|
{ level: 'warning' },
|
|
);
|
|
}
|
|
|
|
if (error.cause.httpCode === '404') {
|
|
throw new NodeOperationError(
|
|
this.getNode(),
|
|
'Check that the repository exists and that you have permission to create the webhooks this node requires',
|
|
{ level: 'warning' },
|
|
);
|
|
}
|
|
|
|
throw error;
|
|
}
|
|
|
|
if (responseData.id === undefined || responseData.active !== true) {
|
|
// Required data is missing so was not successful
|
|
throw new NodeApiError(this.getNode(), responseData as JsonObject, {
|
|
message: 'Github webhook creation response did not contain the expected data.',
|
|
});
|
|
}
|
|
|
|
webhookData.webhookId = responseData.id as string;
|
|
webhookData.webhookEvents = responseData.events as string[];
|
|
|
|
return true;
|
|
},
|
|
async delete(this: IHookFunctions): Promise<boolean> {
|
|
const webhookData = this.getWorkflowStaticData('node');
|
|
|
|
if (webhookData.webhookId !== undefined) {
|
|
const owner = this.getNodeParameter('owner', '', { extractValue: true }) as string;
|
|
const repository = this.getNodeParameter('repository', '', {
|
|
extractValue: true,
|
|
}) as string;
|
|
const endpoint = `/repos/${owner}/${repository}/hooks/${webhookData.webhookId}`;
|
|
const body = {};
|
|
|
|
try {
|
|
await githubApiRequest.call(this, 'DELETE', endpoint, body);
|
|
} catch (error) {
|
|
return false;
|
|
}
|
|
|
|
// Remove from the static workflow data so that it is clear
|
|
// that no webhooks are registered anymore
|
|
delete webhookData.webhookId;
|
|
delete webhookData.webhookEvents;
|
|
}
|
|
|
|
return true;
|
|
},
|
|
},
|
|
};
|
|
|
|
methods = {
|
|
listSearch: {
|
|
getUsers,
|
|
getRepositories,
|
|
},
|
|
};
|
|
|
|
async webhook(this: IWebhookFunctions): Promise<IWebhookResponseData> {
|
|
const bodyData = this.getBodyData();
|
|
|
|
// Check if the webhook is only the ping from Github to confirm if it workshook_id
|
|
if (bodyData.hook_id !== undefined && bodyData.action === undefined) {
|
|
// Is only the ping and not an actual webhook call. So return 'OK'
|
|
// but do not start the workflow.
|
|
|
|
return {
|
|
webhookResponse: 'OK',
|
|
};
|
|
}
|
|
|
|
// Is a regular webhook call
|
|
|
|
// TODO: Add headers & requestPath
|
|
const returnData: IDataObject[] = [];
|
|
|
|
returnData.push({
|
|
body: bodyData,
|
|
headers: this.getHeaderData(),
|
|
query: this.getQueryData(),
|
|
});
|
|
|
|
return {
|
|
workflowData: [this.helpers.returnJsonArray(returnData)],
|
|
};
|
|
}
|
|
}
|