@buildinternet/releases-api-types 0.59.0 → 0.60.0

package/dist/schemas/stats.d.ts

@@ -0,0 +1,82 @@
+import { z } from "zod";
+/**
+ * Per-source activity row in `GET /v1/stats`. `orgName` is nullable because
+ * the source-to-org JOIN is left-joined (legacy orphan sources still exist).
+ */
+export declare const StatsSourceActivitySchema: z.ZodObject<{
+    sourceName: z.ZodString;
+    sourceSlug: z.ZodString;
+    sourceType: z.ZodString;
+    orgName: z.ZodNullable<z.ZodString>;
+    lastFetchedAt: z.ZodNullable<z.ZodString>;
+    totalReleases: z.ZodNumber;
+    recentReleases: z.ZodNumber;
+}, z.core.$strip>;
+/**
+ * Recent fetch-log row, joined with source + org for display. `durationMs`
+ * and `error` are nullable on the underlying table; `orgName` is nullable
+ * for the same orphan-source reason as above.
+ */
+export declare const StatsRecentActivitySchema: z.ZodObject<{
+    sourceName: z.ZodString;
+    sourceSlug: z.ZodString;
+    orgName: z.ZodNullable<z.ZodString>;
+    releasesFound: z.ZodNumber;
+    releasesInserted: z.ZodNumber;
+    totalReleases: z.ZodNumber;
+    status: z.ZodString;
+    durationMs: z.ZodNullable<z.ZodNumber>;
+    error: z.ZodNullable<z.ZodString>;
+    createdAt: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Response shape for `GET /v1/stats`. The handler returns a hybrid payload —
+ * the flat `Stats` counts (legacy `orgs/sources/releases/products` fields used
+ * by the web homepage banner) merged with the richer `StatsSummary` shape
+ * (period window + totals + sourceHealth + sourceActivity + recentActivity).
+ * Modelled with `z.object` over the union of both shapes; consumers may
+ * pick either subset.
+ */
+export declare const StatsResponseSchema: z.ZodObject<{
+    orgs: z.ZodNumber;
+    sources: z.ZodNumber;
+    releases: z.ZodNumber;
+    products: z.ZodNumber;
+    period: z.ZodObject<{
+        days: z.ZodNumber;
+        cutoff: z.ZodString;
+    }, z.core.$strip>;
+    totals: z.ZodObject<{
+        organizations: z.ZodNumber;
+        sources: z.ZodNumber;
+        releases: z.ZodNumber;
+        releasesInPeriod: z.ZodNumber;
+    }, z.core.$strip>;
+    sourceHealth: z.ZodObject<{
+        upToDate: z.ZodNumber;
+        stale: z.ZodNumber;
+        neverFetched: z.ZodNumber;
+    }, z.core.$strip>;
+    sourceActivity: z.ZodArray<z.ZodObject<{
+        sourceName: z.ZodString;
+        sourceSlug: z.ZodString;
+        sourceType: z.ZodString;
+        orgName: z.ZodNullable<z.ZodString>;
+        lastFetchedAt: z.ZodNullable<z.ZodString>;
+        totalReleases: z.ZodNumber;
+        recentReleases: z.ZodNumber;
+    }, z.core.$strip>>;
+    recentActivity: z.ZodArray<z.ZodObject<{
+        sourceName: z.ZodString;
+        sourceSlug: z.ZodString;
+        orgName: z.ZodNullable<z.ZodString>;
+        releasesFound: z.ZodNumber;
+        releasesInserted: z.ZodNumber;
+        totalReleases: z.ZodNumber;
+        status: z.ZodString;
+        durationMs: z.ZodNullable<z.ZodNumber>;
+        error: z.ZodNullable<z.ZodString>;
+        createdAt: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+//# sourceMappingURL=stats.d.ts.map

package/dist/schemas/stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../../src/schemas/stats.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;GAGG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;iBAQpC,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;iBAWpC,CAAC;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAkB9B,CAAC"}

package/dist/schemas/stats.js

@@ -0,0 +1,59 @@
+import { z } from "zod";
+import { StatsSchema } from "./shared.js";
+/**
+ * Per-source activity row in `GET /v1/stats`. `orgName` is nullable because
+ * the source-to-org JOIN is left-joined (legacy orphan sources still exist).
+ */
+export const StatsSourceActivitySchema = z.object({
+    sourceName: z.string(),
+    sourceSlug: z.string(),
+    sourceType: z.string(),
+    orgName: z.string().nullable(),
+    lastFetchedAt: z.string().nullable(),
+    totalReleases: z.number(),
+    recentReleases: z.number(),
+});
+/**
+ * Recent fetch-log row, joined with source + org for display. `durationMs`
+ * and `error` are nullable on the underlying table; `orgName` is nullable
+ * for the same orphan-source reason as above.
+ */
+export const StatsRecentActivitySchema = z.object({
+    sourceName: z.string(),
+    sourceSlug: z.string(),
+    orgName: z.string().nullable(),
+    releasesFound: z.number(),
+    releasesInserted: z.number(),
+    totalReleases: z.number(),
+    status: z.string(),
+    durationMs: z.number().nullable(),
+    error: z.string().nullable(),
+    createdAt: z.string(),
+});
+/**
+ * Response shape for `GET /v1/stats`. The handler returns a hybrid payload —
+ * the flat `Stats` counts (legacy `orgs/sources/releases/products` fields used
+ * by the web homepage banner) merged with the richer `StatsSummary` shape
+ * (period window + totals + sourceHealth + sourceActivity + recentActivity).
+ * Modelled with `z.object` over the union of both shapes; consumers may
+ * pick either subset.
+ */
+export const StatsResponseSchema = StatsSchema.extend({
+    period: z.object({
+        days: z.number().int().min(1),
+        cutoff: z.string(),
+    }),
+    totals: z.object({
+        organizations: z.number().int().min(0),
+        sources: z.number().int().min(0),
+        releases: z.number().int().min(0),
+        releasesInPeriod: z.number().int().min(0),
+    }),
+    sourceHealth: z.object({
+        upToDate: z.number().int().min(0),
+        stale: z.number().int().min(0),
+        neverFetched: z.number().int().min(0),
+    }),
+    sourceActivity: z.array(StatsSourceActivitySchema),
+    recentActivity: z.array(StatsRecentActivitySchema),
+});

package/dist/schemas/taxonomy.d.ts

@@ -0,0 +1,344 @@
+import { z } from "zod";
+/**
+ * Org rollup row shared by category and tag detail responses. Slim by
+ * design — taxonomy pages link out to the full org detail page rather
+ * than embedding it.
+ */
+export declare const TaxonomyOrgSchema: z.ZodObject<{
+    slug: z.ZodString;
+    name: z.ZodString;
+    domain: z.ZodNullable<z.ZodString>;
+    avatarUrl: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+/** Product rollup row, paired with `TaxonomyOrg`. */
+export declare const TaxonomyProductSchema: z.ZodObject<{
+    slug: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodNullable<z.ZodString>;
+    orgSlug: z.ZodString;
+    orgName: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Per-category row on `GET /v1/categories`. Categories are a fixed
+ * taxonomy (`CATEGORIES` in `@buildinternet/releases-core/categories`),
+ * so the response always includes every slug, including ones with zero
+ * members. `name` / `description` / `aliases` come from the optional
+ * `categories` metadata overlay; `description` is null when no override
+ * has been set.
+ */
+export declare const CategoryListItemSchema: z.ZodObject<{
+    slug: z.ZodEnum<{
+        ai: "ai";
+        cloud: "cloud";
+        commerce: "commerce";
+        crm: "crm";
+        database: "database";
+        design: "design";
+        "developer-tools": "developer-tools";
+        devops: "devops";
+        finance: "finance";
+        framework: "framework";
+        infrastructure: "infrastructure";
+        observability: "observability";
+        productivity: "productivity";
+        security: "security";
+    }>;
+    name: z.ZodString;
+    description: z.ZodNullable<z.ZodString>;
+    aliases: z.ZodArray<z.ZodString>;
+    orgCount: z.ZodNumber;
+    productCount: z.ZodNumber;
+    previewMembers: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        slug: z.ZodString;
+        name: z.ZodString;
+        domain: z.ZodNullable<z.ZodString>;
+        avatarUrl: z.ZodNullable<z.ZodString>;
+        githubHandle: z.ZodNullable<z.ZodString>;
+        description: z.ZodNullable<z.ZodString>;
+        kind: z.ZodLiteral<"org">;
+    }, z.core.$strip>, z.ZodObject<{
+        slug: z.ZodString;
+        name: z.ZodString;
+        description: z.ZodNullable<z.ZodString>;
+        org: z.ZodObject<{
+            slug: z.ZodString;
+            name: z.ZodString;
+            domain: z.ZodNullable<z.ZodString>;
+            avatarUrl: z.ZodNullable<z.ZodString>;
+            githubHandle: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>;
+        kind: z.ZodLiteral<"product">;
+    }, z.core.$strip>], "kind">>>;
+}, z.core.$strip>;
+export declare const CategoryListResponseSchema: z.ZodArray<z.ZodObject<{
+    slug: z.ZodEnum<{
+        ai: "ai";
+        cloud: "cloud";
+        commerce: "commerce";
+        crm: "crm";
+        database: "database";
+        design: "design";
+        "developer-tools": "developer-tools";
+        devops: "devops";
+        finance: "finance";
+        framework: "framework";
+        infrastructure: "infrastructure";
+        observability: "observability";
+        productivity: "productivity";
+        security: "security";
+    }>;
+    name: z.ZodString;
+    description: z.ZodNullable<z.ZodString>;
+    aliases: z.ZodArray<z.ZodString>;
+    orgCount: z.ZodNumber;
+    productCount: z.ZodNumber;
+    previewMembers: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        slug: z.ZodString;
+        name: z.ZodString;
+        domain: z.ZodNullable<z.ZodString>;
+        avatarUrl: z.ZodNullable<z.ZodString>;
+        githubHandle: z.ZodNullable<z.ZodString>;
+        description: z.ZodNullable<z.ZodString>;
+        kind: z.ZodLiteral<"org">;
+    }, z.core.$strip>, z.ZodObject<{
+        slug: z.ZodString;
+        name: z.ZodString;
+        description: z.ZodNullable<z.ZodString>;
+        org: z.ZodObject<{
+            slug: z.ZodString;
+            name: z.ZodString;
+            domain: z.ZodNullable<z.ZodString>;
+            avatarUrl: z.ZodNullable<z.ZodString>;
+            githubHandle: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>;
+        kind: z.ZodLiteral<"product">;
+    }, z.core.$strip>], "kind">>>;
+}, z.core.$strip>>;
+/** Returned by `GET /v1/categories/:slug` for the canonical slug. */
+export declare const CategoryDetailSchema: z.ZodObject<{
+    slug: z.ZodEnum<{
+        ai: "ai";
+        cloud: "cloud";
+        commerce: "commerce";
+        crm: "crm";
+        database: "database";
+        design: "design";
+        "developer-tools": "developer-tools";
+        devops: "devops";
+        finance: "finance";
+        framework: "framework";
+        infrastructure: "infrastructure";
+        observability: "observability";
+        productivity: "productivity";
+        security: "security";
+    }>;
+    name: z.ZodString;
+    description: z.ZodNullable<z.ZodString>;
+    aliases: z.ZodArray<z.ZodString>;
+    orgs: z.ZodArray<z.ZodObject<{
+        slug: z.ZodString;
+        name: z.ZodString;
+        domain: z.ZodNullable<z.ZodString>;
+        avatarUrl: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    products: z.ZodArray<z.ZodObject<{
+        slug: z.ZodString;
+        name: z.ZodString;
+        description: z.ZodNullable<z.ZodString>;
+        orgSlug: z.ZodString;
+        orgName: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * Body accepted by `PATCH /v1/categories/:slug`. All fields are optional,
+ * but the body must set at least one of them — an empty body is rejected.
+ * `name` and `description` accept `null` to clear the overlay value;
+ * `aliases` replaces the full set (pass `[]` to clear). The row is
+ * upserted — categories that have never been customized have no row.
+ *
+ * `name` is bounded at 200 chars and `description` at 2000. Alias element
+ * shape (kebab-case, not a canonical slug, not claimed by another row) is
+ * enforced in the handler after the strings are trimmed + lowercased, since
+ * those checks depend on runtime state and case-folding.
+ */
+export declare const UpdateCategoryRequestSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+/** Response from `PATCH /v1/categories/:slug` — the resolved overlay values. */
+export declare const UpdateCategoryResponseSchema: z.ZodObject<{
+    slug: z.ZodEnum<{
+        ai: "ai";
+        cloud: "cloud";
+        commerce: "commerce";
+        crm: "crm";
+        database: "database";
+        design: "design";
+        "developer-tools": "developer-tools";
+        devops: "devops";
+        finance: "finance";
+        framework: "framework";
+        infrastructure: "infrastructure";
+        observability: "observability";
+        productivity: "productivity";
+        security: "security";
+    }>;
+    name: z.ZodString;
+    description: z.ZodNullable<z.ZodString>;
+    aliases: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Aggregated release row on `GET /v1/categories/:slug/releases`. Same wire
+ * shape as `CollectionReleaseItem` — both surfaces aggregate across orgs and
+ * use `formatAggregateReleaseRow` in `apps/api/src/utils.ts` for the
+ * formatting. Re-exported here so the two endpoints describe one schema
+ * instead of two drifting copies.
+ */
+export declare const CategoryReleaseItemSchema: z.ZodObject<{
+    version: z.ZodNullable<z.ZodString>;
+    title: z.ZodString;
+    summary: z.ZodString;
+    content: z.ZodOptional<z.ZodString>;
+    publishedAt: z.ZodNullable<z.ZodString>;
+    fetchedAt: z.ZodOptional<z.ZodString>;
+    url: z.ZodNullable<z.ZodString>;
+    media: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        type: z.ZodEnum<{
+            gif: "gif";
+            image: "image";
+            video: "video";
+        }>;
+        url: z.ZodString;
+        alt: z.ZodOptional<z.ZodString>;
+        r2Key: z.ZodOptional<z.ZodString>;
+        r2Url: z.ZodOptional<z.ZodString>;
+        linkUrl: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    type: z.ZodOptional<z.ZodEnum<{
+        feature: "feature";
+        rollup: "rollup";
+    }>>;
+    prerelease: z.ZodOptional<z.ZodBoolean>;
+    titleGenerated: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    titleShort: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    breaking: z.ZodOptional<z.ZodEnum<{
+        major: "major";
+        minor: "minor";
+        none: "none";
+        unknown: "unknown";
+    }>>;
+    importance: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    coverageCount: z.ZodOptional<z.ZodNumber>;
+    contentChars: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    contentTokens: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    composition: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        bugs: z.ZodNumber;
+        features: z.ZodNumber;
+        enhancements: z.ZodNumber;
+    }, z.core.$strip>>>;
+    id: z.ZodString;
+    source: z.ZodObject<{
+        slug: z.ZodString;
+        name: z.ZodString;
+        type: z.ZodString;
+    }, z.core.$strip>;
+    org: z.ZodObject<{
+        slug: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$strip>;
+    product: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        slug: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$strip>>>;
+    groupSlug: z.ZodOptional<z.ZodString>;
+    groupName: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const CategoryFeedPaginationSchema: z.ZodObject<{
+    nextCursor: z.ZodNullable<z.ZodString>;
+    limit: z.ZodNumber;
+}, z.core.$strip>;
+export declare const CategoryReleasesResponseSchema: z.ZodObject<{
+    releases: z.ZodArray<z.ZodObject<{
+        version: z.ZodNullable<z.ZodString>;
+        title: z.ZodString;
+        summary: z.ZodString;
+        content: z.ZodOptional<z.ZodString>;
+        publishedAt: z.ZodNullable<z.ZodString>;
+        fetchedAt: z.ZodOptional<z.ZodString>;
+        url: z.ZodNullable<z.ZodString>;
+        media: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            type: z.ZodEnum<{
+                gif: "gif";
+                image: "image";
+                video: "video";
+            }>;
+            url: z.ZodString;
+            alt: z.ZodOptional<z.ZodString>;
+            r2Key: z.ZodOptional<z.ZodString>;
+            r2Url: z.ZodOptional<z.ZodString>;
+            linkUrl: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        type: z.ZodOptional<z.ZodEnum<{
+            feature: "feature";
+            rollup: "rollup";
+        }>>;
+        prerelease: z.ZodOptional<z.ZodBoolean>;
+        titleGenerated: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        titleShort: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        breaking: z.ZodOptional<z.ZodEnum<{
+            major: "major";
+            minor: "minor";
+            none: "none";
+            unknown: "unknown";
+        }>>;
+        importance: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        coverageCount: z.ZodOptional<z.ZodNumber>;
+        contentChars: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        contentTokens: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        composition: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            bugs: z.ZodNumber;
+            features: z.ZodNumber;
+            enhancements: z.ZodNumber;
+        }, z.core.$strip>>>;
+        id: z.ZodString;
+        source: z.ZodObject<{
+            slug: z.ZodString;
+            name: z.ZodString;
+            type: z.ZodString;
+        }, z.core.$strip>;
+        org: z.ZodObject<{
+            slug: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$strip>;
+        product: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            slug: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$strip>>>;
+        groupSlug: z.ZodOptional<z.ZodString>;
+        groupName: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    pagination: z.ZodObject<{
+        nextCursor: z.ZodNullable<z.ZodString>;
+        limit: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+/** Returned by `GET /v1/tags/:slug`. */
+export declare const TagDetailSchema: z.ZodObject<{
+    slug: z.ZodString;
+    name: z.ZodString;
+    orgs: z.ZodArray<z.ZodObject<{
+        slug: z.ZodString;
+        name: z.ZodString;
+        domain: z.ZodNullable<z.ZodString>;
+        avatarUrl: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    products: z.ZodArray<z.ZodObject<{
+        slug: z.ZodString;
+        name: z.ZodString;
+        description: z.ZodNullable<z.ZodString>;
+        orgSlug: z.ZodString;
+        orgName: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+//# sourceMappingURL=taxonomy.d.ts.map

package/dist/schemas/taxonomy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"taxonomy.d.ts","sourceRoot":"","sources":["../../src/schemas/taxonomy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB;;;;GAIG;AACH,eAAO,MAAM,iBAAiB;;;;;iBAK5B,CAAC;AAEH,qDAAqD;AACrD,eAAO,MAAM,qBAAqB;;;;;;iBAMhC,CAAC;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAiBjC,CAAC;AAEH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAAkC,CAAC;AAE1E,qEAAqE;AACrE,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAO/B,CAAC;AAEH;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,2BAA2B;;;;iBAQpC,CAAC;AAEL,gFAAgF;AAChF,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;iBAKvC,CAAC;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAA8B,CAAC;AAErE,eAAO,MAAM,4BAA4B;;;iBAGvC,CAAC;AAEH,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAGzC,CAAC;AAEH,wCAAwC;AACxC,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;iBAK1B,CAAC"}

package/{src/schemas/taxonomy.ts → dist/schemas/taxonomy.js}

@@ -1,28 +1,25 @@
 import { z } from "zod";
 import { CategorySchema } from "./shared.js";
 import { CollectionMemberSchema, CollectionReleaseItemSchema } from "./collections.js";
-
 /**
  * Org rollup row shared by category and tag detail responses. Slim by
  * design — taxonomy pages link out to the full org detail page rather
  * than embedding it.
  */
 export const TaxonomyOrgSchema = z.object({
-  slug: z.string(),
-  name: z.string(),
-  domain: z.string().nullable(),
-  avatarUrl: z.string().nullable(),
+    slug: z.string(),
+    name: z.string(),
+    domain: z.string().nullable(),
+    avatarUrl: z.string().nullable(),
 });
-
 /** Product rollup row, paired with `TaxonomyOrg`. */
 export const TaxonomyProductSchema = z.object({
-  slug: z.string(),
-  name: z.string(),
-  description: z.string().nullable(),
-  orgSlug: z.string(),
-  orgName: z.string(),
+    slug: z.string(),
+    name: z.string(),
+    description: z.string().nullable(),
+    orgSlug: z.string(),
+    orgName: z.string(),
 });
-
 /**
  * Per-category row on `GET /v1/categories`. Categories are a fixed
  * taxonomy (`CATEGORIES` in `@buildinternet/releases-core/categories`),
@@ -32,36 +29,33 @@ export const TaxonomyProductSchema = z.object({
  * has been set.
  */
 export const CategoryListItemSchema = z.object({
-  slug: CategorySchema,
-  name: z.string(),
-  description: z.string().nullable(),
-  aliases: z.array(z.string()),
-  orgCount: z.number().int().min(0),
-  productCount: z.number().int().min(0),
-  /**
-   * A small mixed-kind preview (capped at 3) of the orgs and products in this
-   * category, so the list page can render an inline avatar facepile without a
-   * second round trip — same shape and intent as a collection's
-   * `previewMembers`. Org entries are surfaced first (they carry the avatar);
-   * product entries fill any remaining slots and dedupe against orgs already
-   * shown. The list page derives "+N more" from `orgCount + productCount`.
-   * Optional on the wire so older workers mid-rollout don't trip the schema.
-   */
-  previewMembers: z.array(CollectionMemberSchema).optional(),
+    slug: CategorySchema,
+    name: z.string(),
+    description: z.string().nullable(),
+    aliases: z.array(z.string()),
+    orgCount: z.number().int().min(0),
+    productCount: z.number().int().min(0),
+    /**
+     * A small mixed-kind preview (capped at 3) of the orgs and products in this
+     * category, so the list page can render an inline avatar facepile without a
+     * second round trip — same shape and intent as a collection's
+     * `previewMembers`. Org entries are surfaced first (they carry the avatar);
+     * product entries fill any remaining slots and dedupe against orgs already
+     * shown. The list page derives "+N more" from `orgCount + productCount`.
+     * Optional on the wire so older workers mid-rollout don't trip the schema.
+     */
+    previewMembers: z.array(CollectionMemberSchema).optional(),
 });
-
 export const CategoryListResponseSchema = z.array(CategoryListItemSchema);
-
 /** Returned by `GET /v1/categories/:slug` for the canonical slug. */
 export const CategoryDetailSchema = z.object({
-  slug: CategorySchema,
-  name: z.string(),
-  description: z.string().nullable(),
-  aliases: z.array(z.string()),
-  orgs: z.array(TaxonomyOrgSchema),
-  products: z.array(TaxonomyProductSchema),
+    slug: CategorySchema,
+    name: z.string(),
+    description: z.string().nullable(),
+    aliases: z.array(z.string()),
+    orgs: z.array(TaxonomyOrgSchema),
+    products: z.array(TaxonomyProductSchema),
 });
-
 /**
  * Body accepted by `PATCH /v1/categories/:slug`. All fields are optional,
  * but the body must set at least one of them — an empty body is rejected.
@@ -75,23 +69,21 @@ export const CategoryDetailSchema = z.object({
  * those checks depend on runtime state and case-folding.
  */
 export const UpdateCategoryRequestSchema = z
-  .object({
+    .object({
     name: z.string().max(200).nullable().optional(),
     description: z.string().max(2000).nullable().optional(),
     aliases: z.array(z.string()).optional(),
-  })
-  .refine((b) => b.name !== undefined || b.description !== undefined || b.aliases !== undefined, {
+})
+    .refine((b) => b.name !== undefined || b.description !== undefined || b.aliases !== undefined, {
     message: "Body must set at least one of `name`, `description`, or `aliases`",
-  });
-
+});
 /** Response from `PATCH /v1/categories/:slug` — the resolved overlay values. */
 export const UpdateCategoryResponseSchema = z.object({
-  slug: CategorySchema,
-  name: z.string(),
-  description: z.string().nullable(),
-  aliases: z.array(z.string()),
+    slug: CategorySchema,
+    name: z.string(),
+    description: z.string().nullable(),
+    aliases: z.array(z.string()),
 });
-
 /**
  * Aggregated release row on `GET /v1/categories/:slug/releases`. Same wire
  * shape as `CollectionReleaseItem` — both surfaces aggregate across orgs and
@@ -100,21 +92,18 @@ export const UpdateCategoryResponseSchema = z.object({
  * instead of two drifting copies.
  */
 export const CategoryReleaseItemSchema = CollectionReleaseItemSchema;
-
 export const CategoryFeedPaginationSchema = z.object({
-  nextCursor: z.string().nullable(),
-  limit: z.number().int().min(1),
+    nextCursor: z.string().nullable(),
+    limit: z.number().int().min(1),
 });
-
 export const CategoryReleasesResponseSchema = z.object({
-  releases: z.array(CategoryReleaseItemSchema),
-  pagination: CategoryFeedPaginationSchema,
+    releases: z.array(CategoryReleaseItemSchema),
+    pagination: CategoryFeedPaginationSchema,
 });
-
 /** Returned by `GET /v1/tags/:slug`. */
 export const TagDetailSchema = z.object({
-  slug: z.string(),
-  name: z.string(),
-  orgs: z.array(TaxonomyOrgSchema),
-  products: z.array(TaxonomyProductSchema),
+    slug: z.string(),
+    name: z.string(),
+    orgs: z.array(TaxonomyOrgSchema),
+    products: z.array(TaxonomyProductSchema),
 });