@buildinternet/releases-api-types 0.59.0 → 0.60.0

package/src/schemas/orgs.ts

@@ -1,533 +0,0 @@
-import { z } from "zod";
-import { KIND_VALUES } from "@buildinternet/releases-core/kinds";
-import { BREAKING_LEVELS } from "@buildinternet/releases-core/breaking";
-import {
-  AppStoreSourceInfoSchema,
-  CategorySchema,
-  ImportanceScoreSchema,
-  ListResponseSchema,
-  NoticeSchema,
-  OrgStatusSchema,
-  OverviewPageItemSchema,
-  PaginationSchema,
-  ReleaseItemSchema,
-  ReleaseLocationItemSchema,
-  VideoSourceInfoSchema,
-} from "./shared.js";
-import { SourceListItemSchema } from "./sources.js";
-import { ProductListItemSchema } from "./products.js";
-import { CollectionListItemSchema } from "./collections.js";
-
-export const OrgListItemSchema = z.object({
-  id: z.string(),
-  slug: z.string(),
-  name: z.string(),
-  domain: z.string().nullable(),
-  description: z.string().nullable(),
-  category: CategorySchema.nullable(),
-  avatarUrl: z.string().nullable(),
-  featured: z.boolean(),
-  /**
-   * Org tier (#1947). Optional for mid-deploy tolerance; absent ⇒ `"tracked"`.
-   * A `"stub"` org has no processed sources yet — the UI renders a badge and a
-   * stub is excluded from release-ranked surfaces.
-   */
-  status: OrgStatusSchema.optional(),
-  sourceCount: z.number().int().min(0),
-  releaseCount: z.number().int().min(0),
-  recentReleaseCount: z.number().int().min(0),
-  lastActivity: z.string().nullable(),
-  topProducts: z.array(z.string()),
-  /**
-   * Org-level alternate domains (`domain_aliases`, product-scoped aliases
-   * excluded), sorted. Surfaced next to the primary `domain` in catalog rows so
-   * a self-declared name reads against every domain the org actually controls.
-   * Optional for mid-deploy tolerance; absent ⇒ treat as none.
-   */
-  aliasDomains: z.array(z.string()).optional(),
-  sparkline: z.array(z.number().int().min(0)).length(30),
-  /**
-   * Additive, admin-only field (#1947 phase 2). Only populated on the
-   * `GET /v1/orgs?trackingRequested=1` demand-queue projection — absent on
-   * the public catalog listing.
-   */
-  trackingRequestedAt: z.string().nullable().optional(),
-});
-
-/**
- * Per-request side-channel for the orgs list (#746). `emptyOrgCount` is the
- * number of orgs that match the same `q` filter but have zero indexed
- * releases — used to label a "Show empty orgs" toggle without a second
- * round-trip. The value is scoped by the search term but independent of
- * `?includeEmpty=` so the toggle CTA can render a count whether the current
- * response included empty orgs or not.
- */
-export const OrgListMetaSchema = z.object({
-  emptyOrgCount: z.number().int().min(0),
-});
-
-/**
- * `meta` is optional on the wire so older workers / pinned clients mid-deploy
- * don't trip the schema check. New clients can treat missing as
- * `emptyOrgCount: 0` (the toggle just won't render a count).
- */
-export const OrgListResponseSchema = z.object({
-  items: z.array(OrgListItemSchema),
-  pagination: PaginationSchema,
-  meta: OrgListMetaSchema.optional(),
-});
-
-export const OrgAccountItemSchema = z.object({
-  platform: z.string(),
-  handle: z.string(),
-});
-
-export const OrgAccountsListResponseSchema = ListResponseSchema(OrgAccountItemSchema);
-
-/**
- * Response shape for `GET /v1/orgs/:slug/accounts`. Returns the paginated list
- * by default; with `?platform=<name>` returns a single matching account or
- * `null` when no row matches. The dual shape is preserved for compatibility
- * with the OSS CLI which calls `?platform=` and expects a single row.
- */
-export const OrgAccountsResponseSchema = z.union([
-  OrgAccountsListResponseSchema,
-  OrgAccountItemSchema,
-  z.null(),
-]);
-export const OrgTagsResponseSchema = ListResponseSchema(z.string());
-
-/**
- * Body accepted by `POST /v1/orgs`. `category` is a non-empty string at the
- * wire boundary so callers can pass either a canonical slug or one of its
- * configured aliases (resolved server-side via `resolveCategoryInput`).
- * Responses always carry the canonical slug. Empty strings are rejected so
- * the truthy-guard around `resolveCategoryInput` in the handler can't be
- * bypassed into persisting an invalid `""` value.
- */
-export const CreateOrgBodySchema = z.object({
-  name: z.string().min(1),
-  slug: z.string().optional(),
-  domain: z.string().optional(),
-  description: z.string().optional(),
-  category: z.string().min(1).optional(),
-  tags: z.array(z.string()).optional(),
-  /**
-   * Admin-only: opt the new org into automatic AI content (overviews +
-   * per-release summaries). Omitted → defaults to `true` server-side, since
-   * `POST /v1/orgs` only ever mints `curated` orgs and onboarding into the
-   * registry should mean it gets overviews. Pass `false` for a deliberate
-   * opt-out (#1795).
-   */
-  autoGenerateContent: z.boolean().optional(),
-});
-
-/**
- * Body accepted by `PATCH /v1/orgs/:slug`. Same alias-allowed string rule
- * as create, plus `null` to explicitly clear the overlay. Empty strings
- * stay rejected so callers must pick between a slug/alias or `null`.
- */
-export const UpdateOrgBodySchema = z.object({
-  name: z.string().optional(),
-  slug: z.string().optional(),
-  domain: z.string().nullable().optional(),
-  description: z.string().nullable().optional(),
-  category: z.string().min(1).nullable().optional(),
-  avatarUrl: z.string().nullable().optional(),
-  tags: z.array(z.string()).optional(),
-  aliases: z.array(z.string()).optional(),
-  /** Admin-only: pause/unpause all ingest for this org without touching sources (#1057). */
-  fetchPaused: z.boolean().optional(),
-  /** Admin-only: hide the org from the homepage ticker + /v1/orgs directory. Stays reachable via detail, search, sitemap. */
-  isHidden: z.boolean().optional(),
-  /** Admin-only: opt the org into automatic AI content — org overviews AND per-release summaries (single backend flag `auto_generate_content`). */
-  autoGenerateContent: z.boolean().optional(),
-  /**
-   * Admin-only: manual override for the automated overview-regen cadence in
-   * days (#1895). `null` clears back to automatic (velocity-tiered: 7d
-   * default, 2d at high release velocity). A set value pins the cadence in
-   * either direction — faster for a hot org, slower for a bursty one.
-   */
-  overviewCadenceDays: z.number().int().min(1).max(90).nullable().optional(),
-  /** Admin-only: promote this org on the home-page featured rail. */
-  featured: z.boolean().optional(),
-  /** Admin-only: promote or demote the org's discovery status (curated/agent/on_demand). */
-  discovery: z.enum(["curated", "agent", "on_demand"]).optional(),
-  notice: NoticeSchema.nullable().optional(),
-});
-
-/** Body for `POST /v1/orgs/:slug/avatar` — the remote image to mirror to R2 (#1406). */
-export const SetOrgAvatarBodySchema = z.object({
-  sourceUrl: z.url(),
-});
-
-/** Response for `POST /v1/orgs/:slug/avatar` — the mirrored avatar's public URL + dims. */
-export const SetOrgAvatarResponseSchema = z.object({
-  avatarUrl: z.string(),
-  key: z.string(),
-  width: z.number(),
-  height: z.number(),
-});
-
-// Org detail's products query selects a strict subset of `ProductListItem` —
-// no category/orgId because the parent already names the org; createdAt is
-// included for age-based filtering by consumers.
-const OrgDetailProductSchema = ProductListItemSchema.pick({
-  id: true,
-  slug: true,
-  name: true,
-  url: true,
-  description: true,
-  sourceCount: true,
-  kind: true,
-  createdAt: true,
-}).extend({
-  releaseCount: z.number().int().min(0),
-});
-
-const OrgDetailPlaybookSchema = z.object({
-  scope: z.literal("playbook"),
-  content: z.string(),
-  updatedAt: z.string(),
-});
-
-// ── Org catalog (/orgs/:slug/catalog) ──
-
-const OrgCatalogProductItemSchema = z.object({
-  entryType: z.literal("product"),
-  kind: z.enum(KIND_VALUES).nullable().optional(),
-  id: z.string(),
-  slug: z.string(),
-  name: z.string(),
-  url: z.string().nullable(),
-  description: z.string().nullable(),
-  category: CategorySchema.nullable(),
-});
-
-const OrgCatalogSourceItemSchema = z.object({
-  entryType: z.literal("source"),
-  kind: z.enum(KIND_VALUES).nullable().optional(),
-  id: z.string(),
-  slug: z.string(),
-  name: z.string(),
-  type: z.string(),
-  url: z.string(),
-  productId: z.string().nullable(),
-});
-
-/**
- * Combined product + source catalog for `GET /v1/orgs/:slug/catalog`.
- * `entryType` discriminates between the two row shapes (`"product"` vs
- * `"source"`). `kind` carries the entity taxonomy (platform/sdk/mobile/…).
- * Products carry `category` and `description`; sources carry `type` and
- * `productId`.
- */
-export const OrgCatalogItemSchema = z.discriminatedUnion("entryType", [
-  OrgCatalogProductItemSchema,
-  OrgCatalogSourceItemSchema,
-]);
-
-export const OrgCatalogResponseSchema = z.object({
-  org: z.object({ id: z.string(), slug: z.string(), name: z.string() }),
-  items: z.array(OrgCatalogItemSchema),
-});
-
-// ── Org collections membership (/orgs/:slug/collections) ──
-
-/**
- * List of collections the org belongs to, returned by
- * `GET /v1/orgs/:slug/collections`. Each item follows the same shape as
- * `CollectionListItem` on `GET /v1/collections` — `previewMembers` is
- * omitted here because the context (one org's collections) makes inline
- * member previews redundant.
- */
-export const OrgCollectionsResponseSchema = z.array(CollectionListItemSchema);
-
-// ── Org accounts (/orgs/:slug/accounts) ──
-
-/**
- * Body accepted by `POST /v1/orgs/:slug/accounts`.
- * Both `platform` and `handle` are required.
- */
-export const AddOrgAccountBodySchema = z.object({
-  platform: z.string().min(1),
-  handle: z.string().min(1),
-});
-
-// ── Org ignored URLs (/orgs/:slug/ignored-urls) ──
-
-export const IgnoredUrlItemSchema = z.object({
-  id: z.string(),
-  url: z.string(),
-  orgId: z.string(),
-  reason: z.string().nullable(),
-  ignoredAt: z.string(),
-});
-
-export const OrgIgnoredUrlsListResponseSchema = ListResponseSchema(IgnoredUrlItemSchema);
-
-/**
- * Response shape for `GET /v1/orgs/:slug/ignored-urls`. Returns the paginated
- * list by default; with `?url=<encoded>&single=1` returns the matching single
- * row or `null` when not present.
- */
-export const OrgIgnoredUrlsResponseSchema = z.union([
-  OrgIgnoredUrlsListResponseSchema,
-  IgnoredUrlItemSchema,
-  z.null(),
-]);
-
-/**
- * Body accepted by `POST /v1/orgs/:slug/ignored-urls`.
- * `reason` is optional.
- */
-export const AddIgnoredUrlBodySchema = z.object({
-  url: z.string().min(1),
-  reason: z.string().optional(),
-});
-
-/** Response shape for `POST /v1/orgs/:slug/ignored-urls`. */
-export const AddIgnoredUrlResponseSchema = z.object({
-  ignored: z.literal(true),
-});
-
-/** Response shape for `DELETE /v1/orgs/:slug/ignored-urls/:url`. */
-export const DeleteIgnoredUrlResponseSchema = z.object({
-  deleted: z.literal(true),
-});
-
-// ── Org tags (/orgs/:slug/tags and PUT /DELETE) ──
-
-/** Body accepted by `PUT` and `DELETE` `/v1/orgs/:slug/tags`. */
-export const OrgTagsBodySchema = z.object({
-  tags: z.array(z.string()),
-});
-
-/** Response shape returned by `PUT` and `DELETE` `/v1/orgs/:slug/tags`. */
-export const OrgTagsMutationResponseSchema = z.object({
-  ok: z.literal(true),
-});
-
-// ── POST /tags (global tag creation) ──
-
-/** Body accepted by `POST /v1/tags`. */
-export const CreateTagBodySchema = z.object({
-  name: z.string().min(1),
-});
-
-/** Row returned by `POST /v1/tags` (201 on create, 200 if already exists). */
-export const TagRowSchema = z.object({
-  id: z.string(),
-  name: z.string(),
-  slug: z.string(),
-  createdAt: z.string(),
-});
-
-// ── Org activity (/orgs/:slug/activity) ──
-
-const OrgActivityWeeklyBucketSchema = z.object({
-  weekStart: z.string(),
-  count: z.number().int().min(0),
-  earliestVersion: z.string().nullable(),
-  latestVersion: z.string().nullable(),
-});
-
-const OrgActivitySourceSchema = z.object({
-  slug: z.string(),
-  name: z.string(),
-  releaseCount: z.number().int().min(0),
-  avgReleasesPerWeek: z.number(),
-  earliestVersion: z.string().nullable(),
-  latestVersion: z.string().nullable(),
-  latestDate: z.string().nullable(),
-  weeklyBuckets: z.array(OrgActivityWeeklyBucketSchema),
-});
-
-/**
- * Response shape for `GET /v1/orgs/:slug/activity`. Returns per-source
- * weekly release buckets plus an aggregate rollup — used for timeline
- * visualization in the web org detail page.
- */
-export const OrgActivityResponseSchema = z.object({
-  org: z.object({ slug: z.string(), name: z.string() }),
-  range: z.object({ from: z.string(), to: z.string() }),
-  sources: z.array(OrgActivitySourceSchema),
-  aggregateWeekly: z.array(z.object({ weekStart: z.string(), count: z.number().int().min(0) })),
-});
-
-// ── Org heatmap (/orgs/:slug/heatmap) ──
-
-/**
- * Response shape for `GET /v1/orgs/:slug/heatmap`. Returns daily release
- * counts for the trailing 365 days — used for contribution-graph
- * visualization in the web org detail page.
- */
-export const OrgHeatmapResponseSchema = z.object({
-  org: z.object({ slug: z.string(), name: z.string() }),
-  range: z.object({ from: z.string(), to: z.string() }),
-  dailyCounts: z.array(z.object({ date: z.string(), count: z.number().int().min(0) })),
-  total: z.number().int().min(0),
-});
-
-// ── Org sparklines (/orgs/:slug/sparklines) ──
-
-const SparklineSourceSchema = z.object({
-  slug: z.string(),
-  name: z.string(),
-  sparkline: z.array(z.number().int().min(0)).length(30),
-});
-
-/**
- * Response shape for `GET /v1/orgs/:slug/sparklines`. Returns 30-day daily
- * release counts per source and per product, plus an aggregate rollup.
- */
-export const OrgSparklinesResponseSchema = z.object({
-  org: z.object({ slug: z.string(), name: z.string() }),
-  range: z.object({ from: z.string(), to: z.string() }),
-  aggregate: z.array(z.number().int().min(0)).length(30),
-  sources: z.array(SparklineSourceSchema),
-  products: z.array(SparklineSourceSchema),
-});
-
-// ── Org releases feed (/orgs/:slug/releases) ──
-
-/**
- * Release feed item on `GET /v1/orgs/:slug/releases`. Extends `ReleaseItem`
- * with a `source` block identifying the originating source within the org.
- */
-export const OrgReleaseItemSchema = ReleaseItemSchema.extend({
-  source: z.object({
-    slug: z.string(),
-    name: z.string(),
-    type: z.string(),
-    appStore: AppStoreSourceInfoSchema.optional(),
-    video: VideoSourceInfoSchema.optional(),
-  }),
-  /**
-   * Owning product, when the release's source is grouped under a product.
-   * `null` when the source has no `product_id`. Additive — older API responses
-   * omit this field; treat `undefined` as `null`. #1217.
-   */
-  product: z.object({ slug: z.string(), name: z.string() }).nullable().optional(),
-  /**
-   * Server-resolved grouping identity — `COALESCE(product.slug, source.slug)` /
-   * `COALESCE(product.name, source.name)`. The web releases feed keys and labels
-   * SDK/package-cluster rollups on these instead of reconstructing
-   * `product ?? source` client-side. Optional on the wire: older workers omit
-   * them, so clients must fall back to deriving from `product ?? source`. Never
-   * null when present (`source` is always set). #1234
-   */
-  groupSlug: z.string().optional(),
-  groupName: z.string().optional(),
-});
-
-/** Cursor pagination shape for the org releases feed. */
-export const OrgFeedPaginationSchema = z.object({
-  nextCursor: z.string().nullable(),
-  limit: z.number().int().min(1),
-});
-
-/**
- * Response shape for `GET /v1/orgs/:slug/releases`.
- * Cursor-paginated; `nextCursor` is `null` when this is the last page.
- */
-export const OrgReleasesFeedResponseSchema = z.object({
-  releases: z.array(OrgReleaseItemSchema),
-  pagination: OrgFeedPaginationSchema,
-});
-
-// ── Org recent releases (/orgs/:slug/recent-releases) ──
-
-/**
- * Row returned by `GET /v1/orgs/:slug/recent-releases`. This is the full
- * `releasesVisible` row with `sourceName` and `sourceSlug` joined from
- * `sourcesVisible` — intended for summarization / grouping by agents.
- * Many fields are nullable because they may not be populated at ingest time.
- */
-export const OrgRecentReleaseItemSchema = z.object({
-  id: z.string(),
-  sourceId: z.string(),
-  version: z.string().nullable(),
-  type: z.string().optional(),
-  title: z.string(),
-  content: z.string(),
-  summary: z.string().nullable(),
-  titleGenerated: z.string().nullable().optional(),
-  titleShort: z.string().nullable().optional(),
-  /**
-   * Machine-readable breaking-change level (#1696, surfaced on read paths in
-   * #1710). `.optional()` for mid-deploy tolerance; absent or `"unknown"`
-   * means not classified. List paths carry `breaking` only.
-   */
-  breaking: z.enum(BREAKING_LEVELS).optional(),
-  importance: ImportanceScoreSchema,
-  url: z.string().nullable(),
-  contentHash: z.string().nullable(),
-  metadata: z.string().nullable(),
-  media: z.string().nullable(),
-  publishedAt: z.string().nullable(),
-  suppressed: z.number().optional(),
-  suppressedReason: z.string().nullable().optional(),
-  fetchedAt: z.string().optional(),
-  embeddedAt: z.string().nullable().optional(),
-  sourceName: z.string(),
-  sourceSlug: z.string(),
-});
-
-export const OrgRecentReleasesResponseSchema = z.array(OrgRecentReleaseItemSchema);
-
-// ── Org accounts mutation responses ──
-
-/** Response returned by `DELETE /v1/orgs/:slug/accounts/:platform/:handle`. */
-export const DeleteOrgAccountResponseSchema = z.object({
-  deleted: z.literal(true),
-});
-
-export const OrgDetailSchema = z.object({
-  id: z.string().optional(),
-  slug: z.string(),
-  name: z.string(),
-  domain: z.string().nullable(),
-  description: z.string().nullable().optional(),
-  category: CategorySchema.nullable().optional(),
-  avatarUrl: z.string().nullable(),
-  /** Admin display flag: true when the org is hidden from listings (homepage + /v1/orgs). Optional on the wire for older workers mid-deploy. */
-  isHidden: z.boolean().optional(),
-  /** Admin display flag: org is opted into automatic overviews + per-release summaries. Optional on the wire for older workers mid-deploy. */
-  autoGenerateContent: z.boolean().optional(),
-  /** Manual overview-regen cadence override in days (#1895); null = automatic velocity tier. Optional on the wire for older workers mid-deploy. */
-  overviewCadenceDays: z.number().int().nullable().optional(),
-  /** Admin display flag: org is promoted on the home-page featured rail. Optional on the wire for older workers mid-deploy. */
-  featured: z.boolean().optional(),
-  /** Admin display flag: all ingest paused for this org. */
-  fetchPaused: z.boolean().optional(),
-  /** How the org row was created. `on_demand` orgs are excluded from overview generation regardless of `autoGenerateContent`. */
-  discovery: z.enum(["curated", "agent", "on_demand"]).optional(),
-  /**
-   * Org tier (#1947). Optional for mid-deploy tolerance; absent ⇒ `"tracked"`.
-   * A `"stub"` org's `sources` array is empty — `locations` carries the declared
-   * release locations instead.
-   */
-  status: OrgStatusSchema.optional(),
-  /**
-   * Declared release locations (#1947), present (and non-empty) for stub orgs.
-   * Same shape as a releases.json `releases[]` entry plus `basis`/`sourceId`.
-   * Omitted or empty for a tracked org with no locators.
-   */
-  locations: z.array(ReleaseLocationItemSchema).optional(),
-  tags: z.array(z.string()).optional(),
-  sourceCount: z.number().int().min(0),
-  releaseCount: z.number().int().min(0),
-  releasesLast30Days: z.number().int().min(0),
-  avgReleasesPerWeek: z.number(),
-  lastFetchedAt: z.string().nullable(),
-  lastPolledAt: z.string().nullable(),
-  trackingSince: z.string(),
-  aliases: z.array(z.string()).optional(),
-  accounts: z.array(OrgAccountItemSchema),
-  products: z.array(OrgDetailProductSchema),
-  sources: z.array(SourceListItemSchema),
-  overview: OverviewPageItemSchema.nullable().optional(),
-  playbook: OrgDetailPlaybookSchema.nullable().optional(),
-  notice: NoticeSchema.nullable().optional(),
-});

package/src/schemas/recommendations.ts

@@ -1,39 +0,0 @@
-import { z } from "zod";
-
-/**
- * `POST /v1/admin/recommendations/:id/notify-added` body.
- *
- * Resolves a live registry listing (org required, source optional) and
- * emails the submitter's `contactEmail` that their suggestion was added.
- * Opt-in only — triage / close / archive never send this.
- */
-export const RecommendationNotifyAddedBodySchema = z.object({
-  orgSlug: z
-    .string()
-    .min(1)
-    .describe(
-      "Org slug or `org_…` id of the onboarded listing. Required so the email can link a live registry URL.",
-    ),
-  sourceSlug: z
-    .string()
-    .min(1)
-    .optional()
-    .describe(
-      "Optional source slug or `src_…` id under that org. When set, the email links the source page.",
-    ),
-});
-
-/**
- * `POST /v1/admin/recommendations/:id/notify-added` success body.
- *
- * `sent: false` + `reason: "already_notified"` is the idempotent replay —
- * a second call does not email again.
- */
-export const RecommendationNotifyAddedResultSchema = z.object({
-  ok: z.literal(true),
-  sent: z.boolean(),
-  reason: z.enum(["already_notified"]).optional(),
-  notifiedAt: z.number().nullable(),
-  registryUrl: z.string().optional(),
-  contactEmail: z.string().optional(),
-});

package/src/schemas/related.ts

@@ -1,126 +0,0 @@
-import { z } from "zod";
-import { AppStoreSourceInfoSchema, ImportanceScoreSchema } from "./shared.js";
-
-/**
- * Anchor scope for related-* lookups. `org` filters the Vectorize query by
- * the anchor's org id; `global` (default) runs unscoped.
- */
-export const RelatedScopeSchema = z.enum(["org", "global"]);
-
-/** Thumbnail picked from the release's first image-like media entry. */
-export const RelatedReleaseThumbnailSchema = z.object({
-  url: z.string(),
-  alt: z.string().optional(),
-});
-
-/** Owning source rollup attached to each related-release row. */
-export const RelatedReleaseSourceSchema = z.object({
-  id: z.string(),
-  slug: z.string(),
-  name: z.string(),
-  /** Parent product name, when the source belongs to one — preferred over the
-   * bare source/feed name for display. Null for sources with no product. */
-  productName: z.string().nullable(),
-  orgSlug: z.string().nullable(),
-  orgName: z.string().nullable(),
-  orgAvatarUrl: z.string().nullable(),
-  /**
-   * App Store platform + icon, present only for `appstore` sources (resolved
-   * server-side, same block the org/product/ticker read paths already carry).
-   * Its presence is the signal the related rail uses to render the lean
-   * mobile-app card (app icon + "iOS/macOS" cue) instead of the standard
-   * headline/thumbnail. Additive/optional for mid-deploy pin tolerance.
-   * #mobile-app-release-cards
-   */
-  appStore: AppStoreSourceInfoSchema.optional(),
-});
-
-/**
- * One neighbor returned by `GET /v1/related/releases`. `score` is the
- * Vectorize cosine similarity from the underlying query.
- */
-export const RelatedReleaseItemSchema = z.object({
-  id: z.string(),
-  title: z.string(),
-  version: z.string().nullable(),
-  url: z.string().nullable(),
-  publishedAt: z.string().nullable(),
-  summary: z.string(),
-  titleGenerated: z.string().nullable(),
-  titleShort: z.string().nullable(),
-  /**
-   * AI-scored importance 1–5 (5=landmark, 1=housekeeping). Null when
-   * unscored; optional for older servers / mid-deploy pin tolerance.
-   */
-  importance: ImportanceScoreSchema,
-  thumbnail: RelatedReleaseThumbnailSchema.nullable(),
-  score: z.number(),
-  source: RelatedReleaseSourceSchema,
-});
-
-/**
- * One neighbor returned by `GET /v1/related/sources`. Carries enough
- * source + org + recent-release stats for the rail card to render without
- * a follow-up request.
- */
-export const RelatedSourceItemSchema = z.object({
-  id: z.string(),
-  slug: z.string(),
-  name: z.string(),
-  type: z.string(),
-  url: z.string().nullable(),
-  score: z.number(),
-  orgSlug: z.string().nullable(),
-  orgName: z.string().nullable(),
-  orgAvatarUrl: z.string().nullable(),
-  releaseCount: z.number().int().min(0),
-  latestDate: z.string().nullable(),
-  latestTitle: z.string().nullable(),
-  latestVersion: z.string().nullable(),
-  /** Total releases published in the last 30 days (includes the latest). */
-  recentCount: z.number().int().min(0),
-});
-
-/**
- * Successful response from `GET /v1/related/releases`. The handler returns
- * `{scope, items}` when Vectorize is reachable and the anchor has a vector.
- */
-export const RelatedReleasesOkResponseSchema = z.object({
-  scope: RelatedScopeSchema,
-  items: z.array(RelatedReleaseItemSchema),
-});
-
-/**
- * Degraded response from `GET /v1/related/releases`. Returned (HTTP 200) when
- * Vectorize bindings are missing, the anchor hasn't been embedded yet, or a
- * downstream call errored. Callers render nothing in this case rather than
- * surfacing a hard failure. `degradedReason` is human-readable, not stable.
- */
-export const RelatedReleasesDegradedResponseSchema = z.object({
-  degraded: z.literal(true),
-  degradedReason: z.string(),
-  items: z.array(RelatedReleaseItemSchema),
-});
-
-export const RelatedReleasesResponseSchema = z.union([
-  RelatedReleasesOkResponseSchema,
-  RelatedReleasesDegradedResponseSchema,
-]);
-
-/** Successful response from `GET /v1/related/sources`. */
-export const RelatedSourcesOkResponseSchema = z.object({
-  scope: RelatedScopeSchema,
-  items: z.array(RelatedSourceItemSchema),
-});
-
-/** Degraded response from `GET /v1/related/sources`. Same semantics as the releases variant. */
-export const RelatedSourcesDegradedResponseSchema = z.object({
-  degraded: z.literal(true),
-  degradedReason: z.string(),
-  items: z.array(RelatedSourceItemSchema),
-});
-
-export const RelatedSourcesResponseSchema = z.union([
-  RelatedSourcesOkResponseSchema,
-  RelatedSourcesDegradedResponseSchema,
-]);