@devrev/git-sdk 0.11.0

package/dist/devrev/managers/timeline_manager.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Manager for timeline entry operations.
+ */
+import { ChangeEventBody, GitProvider } from '../types';
+import type { publicSDK } from '@devrev/typescript-sdk';
+/**
+ * Result of timeline entry operation.
+ */
+export interface TimelineResult {
+    success: boolean;
+    message?: string;
+    data?: any;
+}
+/**
+ * Event metadata key constants.
+ */
+export declare const EventMetadataKeys: {
+    readonly BRANCH_NAME: "branch_name";
+    readonly REPO_NAME: "repo_name";
+    readonly SOURCE_TIME_STAMP: "source_time_stamp";
+};
+/**
+ * Manager for timeline entry operations.
+ */
+export declare class TimelineManager {
+    private publicApi;
+    private endpoint;
+    private token;
+    private provider;
+    /**
+     * Creates a new TimelineManager.
+     *
+     * @param publicApi - The DevRev public API instance
+     * @param endpoint - The DevRev API endpoint
+     * @param token - The DevRev API token
+     * @param provider - The Git provider used as app identifier (defaults to 'unknown')
+     */
+    constructor(publicApi: publicSDK.Api<unknown>, endpoint: string, token: string, provider?: GitProvider);
+    /**
+     * Creates a timeline entry in the events collection.
+     *
+     * @param objectId - The object ID to create the timeline entry for
+     * @param changeEvent - The change event body
+     * @returns Operation result
+     */
+    createEventEntry(objectId: string, changeEvent: ChangeEventBody): Promise<TimelineResult>;
+    /**
+     * Lists timeline entries in the events collection for a given object.
+     *
+     * @param objectId - The object ID to list timeline entries for
+     * @returns Array of timeline entries
+     */
+    listEventEntries(objectId: string): Promise<Record<string, any>[]>;
+    /**
+     * Creates a change event body for timeline entries.
+     *
+     * @param actor - Actor information (id, username/login, url)
+     * @param branchName - The branch name
+     * @param repoName - The repository name
+     * @param sourceTimestamp - The source timestamp (ISO format)
+     * @param eventUrl - The URL of the event (e.g., PR URL, commit URL)
+     * @param eventType - The type of event
+     * @param message - The event message/summary
+     * @returns The change event body
+     */
+    createChangeEventBody(actor: {
+        id: string;
+        username: string;
+        url: string;
+    }, branchName: string, repoName: string, sourceTimestamp: string, eventUrl: string, eventType: string, message: string): ChangeEventBody;
+    /**
+     * Creates a timeline entry in the discussions collection.
+     *
+     * @param objectId - The object ID to create the timeline entry for
+     * @param message - The message to post
+     * @returns Operation result
+     */
+    createDiscussionEntry(objectId: string, message: string): Promise<TimelineResult>;
+    /**
+     * Deletes a timeline entry.
+     *
+     * @param commentId - The timeline entry ID to delete
+     * @returns Operation result
+     */
+    deleteEntry(commentId: string): Promise<TimelineResult>;
+}

package/dist/devrev/managers/timeline_manager.js

@@ -0,0 +1,184 @@
+"use strict";
+/**
+ * Manager for timeline entry operations.
+ */
+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.TimelineManager = exports.EventMetadataKeys = void 0;
+const http_1 = require("../http");
+const types_1 = require("../types");
+/**
+ * Event metadata key constants.
+ */
+exports.EventMetadataKeys = {
+    BRANCH_NAME: 'branch_name',
+    REPO_NAME: 'repo_name',
+    SOURCE_TIME_STAMP: 'source_time_stamp',
+};
+/**
+ * Manager for timeline entry operations.
+ */
+class TimelineManager {
+    /**
+     * Creates a new TimelineManager.
+     *
+     * @param publicApi - The DevRev public API instance
+     * @param endpoint - The DevRev API endpoint
+     * @param token - The DevRev API token
+     * @param provider - The Git provider used as app identifier (defaults to 'unknown')
+     */
+    constructor(publicApi, endpoint, token, provider = types_1.GitProviderValues.UNKNOWN) {
+        this.publicApi = publicApi;
+        this.endpoint = endpoint;
+        this.token = token;
+        this.provider = provider;
+    }
+    /**
+     * Creates a timeline entry in the events collection.
+     *
+     * @param objectId - The object ID to create the timeline entry for
+     * @param changeEvent - The change event body
+     * @returns Operation result
+     */
+    createEventEntry(objectId, changeEvent) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const endpoint = this.endpoint + '/internal/timeline-entries.create';
+            const data = {
+                change_event: changeEvent,
+                object: objectId,
+                type: 'timeline_change_event',
+            };
+            const response = yield (0, http_1.postCall)(endpoint, this.token, data);
+            if (!response.success) {
+                console.error(`Error creating timeline entry in events: ${response.message}`);
+                return {
+                    success: false,
+                    message: `Error creating timeline entry in events: ${response.message}`,
+                };
+            }
+            return { success: true, data: response.data };
+        });
+    }
+    /**
+     * Lists timeline entries in the events collection for a given object.
+     *
+     * @param objectId - The object ID to list timeline entries for
+     * @returns Array of timeline entries
+     */
+    listEventEntries(objectId) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const endpoint = this.endpoint + '/internal/timeline-entries.list';
+            const data = {
+                collections: ['events'],
+                object: objectId,
+            };
+            const response = yield (0, http_1.postCall)(endpoint, this.token, data);
+            if (!response.success) {
+                throw new Error(`Error listing timeline entries: ${response.message}`);
+            }
+            return response.data.timeline_entries;
+        });
+    }
+    /**
+     * Creates a change event body for timeline entries.
+     *
+     * @param actor - Actor information (id, username/login, url)
+     * @param branchName - The branch name
+     * @param repoName - The repository name
+     * @param sourceTimestamp - The source timestamp (ISO format)
+     * @param eventUrl - The URL of the event (e.g., PR URL, commit URL)
+     * @param eventType - The type of event
+     * @param message - The event message/summary
+     * @returns The change event body
+     */
+    createChangeEventBody(actor, branchName, repoName, sourceTimestamp, eventUrl, eventType, message) {
+        return {
+            app: this.provider,
+            app_user_display_id: actor.username,
+            app_user_id: actor.id,
+            app_user_identifier: actor.url,
+            event_metadata: [
+                {
+                    key: exports.EventMetadataKeys.BRANCH_NAME,
+                    value: branchName,
+                },
+                {
+                    key: exports.EventMetadataKeys.REPO_NAME,
+                    value: repoName,
+                },
+                {
+                    key: exports.EventMetadataKeys.SOURCE_TIME_STAMP,
+                    value: sourceTimestamp,
+                },
+            ],
+            event_summary: message,
+            event_type: eventType,
+            event_url: eventUrl,
+            message: message,
+            source_timestamp: sourceTimestamp,
+            type: 'microflow_action',
+        };
+    }
+    /**
+     * Creates a timeline entry in the discussions collection.
+     *
+     * @param objectId - The object ID to create the timeline entry for
+     * @param message - The message to post
+     * @returns Operation result
+     */
+    createDiscussionEntry(objectId, message) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const response = yield this.publicApi.timelineEntriesCreate({
+                    body: message,
+                    body_type: 'text',
+                    object: objectId,
+                    type: 'timeline_comment',
+                });
+                return { success: true, data: response.data };
+            }
+            catch (error) {
+                const errorMsg = (0, types_1.getErrorMessage)(error);
+                console.error(`Error creating timeline entry in discussions: ${errorMsg}`);
+                return {
+                    success: false,
+                    message: `Error creating timeline entry in discussions: ${errorMsg}`,
+                };
+            }
+        });
+    }
+    /**
+     * Deletes a timeline entry.
+     *
+     * @param commentId - The timeline entry ID to delete
+     * @returns Operation result
+     */
+    deleteEntry(commentId) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const response = yield this.publicApi.timelineEntriesDelete({
+                    id: commentId,
+                });
+                return { success: true, data: response.data };
+            }
+            catch (error) {
+                const errorMsg = (0, types_1.getErrorMessage)(error);
+                console.error(`Error deleting timeline entry: ${errorMsg}`);
+                return {
+                    success: false,
+                    message: `Error deleting timeline entry: ${errorMsg}`,
+                };
+            }
+        });
+    }
+}
+exports.TimelineManager = TimelineManager;
+//# sourceMappingURL=timeline_manager.js.map

package/dist/devrev/managers/timeline_manager.js.map

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

package/dist/devrev/types.d.ts

@@ -0,0 +1,139 @@
+/**
+ * DevRev-specific types for the Git SDK.
+ */
+import { GitProvider } from '../types/provider';
+/**
+ * Safely extracts error message from unknown error type.
+ */
+export declare function getErrorMessage(error: unknown): string;
+export declare const CODE_CHANGE_LEAF_TYPE = "code_change";
+/** Tenant fragment custom field prefix */
+export declare const TF_PREFIX = "tnt__";
+/** Helper to get full custom field name with tenant prefix */
+export declare const tf: (field: string) => string;
+/**
+ * Source provider numeric values for code_change schema enum.
+ * These values correspond to the allowed_values in the tenant fragment.
+ */
+export declare const CodeChangeSource: {
+    readonly UNKNOWN: 0;
+    readonly GITHUB: 1;
+    readonly BITBUCKET: 2;
+    readonly GITLAB: 3;
+    readonly AZURE_DEVOPS: 4;
+};
+export type CodeChangeSourceType = (typeof CodeChangeSource)[keyof typeof CodeChangeSource];
+/**
+ * Maps GitProvider string values to CodeChangeSource numeric values.
+ *
+ * @param provider - The GitProvider string value
+ * @returns The corresponding CodeChangeSource numeric value
+ */
+export declare function getCodeChangeSourceFromProvider(provider: GitProvider): CodeChangeSourceType;
+/**
+ * Status values for code changes (ordered by ordinal).
+ */
+export declare const CodeChangeStatus: {
+    readonly DRAFT: 0;
+    readonly WAITING_FOR_REVIEW: 1;
+    readonly CHANGES_REQUESTED: 2;
+    readonly APPROVED: 3;
+    readonly MERGED: 4;
+    readonly CLOSED: 5;
+};
+export type CodeChangeStatusType = (typeof CodeChangeStatus)[keyof typeof CodeChangeStatus];
+/**
+ * Custom field names for code_change objects (grouped logically).
+ */
+export declare const CodeChangeFields: {
+    readonly SOURCE: "source";
+    readonly AUTHOR: "author";
+    readonly REPO_NAME: "repo_name";
+    readonly SOURCE_BRANCH: "source_branch";
+    readonly TARGET_BRANCH: "target_branch";
+    readonly EXTERNAL_URL: "external_url";
+    readonly STATUS: "status";
+    readonly REVIEWED_BY: "reviewed_by";
+    readonly REQUESTED_REVIEWERS: "requested_reviewers";
+    readonly APPROVED_BY: "approved_by";
+    readonly TARGET_COMMITS: "target_commits";
+    readonly SOURCE_COMMITS: "source_commits";
+    readonly FIRST_COMMIT_AT: "first_commit_at";
+    readonly LAST_COMMIT_AT: "last_commit_at";
+    readonly PR_CREATED_AT: "pr_created_at";
+    readonly FIRST_REVIEW_AT: "first_review_at";
+    readonly LAST_REVIEW_AT: "last_review_at";
+    readonly FIRST_APPROVED_AT: "first_approved_at";
+    readonly LAST_APPROVED_AT: "last_approved_at";
+    readonly CLOSED_AT: "closed_at";
+    readonly LINES_ADDED: "lines_added";
+    readonly LINES_DELETED: "lines_deleted";
+    readonly FILES_CHANGED: "files_changed";
+};
+export declare const ISSUE_CODE_CHANGE_LINK_TYPE_NAME = "issue_code_change";
+export declare const ISSUE_CODE_CHANGE_LINK_TOOLTIP = "Links an issue to code change custom object";
+export declare const ISSUE_CODE_CHANGE_FORWARD_NAME = "addressed by";
+export declare const ISSUE_CODE_CHANGE_BACKWARD_NAME = "addresses";
+/**
+ * Request type for creating a code_change custom object.
+ */
+export interface CodeChangeCustomCreateRequest {
+    title: string;
+    source: CodeChangeSourceType;
+    repo_name: string;
+    source_branch: string;
+    target_branch: string;
+    external_url: string;
+    status: CodeChangeStatusType;
+    author?: string;
+    pr_created_at?: string;
+    first_commit_at?: string;
+    last_commit_at?: string;
+}
+/**
+ * Request type for updating a code_change custom object.
+ */
+export interface CodeChangeCustomUpdateRequest {
+    id: string;
+    status?: CodeChangeStatusType;
+    source_commits?: string[];
+    target_commits?: string[];
+    first_commit_at?: string;
+    last_commit_at?: string;
+    first_review_at?: string;
+    last_review_at?: string;
+    first_approved_at?: string;
+    last_approved_at?: string;
+    closed_at?: string;
+    lines_added?: number;
+    lines_deleted?: number;
+    files_changed?: number;
+    add_reviewed_by?: string[];
+    add_approved_by?: string[];
+    add_requested_reviewer?: string[];
+    remove_requested_reviewer?: string[];
+}
+/**
+ * Metadata for timeline change events.
+ */
+export interface TimelineEventMetadata {
+    key: string;
+    value: string;
+}
+/**
+ * Change event body for timeline entries.
+ */
+export interface ChangeEventBody {
+    app: string;
+    app_user_display_id: string;
+    app_user_id: string;
+    app_user_identifier: string;
+    event_metadata: TimelineEventMetadata[];
+    event_summary: string;
+    event_type: string;
+    event_url: string;
+    message: string;
+    source_timestamp: string;
+    type: string;
+}
+export { GitProvider, GitProviderValues } from '../types/provider';

package/dist/devrev/types.js

@@ -0,0 +1,127 @@
+"use strict";
+/**
+ * DevRev-specific types for the Git SDK.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GitProviderValues = 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.CodeChangeFields = exports.CodeChangeStatus = exports.getCodeChangeSourceFromProvider = exports.CodeChangeSource = exports.tf = exports.TF_PREFIX = exports.CODE_CHANGE_LEAF_TYPE = exports.getErrorMessage = void 0;
+const provider_1 = require("../types/provider");
+// =============================================================================
+// Utility Functions
+// =============================================================================
+/**
+ * Safely extracts error message from unknown error type.
+ */
+function getErrorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+exports.getErrorMessage = getErrorMessage;
+// =============================================================================
+// Code Change Constants
+// =============================================================================
+exports.CODE_CHANGE_LEAF_TYPE = 'code_change';
+/** Tenant fragment custom field prefix */
+exports.TF_PREFIX = 'tnt__';
+/** Helper to get full custom field name with tenant prefix */
+const tf = (field) => `${exports.TF_PREFIX}${field}`;
+exports.tf = tf;
+// =============================================================================
+// Source Enum
+// =============================================================================
+/**
+ * Source provider numeric values for code_change schema enum.
+ * These values correspond to the allowed_values in the tenant fragment.
+ */
+exports.CodeChangeSource = {
+    UNKNOWN: 0,
+    GITHUB: 1,
+    BITBUCKET: 2,
+    GITLAB: 3,
+    AZURE_DEVOPS: 4,
+};
+/**
+ * Maps GitProvider string values to CodeChangeSource numeric values.
+ *
+ * @param provider - The GitProvider string value
+ * @returns The corresponding CodeChangeSource numeric value
+ */
+function getCodeChangeSourceFromProvider(provider) {
+    switch (provider) {
+        case provider_1.GitProviderValues.GITHUB:
+            return exports.CodeChangeSource.GITHUB;
+        case provider_1.GitProviderValues.GITLAB:
+            return exports.CodeChangeSource.GITLAB;
+        case provider_1.GitProviderValues.BITBUCKET:
+            return exports.CodeChangeSource.BITBUCKET;
+        case provider_1.GitProviderValues.AZURE:
+            return exports.CodeChangeSource.AZURE_DEVOPS;
+        case provider_1.GitProviderValues.UNKNOWN:
+        default:
+            return exports.CodeChangeSource.UNKNOWN;
+    }
+}
+exports.getCodeChangeSourceFromProvider = getCodeChangeSourceFromProvider;
+// =============================================================================
+// Status Enum
+// =============================================================================
+/**
+ * Status values for code changes (ordered by ordinal).
+ */
+exports.CodeChangeStatus = {
+    DRAFT: 0,
+    WAITING_FOR_REVIEW: 1,
+    CHANGES_REQUESTED: 2,
+    APPROVED: 3,
+    MERGED: 4,
+    CLOSED: 5,
+};
+// =============================================================================
+// Field Names
+// =============================================================================
+/**
+ * Custom field names for code_change objects (grouped logically).
+ */
+exports.CodeChangeFields = {
+    // Identity
+    SOURCE: 'source',
+    AUTHOR: 'author',
+    // Repository
+    REPO_NAME: 'repo_name',
+    SOURCE_BRANCH: 'source_branch',
+    TARGET_BRANCH: 'target_branch',
+    EXTERNAL_URL: 'external_url',
+    // Status
+    STATUS: 'status',
+    // Reviewers
+    REVIEWED_BY: 'reviewed_by',
+    REQUESTED_REVIEWERS: 'requested_reviewers',
+    APPROVED_BY: 'approved_by',
+    // Commits
+    TARGET_COMMITS: 'target_commits',
+    SOURCE_COMMITS: 'source_commits',
+    // Timestamps
+    FIRST_COMMIT_AT: 'first_commit_at',
+    LAST_COMMIT_AT: 'last_commit_at',
+    PR_CREATED_AT: 'pr_created_at',
+    FIRST_REVIEW_AT: 'first_review_at',
+    LAST_REVIEW_AT: 'last_review_at',
+    FIRST_APPROVED_AT: 'first_approved_at',
+    LAST_APPROVED_AT: 'last_approved_at',
+    CLOSED_AT: 'closed_at',
+    // Metrics
+    LINES_ADDED: 'lines_added',
+    LINES_DELETED: 'lines_deleted',
+    FILES_CHANGED: 'files_changed',
+};
+// =============================================================================
+// Custom Link Type Constants
+// =============================================================================
+exports.ISSUE_CODE_CHANGE_LINK_TYPE_NAME = 'issue_code_change';
+exports.ISSUE_CODE_CHANGE_LINK_TOOLTIP = 'Links an issue to code change custom object';
+exports.ISSUE_CODE_CHANGE_FORWARD_NAME = 'addressed by';
+exports.ISSUE_CODE_CHANGE_BACKWARD_NAME = 'addresses';
+// =============================================================================
+// Re-export GitProvider for convenience
+// =============================================================================
+var provider_2 = require("../types/provider");
+Object.defineProperty(exports, "GitProviderValues", { enumerable: true, get: function () { return provider_2.GitProviderValues; } });
+//# sourceMappingURL=types.js.map

package/dist/devrev/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/devrev/types.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,gDAAmE;AAEnE,gFAAgF;AAChF,oBAAoB;AACpB,gFAAgF;AAEhF;;GAEG;AACH,SAAgB,eAAe,CAAC,KAAc;IAC5C,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC;AAFD,0CAEC;AAED,gFAAgF;AAChF,wBAAwB;AACxB,gFAAgF;AAEnE,QAAA,qBAAqB,GAAG,aAAa,CAAC;AAEnD,0CAA0C;AAC7B,QAAA,SAAS,GAAG,OAAO,CAAC;AAEjC,8DAA8D;AACvD,MAAM,EAAE,GAAG,CAAC,KAAa,EAAU,EAAE,CAAC,GAAG,iBAAS,GAAG,KAAK,EAAE,CAAC;AAAvD,QAAA,EAAE,MAAqD;AAEpE,gFAAgF;AAChF,cAAc;AACd,gFAAgF;AAEhF;;;GAGG;AACU,QAAA,gBAAgB,GAAG;IAC9B,OAAO,EAAE,CAAC;IACV,MAAM,EAAE,CAAC;IACT,SAAS,EAAE,CAAC;IACZ,MAAM,EAAE,CAAC;IACT,YAAY,EAAE,CAAC;CACP,CAAC;AAKX;;;;;GAKG;AACH,SAAgB,+BAA+B,CAC7C,QAAqB;IAErB,QAAQ,QAAQ,EAAE;QAChB,KAAK,4BAAiB,CAAC,MAAM;YAC3B,OAAO,wBAAgB,CAAC,MAAM,CAAC;QACjC,KAAK,4BAAiB,CAAC,MAAM;YAC3B,OAAO,wBAAgB,CAAC,MAAM,CAAC;QACjC,KAAK,4BAAiB,CAAC,SAAS;YAC9B,OAAO,wBAAgB,CAAC,SAAS,CAAC;QACpC,KAAK,4BAAiB,CAAC,KAAK;YAC1B,OAAO,wBAAgB,CAAC,YAAY,CAAC;QACvC,KAAK,4BAAiB,CAAC,OAAO,CAAC;QAC/B;YACE,OAAO,wBAAgB,CAAC,OAAO,CAAC;KACnC;AACH,CAAC;AAhBD,0EAgBC;AAED,gFAAgF;AAChF,cAAc;AACd,gFAAgF;AAEhF;;GAEG;AACU,QAAA,gBAAgB,GAAG;IAC9B,KAAK,EAAE,CAAC;IACR,kBAAkB,EAAE,CAAC;IACrB,iBAAiB,EAAE,CAAC;IACpB,QAAQ,EAAE,CAAC;IACX,MAAM,EAAE,CAAC;IACT,MAAM,EAAE,CAAC;CACD,CAAC;AAKX,gFAAgF;AAChF,cAAc;AACd,gFAAgF;AAEhF;;GAEG;AACU,QAAA,gBAAgB,GAAG;IAC9B,WAAW;IACX,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;IAChB,aAAa;IACb,SAAS,EAAE,WAAW;IACtB,aAAa,EAAE,eAAe;IAC9B,aAAa,EAAE,eAAe;IAC9B,YAAY,EAAE,cAAc;IAC5B,SAAS;IACT,MAAM,EAAE,QAAQ;IAChB,YAAY;IACZ,WAAW,EAAE,aAAa;IAC1B,mBAAmB,EAAE,qBAAqB;IAC1C,WAAW,EAAE,aAAa;IAC1B,UAAU;IACV,cAAc,EAAE,gBAAgB;IAChC,cAAc,EAAE,gBAAgB;IAChC,aAAa;IACb,eAAe,EAAE,iBAAiB;IAClC,cAAc,EAAE,gBAAgB;IAChC,aAAa,EAAE,eAAe;IAC9B,eAAe,EAAE,iBAAiB;IAClC,cAAc,EAAE,gBAAgB;IAChC,iBAAiB,EAAE,mBAAmB;IACtC,gBAAgB,EAAE,kBAAkB;IACpC,SAAS,EAAE,WAAW;IACtB,UAAU;IACV,WAAW,EAAE,aAAa;IAC1B,aAAa,EAAE,eAAe;IAC9B,aAAa,EAAE,eAAe;CACtB,CAAC;AAEX,gFAAgF;AAChF,6BAA6B;AAC7B,gFAAgF;AAEnE,QAAA,gCAAgC,GAAG,mBAAmB,CAAC;AACvD,QAAA,8BAA8B,GACzC,6CAA6C,CAAC;AACnC,QAAA,8BAA8B,GAAG,cAAc,CAAC;AAChD,QAAA,+BAA+B,GAAG,WAAW,CAAC;AAoF3D,gFAAgF;AAChF,wCAAwC;AACxC,gFAAgF;AAEhF,8CAAmE;AAA7C,6GAAA,iBAAiB,OAAA"}

package/dist/handlers/commit_push_handler.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Handler for push events.
+ *
+ * This handler processes push events and updates the associated code_change
+ * custom objects with commit information. It also creates timeline entries
+ * for each commit in the push.
+ */
+import { NormalizedPushEvent } from '../types/events';
+import { HandlerContext, HandlerResult } from './types';
+/**
+ * Process a push event.
+ *
+ * This function handles the core business logic for creating/updating custom code_change
+ * objects and timeline entries when commits are pushed to a PR branch.
+ *
+ * Behavior:
+ * - Push events with no commits are skipped (returns success with skip message)
+ * - Push events with no associated PRs are skipped (returns success with skip message)
+ * - For new code_change objects, historical commits are fetched from the adapter
+ *   and populated (first_commit_at, last_commit_at, timeline entries)
+ *
+ * For each associated PR:
+ * 1. Gets or creates the code_change custom object
+ * 2. Updates source_commits, first_commit_at (if not set), and last_commit_at
+ * 3. Creates timeline entries for each commit (when updating existing code_change)
+ *
+ * @param input - The normalized push event
+ * @param context - The handler context with DevRev client and adapter
+ * @returns Handler result indicating success or failure
+ */
+export declare function handlePushEvent(input: NormalizedPushEvent, context: HandlerContext): Promise<HandlerResult>;