@saacms/github-bridge 0.1.0

package/dist/client.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Structural subset of the GitHub Issues API surface this bridge uses.
+ *
+ * Mirrors the `auth-better-auth` discipline: we never import `@octokit/*`
+ * here. `GitHubClientLike` is a structural interface covering exactly the
+ * four operations the escalation + scale-cost flows need. The host injects
+ * a real Octokit / GitHub-App-backed implementation that satisfies the
+ * shape; this package compiles and tests with a hand-rolled mock.
+ */
+export type IssueState = "open" | "closed";
+export interface CreateIssueArgs {
+    readonly owner: string;
+    readonly repo: string;
+    readonly title: string;
+    readonly body: string;
+    readonly labels: ReadonlyArray<string>;
+}
+export interface CreatedIssue {
+    readonly number: number;
+    readonly htmlUrl: string;
+}
+export interface UpdateIssueArgs {
+    readonly owner: string;
+    readonly repo: string;
+    readonly number: number;
+    readonly labels?: ReadonlyArray<string>;
+    readonly state?: IssueState;
+}
+export interface ListIssuesArgs {
+    readonly owner: string;
+    readonly repo: string;
+    readonly labels?: ReadonlyArray<string>;
+    readonly state?: IssueState;
+}
+export interface ListedIssue {
+    readonly number: number;
+    readonly title: string;
+    readonly labels: ReadonlyArray<string>;
+    readonly state: IssueState;
+}
+export interface AddCommentArgs {
+    readonly owner: string;
+    readonly repo: string;
+    readonly number: number;
+    readonly body: string;
+}
+/**
+ * The injected GitHub client. Any object with this shape works; a real
+ * Octokit wrapper supplied by the host satisfies it. The bridge never
+ * depends on the concrete SDK.
+ */
+export interface GitHubClientLike {
+    createIssue(args: CreateIssueArgs): Promise<CreatedIssue>;
+    updateIssue(args: UpdateIssueArgs): Promise<void>;
+    listIssues(args: ListIssuesArgs): Promise<ReadonlyArray<ListedIssue>>;
+    addComment(args: AddCommentArgs): Promise<void>;
+}
+export interface GitHubBridgeOptions {
+    readonly client: GitHubClientLike;
+    readonly owner: string;
+    readonly repo: string;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,QAAQ,CAAA;AAE1C,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;CACvC;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;IACvC,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,CAAA;CAC5B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;IACvC,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,CAAA;CAC5B;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;IACtC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAA;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,WAAW,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,YAAY,CAAC,CAAA;IACzD,WAAW,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACjD,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC,CAAA;IACrE,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAChD;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAA;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB"}

package/dist/escalation.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Requested-block escalation → GitHub Issue, per ADR 0025 + CONTEXT.md.
+ *
+ * On Publish, a Requested block materializes as a GitHub Issue: the Owner's
+ * plain-language annotation + a deep-link back into the editor + a rendered
+ * snapshot + a machine-readable marker for round-trip. The Issue is the
+ * dev-side system of record; lifecycle is derived purely from its labels
+ * and state so a webhook can map it back to the editor badge.
+ */
+import type { GitHubBridgeOptions } from "./client.ts";
+export declare const ESCALATION_LABEL = "saacms:escalation";
+/** Lifecycle stages, per the Team-Topologies Collaboration round-trip. */
+export type Lifecycle = "open" | "triaged" | "approved" | "delivered";
+export interface EscalationRequest {
+    readonly pageId: string;
+    readonly blockPath: string;
+    readonly annotation: string;
+    readonly editorDeepLink: string;
+    readonly snapshotMarkdown: string;
+}
+export interface EscalationFiled {
+    readonly issueNumber: number;
+    readonly htmlUrl: string;
+}
+/** The subset of the escalation request we round-trip through the marker. */
+export interface EscalationMarker {
+    readonly pageId: string;
+    readonly blockPath: string;
+    readonly annotation: string;
+}
+/**
+ * File the escalation Issue. Deterministic title + body so the same request
+ * always produces the same artifact (and the marker round-trips cleanly).
+ */
+export declare function fileEscalationIssue(opts: GitHubBridgeOptions, req: EscalationRequest): Promise<EscalationFiled>;
+/**
+ * Pure lifecycle projection. closed → delivered (closed wins over all);
+ * open + `approved` → approved (approved implies triaged-or-beyond);
+ * open + `triaged` → triaged; else open.
+ */
+export declare function mapIssueToLifecycle(issue: {
+    readonly labels: ReadonlyArray<string>;
+    readonly state: "open" | "closed";
+}): Lifecycle;
+/**
+ * Extract the machine-readable escalation marker from an Issue body.
+ * Untrusted-input boundary: returns null on absent/malformed marker,
+ * never throws.
+ */
+export declare function parseEscalationMarker(issueBody: string): EscalationMarker | null;
+//# sourceMappingURL=escalation.d.ts.map

package/dist/escalation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"escalation.d.ts","sourceRoot":"","sources":["../src/escalation.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAEtD,eAAO,MAAM,gBAAgB,sBAAsB,CAAA;AAEnD,0EAA0E;AAC1E,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,GAAG,WAAW,CAAA;AAQrE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;CAClC;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB;AAED,6EAA6E;AAC7E,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC5B;AA2BD;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,mBAAmB,EACzB,GAAG,EAAE,iBAAiB,GACrB,OAAO,CAAC,eAAe,CAAC,CAS1B;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IACzC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;IACtC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,CAAA;CAClC,GAAG,SAAS,CAKZ;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CA4BhF"}

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @saacms/github-bridge — the ADR-0025 developer control plane.
+ *
+ * The Developer's working surface is GitHub Issues, never the admin. A
+ * Requested-block escalation and a Scale & Cost threshold crossing each
+ * materialize as a GitHub Issue; Issue activity is the dev-side system of
+ * record; a webhook maps it back to a thin Owner-facing editor badge.
+ *
+ * This package is pure and fully mock-testable: it never imports
+ * `@octokit/*` or touches the network. The host wires the real
+ * GitHub-App-backed client that satisfies `GitHubClientLike`.
+ */
+export type { GitHubClientLike, GitHubBridgeOptions, CreateIssueArgs, CreatedIssue, UpdateIssueArgs, ListIssuesArgs, ListedIssue, AddCommentArgs, IssueState, } from "./client.ts";
+export { fileEscalationIssue, mapIssueToLifecycle, parseEscalationMarker, ESCALATION_LABEL, } from "./escalation.ts";
+export type { EscalationRequest, EscalationFiled, EscalationMarker, Lifecycle, } from "./escalation.ts";
+export { fileScaleCostIssue, shouldFileNew, SCALE_COST_LABEL, } from "./scale-cost-issue.ts";
+export type { ScaleCostSignal, ScaleCostFiled, ScaleAxis, } from "./scale-cost-issue.ts";
+export { parseIssueWebhook, webhookToBadgeUpdate } from "./webhook.ts";
+export type { ParsedIssueWebhook, BadgeUpdate } from "./webhook.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,YAAY,EACV,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,YAAY,EACZ,eAAe,EACf,cAAc,EACd,WAAW,EACX,cAAc,EACd,UAAU,GACX,MAAM,aAAa,CAAA;AAEpB,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,iBAAiB,CAAA;AACxB,YAAY,EACV,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,SAAS,GACV,MAAM,iBAAiB,CAAA;AAExB,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,gBAAgB,GACjB,MAAM,uBAAuB,CAAA;AAC9B,YAAY,EACV,eAAe,EACf,cAAc,EACd,SAAS,GACV,MAAM,uBAAuB,CAAA;AAE9B,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AACtE,YAAY,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA"}

package/dist/index.js

@@ -0,0 +1,195 @@
+// src/escalation.ts
+var ESCALATION_LABEL = "saacms:escalation";
+var TRIAGED_LABEL = "triaged";
+var APPROVED_LABEL = "approved";
+var MARKER_OPEN = "<!-- saacms:escalation ";
+var MARKER_CLOSE = " -->";
+function escalationTitle(pageId, blockPath) {
+  return `[saacms] Requested block: ${pageId} ${blockPath}`;
+}
+function escalationBody(req) {
+  const marker = {
+    pageId: req.pageId,
+    blockPath: req.blockPath,
+    annotation: req.annotation
+  };
+  return [
+    "## Requested block",
+    "",
+    req.annotation,
+    "",
+    `**Editor:** ${req.editorDeepLink}`,
+    "",
+    "### Rendered snapshot",
+    "",
+    req.snapshotMarkdown,
+    "",
+    `${MARKER_OPEN}${JSON.stringify(marker)}${MARKER_CLOSE}`
+  ].join(`
+`);
+}
+async function fileEscalationIssue(opts, req) {
+  const created = await opts.client.createIssue({
+    owner: opts.owner,
+    repo: opts.repo,
+    title: escalationTitle(req.pageId, req.blockPath),
+    body: escalationBody(req),
+    labels: [ESCALATION_LABEL]
+  });
+  return { issueNumber: created.number, htmlUrl: created.htmlUrl };
+}
+function mapIssueToLifecycle(issue) {
+  if (issue.state === "closed")
+    return "delivered";
+  if (issue.labels.includes(APPROVED_LABEL))
+    return "approved";
+  if (issue.labels.includes(TRIAGED_LABEL))
+    return "triaged";
+  return "open";
+}
+function parseEscalationMarker(issueBody) {
+  if (typeof issueBody !== "string")
+    return null;
+  const start = issueBody.indexOf(MARKER_OPEN);
+  if (start === -1)
+    return null;
+  const jsonStart = start + MARKER_OPEN.length;
+  const end = issueBody.indexOf(MARKER_CLOSE, jsonStart);
+  if (end === -1)
+    return null;
+  const raw = issueBody.slice(jsonStart, end).trim();
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch {
+    return null;
+  }
+  if (parsed === null || typeof parsed !== "object")
+    return null;
+  const obj = parsed;
+  if (typeof obj.pageId !== "string" || typeof obj.blockPath !== "string" || typeof obj.annotation !== "string") {
+    return null;
+  }
+  return {
+    pageId: obj.pageId,
+    blockPath: obj.blockPath,
+    annotation: obj.annotation
+  };
+}
+// src/scale-cost-issue.ts
+var SCALE_COST_LABEL = "saacms:scale-cost";
+var MARKER_OPEN2 = "<!-- saacms:scale-cost ";
+var MARKER_CLOSE2 = " -->";
+function scaleCostTitle(axis, collection) {
+  const suffix = collection ? ` — ${collection}` : "";
+  return `[saacms] Scale & Cost: ${axis} threshold crossed${suffix}`;
+}
+function scaleCostBody(signal) {
+  const marker = {
+    axis: signal.axis,
+    collection: signal.collection ?? null
+  };
+  return [
+    "## Scale & Cost threshold crossed",
+    "",
+    ...signal.metricLines,
+    "",
+    `**Recommended action:** ${signal.recommendedAction}`,
+    "",
+    `${MARKER_OPEN2}${JSON.stringify(marker)}${MARKER_CLOSE2}`
+  ].join(`
+`);
+}
+function shouldFileNew(existing, axis, collection) {
+  const wanted = scaleCostTitle(axis, collection);
+  for (const issue of existing) {
+    if (issue.state !== "open")
+      continue;
+    if (!issue.labels.includes(SCALE_COST_LABEL))
+      continue;
+    if (issue.title === wanted)
+      return false;
+  }
+  return true;
+}
+async function fileScaleCostIssue(opts, signal, existing = []) {
+  if (!shouldFileNew(existing, signal.axis, signal.collection)) {
+    const wanted = scaleCostTitle(signal.axis, signal.collection);
+    const match = existing.find((i) => i.state === "open" && i.labels.includes(SCALE_COST_LABEL) && i.title === wanted);
+    if (match) {
+      await opts.client.addComment({
+        owner: opts.owner,
+        repo: opts.repo,
+        number: match.number,
+        body: scaleCostBody(signal)
+      });
+      return { issueNumber: match.number };
+    }
+  }
+  const created = await opts.client.createIssue({
+    owner: opts.owner,
+    repo: opts.repo,
+    title: scaleCostTitle(signal.axis, signal.collection),
+    body: scaleCostBody(signal),
+    labels: [SCALE_COST_LABEL]
+  });
+  return { issueNumber: created.number };
+}
+// src/webhook.ts
+function isObject(v) {
+  return typeof v === "object" && v !== null;
+}
+function parseIssueWebhook(payload) {
+  if (!isObject(payload))
+    return null;
+  const action = payload.action;
+  if (typeof action !== "string")
+    return null;
+  const issue = payload.issue;
+  if (!isObject(issue))
+    return null;
+  const number = issue.number;
+  if (typeof number !== "number" || !Number.isFinite(number))
+    return null;
+  const state = issue.state;
+  if (state !== "open" && state !== "closed")
+    return null;
+  const rawBody = issue.body;
+  const body = typeof rawBody === "string" ? rawBody : "";
+  const rawLabels = issue.labels;
+  const labels = [];
+  if (Array.isArray(rawLabels)) {
+    for (const l of rawLabels) {
+      if (isObject(l) && typeof l.name === "string") {
+        labels.push(l.name);
+      } else if (typeof l === "string") {
+        labels.push(l);
+      }
+    }
+  }
+  return { action, issue: { number, labels, state, body } };
+}
+function webhookToBadgeUpdate(payload) {
+  const parsed = parseIssueWebhook(payload);
+  if (parsed === null)
+    return null;
+  return {
+    issueNumber: parsed.issue.number,
+    lifecycle: mapIssueToLifecycle({
+      labels: parsed.issue.labels,
+      state: parsed.issue.state
+    }),
+    marker: parseEscalationMarker(parsed.issue.body)
+  };
+}
+export {
+  webhookToBadgeUpdate,
+  shouldFileNew,
+  parseIssueWebhook,
+  parseEscalationMarker,
+  mapIssueToLifecycle,
+  fileScaleCostIssue,
+  fileEscalationIssue,
+  SCALE_COST_LABEL,
+  ESCALATION_LABEL
+};

package/dist/scale-cost-issue.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Scale & Cost threshold crossing → GitHub Issue, per ADR 0025 + CONTEXT.md.
+ *
+ * When the site crosses a growth point, the Developer gets a tracked Issue
+ * (labeled `saacms:scale-cost`) with the numbers + the exact recommended
+ * plugin/tier action — the Developer never opens the admin. Idempotent:
+ * one open Issue per axis(+collection); a re-crossing comments rather than
+ * duplicating, so it stays a single "failing test" the Developer acts on.
+ */
+import type { GitHubBridgeOptions, ListedIssue } from "./client.ts";
+export declare const SCALE_COST_LABEL = "saacms:scale-cost";
+export type ScaleAxis = "serve" | "publish";
+export interface ScaleCostSignal {
+    readonly axis: ScaleAxis;
+    readonly collection?: string;
+    readonly metricLines: ReadonlyArray<string>;
+    readonly recommendedAction: string;
+}
+export interface ScaleCostFiled {
+    readonly issueNumber: number;
+}
+/**
+ * Pure idempotency decision: file a fresh Issue only when no open
+ * scale-cost Issue already covers this exact axis(+collection).
+ */
+export declare function shouldFileNew(existing: ReadonlyArray<ListedIssue>, axis: ScaleAxis, collection?: string): boolean;
+/**
+ * File (or coalesce into) the Scale & Cost Issue. `existing` is the caller's
+ * `listIssues` result; when a matching open Issue exists we `addComment`
+ * instead of duplicating and return that Issue's number.
+ */
+export declare function fileScaleCostIssue(opts: GitHubBridgeOptions, signal: ScaleCostSignal, existing?: ReadonlyArray<ListedIssue>): Promise<ScaleCostFiled>;
+//# sourceMappingURL=scale-cost-issue.d.ts.map

package/dist/scale-cost-issue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scale-cost-issue.d.ts","sourceRoot":"","sources":["../src/scale-cost-issue.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAEnE,eAAO,MAAM,gBAAgB,sBAAsB,CAAA;AAKnD,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,SAAS,CAAA;AAE3C,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;IAC3C,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAA;CACnC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;CAC7B;AA4BD;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,aAAa,CAAC,WAAW,CAAC,EACpC,IAAI,EAAE,SAAS,EACf,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAQT;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,mBAAmB,EACzB,MAAM,EAAE,eAAe,EACvB,QAAQ,GAAE,aAAa,CAAC,WAAW,CAAM,GACxC,OAAO,CAAC,cAAc,CAAC,CA6BzB"}

package/dist/webhook.d.ts

@@ -0,0 +1,35 @@
+/**
+ * GitHub `issues` webhook → editor badge update, per ADR 0025.
+ *
+ * Webhooks are untrusted input: every parser here is defensive and returns
+ * null on any shape mismatch — never throws. `webhookToBadgeUpdate`
+ * composes the parse + the pure lifecycle projection + the marker
+ * round-trip so the saacms webhook handler can flip the Owner-side badge.
+ */
+import { type EscalationMarker, type Lifecycle } from "./escalation.ts";
+export interface ParsedIssueWebhook {
+    readonly action: string;
+    readonly issue: {
+        readonly number: number;
+        readonly labels: ReadonlyArray<string>;
+        readonly state: "open" | "closed";
+        readonly body: string;
+    };
+}
+/**
+ * Defensive parse of the GitHub `issues` event payload. Pulls action +
+ * issue.number + issue.labels[].name + issue.state + issue.body. Returns
+ * null on any missing/wrong-typed field.
+ */
+export declare function parseIssueWebhook(payload: unknown): ParsedIssueWebhook | null;
+export interface BadgeUpdate {
+    readonly issueNumber: number;
+    readonly lifecycle: Lifecycle;
+    readonly marker: EscalationMarker | null;
+}
+/**
+ * Compose parse → lifecycle → marker. Returns null when the payload is not
+ * a parseable `issues` event.
+ */
+export declare function webhookToBadgeUpdate(payload: unknown): BadgeUpdate | null;
+//# sourceMappingURL=webhook.d.ts.map

package/dist/webhook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook.d.ts","sourceRoot":"","sources":["../src/webhook.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAGL,KAAK,gBAAgB,EACrB,KAAK,SAAS,EACf,MAAM,iBAAiB,CAAA;AAExB,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,KAAK,EAAE;QACd,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;QACvB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;QACtC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,CAAA;QACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KACtB,CAAA;CACF;AAMD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,kBAAkB,GAAG,IAAI,CA+B7E;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAA;IAC7B,QAAQ,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAAA;CACzC;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,WAAW,GAAG,IAAI,CAWzE"}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@saacms/github-bridge",
+  "version": "0.1.0",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc --build",
+    "typecheck": "tsc --build --noEmit",
+    "prepack": "cp package.json package.json.pack-bak && bun run ../../scripts/prepack-pkg.ts",
+    "postpack": "mv package.json.pack-bak package.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@saacms/core": "workspace:*"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "typescript": "^5.7.0"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts"
+}