@buildinternet/releases-api-types 0.46.0 → 0.48.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buildinternet/releases-api-types",
-  "version": "0.46.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",
@@ -17,7 +17,7 @@
     "README.md"
   ],
   "dependencies": {
-    "@buildinternet/releases-core": "^0.27.0",
+    "@buildinternet/releases-core": "^0.28.0",
     "zod": "^4.4.3"
   },
   "publishConfig": {

package/src/api-types.ts

@@ -203,7 +203,12 @@ import type {
   FeedbackUpdateBodySchema,
   FeedbackDeleteResponseSchema,
 } from "./schemas/feedback.js";
-import type { SitemapSourceSchema, SitemapPayloadSchema } from "./schemas/sitemap.js";
+import type {
+  SitemapSourceSchema,
+  SitemapPayloadSchema,
+  SitemapReleaseSchema,
+  SitemapReleasesPayloadSchema,
+} from "./schemas/sitemap.js";
 import type {
   RelatedScopeSchema,
   RelatedReleaseThumbnailSchema,
@@ -239,6 +244,10 @@ import type {
   AddCollectionMemberResponseSchema,
   CollectionDailySummarySchema,
   CollectionDailySummariesResponseSchema,
+  CollectionWeeklyDigestListItemSchema,
+  CollectionWeeklyDigestsResponseSchema,
+  DigestCoveredReleaseSchema,
+  CollectionWeeklyDigestDetailSchema,
 } from "./schemas/collections.js";
 import type {
   OrgOverviewResponseSchema,
@@ -510,7 +519,12 @@ export {
   FeedbackUpdateBodySchema,
   FeedbackDeleteResponseSchema,
 } from "./schemas/feedback.js";
-export { SitemapSourceSchema, SitemapPayloadSchema } from "./schemas/sitemap.js";
+export {
+  SitemapSourceSchema,
+  SitemapPayloadSchema,
+  SitemapReleaseSchema,
+  SitemapReleasesPayloadSchema,
+} from "./schemas/sitemap.js";
 export { errorEnvelopeSchema, decodeApiError, isApiError } from "./schemas/errors.js";
 export type { ErrorEnvelope, DecodedApiError } from "./schemas/errors.js";
 export {
@@ -548,6 +562,10 @@ export {
   AddCollectionMemberResponseSchema,
   CollectionDailySummarySchema,
   CollectionDailySummariesResponseSchema,
+  CollectionWeeklyDigestListItemSchema,
+  CollectionWeeklyDigestsResponseSchema,
+  DigestCoveredReleaseSchema,
+  CollectionWeeklyDigestDetailSchema,
 } from "./schemas/collections.js";
 export {
   OrgOverviewResponseSchema,
@@ -623,6 +641,8 @@ export interface CreateUserApiKeyBody {
 
 export type SitemapSource = z.infer<typeof SitemapSourceSchema>;
 export type SitemapPayload = z.infer<typeof SitemapPayloadSchema>;
+export type SitemapRelease = z.infer<typeof SitemapReleaseSchema>;
+export type SitemapReleasesPayload = z.infer<typeof SitemapReleasesPayloadSchema>;
 
 // ── Related (Vectorize neighbors) ──
 
@@ -1527,6 +1547,10 @@ export type CollectionDailySummary = z.infer<typeof CollectionDailySummarySchema
 export type CollectionDailySummariesResponse = z.infer<
   typeof CollectionDailySummariesResponseSchema
 >;
+export type CollectionWeeklyDigestListItem = z.infer<typeof CollectionWeeklyDigestListItemSchema>;
+export type CollectionWeeklyDigestsResponse = z.infer<typeof CollectionWeeklyDigestsResponseSchema>;
+export type DigestCoveredRelease = z.infer<typeof DigestCoveredReleaseSchema>;
+export type CollectionWeeklyDigestDetail = z.infer<typeof CollectionWeeklyDigestDetailSchema>;
 
 // ── Releases (enriched) ──
 

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.
@@ -249,3 +249,52 @@ export const CollectionDailySummarySchema = z.object({
 export const CollectionDailySummariesResponseSchema = z.object({
   summaries: z.array(CollectionDailySummarySchema),
 });
+
+// ── Weekly digests ────────────────────────────────────────────────
+
+/** List row on `GET /v1/collections/:slug/digests` — newest-first, no body. */
+export const CollectionWeeklyDigestListItemSchema = z.object({
+  id: z.string(),
+  /** ET Monday starting the covered week, YYYY-MM-DD. */
+  weekStart: z.string(),
+  title: z.string(),
+  intro: z.string(),
+  releaseCount: z.number().int().nonnegative(),
+  generatedAt: z.string(),
+});
+
+/** Cursor pagination shape matches the other paginated list surfaces. */
+export const CollectionWeeklyDigestsResponseSchema = z.object({
+  digests: z.array(CollectionWeeklyDigestListItemSchema),
+  pagination: CollectionFeedPaginationSchema,
+});
+
+/** Minimal, server-resolved release info for a digest's "Releases covered" list. */
+export const DigestCoveredReleaseSchema = z.object({
+  id: z.string(),
+  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`. */
+export const CollectionWeeklyDigestDetailSchema = z.object({
+  id: z.string(),
+  weekStart: z.string(),
+  title: z.string(),
+  intro: z.string(),
+  body: z.string(),
+  releaseIds: z.array(z.string()),
+  releaseCount: z.number().int().nonnegative(),
+  generatedAt: z.string(),
+  /** Server-resolved minimal release info for every id in `releaseIds` that
+   *  still resolves — a release deleted/suppressed after generation is
+   *  dropped rather than surfaced as a dead link. */
+  releases: z.array(DigestCoveredReleaseSchema),
+});

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`

package/src/schemas/sitemap.ts

@@ -39,4 +39,42 @@ export const SitemapPayloadSchema = z.object({
   sources: z.array(SitemapSourceSchema),
   products: z.array(z.object({ orgSlug: z.string(), slug: z.string() })),
   collections: z.array(z.object({ slug: z.string(), updatedAt: z.string() })),
+  /**
+   * Weekly collection digest permalinks (`/collections/:slug/digest/:week`),
+   * with `generatedAt` driving `<lastmod>`. `.optional()` for backwards
+   * compatibility with older cached responses. Small at 12 collections × 52
+   * weeks/year, so no dedicated `/sitemap/digests` surface (unlike releases).
+   */
+  digests: z
+    .array(
+      z.object({
+        collectionSlug: z.string(),
+        weekStart: z.string(),
+        generatedAt: z.string(),
+      }),
+    )
+    .optional(),
+});
+
+/**
+ * Per-release row in `GET /v1/sitemap/releases` (#1181, scoped down). Carries
+ * exactly what the web needs to build the slugged canonical `/release/...`
+ * URL (`releasePath()` inputs) plus `fetchedAt` for `<lastmod>`.
+ */
+export const SitemapReleaseSchema = z.object({
+  id: z.string(),
+  title: z.string(),
+  titleShort: z.string().nullable(),
+  titleGenerated: z.string().nullable(),
+  version: z.string().nullable(),
+  publishedAt: z.string().nullable(),
+  fetchedAt: z.string(),
+});
+
+/**
+ * Payload for the curated release sitemap: visible releases with a summary
+ * and importance at or above the experiment threshold, newest first, capped.
+ */
+export const SitemapReleasesPayloadSchema = z.object({
+  releases: z.array(SitemapReleaseSchema),
 });