@sentry/junior-github 0.106.0 → 0.107.1

package/dist/pull-request-outcomes/report.d.ts

@@ -0,0 +1,7 @@
+import type { PluginOperationalReportContent } from "@sentry/junior-plugin-api";
+import type { GitHubDb } from "./store.js";
+/** Build the generic dashboard report for Junior-owned pull request outcomes. */
+export declare function buildGitHubOutcomeReport(args: {
+    db: GitHubDb;
+    nowMs: number;
+}): Promise<PluginOperationalReportContent>;

package/dist/pull-request-outcomes/store.d.ts

@@ -0,0 +1,29 @@
+import type { PgDatabase } from "drizzle-orm/pg-core";
+import type { PgQueryResultHKT } from "drizzle-orm/pg-core/session";
+import { z } from "zod";
+import { githubSqlSchema } from "../db/schema.js";
+export type GitHubDb = PgDatabase<PgQueryResultHKT, typeof githubSqlSchema>;
+declare const githubPullRequestOutcomeInputSchema: z.ZodObject<{
+    candidateOwned: z.ZodBoolean;
+    closedAt: z.ZodOptional<z.ZodDate>;
+    mergedAt: z.ZodOptional<z.ZodDate>;
+    number: z.ZodNumber;
+    openedAt: z.ZodDate;
+    pullRequestId: z.ZodString;
+    repositoryFullName: z.ZodString;
+    repositoryId: z.ZodString;
+    state: z.ZodEnum<{
+        merged: "merged";
+        open: "open";
+        closed_unmerged: "closed_unmerged";
+    }>;
+    updatedAt: z.ZodDate;
+}, z.core.$strict>;
+export type GitHubPullRequestOutcomeInput = z.output<typeof githubPullRequestOutcomeInputSchema>;
+/**
+ * Record the newest lifecycle projection for one Junior-owned pull request.
+ * An ownership-qualified opening or terminal recovery inserts; later events
+ * update existing rows, and older provider timestamps cannot regress it.
+ */
+export declare function recordGitHubPullRequestOutcome(db: GitHubDb, input: GitHubPullRequestOutcomeInput): Promise<void>;
+export {};

package/dist/resource-events/pull-request.d.ts

@@ -1,5 +1,10 @@
 import type { SubscribableResource } from "@sentry/junior-plugin-api";
-/** Build the stable resource identity shared by GitHub PR tool results and webhooks. */
+/** Build the stable pull request identity shared by tools and webhooks. */
+export declare function gitHubPullRequestResource(input: {
+    number: number;
+    repo: string;
+}): Pick<SubscribableResource, "label" | "provider" | "resourceRef">;
+/** Describe a pull request as a resource when webhook subscriptions are enabled. */
 export declare function gitHubPullRequestSubscribable(input: {
     number: number;
     repo: string;

package/dist/testing.d.ts

@@ -0,0 +1,2 @@
+/** Test-only access to GitHub webhook normalization for runtime eval fixtures. */
+export { normalizeGitHubResourceEvents } from "./webhooks/resource-events.js";

package/dist/testing.js

@@ -0,0 +1,6 @@
+import {
+  normalizeGitHubResourceEvents
+} from "./chunk-JDNXIBCQ.js";
+export {
+  normalizeGitHubResourceEvents
+};

package/dist/tools/update-pull-request.d.ts

@@ -0,0 +1,57 @@
+import { type ToolRegistrationHookContext } from "@sentry/junior-plugin-api";
+/** Update mutable PR metadata while preserving Junior-owned body attribution. */
+export declare function createGitHubUpdatePullRequestTool(ctx: ToolRegistrationHookContext): import("@sentry/junior-plugin-api").PluginToolDefinition<{
+    repo: string;
+    number: number;
+    title?: string | undefined;
+    body?: string | undefined;
+    base?: string | undefined;
+    state?: "open" | "closed" | undefined;
+}, {
+    [x: string]: unknown;
+    base: string;
+    body: string | null;
+    draft: boolean;
+    number: number;
+    state: string;
+    title: string;
+    url: string;
+    ok: true;
+    status: "success";
+    target: "updatePullRequest";
+    data: {
+        base: string;
+        body: string | null;
+        draft: boolean;
+        number: number;
+        state: string;
+        title: string;
+        url: string;
+        subscribable?: {
+            label: string;
+            provider: string;
+            resourceRef: string;
+            supportedEvents: string[];
+            type: string;
+            suggestedEvents?: string[] | undefined;
+        } | undefined;
+    };
+    truncated?: boolean | undefined;
+    continuation?: {
+        arguments: Record<string, unknown>;
+        reason?: string | undefined;
+    } | undefined;
+    error?: string | {
+        kind: string;
+        message: string;
+        retryable?: boolean | undefined;
+    } | undefined;
+    subscribable?: {
+        label: string;
+        provider: string;
+        resourceRef: string;
+        supportedEvents: string[];
+        type: string;
+        suggestedEvents?: string[] | undefined;
+    } | undefined;
+}>;

package/dist/webhooks/handler.d.ts

@@ -0,0 +1,9 @@
+import type { PluginRoute, ResourceEventPublisher } from "@sentry/junior-plugin-api";
+import type { GitHubDb } from "../pull-request-outcomes/store.js";
+/** Create the public, signed GitHub webhook route owned by the plugin. */
+export declare function createGitHubWebhookRoute(args: {
+    botEmail(): string | undefined;
+    db: GitHubDb;
+    resourceEvents: ResourceEventPublisher;
+    webhookSecret(): string | undefined;
+}): PluginRoute;

package/dist/webhooks/pull-request-outcome.d.ts

@@ -0,0 +1,6 @@
+import type { GitHubPullRequestOutcomeInput } from "../pull-request-outcomes/store.js";
+/** Normalize only the fields required for the Junior-owned PR projection. */
+export declare function normalizeGitHubPullRequestOutcome(args: {
+    body: unknown;
+    botEmail?: string;
+}): GitHubPullRequestOutcomeInput | undefined;

package/dist/webhooks/resource-events.d.ts

@@ -0,0 +1,7 @@
+import type { ResourceEvent } from "@sentry/junior-plugin-api";
+/** Normalize one verified GitHub delivery into conversation resource events. */
+export declare function normalizeGitHubResourceEvents(args: {
+    body: unknown;
+    deliveryId: string;
+    eventName: string;
+}): ResourceEvent[];

package/migrations/0000_pull_request_outcomes.sql

@@ -0,0 +1,16 @@
+CREATE TABLE "junior_github_pull_requests" (
+	"pull_request_id" text PRIMARY KEY NOT NULL,
+	"repository_id" text NOT NULL,
+	"repository_full_name" text NOT NULL,
+	"number" integer NOT NULL,
+	"state" text NOT NULL,
+	"opened_at" timestamp with time zone NOT NULL,
+	"merged_at" timestamp with time zone,
+	"closed_at" timestamp with time zone,
+	"updated_at" timestamp with time zone NOT NULL
+);
+--> statement-breakpoint
+CREATE INDEX "junior_github_pull_requests_opened_at_idx" ON "junior_github_pull_requests" USING btree ("opened_at");--> statement-breakpoint
+CREATE INDEX "junior_github_pull_requests_merged_at_idx" ON "junior_github_pull_requests" USING btree ("merged_at");--> statement-breakpoint
+CREATE INDEX "junior_github_pull_requests_closed_at_idx" ON "junior_github_pull_requests" USING btree ("closed_at");--> statement-breakpoint
+CREATE INDEX "junior_github_pull_requests_open_idx" ON "junior_github_pull_requests" USING btree ("pull_request_id") WHERE "junior_github_pull_requests"."state" = 'open';

package/migrations/meta/0000_snapshot.json

@@ -0,0 +1,148 @@
+{
+  "id": "2c771be0-ac94-4eff-a69a-ade43801be34",
+  "prevId": "00000000-0000-0000-0000-000000000000",
+  "version": "7",
+  "dialect": "postgresql",
+  "tables": {
+    "public.junior_github_pull_requests": {
+      "name": "junior_github_pull_requests",
+      "schema": "",
+      "columns": {
+        "pull_request_id": {
+          "name": "pull_request_id",
+          "type": "text",
+          "primaryKey": true,
+          "notNull": true
+        },
+        "repository_id": {
+          "name": "repository_id",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "repository_full_name": {
+          "name": "repository_full_name",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "number": {
+          "name": "number",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "state": {
+          "name": "state",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "opened_at": {
+          "name": "opened_at",
+          "type": "timestamp with time zone",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "merged_at": {
+          "name": "merged_at",
+          "type": "timestamp with time zone",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "closed_at": {
+          "name": "closed_at",
+          "type": "timestamp with time zone",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "timestamp with time zone",
+          "primaryKey": false,
+          "notNull": true
+        }
+      },
+      "indexes": {
+        "junior_github_pull_requests_opened_at_idx": {
+          "name": "junior_github_pull_requests_opened_at_idx",
+          "columns": [
+            {
+              "expression": "opened_at",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            }
+          ],
+          "isUnique": false,
+          "concurrently": false,
+          "method": "btree",
+          "with": {}
+        },
+        "junior_github_pull_requests_merged_at_idx": {
+          "name": "junior_github_pull_requests_merged_at_idx",
+          "columns": [
+            {
+              "expression": "merged_at",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            }
+          ],
+          "isUnique": false,
+          "concurrently": false,
+          "method": "btree",
+          "with": {}
+        },
+        "junior_github_pull_requests_closed_at_idx": {
+          "name": "junior_github_pull_requests_closed_at_idx",
+          "columns": [
+            {
+              "expression": "closed_at",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            }
+          ],
+          "isUnique": false,
+          "concurrently": false,
+          "method": "btree",
+          "with": {}
+        },
+        "junior_github_pull_requests_open_idx": {
+          "name": "junior_github_pull_requests_open_idx",
+          "columns": [
+            {
+              "expression": "pull_request_id",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            }
+          ],
+          "isUnique": false,
+          "where": "\"junior_github_pull_requests\".\"state\" = 'open'",
+          "concurrently": false,
+          "method": "btree",
+          "with": {}
+        }
+      },
+      "foreignKeys": {},
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "policies": {},
+      "checkConstraints": {},
+      "isRLSEnabled": false
+    }
+  },
+  "enums": {},
+  "schemas": {},
+  "sequences": {},
+  "roles": {},
+  "policies": {},
+  "views": {},
+  "_meta": {
+    "columns": {},
+    "schemas": {},
+    "tables": {}
+  }
+}

package/migrations/meta/_journal.json

@@ -0,0 +1,13 @@
+{
+  "version": "7",
+  "dialect": "postgresql",
+  "entries": [
+    {
+      "idx": 0,
+      "version": "7",
+      "when": 1784743423488,
+      "tag": "0000_pull_request_outcomes",
+      "breakpoints": true
+    }
+  ]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sentry/junior-github",
-  "version": "0.106.0",
+  "version": "0.107.1",
   "private": false,
   "publishConfig": {
     "access": "public"
@@ -15,28 +15,37 @@
     ".": {
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
+    },
+    "./testing": {
+      "types": "./dist/testing.d.ts",
+      "default": "./dist/testing.js"
     }
   },
   "files": [
     "dist",
+    "migrations",
     "skills",
     "SETUP.md"
   ],
   "dependencies": {
     "@sinclair/typebox": "^0.34.49",
+    "drizzle-orm": "^0.45.2",
     "zod": "^4.4.3",
-    "@sentry/junior-plugin-api": "0.106.0"
+    "@sentry/junior-plugin-api": "0.107.1"
   },
   "devDependencies": {
     "@types/node": "^25.9.1",
     "msw": "^2.14.6",
+    "drizzle-kit": "^0.31.8",
     "oxlint": "^1.66.0",
     "tsup": "^8.5.1",
     "typescript": "^6.0.3",
-    "vitest": "^4.1.7"
+    "vitest": "^4.1.7",
+    "@sentry/junior-testing": "0.0.0"
   },
   "scripts": {
     "build": "tsup && tsc -p tsconfig.build.json --emitDeclarationOnly",
+    "db:generate": "pnpm exec drizzle-kit generate --config drizzle.config.ts",
     "lint": "oxlint --config ../junior/.oxlintrc.json --deny-warnings src tests tsup.config.ts vitest.config.ts",
     "test": "vitest run",
     "typecheck": "tsc --noEmit"