@devrev/git-sdk 0.11.0

package/dist/handlers/pr_merge_handler.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Handler for pull request merge events.
+ *
+ * This module handles PR merge events, updating the code_change custom object
+ * with merged status, closed timestamp, target commit information, and
+ * lines of code metrics (lines added, lines deleted, files changed).
+ */
+import { NormalizedPullRequestMergeEvent } from '../types/events';
+import { HandlerContext, HandlerResult } from './types';
+/**
+ * Process a pull request merge event.
+ *
+ * This function handles the core business logic for updating code_change
+ * custom objects when a pull request is merged.
+ *
+ * The handler will:
+ * 1. Get or create the code_change for this PR (by URL)
+ * 2. Fetch diff stats (lines added, lines deleted, files changed) from the provider
+ * 3. Update the code_change with:
+ *    - Status → MERGED
+ *    - closed_at → merge timestamp
+ *    - target_commits → merge commit SHA (when available)
+ *    - lines_added, lines_deleted, files_changed → from diff stats
+ *
+ * @param input - The normalized PR merge event
+ * @param context - The handler context with DevRev client and adapter
+ * @returns Handler result indicating success or failure
+ */
+export declare function handlePRMerge(input: NormalizedPullRequestMergeEvent, context: HandlerContext): Promise<HandlerResult>;

package/dist/handlers/pr_merge_handler.js

@@ -0,0 +1,86 @@
+"use strict";
+/**
+ * Handler for pull request merge events.
+ *
+ * This module handles PR merge events, updating the code_change custom object
+ * with merged status, closed timestamp, target commit information, and
+ * lines of code metrics (lines added, lines deleted, files changed).
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handlePRMerge = void 0;
+const types_1 = require("../devrev/types");
+const helpers_1 = require("./helpers");
+// =============================================================================
+// PR Merge Handler
+// =============================================================================
+/**
+ * Process a pull request merge event.
+ *
+ * This function handles the core business logic for updating code_change
+ * custom objects when a pull request is merged.
+ *
+ * The handler will:
+ * 1. Get or create the code_change for this PR (by URL)
+ * 2. Fetch diff stats (lines added, lines deleted, files changed) from the provider
+ * 3. Update the code_change with:
+ *    - Status → MERGED
+ *    - closed_at → merge timestamp
+ *    - target_commits → merge commit SHA (when available)
+ *    - lines_added, lines_deleted, files_changed → from diff stats
+ *
+ * @param input - The normalized PR merge event
+ * @param context - The handler context with DevRev client and adapter
+ * @returns Handler result indicating success or failure
+ */
+function handlePRMerge(input, context) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const { pullRequest, repository, mergedAt, mergeCommitSha } = input;
+        const repoName = repository.name;
+        const { client, adapter } = context;
+        try {
+            // Get or create code_change for this PR
+            const { codeChange } = yield (0, helpers_1.getOrCreateCodeChangeForPR)(pullRequest, repoName, context);
+            // Fetch diff stats from the provider (lines added, deleted, files changed)
+            let diffStats;
+            try {
+                diffStats = yield adapter.getPullRequestDiffStats(pullRequest);
+            }
+            catch (error) {
+                console.log(`Warning: Could not fetch diff stats for PR #${pullRequest.number}: ${error}`);
+            }
+            // Build update request for merge
+            const updateRequest = Object.assign(Object.assign({ id: codeChange.id, status: types_1.CodeChangeStatus.MERGED, closed_at: mergedAt }, (mergeCommitSha && { target_commits: [mergeCommitSha] })), (diffStats && {
+                lines_added: diffStats.lines_added,
+                lines_deleted: diffStats.lines_deleted,
+                files_changed: diffStats.files_changed,
+            }));
+            yield client.codeChange.update(updateRequest, codeChange);
+            // Note: No separate timeline entry is created for merge events.
+            // The status change to MERGED generates a timeline entry automatically
+            // via the code_change status field change delta.
+            return {
+                data: Object.assign({ codeChangeId: codeChange.id, mergedAt, mergeCommitSha: mergeCommitSha || null }, (diffStats && {
+                    linesAdded: diffStats.lines_added,
+                    linesDeleted: diffStats.lines_deleted,
+                    filesChanged: diffStats.files_changed,
+                })),
+                message: `Processed merge for PR #${pullRequest.number}`,
+                success: true,
+            };
+        }
+        catch (error) {
+            return (0, helpers_1.createPRHandlerErrorResult)('PR merge', pullRequest, error);
+        }
+    });
+}
+exports.handlePRMerge = handlePRMerge;
+//# sourceMappingURL=pr_merge_handler.js.map

package/dist/handlers/pr_merge_handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pr_merge_handler.js","sourceRoot":"","sources":["../../src/handlers/pr_merge_handler.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;;;;;;;;;;AAEH,2CAGyB;AAIzB,uCAAmF;AAGnF,gFAAgF;AAChF,mBAAmB;AACnB,gFAAgF;AAEhF;;;;;;;;;;;;;;;;;;GAkBG;AACH,SAAsB,aAAa,CACjC,KAAsC,EACtC,OAAuB;;QAEvB,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,QAAQ,EAAE,cAAc,EAAE,GAAG,KAAK,CAAC;QACpE,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC;QACjC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;QAEpC,IAAI;YACF,wCAAwC;YACxC,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,IAAA,oCAA0B,EACrD,WAAW,EACX,QAAQ,EACR,OAAO,CACR,CAAC;YAEF,2EAA2E;YAC3E,IAAI,SAA0C,CAAC;YAC/C,IAAI;gBACF,SAAS,GAAG,MAAM,OAAO,CAAC,uBAAuB,CAAC,WAAW,CAAC,CAAC;aAChE;YAAC,OAAO,KAAK,EAAE;gBACd,OAAO,CAAC,GAAG,CAAC,+CAA+C,WAAW,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC,CAAC;aAC5F;YAED,iCAAiC;YACjC,MAAM,aAAa,iCACjB,EAAE,EAAE,UAAU,CAAC,EAAE,EACjB,MAAM,EAAE,wBAAgB,CAAC,MAAM,EAC/B,SAAS,EAAE,QAAQ,IAChB,CAAC,cAAc,IAAI,EAAE,cAAc,EAAE,CAAC,cAAc,CAAC,EAAE,CAAC,GACxD,CAAC,SAAS,IAAI;gBACf,WAAW,EAAE,SAAS,CAAC,WAAW;gBAClC,aAAa,EAAE,SAAS,CAAC,aAAa;gBACtC,aAAa,EAAE,SAAS,CAAC,aAAa;aACvC,CAAC,CACH,CAAC;YAEF,MAAM,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC;YAE1D,gEAAgE;YAChE,uEAAuE;YACvE,iDAAiD;YAEjD,OAAO;gBACL,IAAI,kBACF,YAAY,EAAE,UAAU,CAAC,EAAE,EAC3B,QAAQ,EACR,cAAc,EAAE,cAAc,IAAI,IAAI,IACnC,CAAC,SAAS,IAAI;oBACf,UAAU,EAAE,SAAS,CAAC,WAAW;oBACjC,YAAY,EAAE,SAAS,CAAC,aAAa;oBACrC,YAAY,EAAE,SAAS,CAAC,aAAa;iBACtC,CAAC,CACH;gBACD,OAAO,EAAE,2BAA2B,WAAW,CAAC,MAAM,EAAE;gBACxD,OAAO,EAAE,IAAI;aACd,CAAC;SACH;QAAC,OAAO,KAAK,EAAE;YACd,OAAO,IAAA,oCAA0B,EAAC,UAAU,EAAE,WAAW,EAAE,KAAK,CAAC,CAAC;SACnE;IACH,CAAC;CAAA;AA5DD,sCA4DC"}

package/dist/handlers/pr_review_handler.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Handler for pull request review events.
+ *
+ * This module handles PR review submissions (approval or changes requested),
+ * updating the code_change custom object with reviewer information, status
+ * changes, and review timestamps.
+ */
+import { NormalizedPRReviewEvent } from '../types/events';
+import { HandlerContext, HandlerResult } from './types';
+/**
+ * Process a pull request review event.
+ *
+ * This function handles the core business logic for updating code_change
+ * custom objects when a review is submitted on a pull request.
+ *
+ * The handler will:
+ * 1. Get or create the code_change for this PR (by URL)
+ * 2. Resolve the reviewer to a DevRev user ID
+ * 3. Update the code_change status based on review state:
+ *    - APPROVED → status = APPROVED, update approved_by + reviewed_by
+ *    - CHANGES_REQUESTED → status = CHANGES_REQUESTED, update reviewed_by
+ * 4. Update review timestamps (first_review_at, last_review_at, first_approved_at, last_approved_at)
+ * 5. Remove reviewer from requested_reviewers (they've submitted their review)
+ * 6. Create a timeline entry for the review event
+ *
+ * @param input - The normalized PR review event
+ * @param context - The handler context with DevRev client and adapter
+ * @returns Handler result indicating success or failure
+ */
+export declare function handlePRReview(input: NormalizedPRReviewEvent, context: HandlerContext): Promise<HandlerResult>;

package/dist/handlers/pr_review_handler.js

@@ -0,0 +1,109 @@
+"use strict";
+/**
+ * Handler for pull request review events.
+ *
+ * This module handles PR review submissions (approval or changes requested),
+ * updating the code_change custom object with reviewer information, status
+ * changes, and review timestamps.
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handlePRReview = void 0;
+const types_1 = require("../devrev/types");
+const events_1 = require("../types/events");
+const helpers_1 = require("./helpers");
+// =============================================================================
+// PR Review Handler
+// =============================================================================
+/**
+ * Process a pull request review event.
+ *
+ * This function handles the core business logic for updating code_change
+ * custom objects when a review is submitted on a pull request.
+ *
+ * The handler will:
+ * 1. Get or create the code_change for this PR (by URL)
+ * 2. Resolve the reviewer to a DevRev user ID
+ * 3. Update the code_change status based on review state:
+ *    - APPROVED → status = APPROVED, update approved_by + reviewed_by
+ *    - CHANGES_REQUESTED → status = CHANGES_REQUESTED, update reviewed_by
+ * 4. Update review timestamps (first_review_at, last_review_at, first_approved_at, last_approved_at)
+ * 5. Remove reviewer from requested_reviewers (they've submitted their review)
+ * 6. Create a timeline entry for the review event
+ *
+ * @param input - The normalized PR review event
+ * @param context - The handler context with DevRev client and adapter
+ * @returns Handler result indicating success or failure
+ */
+function handlePRReview(input, context) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const { pullRequest, repository, state, reviewer, reviewedAt } = input;
+        const repoName = repository.name;
+        const { client } = context;
+        try {
+            // Get or create code_change for this PR
+            const { codeChange } = yield (0, helpers_1.getOrCreateCodeChangeForPR)(pullRequest, repoName, context);
+            // Resolve reviewer to DevRev user ID
+            const reviewerDevUserId = yield client.devUser.resolveByExternalId(reviewer.external_id, reviewer.email);
+            // Read existing custom fields from the code_change
+            const existingFirstReviewAt = (0, helpers_1.getCodeChangeCustomField)(codeChange, types_1.CodeChangeFields.FIRST_REVIEW_AT);
+            const existingFirstApprovedAt = (0, helpers_1.getCodeChangeCustomField)(codeChange, types_1.CodeChangeFields.FIRST_APPROVED_AT);
+            // Check if reviewer is already in reviewed_by / approved_by lists
+            const existingReviewedBy = (0, helpers_1.getCodeChangeCustomField)(codeChange, types_1.CodeChangeFields.REVIEWED_BY) || [];
+            const existingApprovedBy = (0, helpers_1.getCodeChangeCustomField)(codeChange, types_1.CodeChangeFields.APPROVED_BY) || [];
+            const isAlreadyReviewer = reviewerDevUserId != null && existingReviewedBy.includes(reviewerDevUserId);
+            const isAlreadyApprover = reviewerDevUserId != null && existingApprovedBy.includes(reviewerDevUserId);
+            // Build update request based on review state
+            const updateRequest = Object.assign(Object.assign(Object.assign({ id: codeChange.id, 
+                // Always update last_review_at
+                last_review_at: reviewedAt }, (!existingFirstReviewAt && { first_review_at: reviewedAt })), (reviewerDevUserId && !isAlreadyReviewer && { add_reviewed_by: [reviewerDevUserId] })), (reviewerDevUserId && {
+                remove_requested_reviewer: [reviewerDevUserId],
+            }));
+            if (state === events_1.ReviewStateValues.APPROVED) {
+                updateRequest.status = types_1.CodeChangeStatus.APPROVED;
+                updateRequest.last_approved_at = reviewedAt;
+                // Set first_approved_at only if not already set
+                if (!existingFirstApprovedAt) {
+                    updateRequest.first_approved_at = reviewedAt;
+                }
+                // Add to approved_by list only if not already present
+                if (reviewerDevUserId && !isAlreadyApprover) {
+                    updateRequest.add_approved_by = [reviewerDevUserId];
+                }
+            }
+            else if (state === events_1.ReviewStateValues.CHANGES_REQUESTED) {
+                updateRequest.status = types_1.CodeChangeStatus.CHANGES_REQUESTED;
+            }
+            yield client.codeChange.update(updateRequest, codeChange);
+            // Create timeline entry for the review
+            // Prefer the resolved DevRev user identity; fall back to provider username
+            const reviewerName = reviewerDevUserId || reviewer.username || 'A reviewer';
+            const message = state === events_1.ReviewStateValues.APPROVED
+                ? `${reviewerName} approved PR #${pullRequest.number}`
+                : `${reviewerName} requested changes on PR #${pullRequest.number}`;
+            yield (0, helpers_1.createPRTimelineEntry)(codeChange.id, pullRequest, repoName, reviewedAt, message, context);
+            return {
+                data: {
+                    codeChangeId: codeChange.id,
+                    reviewState: state,
+                    reviewerDevUserId,
+                },
+                message: `Processed ${state.toLowerCase()} review for PR #${pullRequest.number}`,
+                success: true,
+            };
+        }
+        catch (error) {
+            return (0, helpers_1.createPRHandlerErrorResult)('PR review', pullRequest, error);
+        }
+    });
+}
+exports.handlePRReview = handlePRReview;
+//# sourceMappingURL=pr_review_handler.js.map

package/dist/handlers/pr_review_handler.js.map

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

package/dist/handlers/registry.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Default handler registry for the Git SDK.
+ *
+ * Maps each normalized event type to its corresponding handler function.
+ * `pull_request_edit` is intentionally not mapped — there is no dedicated
+ * handler for edit events yet.
+ */
+import { HandlerRegistry } from './types';
+export declare const DEFAULT_HANDLER_REGISTRY: HandlerRegistry;

package/dist/handlers/registry.js

@@ -0,0 +1,22 @@
+"use strict";
+/**
+ * Default handler registry for the Git SDK.
+ *
+ * Maps each normalized event type to its corresponding handler function.
+ * `pull_request_edit` is intentionally not mapped — there is no dedicated
+ * handler for edit events yet.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_HANDLER_REGISTRY = void 0;
+const commit_push_handler_1 = require("./commit_push_handler");
+const pr_create_handler_1 = require("./pr_create_handler");
+const pr_review_handler_1 = require("./pr_review_handler");
+const pr_merge_handler_1 = require("./pr_merge_handler");
+exports.DEFAULT_HANDLER_REGISTRY = {
+    'push': commit_push_handler_1.handlePushEvent,
+    'pull_request_create': pr_create_handler_1.handlePRCreate,
+    'pull_request_close': pr_create_handler_1.handlePRClose,
+    'pull_request_review': pr_review_handler_1.handlePRReview,
+    'pull_request_merge': pr_merge_handler_1.handlePRMerge,
+};
+//# sourceMappingURL=registry.js.map

package/dist/handlers/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/handlers/registry.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH,+DAAwD;AACxD,2DAAoE;AACpE,2DAAqD;AACrD,yDAAmD;AAGtC,QAAA,wBAAwB,GAAoB;IACvD,MAAM,EAAE,qCAA+B;IACvC,qBAAqB,EAAE,kCAA8B;IACrD,oBAAoB,EAAE,iCAA6B;IACnD,qBAAqB,EAAE,kCAA8B;IACrD,oBAAoB,EAAE,gCAA6B;CACpD,CAAC"}

package/dist/handlers/types.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Types for event handlers.
+ */
+import { IProviderAdapter } from '../adapter/adapter';
+import { DevRevClient } from '../devrev/client';
+import { CodeChangeSourceType } from '../devrev/types';
+import { NormalizedEvent } from '../types/events';
+/**
+ * Result of a handler operation.
+ */
+export interface HandlerResult {
+    success: boolean;
+    message: string;
+    data?: Record<string, unknown>;
+}
+/**
+ * Context required for event handlers.
+ */
+export interface HandlerContext {
+    /**
+     * The DevRev client instance for API operations.
+     */
+    client: DevRevClient;
+    /**
+     * The code change source type (GitHub=1, GitLab=2, etc.).
+     */
+    source: CodeChangeSourceType;
+    /**
+     * Event type identifier for timeline entries.
+     * Should be the type field from the events defined in src/types/events.ts
+     * (e.g., 'push', 'pull_request_create', 'pull_request_edit', 'pull_request_review').
+     */
+    eventType: string;
+    /**
+     * The provider adapter for extracting work IDs and fetching commits.
+     */
+    adapter: IProviderAdapter;
+}
+/**
+ * A handler function that processes a normalized event.
+ */
+export type EventHandler = (event: NormalizedEvent, context: HandlerContext) => Promise<HandlerResult>;
+/**
+ * Map of event type string to its handler function.
+ */
+export type HandlerRegistry = Record<string, EventHandler>;

package/dist/handlers/types.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Types for event handlers.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/handlers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/handlers/types.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Git SDK - Adapter interfaces for git connectors
+ *
+ * This SDK provides interfaces that git connectors can implement
+ * to publish events from git tools (GitHub, GitLab, etc.) into DevRev.
+ */
+export { type ProviderContext, type DevRevConfig, type SDKConfiguration, type NormalizedActor, type NormalizedCommit, type NormalizedBranch, type NormalizedDiffStats, type NormalizedPullRequest, type NormalizedRepository, type NormalizedEvent, type NormalizedPushEvent, type NormalizedPullRequestCreateEvent, type NormalizedPullRequestEditEvent, type NormalizedPRReviewEvent, type NormalizedPullRequestCloseEvent, type NormalizedPullRequestMergeEvent, ReviewStateValues, type ReviewState, } from './types';
+export { createConfig, type CreateConfigOptions } from './config';
+export { DevRevClient, type DevRevClientConfig, getErrorMessage, getCodeChangeSourceFromProvider, CODE_CHANGE_LEAF_TYPE, TF_PREFIX, tf, ISSUE_CODE_CHANGE_LINK_TYPE_NAME, ISSUE_CODE_CHANGE_LINK_TOOLTIP, ISSUE_CODE_CHANGE_FORWARD_NAME, ISSUE_CODE_CHANGE_BACKWARD_NAME, CodeChangeSource, CodeChangeStatus, CodeChangeFields, GitProviderValues, type GitProvider, type CodeChangeSourceType, type CodeChangeStatusType, type CodeChangeCustomCreateRequest, type CodeChangeCustomUpdateRequest, type TimelineEventMetadata, type ChangeEventBody, type HTTPResponse, type TenantFragmentResult, type CustomLinkTypeInstallResult, type TimelineResult, CodeChangeManager, TenantFragmentManager, CustomLinkTypeManager, LinkManager, TimelineManager, DevUserManager, EventMetadataKeys, postCall, getCall, constructURL, } from './devrev';
+export { handlePushEvent, handlePRCreate, handlePRClose, handlePRReview, handlePRMerge, DEFAULT_HANDLER_REGISTRY, type EventHandler, type HandlerContext, type HandlerRegistry, type HandlerResult, } from './handlers';
+export { EventOrchestrator, type EventOrchestratorConfig, } from './orchestrator';
+export { type IProviderAdapter } from './adapter/adapter';

package/dist/index.js

@@ -0,0 +1,65 @@
+"use strict";
+/**
+ * Git SDK - Adapter interfaces for git connectors
+ *
+ * This SDK provides interfaces that git connectors can implement
+ * to publish events from git tools (GitHub, GitLab, etc.) into DevRev.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventOrchestrator = exports.DEFAULT_HANDLER_REGISTRY = exports.handlePRMerge = exports.handlePRReview = exports.handlePRClose = exports.handlePRCreate = exports.handlePushEvent = exports.constructURL = exports.getCall = exports.postCall = exports.EventMetadataKeys = exports.DevUserManager = exports.TimelineManager = exports.LinkManager = exports.CustomLinkTypeManager = exports.TenantFragmentManager = exports.CodeChangeManager = exports.GitProviderValues = exports.CodeChangeFields = exports.CodeChangeStatus = exports.CodeChangeSource = exports.ISSUE_CODE_CHANGE_BACKWARD_NAME = exports.ISSUE_CODE_CHANGE_FORWARD_NAME = exports.ISSUE_CODE_CHANGE_LINK_TOOLTIP = exports.ISSUE_CODE_CHANGE_LINK_TYPE_NAME = exports.tf = exports.TF_PREFIX = exports.CODE_CHANGE_LEAF_TYPE = exports.getCodeChangeSourceFromProvider = exports.getErrorMessage = exports.DevRevClient = exports.createConfig = exports.ReviewStateValues = void 0;
+// Types - re-export from types module
+var types_1 = require("./types");
+Object.defineProperty(exports, "ReviewStateValues", { enumerable: true, get: function () { return types_1.ReviewStateValues; } });
+// Config
+var config_1 = require("./config");
+Object.defineProperty(exports, "createConfig", { enumerable: true, get: function () { return config_1.createConfig; } });
+// DevRev Client
+var devrev_1 = require("./devrev");
+// Main client
+Object.defineProperty(exports, "DevRevClient", { enumerable: true, get: function () { return devrev_1.DevRevClient; } });
+// Utilities
+Object.defineProperty(exports, "getErrorMessage", { enumerable: true, get: function () { return devrev_1.getErrorMessage; } });
+Object.defineProperty(exports, "getCodeChangeSourceFromProvider", { enumerable: true, get: function () { return devrev_1.getCodeChangeSourceFromProvider; } });
+// Constants
+Object.defineProperty(exports, "CODE_CHANGE_LEAF_TYPE", { enumerable: true, get: function () { return devrev_1.CODE_CHANGE_LEAF_TYPE; } });
+Object.defineProperty(exports, "TF_PREFIX", { enumerable: true, get: function () { return devrev_1.TF_PREFIX; } });
+Object.defineProperty(exports, "tf", { enumerable: true, get: function () { return devrev_1.tf; } });
+Object.defineProperty(exports, "ISSUE_CODE_CHANGE_LINK_TYPE_NAME", { enumerable: true, get: function () { return devrev_1.ISSUE_CODE_CHANGE_LINK_TYPE_NAME; } });
+Object.defineProperty(exports, "ISSUE_CODE_CHANGE_LINK_TOOLTIP", { enumerable: true, get: function () { return devrev_1.ISSUE_CODE_CHANGE_LINK_TOOLTIP; } });
+Object.defineProperty(exports, "ISSUE_CODE_CHANGE_FORWARD_NAME", { enumerable: true, get: function () { return devrev_1.ISSUE_CODE_CHANGE_FORWARD_NAME; } });
+Object.defineProperty(exports, "ISSUE_CODE_CHANGE_BACKWARD_NAME", { enumerable: true, get: function () { return devrev_1.ISSUE_CODE_CHANGE_BACKWARD_NAME; } });
+// Enums
+Object.defineProperty(exports, "CodeChangeSource", { enumerable: true, get: function () { return devrev_1.CodeChangeSource; } });
+Object.defineProperty(exports, "CodeChangeStatus", { enumerable: true, get: function () { return devrev_1.CodeChangeStatus; } });
+Object.defineProperty(exports, "CodeChangeFields", { enumerable: true, get: function () { return devrev_1.CodeChangeFields; } });
+// Git Provider
+Object.defineProperty(exports, "GitProviderValues", { enumerable: true, get: function () { return devrev_1.GitProviderValues; } });
+// Managers (for advanced usage)
+Object.defineProperty(exports, "CodeChangeManager", { enumerable: true, get: function () { return devrev_1.CodeChangeManager; } });
+Object.defineProperty(exports, "TenantFragmentManager", { enumerable: true, get: function () { return devrev_1.TenantFragmentManager; } });
+Object.defineProperty(exports, "CustomLinkTypeManager", { enumerable: true, get: function () { return devrev_1.CustomLinkTypeManager; } });
+Object.defineProperty(exports, "LinkManager", { enumerable: true, get: function () { return devrev_1.LinkManager; } });
+Object.defineProperty(exports, "TimelineManager", { enumerable: true, get: function () { return devrev_1.TimelineManager; } });
+Object.defineProperty(exports, "DevUserManager", { enumerable: true, get: function () { return devrev_1.DevUserManager; } });
+Object.defineProperty(exports, "EventMetadataKeys", { enumerable: true, get: function () { return devrev_1.EventMetadataKeys; } });
+// HTTP utilities
+Object.defineProperty(exports, "postCall", { enumerable: true, get: function () { return devrev_1.postCall; } });
+Object.defineProperty(exports, "getCall", { enumerable: true, get: function () { return devrev_1.getCall; } });
+Object.defineProperty(exports, "constructURL", { enumerable: true, get: function () { return devrev_1.constructURL; } });
+// Event Handlers
+var handlers_1 = require("./handlers");
+// Push event handler
+Object.defineProperty(exports, "handlePushEvent", { enumerable: true, get: function () { return handlers_1.handlePushEvent; } });
+// PR handlers
+Object.defineProperty(exports, "handlePRCreate", { enumerable: true, get: function () { return handlers_1.handlePRCreate; } });
+Object.defineProperty(exports, "handlePRClose", { enumerable: true, get: function () { return handlers_1.handlePRClose; } });
+// PR review handler
+Object.defineProperty(exports, "handlePRReview", { enumerable: true, get: function () { return handlers_1.handlePRReview; } });
+// PR merge handler
+Object.defineProperty(exports, "handlePRMerge", { enumerable: true, get: function () { return handlers_1.handlePRMerge; } });
+// Handler registry
+Object.defineProperty(exports, "DEFAULT_HANDLER_REGISTRY", { enumerable: true, get: function () { return handlers_1.DEFAULT_HANDLER_REGISTRY; } });
+// Event Orchestrator
+var orchestrator_1 = require("./orchestrator");
+Object.defineProperty(exports, "EventOrchestrator", { enumerable: true, get: function () { return orchestrator_1.EventOrchestrator; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,sCAAsC;AACtC,iCAqBiB;AAFf,0GAAA,iBAAiB,OAAA;AAInB,SAAS;AACT,mCAAkE;AAAzD,sGAAA,YAAY,OAAA;AAErB,gBAAgB;AAChB,mCA6CkB;AA5ChB,cAAc;AACd,sGAAA,YAAY,OAAA;AAEZ,YAAY;AACZ,yGAAA,eAAe,OAAA;AACf,yHAAA,+BAA+B,OAAA;AAC/B,YAAY;AACZ,+GAAA,qBAAqB,OAAA;AACrB,mGAAA,SAAS,OAAA;AACT,4FAAA,EAAE,OAAA;AACF,0HAAA,gCAAgC,OAAA;AAChC,wHAAA,8BAA8B,OAAA;AAC9B,wHAAA,8BAA8B,OAAA;AAC9B,yHAAA,+BAA+B,OAAA;AAC/B,QAAQ;AACR,0GAAA,gBAAgB,OAAA;AAChB,0GAAA,gBAAgB,OAAA;AAChB,0GAAA,gBAAgB,OAAA;AAChB,eAAe;AACf,2GAAA,iBAAiB,OAAA;AAajB,gCAAgC;AAChC,2GAAA,iBAAiB,OAAA;AACjB,+GAAA,qBAAqB,OAAA;AACrB,+GAAA,qBAAqB,OAAA;AACrB,qGAAA,WAAW,OAAA;AACX,yGAAA,eAAe,OAAA;AACf,wGAAA,cAAc,OAAA;AACd,2GAAA,iBAAiB,OAAA;AACjB,iBAAiB;AACjB,kGAAA,QAAQ,OAAA;AACR,iGAAA,OAAO,OAAA;AACP,sGAAA,YAAY,OAAA;AAGd,iBAAiB;AACjB,uCAiBoB;AAhBlB,qBAAqB;AACrB,2GAAA,eAAe,OAAA;AACf,cAAc;AACd,0GAAA,cAAc,OAAA;AACd,yGAAA,aAAa,OAAA;AACb,oBAAoB;AACpB,0GAAA,cAAc,OAAA;AACd,mBAAmB;AACnB,yGAAA,aAAa,OAAA;AACb,mBAAmB;AACnB,oHAAA,wBAAwB,OAAA;AAQ1B,qBAAqB;AACrB,+CAGwB;AAFtB,iHAAA,iBAAiB,OAAA"}

package/dist/orchestrator/event_orchestrator.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Event Orchestrator for the Git SDK.
+ *
+ * The orchestrator is the central routing layer that receives raw events from
+ * any Git provider, normalizes them via the provider adapter, and dispatches
+ * them to the appropriate handler. This simplifies the consumer experience —
+ * instead of manually normalizing events and routing to individual handlers,
+ * consumers call a single `processEvent()` method.
+ *
+ * Flow:
+ * 1. Raw provider event → adapter.normalizeEvent() → NormalizedEvent
+ * 2. NormalizedEvent.type → route to correct handler
+ * 3. Handler processes event → HandlerResult
+ */
+import { IProviderAdapter } from '../adapter/adapter';
+import { HandlerResult } from '../handlers/types';
+import { SDKConfiguration } from '../types/config';
+import { NormalizedEvent } from '../types/events';
+import { GitProvider } from '../types/provider';
+/**
+ * Configuration for the EventOrchestrator.
+ */
+export interface EventOrchestratorConfig {
+    /** SDK configuration with DevRev and provider settings */
+    sdkConfig: SDKConfiguration;
+    /** The provider adapter for normalization and data fetching */
+    adapter: IProviderAdapter;
+    /**
+     * The Git provider identifier (e.g., 'github', 'gitlab', 'bitbucket', 'azure').
+     * Used to derive the CodeChangeSource for code_change objects.
+     */
+    provider: GitProvider;
+}
+/**
+ * Central event processing engine for the Git SDK.
+ *
+ * The EventOrchestrator ties together the provider adapter (normalization)
+ * and the event handlers (processing) into a single, easy-to-use interface.
+ *
+ * Usage:
+ * 1. Create an orchestrator with SDK configuration, a provider adapter, and a provider name.
+ * 2. Call `processEvent(rawEvent)` for each incoming webhook payload.
+ * 3. The orchestrator normalizes the event and routes it to the correct handler.
+ *
+ * @example
+ * ```typescript
+ * const orchestrator = new EventOrchestrator({
+ *   sdkConfig: {
+ *     devrev: { endpoint: 'https://api.devrev.ai', token: devrevToken },
+ *     provider: { token: providerToken },
+ *   },
+ *   adapter: myProviderAdapter,
+ *   provider: 'github', // or 'gitlab', 'bitbucket', 'azure'
+ * });
+ *
+ * // Process a raw webhook payload
+ * const result = await orchestrator.processEvent(webhookPayload);
+ * console.log(result.success, result.message);
+ * ```
+ */
+export declare class EventOrchestrator {
+    private readonly client;
+    private readonly adapter;
+    private readonly source;
+    /**
+     * Creates a new EventOrchestrator.
+     *
+     * Internally builds a DevRevClient from the provided SDKConfiguration.
+     *
+     * @param config - The orchestrator configuration
+     */
+    constructor(config: EventOrchestratorConfig);
+    /**
+     * Processes a raw event from a Git provider.
+     *
+     * This is the primary entry point for event processing. It:
+     * 1. Normalizes the raw event via the provider adapter
+     * 2. Routes the normalized event to the appropriate handler
+     * 3. Returns the handler result
+     *
+     * @param rawEvent - The raw event payload from the Git provider
+     * @returns The handler result indicating success or failure
+     */
+    processEvent(rawEvent: unknown): Promise<HandlerResult>;
+    /**
+     * Processes a pre-normalized event.
+     *
+     * Use this when the event has already been normalized (e.g., in testing
+     * or when the normalization step is handled externally).
+     *
+     * @param event - The normalized event
+     * @returns The handler result indicating success or failure
+     */
+    processNormalizedEvent(event: NormalizedEvent): Promise<HandlerResult>;
+    /**
+     * Builds the HandlerContext for a given event type.
+     */
+    private buildHandlerContext;
+}