feat(web,api): filter org release feed by source type, hide prereleases by default (#797)

* feat(web,api): filter org release feed by source type, hide prereleases by default

Adds two filters to `/v1/orgs/:slug/releases` and the org Releases tab:

- `?source_type=github,feed` (catalog-shaped tolerant parser; unknowns dropped)
- `?include_prereleases=true` (default false)

Prerelease detection runs at ingest. The GitHub adapter captures the
authoritative `prerelease` field from the GitHub API; other adapters fall
back to a SemVer-prerelease regex via `@buildinternet/releases-core/prerelease`
covering -alpha/-beta/-rc/-pre/-preview/-nightly/-canary/-snapshot/-dev/-edge
/-insider/-experimental/-early-access/-ea/-mN identifiers.

Migration `20260507000000_releases_prerelease.sql` adds the column with
default 0; `20260507000001_releases_prerelease_backfill.sql` retags existing
rows by version pattern. The existing `idx_releases_source_suppressed_published`
composite carries the per-org join — a standalone bool index would have
near-zero selectivity and sit unused.

Web frontend renders a filter row above the release list: source-type chips
(auto-hidden when only one source type exists for the org) and a "Show
prereleases" checkbox. Pre-release rows get a small "pre" pill.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Address PR #797 review: error UI, decouple prerelease toggle, missed call sites

- Surface non-abort fetch failures via a fetchError banner above the list
  (CodeRabbit catch was real — re-throwing escaped the promise chain)
- Decouple "Show prereleases" checkbox from source-type tab visibility:
  feed/scrape/agent-only orgs need the toggle too (their adapters fall back
  to the version-pattern detector)
- Add `-next` and `-milestone` to the SQL backfill (`-next.x` is common
  for pnpm/Supabase; the regex already covered both)
- Add `prerelease` column to the `releasesVisible` Drizzle view declaration
  so type-safe queries can reference it; plumb through the GraphQL loader
- Set `prerelease` on the single-release seed endpoint
  (POST /sources/:slug/releases) — it was hitting the column default of 0
- Bump cron releases-insert chunk from hardcoded 5 to RELEASES_BATCH_CHUNK_SIZE
  (7), aligning with the bind-budget convention used elsewhere

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: zachdunn

packages/adapters/src/github.ts

@@ -404,6 +404,7 @@ interface GitHubRelease {
   body: string | null;
   html_url: string;
   published_at: string | null;
+  prerelease: boolean;
 }
 
 // Re-fetch protection: The UNIQUE constraints on releases (source_id, url)
@@ -467,6 +468,7 @@ export const github: Adapter = {
           content: rel.body || "",
           url: rel.html_url,
           publishedAt,
+          prerelease: rel.prerelease === true,
         });
 
         if (maxEntries && releases.length >= maxEntries) {

packages/adapters/src/types.ts

@@ -9,6 +9,14 @@ export interface RawRelease {
   isBreaking?: boolean;
   type?: ReleaseType;
   media?: Array<{ type: "image" | "video" | "gif"; url: string; alt?: string }>;
+  /**
+   * Whether this is a pre-release (beta, rc, nightly, preview, etc.). Set
+   * authoritatively by adapters with first-class signals (GitHub releases
+   * API exposes `prerelease`); other adapters leave it undefined and let
+   * the upsert path fall back to a version-pattern heuristic via
+   * `isPrereleaseVersion()`.
+   */
+  prerelease?: boolean;
 }
 
 export interface FetchOptions {

packages/api-types/src/schemas/shared.ts

@@ -52,6 +52,11 @@ export const ReleaseItemSchema = z.object({
   // `.optional()` — older API responses (mid-deploy or pinned old workers)
   // may omit `type`; consumers should treat `undefined` as `"feature"`.
   type: ReleaseTypeSchema.optional(),
+  // Pre-release flag (alpha/beta/rc/preview/nightly). Computed at ingest —
+  // GitHub uses the API's authoritative `prerelease` field; other adapters
+  // fall back to a SemVer-prerelease regex. `.optional()` for the same
+  // older-response degrade-gracefully reason as `type`.
+  prerelease: z.boolean().optional(),
 });
 
 export const ReleaseSummaryItemSchema = z.object({

packages/core/package.json

@@ -25,6 +25,7 @@
     "./sources": "./src/sources.ts",
     "./reserved-slugs": "./src/reserved-slugs.ts",
     "./tokens": "./src/tokens.ts",
+    "./prerelease": "./src/prerelease.ts",
     "./cli-contracts": "./src/cli-contracts.ts",
     "./cursor": "./src/cursor.ts"
   },

packages/core/src/prerelease.ts

@@ -0,0 +1,24 @@
+/**
+ * Detect whether a release version string represents a pre-release.
+ *
+ * Used at ingest time as a fallback for non-GitHub adapters (the GitHub
+ * adapter uses the API's authoritative `prerelease` field instead). Matches
+ * the SemVer pre-release convention — anything after a `-` separator that
+ * begins with a recognized identifier (`alpha`, `beta`, `rc`, `pre`,
+ * `preview`, `nightly`, `dev`, `canary`, `next`, `snapshot`, `milestone`,
+ * `m1`/`M1`, etc.). Date-suffixed nightlies (`-nightly.20260506`) and
+ * commit-suffixed previews (`-preview.1.g80d269054`) match too.
+ *
+ * Conservative on purpose — when in doubt, return false so we don't
+ * accidentally hide a real release. The flag is a UX nicety, not a
+ * security boundary.
+ */
+const PRERELEASE_TAG_RE =
+  /[-.](?:alpha|beta|rc|pre|preview|nightly|dev|canary|next|snapshot|milestone|m\d+|edge|insider|experimental|test|early-access|ea)\b/i;
+
+export function isPrereleaseVersion(version: string | null | undefined): boolean {
+  if (!version) return false;
+  const trimmed = version.trim();
+  if (!trimmed) return false;
+  return PRERELEASE_TAG_RE.test(trimmed);
+}

packages/core/src/schema.ts

@@ -259,6 +259,7 @@ export const releases = sqliteTable(
     metadata: text("metadata").default("{}"),
     media: text("media").default("[]"),
     publishedAt: text("published_at"),
+    prerelease: integer("prerelease", { mode: "boolean" }).notNull().default(false),
     suppressed: integer("suppressed", { mode: "boolean" }).default(false),
     suppressedReason: text("suppressed_reason"),
     fetchedAt: text("fetched_at")
@@ -820,6 +821,7 @@ export const releasesVisible = sqliteView("releases_visible", {
   metadata: text("metadata"),
   media: text("media"),
   publishedAt: text("published_at"),
+  prerelease: integer("prerelease", { mode: "boolean" }).notNull(),
   suppressed: integer("suppressed", { mode: "boolean" }),
   suppressedReason: text("suppressed_reason"),
   fetchedAt: text("fetched_at").notNull(),

tests/api/releases-batch-binds.test.ts

@@ -36,6 +36,7 @@ const mockRow = (i: number) => ({
   url: `https://example.invalid/${i}`,
   contentHash: "h",
   publishedAt: "2026-01-01",
+  prerelease: false,
   media: "[]",
 });
 

tests/unit/prerelease.test.ts

@@ -0,0 +1,41 @@
+import { describe, test, expect } from "bun:test";
+import { isPrereleaseVersion } from "@buildinternet/releases-core/prerelease";
+
+describe("isPrereleaseVersion", () => {
+  test.each([
+    "v0.42.0-preview.1",
+    "v0.42.0-preview.2",
+    "v0.42.0-nightly.20260506.g80d269054",
+    "v1.0.0-rc.2",
+    "1.0.0-alpha",
+    "1.0.0-alpha.3",
+    "1.0.0-beta.1",
+    "v2.0.0-pre.4",
+    "0.5.0-canary.7",
+    "5.0.0-next.42",
+    "1.2.3-dev",
+    "3.0.0-snapshot",
+    "1.0.0-M1",
+    "1.0.0-milestone.2",
+    "v22.0.0-edge",
+    "1.0.0-insider",
+    "1.0.0-experimental",
+    "1.0.0-early-access",
+  ])("flags %s as prerelease", (v) => {
+    expect(isPrereleaseVersion(v)).toBe(true);
+  });
+
+  test.each(["v1.0.0", "1.0.0", "v0.41.2", "2024.05.07", "v22-lts", "v1.0.0+build.123"])(
+    "does not flag %s as prerelease",
+    (v) => {
+      expect(isPrereleaseVersion(v)).toBe(false);
+    },
+  );
+
+  test("handles null/undefined/empty", () => {
+    expect(isPrereleaseVersion(null)).toBe(false);
+    expect(isPrereleaseVersion(undefined)).toBe(false);
+    expect(isPrereleaseVersion("")).toBe(false);
+    expect(isPrereleaseVersion("   ")).toBe(false);
+  });
+});

web/src/app/[orgSlug]/page.tsx

@@ -180,6 +180,7 @@ export default async function OrgPage({
                   initialReleases={initialReleases.releases}
                   initialCursor={initialReleases.pagination.nextCursor}
                   multipleSourcesExist={org.sources.length > 1}
+                  availableSourceTypes={Array.from(new Set(org.sources.map((s) => s.type)))}
                 />
               ) : (
                 <div className="text-center py-12 text-stone-400 dark:text-stone-500 text-sm">

web/src/app/api/format/[orgSlug]/route.ts

@@ -19,7 +19,7 @@ export async function GET(
     try {
       [org, feed] = await Promise.all([
         api.orgDetail(orgSlug),
-        api.orgReleases(orgSlug, undefined, ATOM_DEFAULT_MAX_ENTRIES),
+        api.orgReleases(orgSlug, { limit: ATOM_DEFAULT_MAX_ENTRIES }),
       ]);
     } catch {
       return NextResponse.json(
@@ -35,7 +35,7 @@ export async function GET(
     try {
       [org, feed] = await Promise.all([
         api.orgDetail(orgSlug),
-        api.orgReleases(orgSlug, undefined, 10),
+        api.orgReleases(orgSlug, { limit: 10 }),
       ]);
     } catch {
       return NextResponse.json(