@generacy-ai/generacy-plugin-jira 0.0.0-preview-20260304013206

package/dist/utils/jql-builder.js

@@ -0,0 +1,264 @@
+/**
+ * JQL query builder for constructing type-safe JQL queries
+ */
+export class JqlBuilder {
+    conditions = [];
+    orderByClause = [];
+    /**
+     * Add a condition for project
+     */
+    project(key) {
+        this.conditions.push(`project = "${this.escape(key)}"`);
+        return this;
+    }
+    /**
+     * Add a condition for projects (multiple)
+     */
+    projects(keys) {
+        const escaped = keys.map((k) => `"${this.escape(k)}"`).join(', ');
+        this.conditions.push(`project IN (${escaped})`);
+        return this;
+    }
+    /**
+     * Add a condition for issue type
+     */
+    issueType(type) {
+        this.conditions.push(`issuetype = "${this.escape(type)}"`);
+        return this;
+    }
+    /**
+     * Add a condition for issue types (multiple)
+     */
+    issueTypes(types) {
+        const escaped = types.map((t) => `"${this.escape(t)}"`).join(', ');
+        this.conditions.push(`issuetype IN (${escaped})`);
+        return this;
+    }
+    /**
+     * Add a condition for status
+     */
+    status(name) {
+        this.conditions.push(`status = "${this.escape(name)}"`);
+        return this;
+    }
+    /**
+     * Add a condition for statuses (multiple)
+     */
+    statuses(names) {
+        const escaped = names.map((n) => `"${this.escape(n)}"`).join(', ');
+        this.conditions.push(`status IN (${escaped})`);
+        return this;
+    }
+    /**
+     * Add a condition for status category
+     */
+    statusCategory(category) {
+        const categoryMap = {
+            new: 'To Do',
+            indeterminate: 'In Progress',
+            done: 'Done',
+        };
+        this.conditions.push(`statusCategory = "${categoryMap[category]}"`);
+        return this;
+    }
+    /**
+     * Add a condition for assignee
+     */
+    assignee(accountId) {
+        this.conditions.push(`assignee = "${this.escape(accountId)}"`);
+        return this;
+    }
+    /**
+     * Add a condition for unassigned issues
+     */
+    unassigned() {
+        this.conditions.push('assignee IS EMPTY');
+        return this;
+    }
+    /**
+     * Add a condition for reporter
+     */
+    reporter(accountId) {
+        this.conditions.push(`reporter = "${this.escape(accountId)}"`);
+        return this;
+    }
+    /**
+     * Add a condition for current user
+     */
+    assignedToCurrentUser() {
+        this.conditions.push('assignee = currentUser()');
+        return this;
+    }
+    /**
+     * Add a condition for sprint
+     */
+    sprint(sprintId) {
+        this.conditions.push(`sprint = ${sprintId}`);
+        return this;
+    }
+    /**
+     * Add a condition for active sprint
+     */
+    activeSprint() {
+        this.conditions.push('sprint in openSprints()');
+        return this;
+    }
+    /**
+     * Add a condition for future sprints
+     */
+    futureSprints() {
+        this.conditions.push('sprint in futureSprints()');
+        return this;
+    }
+    /**
+     * Add a condition for labels
+     */
+    label(label) {
+        this.conditions.push(`labels = "${this.escape(label)}"`);
+        return this;
+    }
+    /**
+     * Add a condition for labels (multiple, any match)
+     */
+    labels(labels) {
+        const escaped = labels.map((l) => `"${this.escape(l)}"`).join(', ');
+        this.conditions.push(`labels IN (${escaped})`);
+        return this;
+    }
+    /**
+     * Add a condition for priority
+     */
+    priority(name) {
+        this.conditions.push(`priority = "${this.escape(name)}"`);
+        return this;
+    }
+    /**
+     * Add a condition for priorities (multiple)
+     */
+    priorities(names) {
+        const escaped = names.map((n) => `"${this.escape(n)}"`).join(', ');
+        this.conditions.push(`priority IN (${escaped})`);
+        return this;
+    }
+    /**
+     * Add a condition for parent issue (epic)
+     */
+    parent(parentKey) {
+        this.conditions.push(`parent = "${this.escape(parentKey)}"`);
+        return this;
+    }
+    /**
+     * Add a condition for epic link
+     */
+    epicLink(epicKey) {
+        this.conditions.push(`"Epic Link" = "${this.escape(epicKey)}"`);
+        return this;
+    }
+    /**
+     * Add a condition for created date
+     */
+    createdAfter(date) {
+        this.conditions.push(`created >= "${this.formatDate(date)}"`);
+        return this;
+    }
+    /**
+     * Add a condition for created date
+     */
+    createdBefore(date) {
+        this.conditions.push(`created <= "${this.formatDate(date)}"`);
+        return this;
+    }
+    /**
+     * Add a condition for updated date
+     */
+    updatedAfter(date) {
+        this.conditions.push(`updated >= "${this.formatDate(date)}"`);
+        return this;
+    }
+    /**
+     * Add a condition for updated date
+     */
+    updatedBefore(date) {
+        this.conditions.push(`updated <= "${this.formatDate(date)}"`);
+        return this;
+    }
+    /**
+     * Add a condition for due date
+     */
+    dueBefore(date) {
+        this.conditions.push(`due <= "${this.formatDate(date)}"`);
+        return this;
+    }
+    /**
+     * Add a condition for overdue issues
+     */
+    overdue() {
+        this.conditions.push('due < now()');
+        return this;
+    }
+    /**
+     * Add a text search condition
+     */
+    text(query) {
+        this.conditions.push(`text ~ "${this.escape(query)}"`);
+        return this;
+    }
+    /**
+     * Add a summary search condition
+     */
+    summaryContains(text) {
+        this.conditions.push(`summary ~ "${this.escape(text)}"`);
+        return this;
+    }
+    /**
+     * Add a raw JQL condition
+     */
+    raw(condition) {
+        this.conditions.push(condition);
+        return this;
+    }
+    /**
+     * Add order by clause
+     */
+    orderBy(field, direction = 'ASC') {
+        this.orderByClause.push(`${field} ${direction}`);
+        return this;
+    }
+    /**
+     * Build the JQL query string
+     */
+    build() {
+        let jql = this.conditions.join(' AND ');
+        if (this.orderByClause.length > 0) {
+            jql += ` ORDER BY ${this.orderByClause.join(', ')}`;
+        }
+        return jql;
+    }
+    /**
+     * Reset the builder
+     */
+    reset() {
+        this.conditions = [];
+        this.orderByClause = [];
+        return this;
+    }
+    /**
+     * Escape special characters in JQL values
+     */
+    escape(value) {
+        return value.replace(/"/g, '\\"');
+    }
+    /**
+     * Format date for JQL
+     */
+    formatDate(date) {
+        return date.toISOString().split('T')[0] ?? '';
+    }
+}
+/**
+ * Create a new JQL builder
+ */
+export function jql() {
+    return new JqlBuilder();
+}
+//# sourceMappingURL=jql-builder.js.map

package/dist/utils/jql-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jql-builder.js","sourceRoot":"","sources":["../../src/utils/jql-builder.ts"],"names":[],"mappings":"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"}

package/dist/utils/validation.d.ts

@@ -0,0 +1,31 @@
+import type { JiraConfig, ValidatedJiraConfig } from '../types/config.js';
+/**
+ * Validate Jira configuration
+ * @throws {JiraValidationError} if configuration is invalid
+ */
+export declare function validateConfig(config: JiraConfig): ValidatedJiraConfig;
+/**
+ * Validate an issue key format (e.g., "PROJ-123")
+ */
+export declare function validateIssueKey(key: string): boolean;
+/**
+ * Validate a project key format (e.g., "PROJ")
+ */
+export declare function validateProjectKey(key: string): boolean;
+/**
+ * Validate JQL query (basic syntax check)
+ */
+export declare function validateJql(jql: string): boolean;
+/**
+ * Validate a date string (YYYY-MM-DD format)
+ */
+export declare function validateDateString(date: string): boolean;
+/**
+ * Ensure a value is an issue key, throwing if invalid
+ */
+export declare function ensureIssueKey(key: string): string;
+/**
+ * Ensure a value is a project key, throwing if invalid
+ */
+export declare function ensureProjectKey(key: string): string;
+//# sourceMappingURL=validation.d.ts.map

package/dist/utils/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAI1E;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,mBAAmB,CAiBtE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAErD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAQhD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAOlD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAOpD"}

package/dist/utils/validation.js

@@ -0,0 +1,75 @@
+import { ZodError } from 'zod';
+import { JiraConfigSchema } from '../types/config.js';
+import { JiraValidationError } from './errors.js';
+/**
+ * Validate Jira configuration
+ * @throws {JiraValidationError} if configuration is invalid
+ */
+export function validateConfig(config) {
+    try {
+        return JiraConfigSchema.parse(config);
+    }
+    catch (error) {
+        if (error instanceof ZodError) {
+            const details = {};
+            for (const issue of error.issues) {
+                const path = issue.path.join('.');
+                if (!details[path]) {
+                    details[path] = [];
+                }
+                details[path].push(issue.message);
+            }
+            throw new JiraValidationError('Invalid Jira configuration', details);
+        }
+        throw error;
+    }
+}
+/**
+ * Validate an issue key format (e.g., "PROJ-123")
+ */
+export function validateIssueKey(key) {
+    return /^[A-Z][A-Z0-9]+-\d+$/.test(key);
+}
+/**
+ * Validate a project key format (e.g., "PROJ")
+ */
+export function validateProjectKey(key) {
+    return /^[A-Z][A-Z0-9_]*$/.test(key);
+}
+/**
+ * Validate JQL query (basic syntax check)
+ */
+export function validateJql(jql) {
+    // Basic validation - not empty and doesn't contain obvious injection attempts
+    if (!jql.trim()) {
+        return false;
+    }
+    // Jira JQL doesn't allow certain special characters in specific contexts
+    // This is a basic sanity check, Jira API will provide full validation
+    return true;
+}
+/**
+ * Validate a date string (YYYY-MM-DD format)
+ */
+export function validateDateString(date) {
+    return /^\d{4}-\d{2}-\d{2}$/.test(date);
+}
+/**
+ * Ensure a value is an issue key, throwing if invalid
+ */
+export function ensureIssueKey(key) {
+    if (!validateIssueKey(key)) {
+        throw new JiraValidationError(`Invalid issue key format: ${key}. Expected format: PROJECT-123`);
+    }
+    return key;
+}
+/**
+ * Ensure a value is a project key, throwing if invalid
+ */
+export function ensureProjectKey(key) {
+    if (!validateProjectKey(key)) {
+        throw new JiraValidationError(`Invalid project key format: ${key}. Must start with uppercase letter.`);
+    }
+    return key;
+}
+//# sourceMappingURL=validation.js.map

package/dist/utils/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,KAAK,CAAC;AAE/B,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAElD;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,MAAkB;IAC/C,IAAI,CAAC;QACH,OAAO,gBAAgB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACxC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,QAAQ,EAAE,CAAC;YAC9B,MAAM,OAAO,GAA6B,EAAE,CAAC;YAC7C,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;gBACjC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBAClC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;oBACnB,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;gBACrB,CAAC;gBACD,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACpC,CAAC;YACD,MAAM,IAAI,mBAAmB,CAAC,4BAA4B,EAAE,OAAO,CAAC,CAAC;QACvE,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,OAAO,sBAAsB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC1C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,OAAO,mBAAmB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,8EAA8E;IAC9E,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;QAChB,OAAO,KAAK,CAAC;IACf,CAAC;IACD,yEAAyE;IACzE,sEAAsE;IACtE,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,OAAO,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,mBAAmB,CAC3B,6BAA6B,GAAG,gCAAgC,CACjE,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,mBAAmB,CAC3B,+BAA+B,GAAG,qCAAqC,CACxE,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/webhooks/handler.d.ts

@@ -0,0 +1,80 @@
+import type { JiraWebhookEvent, JiraEventType, WebhookAction, WebhookActionType, WebhookHandler } from './types.js';
+/**
+ * Configuration for webhook handler
+ */
+export interface JiraWebhookHandlerConfig {
+    /** Optional webhook secret for verification */
+    webhookSecret?: string;
+    /** Whether to log events */
+    logEvents?: boolean;
+}
+/**
+ * Result of processing a webhook event
+ */
+export interface WebhookProcessResult {
+    success: boolean;
+    action: WebhookAction;
+    handlersExecuted: number;
+    errors: Error[];
+}
+/**
+ * Jira webhook event handler
+ */
+export declare class JiraWebhookHandler {
+    private handlers;
+    private readonly config;
+    constructor(config?: JiraWebhookHandlerConfig);
+    /**
+     * Register a handler for specific event types
+     */
+    on(eventTypes: JiraEventType | JiraEventType[], handler: WebhookHandler): this;
+    /**
+     * Register a handler for specific action types
+     */
+    onAction(actionTypes: WebhookActionType | WebhookActionType[], handler: WebhookHandler): this;
+    /**
+     * Register a handler for issue created events
+     */
+    onIssueCreated(handler: WebhookHandler): this;
+    /**
+     * Register a handler for issue updated events
+     */
+    onIssueUpdated(handler: WebhookHandler): this;
+    /**
+     * Register a handler for issue transitioned events
+     */
+    onIssueTransitioned(handler: WebhookHandler): this;
+    /**
+     * Register a handler for issue assigned events
+     */
+    onIssueAssigned(handler: WebhookHandler): this;
+    /**
+     * Register a handler for comment created events
+     */
+    onCommentCreated(handler: WebhookHandler): this;
+    /**
+     * Process a raw webhook payload
+     */
+    handle(payload: unknown): Promise<WebhookProcessResult>;
+    /**
+     * Process a typed webhook event
+     */
+    processEvent(event: JiraWebhookEvent): Promise<WebhookProcessResult>;
+    /**
+     * Find handlers that match the event and action
+     */
+    private findMatchingHandlers;
+    /**
+     * Clear all registered handlers
+     */
+    clearHandlers(): void;
+    /**
+     * Get the number of registered handlers
+     */
+    get handlerCount(): number;
+}
+/**
+ * Create a new webhook handler instance
+ */
+export declare function createWebhookHandler(config?: JiraWebhookHandlerConfig): JiraWebhookHandler;
+//# sourceMappingURL=handler.d.ts.map

package/dist/webhooks/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../src/webhooks/handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,cAAc,EAEf,MAAM,YAAY,CAAC;AAGpB;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,+CAA+C;IAC/C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,4BAA4B;IAC5B,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,aAAa,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,KAAK,EAAE,CAAC;CACjB;AAED;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAoC;IACpD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2B;gBAEtC,MAAM,GAAE,wBAA6B;IAIjD;;OAEG;IACH,EAAE,CACA,UAAU,EAAE,aAAa,GAAG,aAAa,EAAE,EAC3C,OAAO,EAAE,cAAc,GACtB,IAAI;IAMP;;OAEG;IACH,QAAQ,CACN,WAAW,EAAE,iBAAiB,GAAG,iBAAiB,EAAE,EACpD,OAAO,EAAE,cAAc,GACtB,IAAI;IAUP;;OAEG;IACH,cAAc,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAI7C;;OAEG;IACH,cAAc,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAI7C;;OAEG;IACH,mBAAmB,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAIlD;;OAEG;IACH,eAAe,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAI9C;;OAEG;IACH,gBAAgB,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAI/C;;OAEG;IACG,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAK7D;;OAEG;IACG,YAAY,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IA6B1E;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAoB5B;;OAEG;IACH,aAAa,IAAI,IAAI;IAIrB;;OAEG;IACH,IAAI,YAAY,IAAI,MAAM,CAEzB;CACF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,CAAC,EAAE,wBAAwB,GAChC,kBAAkB,CAEpB"}

package/dist/webhooks/handler.js

@@ -0,0 +1,130 @@
+import { parseWebhookPayload, parseWebhookAction } from './parser.js';
+/**
+ * Jira webhook event handler
+ */
+export class JiraWebhookHandler {
+    handlers = [];
+    config;
+    constructor(config = {}) {
+        this.config = config;
+    }
+    /**
+     * Register a handler for specific event types
+     */
+    on(eventTypes, handler) {
+        const types = Array.isArray(eventTypes) ? eventTypes : [eventTypes];
+        this.handlers.push({ eventTypes: types, handler });
+        return this;
+    }
+    /**
+     * Register a handler for specific action types
+     */
+    onAction(actionTypes, handler) {
+        const types = Array.isArray(actionTypes) ? actionTypes : [actionTypes];
+        this.handlers.push({
+            eventTypes: [], // Will match any event type
+            actionTypes: types,
+            handler,
+        });
+        return this;
+    }
+    /**
+     * Register a handler for issue created events
+     */
+    onIssueCreated(handler) {
+        return this.on('jira:issue_created', handler);
+    }
+    /**
+     * Register a handler for issue updated events
+     */
+    onIssueUpdated(handler) {
+        return this.on('jira:issue_updated', handler);
+    }
+    /**
+     * Register a handler for issue transitioned events
+     */
+    onIssueTransitioned(handler) {
+        return this.onAction('issue_transitioned', handler);
+    }
+    /**
+     * Register a handler for issue assigned events
+     */
+    onIssueAssigned(handler) {
+        return this.onAction('issue_assigned', handler);
+    }
+    /**
+     * Register a handler for comment created events
+     */
+    onCommentCreated(handler) {
+        return this.on('comment_created', handler);
+    }
+    /**
+     * Process a raw webhook payload
+     */
+    async handle(payload) {
+        const event = parseWebhookPayload(payload);
+        return this.processEvent(event);
+    }
+    /**
+     * Process a typed webhook event
+     */
+    async processEvent(event) {
+        const action = parseWebhookAction(event);
+        if (this.config.logEvents) {
+            console.log(`[JiraWebhook] ${event.webhookEvent} -> ${action.type}`, {
+                issueKey: action.issueKey,
+                userId: action.userId,
+            });
+        }
+        const matchingHandlers = this.findMatchingHandlers(event, action);
+        const errors = [];
+        for (const registration of matchingHandlers) {
+            try {
+                await registration.handler(event, action);
+            }
+            catch (error) {
+                errors.push(error instanceof Error ? error : new Error(String(error)));
+            }
+        }
+        return {
+            success: errors.length === 0,
+            action,
+            handlersExecuted: matchingHandlers.length,
+            errors,
+        };
+    }
+    /**
+     * Find handlers that match the event and action
+     */
+    findMatchingHandlers(event, action) {
+        return this.handlers.filter((registration) => {
+            // Check event type match
+            const eventTypeMatch = registration.eventTypes.length === 0 ||
+                registration.eventTypes.includes(event.webhookEvent);
+            // Check action type match
+            const actionTypeMatch = !registration.actionTypes ||
+                registration.actionTypes.length === 0 ||
+                registration.actionTypes.includes(action.type);
+            return eventTypeMatch && actionTypeMatch;
+        });
+    }
+    /**
+     * Clear all registered handlers
+     */
+    clearHandlers() {
+        this.handlers = [];
+    }
+    /**
+     * Get the number of registered handlers
+     */
+    get handlerCount() {
+        return this.handlers.length;
+    }
+}
+/**
+ * Create a new webhook handler instance
+ */
+export function createWebhookHandler(config) {
+    return new JiraWebhookHandler(config);
+}
+//# sourceMappingURL=handler.js.map

package/dist/webhooks/handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.js","sourceRoot":"","sources":["../../src/webhooks/handler.ts"],"names":[],"mappings":"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"}

package/dist/webhooks/parser.d.ts

@@ -0,0 +1,34 @@
+import type { JiraWebhookEvent, WebhookAction, ChangelogItem, Changelog } from './types.js';
+/**
+ * Parse a raw webhook payload into a typed event
+ */
+export declare function parseWebhookPayload(payload: unknown): JiraWebhookEvent;
+/**
+ * Extract changes from a changelog
+ */
+export declare function extractChanges(changelog?: Changelog): ChangelogItem[];
+/**
+ * Check if a specific field was changed
+ */
+export declare function hasFieldChange(changelog: Changelog | undefined, fieldName: string): boolean;
+/**
+ * Get the change for a specific field
+ */
+export declare function getFieldChange(changelog: Changelog | undefined, fieldName: string): ChangelogItem | undefined;
+/**
+ * Parse webhook event into a normalized action
+ */
+export declare function parseWebhookAction(event: JiraWebhookEvent): WebhookAction;
+/**
+ * Check if an event is for a specific issue
+ */
+export declare function isEventForIssue(event: JiraWebhookEvent, issueKey: string): boolean;
+/**
+ * Check if an event involves a specific user
+ */
+export declare function isEventByUser(event: JiraWebhookEvent, accountId: string): boolean;
+/**
+ * Get the issue key from any webhook event
+ */
+export declare function getIssueKeyFromEvent(event: JiraWebhookEvent): string | null;
+//# sourceMappingURL=parser.d.ts.map

package/dist/webhooks/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/webhooks/parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAGhB,aAAa,EAEb,aAAa,EACb,SAAS,EACV,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,gBAAgB,CActE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,SAAS,CAAC,EAAE,SAAS,GAAG,aAAa,EAAE,CAErE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,SAAS,GAAG,SAAS,EAChC,SAAS,EAAE,MAAM,GAChB,OAAO,CAIT;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,SAAS,GAAG,SAAS,EAChC,SAAS,EAAE,MAAM,GAChB,aAAa,GAAG,SAAS,CAI3B;AAoDD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,gBAAgB,GAAG,aAAa,CA0DzE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,gBAAgB,EACvB,QAAQ,EAAE,MAAM,GACf,OAAO,CAKT;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,gBAAgB,EACvB,SAAS,EAAE,MAAM,GAChB,OAAO,CAET;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM,GAAG,IAAI,CAK3E"}