@0xbigboss/gh-pulse-core 1.0.0

package/dist/time.js

@@ -0,0 +1,145 @@
+const DAY_MS = 24 * 60 * 60 * 1000;
+export function periodToRange(period, now, timeZone) {
+    const end = now.getTime();
+    switch (period) {
+        case 'today': {
+            const start = startOfDay(now, timeZone);
+            return { start, end, label: 'today' };
+        }
+        case 'week': {
+            const start = end - 7 * DAY_MS;
+            return { start, end, label: 'last 7 days' };
+        }
+        case 'sprint': {
+            const start = end - 14 * DAY_MS;
+            return { start, end, label: 'last 14 days' };
+        }
+        case 'month': {
+            const start = end - 30 * DAY_MS;
+            return { start, end, label: 'last 30 days' };
+        }
+        case 'quarter': {
+            const start = end - 90 * DAY_MS;
+            return { start, end, label: 'last 90 days' };
+        }
+        default: {
+            const _exhaustive = period;
+            throw new Error(`Unhandled period: ${_exhaustive}`);
+        }
+    }
+}
+export function resolveSince(input, now) {
+    if (isRelative(input)) {
+        return now.getTime() - parseRelativeDuration(input);
+    }
+    return parseAbsoluteDate(input);
+}
+export function resolveUntil(input, now) {
+    if (isRelative(input)) {
+        return now.getTime() - parseRelativeDuration(input);
+    }
+    return parseAbsoluteDate(input);
+}
+export function formatTimestamp(timestamp, timeZone) {
+    const formatter = new Intl.DateTimeFormat('en-US', {
+        timeZone,
+        year: 'numeric',
+        month: '2-digit',
+        day: '2-digit',
+        hour: '2-digit',
+        minute: '2-digit',
+        second: '2-digit',
+        hour12: false,
+    });
+    return formatter.format(new Date(timestamp));
+}
+export function diffInDays(start, end) {
+    return Math.floor((end - start) / DAY_MS);
+}
+export function parseRelativeDuration(input) {
+    const match = input.trim().match(/^(\d+)([dwmy])$/i);
+    if (!match) {
+        throw new Error(`Invalid relative duration: ${input}`);
+    }
+    const value = Number(match[1]);
+    const unitRaw = match[2];
+    if (!unitRaw) {
+        throw new Error(`Invalid relative duration unit: ${input}`);
+    }
+    const unit = unitRaw.toLowerCase();
+    switch (unit) {
+        case 'd':
+            return value * DAY_MS;
+        case 'w':
+            return value * 7 * DAY_MS;
+        case 'm':
+            return value * 30 * DAY_MS;
+        case 'y':
+            return value * 365 * DAY_MS;
+        default: {
+            const _exhaustive = unit;
+            throw new Error(`Unhandled duration unit: ${_exhaustive}`);
+        }
+    }
+}
+function isRelative(input) {
+    return /^(\d+)([dwmy])$/i.test(input.trim());
+}
+function parseAbsoluteDate(input) {
+    const parsed = Date.parse(input);
+    if (Number.isNaN(parsed)) {
+        throw new Error(`Invalid date: ${input}`);
+    }
+    return parsed;
+}
+function startOfDay(now, timeZone) {
+    const parts = getZonedParts(now, timeZone);
+    const utcMs = zonedTimeToUtcMs({
+        ...parts,
+        hour: 0,
+        minute: 0,
+        second: 0,
+    }, timeZone);
+    return utcMs;
+}
+function getZonedParts(date, timeZone) {
+    const formatter = new Intl.DateTimeFormat('en-US', {
+        timeZone,
+        hour12: false,
+        year: 'numeric',
+        month: '2-digit',
+        day: '2-digit',
+        hour: '2-digit',
+        minute: '2-digit',
+        second: '2-digit',
+    });
+    const parts = formatter.formatToParts(date);
+    const lookup = Object.fromEntries(parts.filter((part) => part.type !== 'literal').map((part) => [part.type, part.value]));
+    const year = lookup.year;
+    const month = lookup.month;
+    const day = lookup.day;
+    const hour = lookup.hour;
+    const minute = lookup.minute;
+    const second = lookup.second;
+    if (!year || !month || !day || !hour || !minute || !second) {
+        throw new Error(`Failed to resolve timezone parts for ${timeZone}`);
+    }
+    return {
+        year: Number(year),
+        month: Number(month),
+        day: Number(day),
+        hour: Number(hour),
+        minute: Number(minute),
+        second: Number(second),
+    };
+}
+function zonedTimeToUtcMs(parts, timeZone) {
+    const utcGuess = Date.UTC(parts.year, parts.month - 1, parts.day, parts.hour, parts.minute, parts.second);
+    const offset = getTimeZoneOffsetMs(new Date(utcGuess), timeZone);
+    return utcGuess - offset;
+}
+function getTimeZoneOffsetMs(date, timeZone) {
+    const parts = getZonedParts(date, timeZone);
+    const utcFromParts = Date.UTC(parts.year, parts.month - 1, parts.day, parts.hour, parts.minute, parts.second);
+    return utcFromParts - date.getTime();
+}

package/dist/types.cjs

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types.d.cts

@@ -0,0 +1,133 @@
+export type GitHubUsername = string;
+export type RepoFullName = string;
+export type PullRequestId = number;
+export type CommitSha = string;
+export type LinearIssueId = string;
+export type Timestamp = number;
+export type Duration = number;
+export type PRState = 'open' | 'closed' | 'merged';
+export type PRDraftState = 'draft' | 'ready';
+export type ReviewState = 'pending' | 'commented' | 'approved' | 'changes_requested' | 'dismissed';
+export interface ProgressEvent {
+    phase: 'resolve' | 'sync';
+    message: string;
+    current?: number;
+    total?: number;
+}
+export interface PROpenedEvent {
+    type: 'pr_opened';
+    repo: RepoFullName;
+    pr_number: PullRequestId;
+    author: GitHubUsername;
+    opened_at: Timestamp;
+    is_draft: boolean;
+}
+export interface PRReadyEvent {
+    type: 'pr_ready';
+    repo: RepoFullName;
+    pr_number: PullRequestId;
+    ready_at: Timestamp;
+}
+export interface PRMergedEvent {
+    type: 'pr_merged';
+    repo: RepoFullName;
+    pr_number: PullRequestId;
+    merged_at: Timestamp;
+    merged_by: GitHubUsername;
+}
+export interface PRClosedEvent {
+    type: 'pr_closed';
+    repo: RepoFullName;
+    pr_number: PullRequestId;
+    closed_at: Timestamp;
+}
+export interface ReviewSubmittedEvent {
+    type: 'review_submitted';
+    repo: RepoFullName;
+    pr_number: PullRequestId;
+    reviewer: GitHubUsername;
+    state: ReviewState;
+    submitted_at: Timestamp;
+}
+export interface CommentAddedEvent {
+    type: 'comment_added';
+    repo: RepoFullName;
+    pr_number: PullRequestId;
+    author: GitHubUsername;
+    commented_at: Timestamp;
+}
+export interface CommitPushedEvent {
+    type: 'commit_pushed';
+    repo: RepoFullName;
+    sha: CommitSha;
+    author: GitHubUsername;
+    committed_at: Timestamp;
+    message: string;
+    additions: number;
+    deletions: number;
+    files_changed: number;
+}
+export type Event = PROpenedEvent | PRReadyEvent | PRMergedEvent | PRClosedEvent | ReviewSubmittedEvent | CommentAddedEvent | CommitPushedEvent;
+export interface PullRequest {
+    repo: RepoFullName;
+    number: PullRequestId;
+    title: string;
+    state: PRState;
+    draft: boolean;
+    author: GitHubUsername;
+    created_at: Timestamp;
+    updated_at: Timestamp;
+    merged_at: Timestamp | null;
+    closed_at: Timestamp | null;
+    additions: number;
+    deletions: number;
+    commits: number;
+    requested_reviewers: GitHubUsername[];
+    labels: string[];
+    linked_issues: LinearIssueId[];
+}
+export interface Commit {
+    repo: RepoFullName;
+    sha: CommitSha;
+    author: GitHubUsername;
+    committed_at: Timestamp;
+    message: string;
+    additions: number;
+    deletions: number;
+    files_changed: number;
+}
+export interface CycleTimeMetrics {
+    draft_time: Duration | null;
+    review_time: Duration;
+    merge_time: Duration;
+    total_time: Duration;
+}
+export interface ReviewEngagement {
+    time_to_first_comment: Duration | null;
+    time_to_first_review: Duration | null;
+    review_count: number;
+    comment_count: number;
+}
+export type LinearIssueState = 'backlog' | 'unstarted' | 'started' | 'completed' | 'canceled';
+export interface LinearIssue {
+    id: LinearIssueId;
+    identifier: string;
+    title: string;
+    state: LinearIssueState;
+    assignee: string | null;
+    created_at: Timestamp;
+    completed_at: Timestamp | null;
+    linked_prs: Array<{
+        repo: RepoFullName;
+        number: PullRequestId;
+    }>;
+}
+export type LinearCorrelation = {
+    method: 'branch_name';
+    pattern: RegExp;
+} | {
+    method: 'pr_body';
+    pattern: RegExp;
+} | {
+    method: 'linear_api';
+};

package/dist/types.d.ts

@@ -0,0 +1,133 @@
+export type GitHubUsername = string;
+export type RepoFullName = string;
+export type PullRequestId = number;
+export type CommitSha = string;
+export type LinearIssueId = string;
+export type Timestamp = number;
+export type Duration = number;
+export type PRState = 'open' | 'closed' | 'merged';
+export type PRDraftState = 'draft' | 'ready';
+export type ReviewState = 'pending' | 'commented' | 'approved' | 'changes_requested' | 'dismissed';
+export interface ProgressEvent {
+    phase: 'resolve' | 'sync';
+    message: string;
+    current?: number;
+    total?: number;
+}
+export interface PROpenedEvent {
+    type: 'pr_opened';
+    repo: RepoFullName;
+    pr_number: PullRequestId;
+    author: GitHubUsername;
+    opened_at: Timestamp;
+    is_draft: boolean;
+}
+export interface PRReadyEvent {
+    type: 'pr_ready';
+    repo: RepoFullName;
+    pr_number: PullRequestId;
+    ready_at: Timestamp;
+}
+export interface PRMergedEvent {
+    type: 'pr_merged';
+    repo: RepoFullName;
+    pr_number: PullRequestId;
+    merged_at: Timestamp;
+    merged_by: GitHubUsername;
+}
+export interface PRClosedEvent {
+    type: 'pr_closed';
+    repo: RepoFullName;
+    pr_number: PullRequestId;
+    closed_at: Timestamp;
+}
+export interface ReviewSubmittedEvent {
+    type: 'review_submitted';
+    repo: RepoFullName;
+    pr_number: PullRequestId;
+    reviewer: GitHubUsername;
+    state: ReviewState;
+    submitted_at: Timestamp;
+}
+export interface CommentAddedEvent {
+    type: 'comment_added';
+    repo: RepoFullName;
+    pr_number: PullRequestId;
+    author: GitHubUsername;
+    commented_at: Timestamp;
+}
+export interface CommitPushedEvent {
+    type: 'commit_pushed';
+    repo: RepoFullName;
+    sha: CommitSha;
+    author: GitHubUsername;
+    committed_at: Timestamp;
+    message: string;
+    additions: number;
+    deletions: number;
+    files_changed: number;
+}
+export type Event = PROpenedEvent | PRReadyEvent | PRMergedEvent | PRClosedEvent | ReviewSubmittedEvent | CommentAddedEvent | CommitPushedEvent;
+export interface PullRequest {
+    repo: RepoFullName;
+    number: PullRequestId;
+    title: string;
+    state: PRState;
+    draft: boolean;
+    author: GitHubUsername;
+    created_at: Timestamp;
+    updated_at: Timestamp;
+    merged_at: Timestamp | null;
+    closed_at: Timestamp | null;
+    additions: number;
+    deletions: number;
+    commits: number;
+    requested_reviewers: GitHubUsername[];
+    labels: string[];
+    linked_issues: LinearIssueId[];
+}
+export interface Commit {
+    repo: RepoFullName;
+    sha: CommitSha;
+    author: GitHubUsername;
+    committed_at: Timestamp;
+    message: string;
+    additions: number;
+    deletions: number;
+    files_changed: number;
+}
+export interface CycleTimeMetrics {
+    draft_time: Duration | null;
+    review_time: Duration;
+    merge_time: Duration;
+    total_time: Duration;
+}
+export interface ReviewEngagement {
+    time_to_first_comment: Duration | null;
+    time_to_first_review: Duration | null;
+    review_count: number;
+    comment_count: number;
+}
+export type LinearIssueState = 'backlog' | 'unstarted' | 'started' | 'completed' | 'canceled';
+export interface LinearIssue {
+    id: LinearIssueId;
+    identifier: string;
+    title: string;
+    state: LinearIssueState;
+    assignee: string | null;
+    created_at: Timestamp;
+    completed_at: Timestamp | null;
+    linked_prs: Array<{
+        repo: RepoFullName;
+        number: PullRequestId;
+    }>;
+}
+export type LinearCorrelation = {
+    method: 'branch_name';
+    pattern: RegExp;
+} | {
+    method: 'pr_body';
+    pattern: RegExp;
+} | {
+    method: 'linear_api';
+};

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@0xbigboss/gh-pulse-core",
+  "version": "1.0.0",
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.cts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.cts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "scripts": {
+    "build": "zshy"
+  },
+  "dependencies": {
+    "@octokit/types": "^13.10.0",
+    "octokit": "^3.2.1",
+    "picomatch": "^4.0.2",
+    "yaml": "^2.7.0",
+    "zod": "^3.25.7"
+  },
+  "zshy": "./src/index.ts"
+}