crashrelay 0.1.0

package/dist/providers/format.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildSummary = buildSummary;
+exports.buildBody = buildBody;
+const MAX_SUMMARY_LENGTH = 120;
+function buildSummary(defect) {
+    const firstLine = defect.message.split('\n')[0].trim();
+    const summary = `[${defect.type}] ${firstLine}`;
+    return summary.length > MAX_SUMMARY_LENGTH ? summary.slice(0, MAX_SUMMARY_LENGTH - 1) + '…' : summary;
+}
+function buildBody(defect) {
+    const lines = [`Type: ${defect.type}`, `First seen: ${defect.occurredAt}`];
+    if (defect.context) {
+        for (const [key, value] of Object.entries(defect.context)) {
+            if (value !== undefined)
+                lines.push(`${key}: ${value}`);
+        }
+    }
+    lines.push('', defect.message);
+    if (defect.stack)
+        lines.push('', defect.stack);
+    return lines.join('\n');
+}

package/dist/providers/github.d.ts

@@ -0,0 +1,4 @@
+import type { Fetcher } from '../fetcher';
+import type { GithubConfig } from '../types';
+import type { TicketProvider } from './types';
+export declare function createGithubProvider(config: GithubConfig, fetcher: Fetcher): TicketProvider;

package/dist/providers/github.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createGithubProvider = createGithubProvider;
+const format_1 = require("./format");
+async function githubFetch(config, fetcher, path, init) {
+    const response = await fetcher(`https://api.github.com/repos/${config.owner}/${config.repo}${path}`, {
+        method: init?.method ?? 'GET',
+        headers: {
+            Authorization: `Bearer ${config.token}`,
+            Accept: 'application/vnd.github+json',
+            'X-GitHub-Api-Version': '2022-11-28',
+            'Content-Type': 'application/json',
+        },
+        body: init?.body !== undefined ? JSON.stringify(init.body) : undefined,
+    });
+    if (!response.ok) {
+        throw new Error(`GitHub API error (HTTP ${response.status}) for ${path}`);
+    }
+    return response;
+}
+function createGithubProvider(config, fetcher) {
+    return {
+        name: 'github',
+        async createTicket(defect) {
+            const response = await githubFetch(config, fetcher, '/issues', {
+                method: 'POST',
+                body: {
+                    title: (0, format_1.buildSummary)(defect),
+                    body: '```\n' + (0, format_1.buildBody)(defect) + '\n```',
+                    labels: ['crashrelay', 'auto-filed'],
+                },
+            });
+            const body = (await response.json());
+            return { provider: 'github', id: `#${body.number}`, url: body.html_url };
+        },
+        async addComment(ticket, text) {
+            const number = ticket.id.replace(/^#/, '');
+            await githubFetch(config, fetcher, `/issues/${number}/comments`, {
+                method: 'POST',
+                body: { body: text },
+            });
+        },
+        async checkConnection() {
+            await githubFetch(config, fetcher, '');
+        },
+    };
+}

package/dist/providers/index.d.ts

@@ -0,0 +1,7 @@
+import type { Fetcher } from '../fetcher';
+import type { Config } from '../types';
+import type { TicketProvider } from './types';
+export declare function resolveProviders(config: Config, fetcher: Fetcher): TicketProvider[];
+export type { TicketProvider } from './types';
+export { textToAdf } from './adf';
+export { buildSummary, buildBody } from './format';

package/dist/providers/index.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildBody = exports.buildSummary = exports.textToAdf = void 0;
+exports.resolveProviders = resolveProviders;
+const jira_1 = require("./jira");
+const github_1 = require("./github");
+function resolveProviders(config, fetcher) {
+    const providers = [];
+    if (config.jira)
+        providers.push((0, jira_1.createJiraProvider)(config.jira, fetcher));
+    if (config.github)
+        providers.push((0, github_1.createGithubProvider)(config.github, fetcher));
+    return providers;
+}
+var adf_1 = require("./adf");
+Object.defineProperty(exports, "textToAdf", { enumerable: true, get: function () { return adf_1.textToAdf; } });
+var format_1 = require("./format");
+Object.defineProperty(exports, "buildSummary", { enumerable: true, get: function () { return format_1.buildSummary; } });
+Object.defineProperty(exports, "buildBody", { enumerable: true, get: function () { return format_1.buildBody; } });

package/dist/providers/jira.d.ts

@@ -0,0 +1,4 @@
+import type { Fetcher } from '../fetcher';
+import type { JiraConfig } from '../types';
+import type { TicketProvider } from './types';
+export declare function createJiraProvider(config: JiraConfig, fetcher: Fetcher): TicketProvider;

package/dist/providers/jira.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createJiraProvider = createJiraProvider;
+const adf_1 = require("./adf");
+const format_1 = require("./format");
+function authHeader(config) {
+    const encoded = Buffer.from(`${config.email}:${config.apiToken}`).toString('base64');
+    return `Basic ${encoded}`;
+}
+async function jiraFetch(config, fetcher, path, init) {
+    const response = await fetcher(`${config.baseUrl}${path}`, {
+        method: init?.method ?? 'GET',
+        headers: {
+            Authorization: authHeader(config),
+            'Content-Type': 'application/json',
+            Accept: 'application/json',
+        },
+        body: init?.body !== undefined ? JSON.stringify(init.body) : undefined,
+    });
+    if (!response.ok) {
+        throw new Error(`Jira API error (HTTP ${response.status}) for ${path}`);
+    }
+    return response;
+}
+function createJiraProvider(config, fetcher) {
+    return {
+        name: 'jira',
+        async createTicket(defect) {
+            const response = await jiraFetch(config, fetcher, '/rest/api/3/issue', {
+                method: 'POST',
+                body: {
+                    fields: {
+                        project: { key: config.projectKey },
+                        summary: (0, format_1.buildSummary)(defect),
+                        issuetype: { name: config.issueType },
+                        description: (0, adf_1.textToAdf)((0, format_1.buildBody)(defect)),
+                    },
+                },
+            });
+            const body = (await response.json());
+            return { provider: 'jira', id: body.key, url: `${config.baseUrl}/browse/${body.key}` };
+        },
+        async addComment(ticket, text) {
+            await jiraFetch(config, fetcher, `/rest/api/3/issue/${ticket.id}/comment`, {
+                method: 'POST',
+                body: { body: (0, adf_1.textToAdf)(text) },
+            });
+        },
+        async checkConnection() {
+            await jiraFetch(config, fetcher, `/rest/api/3/project/${config.projectKey}`);
+        },
+    };
+}

package/dist/providers/types.d.ts

@@ -0,0 +1,8 @@
+import type { Defect, TicketRef } from '../types';
+export interface TicketProvider {
+    name: string;
+    createTicket(defect: Defect): Promise<TicketRef>;
+    addComment(ticket: TicketRef, text: string): Promise<void>;
+    /** Lightweight read-only call used by `crashrelay test-ticket --dry-run` to verify credentials without creating anything. */
+    checkConnection(): Promise<void>;
+}

package/dist/providers/types.js

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

package/dist/types.d.ts

@@ -0,0 +1,62 @@
+export type DefectType = 'process-crash' | 'unhandled-rejection' | 'http-5xx' | 'log-error' | 'client-error';
+export interface Defect {
+    type: DefectType;
+    message: string;
+    stack?: string;
+    /** Extra context: route, status code, log line, source URL, etc. */
+    context?: Record<string, string | number | undefined>;
+    occurredAt: string;
+}
+export interface TicketRef {
+    provider: string;
+    id: string;
+    url: string;
+}
+export interface JiraConfig {
+    baseUrl: string;
+    email: string;
+    apiToken: string;
+    projectKey: string;
+    issueType: string;
+}
+export interface GithubConfig {
+    token: string;
+    owner: string;
+    repo: string;
+}
+export interface IngestionConfig {
+    enabled: boolean;
+    port: number;
+    token: string;
+    allowedOrigins: string[];
+}
+export interface Config {
+    jira?: JiraConfig;
+    github?: GithubConfig;
+    ingestion?: IngestionConfig;
+    dedupCooldownHours: number;
+    commentCooldownMinutes: number;
+    logTailPath?: string;
+    logTailPattern: string;
+    cacheFilePath: string;
+}
+export interface DedupCacheEntry {
+    firstSeenAt: string;
+    lastSeenAt: string;
+    count: number;
+    cooldownUntil: string;
+    lastCommentAt?: string;
+    ticket: TicketRef;
+}
+export interface DedupCache {
+    entries: Record<string, DedupCacheEntry>;
+}
+export type DedupDecision = {
+    action: 'create';
+} | {
+    action: 'comment';
+    entry: DedupCacheEntry;
+} | {
+    action: 'skip';
+    entry: DedupCacheEntry;
+};

package/dist/types.js

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

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "crashrelay",
+  "version": "0.1.0",
+  "description": "Catch backend crashes, HTTP 5xx responses, and error-log lines (plus frontend JS errors via crashrelay-browser) and auto-file tickets in Jira or GitHub Issues.",
+  "license": "MIT",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "crashrelay": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "tsc -p tsconfig.test.json && find .test-build -name '*.test.js' -print0 | xargs -0 node --test",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "error-tracking",
+    "jira",
+    "github-issues",
+    "monitoring",
+    "crash-reporting",
+    "cli",
+    "ticketing"
+  ],
+  "dependencies": {
+    "@inquirer/prompts": "^8.5.2",
+    "commander": "^12.1.0",
+    "node-cron": "^4.6.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.14.0",
+    "typescript": "^5.6.0"
+  }
+}