@buildinternet/releases-api-types 0.47.0 → 0.48.0

package/package.json

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

package/src/schemas/collections.ts

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { ReleaseItemSchema } from "./shared.js";
+import { ImportanceScoreSchema, ReleaseItemSchema } from "./shared.js";
 
 /**
  * One org as it appears inside a collection's preview list or detail page.
@@ -275,6 +275,12 @@ export const DigestCoveredReleaseSchema = z.object({
   title: z.string(),
   path: z.string(),
   org: z.object({ slug: z.string(), name: z.string() }),
+  /**
+   * AI-scored importance 1–5. Null when unscored; optional for older
+   * servers. Cheap to project on the existing hydrate — powers the flame
+   * marker on the collapsed "Releases covered" list.
+   */
+  importance: ImportanceScoreSchema,
 });
 
 /** Full row returned by `GET /v1/collections/:slug/digests/:weekStart`. */

package/src/schemas/related.ts

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import { ImportanceScoreSchema } from "./shared.js";
 
 /**
  * Anchor scope for related-* lookups. `org` filters the Vectorize query by
@@ -38,6 +39,11 @@ export const RelatedReleaseItemSchema = z.object({
   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,

package/src/schemas/search.ts

@@ -2,6 +2,7 @@ import { z } from "zod";
 import { KIND_VALUES } from "@buildinternet/releases-core/kinds";
 import {
   AppStoreSourceInfoSchema,
+  ImportanceScoreSchema,
   MediaItemSchema,
   OrgStatusSchema,
   ReleaseThumbnailSchema,
@@ -109,6 +110,11 @@ export const SearchReleaseHitSchema = z.object({
   summary: z.string(),
   titleGenerated: z.string().nullable().optional(),
   titleShort: z.string().nullable().optional(),
+  /**
+   * AI-scored importance 1–5 (5=landmark, 1=housekeeping). Null when
+   * unscored; optional for older servers / mid-deploy pin tolerance.
+   */
+  importance: ImportanceScoreSchema,
   /**
    * Full markdown body. Omitted on list hits by default (summary + media
    * cover the card/snippet surfaces). Opt in with `?include_content=true`