@buildinternet/releases-api-types 0.11.0 → 0.13.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buildinternet/releases-api-types",
-  "version": "0.11.0",
+  "version": "0.13.0",
   "description": "Wire protocol — request/response types for the Releases registry API. Shared by web, workers, and clients.",
   "type": "module",
   "license": "MIT",

package/src/api-types.ts

@@ -208,7 +208,23 @@ export interface ReleaseDetail {
   version: string | null;
   title: string;
   content: string;
+  /** AI-generated summary (#852, renamed in #860). Nullable — most rows unpopulated. */
+  summary: string | null;
+  /**
+   * AI-generated self-contained news-headline form of the release (#852,
+   * renamed in #860). Nullable because most rows are unpopulated — fall
+   * back to `title` for display. `.optional()` for the same mid-deploy /
+   * pinned-worker reason as `type` on {@link ReleaseItem}.
+   */
+  titleGenerated?: string | null;
+  /** AI-generated smart-brevity headline (#852, renamed in #860). Same fallback as `titleGenerated`. */
+  titleShort?: string | null;
+  /** @deprecated Use `summary`. Kept as an alias populated with the same value. */
   contentSummary: string | null;
+  /** @deprecated Use `titleGenerated`. Kept as an alias populated with the same value. */
+  contentTitle?: string | null;
+  /** @deprecated Use `titleShort`. Kept as an alias populated with the same value. */
+  contentTitleShort?: string | null;
   url: string | null;
   media: MediaItem[];
   publishedAt: string | null;
@@ -334,6 +350,16 @@ export interface SearchReleaseHit {
   version: string | null;
   title: string;
   summary: string;
+  /** AI-generated headline (#852, renamed in #860). Optional + nullable: most rows are unpopulated. */
+  titleGenerated?: string | null;
+  /** AI-generated smart-brevity headline (#852, renamed in #860). Same caveat as titleGenerated. */
+  titleShort?: string | null;
+  /** @deprecated Use `titleGenerated`. Kept as an alias populated with the same value. */
+  contentTitle?: string | null;
+  /** @deprecated Use `titleShort`. Kept as an alias populated with the same value. */
+  contentTitleShort?: string | null;
+  /** @deprecated Use `summary`. Kept as an alias populated with the same value. */
+  contentSummary?: string;
   /**
    * Full release body, media URLs hydrated through the MEDIA_ORIGIN proxy.
    * Present so the web can render the same markdown + thumbnail treatment
@@ -785,7 +811,18 @@ export interface ReleaseWithSource {
   version: string | null;
   title: string;
   content: string;
+  /** AI-generated summary (#852, renamed in #860). Nullable — most rows unpopulated. */
+  summary: string | null;
+  /** AI-generated headline (#852, renamed in #860). See {@link ReleaseDetail.titleGenerated}. */
+  titleGenerated?: string | null;
+  /** AI-generated smart-brevity headline (#852, renamed in #860). */
+  titleShort?: string | null;
+  /** @deprecated Use `summary`. Kept as an alias populated with the same value. */
   contentSummary: string | null;
+  /** @deprecated Use `titleGenerated`. Kept as an alias populated with the same value. */
+  contentTitle?: string | null;
+  /** @deprecated Use `titleShort`. Kept as an alias populated with the same value. */
+  contentTitleShort?: string | null;
   url: string | null;
   contentHash: string | null;
   metadata: string | null;
@@ -804,7 +841,18 @@ export interface LatestRelease {
   publishedAt: string | null;
   sourceName: string;
   sourceSlug: string;
+  /** AI-generated summary (#852, renamed in #860). Nullable — most rows unpopulated. */
+  summary: string | null;
+  /** AI-generated headline (#852, renamed in #860). See {@link ReleaseDetail.titleGenerated}. */
+  titleGenerated?: string | null;
+  /** AI-generated smart-brevity headline (#852, renamed in #860). */
+  titleShort?: string | null;
+  /** @deprecated Use `summary`. Kept as an alias populated with the same value. */
   contentSummary: string | null;
+  /** @deprecated Use `titleGenerated`. Kept as an alias populated with the same value. */
+  contentTitle?: string | null;
+  /** @deprecated Use `titleShort`. Kept as an alias populated with the same value. */
+  contentTitleShort?: string | null;
   media: MediaItem[];
 }
 

package/src/schemas/shared.ts

@@ -57,6 +57,18 @@ export const ReleaseItemSchema = z.object({
   // fall back to a SemVer-prerelease regex. `.optional()` for the same
   // older-response degrade-gracefully reason as `type`.
   prerelease: z.boolean().optional(),
+  // AI-generated headline forms paired with `summary` (#852, renamed in #860).
+  // Both nullable — most rows in the DB have neither populated, and we don't
+  // plan to backfill, so consumers must fall back to `title` for display.
+  // `.optional()` for the same mid-deploy / pinned-worker reason as `type`.
+  titleGenerated: z.string().nullable().optional(),
+  titleShort: z.string().nullable().optional(),
+  /** @deprecated Use `titleGenerated`. Kept as an alias populated with the same value. */
+  contentTitle: z.string().nullable().optional(),
+  /** @deprecated Use `titleShort`. Kept as an alias populated with the same value. */
+  contentTitleShort: z.string().nullable().optional(),
+  /** @deprecated Use `summary`. Kept as an alias populated with the same value. */
+  contentSummary: z.string().nullable().optional(),
 });
 
 export const ReleaseSummaryItemSchema = z.object({