Event Triggers#

{
  eventType: "avi:jira:created:issue",
  atlassianId: "5a0000000000000000000001",  // User who triggered
  issue: {
    id: "10001",
    key: "PROJ-123",
    self: "https://your-site.atlassian.net/rest/api/3/issue/10001"
  },
  // Additional fields vary by event type
  changelog: {  // For update events
    items: [
      {
        field: "status",
        fromString: "To Do",
        toString: "In Progress"
      }
    ]
  }
}

{
  eventType: "avi:jira:commented:issue",
  atlassianId: "5a0000000000000000000001",
  issue: {
    id: "10001",
    key: "PROJ-123"
  },
  comment: {
    id: "10050",
    author: {
      accountId: "5a0000000000000000000001",
      displayName: "John Doe"
    },
    body: {
      type: "doc",
      version: 1,
      content: [...]
    },
    created: "2024-01-15T10:30:00.000Z",
    updated: "2024-01-15T10:30:00.000Z"
  }
}

{
  eventType: "avi:jira:released:version",
  atlassianId: "5a0000000000000000000001",
  version: {
    id: "10000",
    name: "v1.0.0",
    description: "First release",
    projectId: "10001",
    released: true,
    releaseDate: "2024-01-15"
  }
}

if (event.eventType !== "avi:jira:created:issue") return;

// Get the full work item details
const response = await requestJira(
  route`/rest/api/3/issue/${event.issue.key}`
);
const issue = await response.json();

// Check if high priority
if (issue.fields.priority.name === "Highest") {
  // Add a comment alerting the team
  await requestJira(
    route`/rest/api/3/issue/${event.issue.key}/comment`,
    {
      method: "POST",
      headers: { "Content-Type": "application/json" },
      body: JSON.stringify({
        body: {
          type: "doc",
          version: 1,
          content: [{
            type: "paragraph",
            content: [{
              type: "text",
              text: "High priority work item created - requires immediate attention!"
            }]
          }]
        }
      })
    }
  );

  console.log("Alert added to high priority work item:", event.issue.key);
}

if (event.eventType !== "avi:jira:created:issue") return;

// Get work item details
const response = await requestJira(
  route`/rest/api/3/issue/${event.issue.key}`
);
const issue = await response.json();

// Map components to assignees
const componentOwners = {
  "Frontend": process.env.FRONTEND_LEAD_ID,
  "Backend": process.env.BACKEND_LEAD_ID,
  "Database": process.env.DB_LEAD_ID
};

// Find matching component owner
const components = issue.fields.components || [];
for (const comp of components) {
  const ownerId = componentOwners[comp.name];
  if (ownerId) {
    await requestJira(
      route`/rest/api/3/issue/${event.issue.key}`,
      {
        method: "PUT",
        headers: { "Content-Type": "application/json" },
        body: JSON.stringify({
          fields: {
            assignee: { accountId: ownerId }
          }
        })
      }
    );
    console.log(`Assigned ${event.issue.key} to ${comp.name} lead`);
    break;
  }
}

if (event.eventType !== "avi:jira:updated:issue") return;

const changes = event.changelog?.items || [];

// Log significant changes
for (const change of changes) {
  console.log(
    `Field "${change.field}" changed from "${change.fromString}" to "${change.toString}"`
  );
}

// Check for status changes
const statusChange = changes.find(c => c.field === "status");
if (statusChange) {
  console.log(`Work item ${event.issue.key} moved to ${statusChange.toString}`);

  // Add a comment documenting the change
  await requestJira(
    route`/rest/api/3/issue/${event.issue.key}/comment`,
    {
      method: "POST",
      headers: { "Content-Type": "application/json" },
      body: JSON.stringify({
        body: {
          type: "doc",
          version: 1,
          content: [{
            type: "paragraph",
            content: [{
              type: "text",
              text: `Status changed: ${statusChange.fromString} → ${statusChange.toString}`
            }]
          }]
        }
      })
    }
  );
}

if (event.eventType !== "avi:jira:released:version") return;

const versionName = event.version.name;
console.log(`Version ${versionName} released!`);

// Find all work items in this version and add a label
const jql = `fixVersion = "${versionName}"`;
const searchResponse = await requestJira(
  route`/rest/api/3/search/jql?jql=${encodeURIComponent(jql)}&maxResults=100`
);
const searchResult = await searchResponse.json();

console.log(`Found ${searchResult.total} work items in version ${versionName}`);

// Update each work item
for (const issue of searchResult.issues) {
  const currentLabels = issue.fields.labels || [];
  if (!currentLabels.includes("released")) {
    await requestJira(
      route`/rest/api/3/issue/${issue.key}`,
      {
        method: "PUT",
        headers: { "Content-Type": "application/json" },
        body: JSON.stringify({
          fields: {
            labels: [...currentLabels, "released"]
          }
        })
      }
    );
    console.log(`Added 'released' label to ${issue.key}`);
  }
}

if (event.eventType !== "avi:jira:commented:issue") return;

const comment = event.comment;
const content = comment.body?.content || [];

// Find all mentions in the comment
function findMentions(nodes) {
  const mentions = [];
  for (const node of nodes) {
    if (node.type === "mention") {
      mentions.push(node.attrs?.id);
    }
    if (node.content) {
      mentions.push(...findMentions(node.content));
    }
  }
  return mentions;
}

const mentionedUsers = findMentions(content);
if (mentionedUsers.length > 0) {
  console.log(`Comment on ${event.issue.key} mentioned ${mentionedUsers.length} users`);

  // You could log this, send notifications, etc.
  for (const userId of mentionedUsers) {
    console.log(`User mentioned: ${userId}`);
  }
}