@buildinternet/releases-api-types 0.53.0 → 0.55.0

package/README.md

@@ -1,5 +1,7 @@
 # @buildinternet/releases-api-types
 
+**Scope:** request/response wire types for the public API worker — types only, zero runtime dependencies. No request logic, no client code, no server handlers.
+
 Wire protocol types for the [Releases](https://releases.sh) registry API.
 
 Pure TypeScript types — zero runtime dependencies — describing request/response

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buildinternet/releases-api-types",
-  "version": "0.53.0",
+  "version": "0.55.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.31.0",
+    "@buildinternet/releases-core": "^0.31.1",
     "zod": "^4.4.3"
   },
   "publishConfig": {

package/src/api-types.ts

@@ -275,6 +275,7 @@ import type {
   CollectionWeeklyDigestListItemSchema,
   CollectionWeeklyDigestsResponseSchema,
   DigestCoveredReleaseSchema,
+  DigestSectionSchema,
   CollectionWeeklyDigestDetailSchema,
 } from "./schemas/collections.js";
 import type {
@@ -625,6 +626,7 @@ export {
   CollectionWeeklyDigestListItemSchema,
   CollectionWeeklyDigestsResponseSchema,
   DigestCoveredReleaseSchema,
+  DigestSectionSchema,
   CollectionWeeklyDigestDetailSchema,
 } from "./schemas/collections.js";
 export {
@@ -1768,7 +1770,7 @@ export type TagDetail = z.infer<typeof TagDetailSchema>;
 /**
  * Aggregated release feed row for a category rollup — same wire shape as
  * `CollectionReleaseItem` (both surfaces use `formatAggregateReleaseRow` in
- * `workers/api/src/utils.ts`). Aliased rather than duplicated so renderers
+ * `apps/api/src/utils.ts`). Aliased rather than duplicated so renderers
  * can treat them as one.
  */
 export type CategoryReleaseItem = CollectionReleaseItem;
@@ -1806,6 +1808,7 @@ export type CollectionDailySummariesResponse = z.infer<
 export type CollectionWeeklyDigestListItem = z.infer<typeof CollectionWeeklyDigestListItemSchema>;
 export type CollectionWeeklyDigestsResponse = z.infer<typeof CollectionWeeklyDigestsResponseSchema>;
 export type DigestCoveredRelease = z.infer<typeof DigestCoveredReleaseSchema>;
+export type DigestSection = z.infer<typeof DigestSectionSchema>;
 export type CollectionWeeklyDigestDetail = z.infer<typeof CollectionWeeklyDigestDetailSchema>;
 
 // ── Releases (enriched) ──

package/src/schemas/collections.ts

@@ -273,8 +273,18 @@ export const CollectionWeeklyDigestsResponseSchema = z.object({
 export const DigestCoveredReleaseSchema = z.object({
   id: z.string(),
   title: z.string(),
+  /** Internal `/release/*` path — fallback link only (see `url`). */
   path: z.string(),
-  org: z.object({ slug: z.string(), name: z.string() }),
+  /** Upstream source URL. Primary link target when http(s); optional for older servers. */
+  url: z.string().nullable().optional(),
+  org: z.object({
+    slug: z.string(),
+    name: z.string(),
+    avatarUrl: z.string().nullable().optional(),
+    githubHandle: z.string().nullable().optional(),
+  }),
+  /** Product the release's source belongs to, when it has one. */
+  product: z.object({ slug: z.string(), name: z.string() }).nullable().optional(),
   /**
    * AI-scored importance 1–5. Null when unscored; optional for older
    * servers. Cheap to project on the existing hydrate — powers the flame
@@ -283,7 +293,25 @@ export const DigestCoveredReleaseSchema = z.object({
   importance: ImportanceScoreSchema,
 });
 
-/** Full row returned by `GET /v1/collections/:slug/digests/:weekStart`. */
+/** One `###` section of a digest body, parsed server-side. */
+export const DigestSectionSchema = z.object({
+  heading: z.string(),
+  /** Slug the digest page renders as the heading's `id` — link target `#anchor`. */
+  anchor: z.string(),
+  /** First sentence of the section, plain text. */
+  lede: z.string(),
+  /** Cited release ids in first-seen order; resolve against the detail's `releases`. */
+  releaseIds: z.array(z.string()),
+  /**
+   * The section's cited releases, resolved server-side in `releaseIds` order.
+   * Ids that no longer resolve are dropped, so `releases.length` can be less
+   * than `releaseIds.length`. Optional for older servers.
+   */
+  releases: z.array(DigestCoveredReleaseSchema).optional(),
+});
+
+/** Full row returned by `GET /v1/collections/:slug/digests/:weekStart` and
+ *  `GET /v1/collections/:slug/digests/latest`. */
 export const CollectionWeeklyDigestDetailSchema = z.object({
   id: z.string(),
   weekStart: z.string(),
@@ -297,4 +325,6 @@ export const CollectionWeeklyDigestDetailSchema = z.object({
    *  still resolves — a release deleted/suppressed after generation is
    *  dropped rather than surfaced as a dead link. */
   releases: z.array(DigestCoveredReleaseSchema),
+  /** Parsed `###` sections. Optional for older servers. */
+  sections: z.array(DigestSectionSchema).optional(),
 });

package/src/schemas/search.ts

@@ -110,6 +110,14 @@ export const SearchReleaseHitSchema = z.object({
   summary: z.string(),
   titleGenerated: z.string().nullable().optional(),
   titleShort: z.string().nullable().optional(),
+  /**
+   * The release's upstream source URL, when it has one. Lets the web link
+   * search/lookup hits straight to the original page instead of the
+   * noindexed `/release/<id>` stub — see `releaseLinkProps()` in
+   * `apps/web/src/lib/release-link.ts`. Optional for older servers / mid-deploy
+   * pin tolerance.
+   */
+  url: z.string().nullable().optional(),
   /**
    * AI-scored importance 1–5 (5=landmark, 1=housekeeping). Null when
    * unscored; optional for older servers / mid-deploy pin tolerance.
@@ -213,6 +221,9 @@ export const LookupResultPayloadSchema = z.object({
         publishedAt: z.string().nullable(),
         /** First image/gif thumbnail; null when the release has none. */
         thumbnail: ReleaseThumbnailSchema.nullable().optional(),
+        /** The release's upstream source URL, when it has one. See
+         *  `SearchReleaseHitSchema.url`. */
+        url: z.string().nullable().optional(),
       }),
     )
     .optional(),

package/src/schemas/shared.ts

@@ -206,8 +206,9 @@ export const OverviewCitationSchema = z.object({
   releaseId: z.string().nullable().optional(),
   /**
    * Canonical web URL of the on-registry release page for this source, when
-   * `releaseId` resolved (#1934). The Sources footer links here (internal,
-   * crawlable) in preference to the external `sourceUrl`.
+   * `releaseId` resolved (#1934). Kept for machine consumers; the web Sources
+   * footer links `sourceUrl` (the #2218 link policy — `/release/*` pages are
+   * noindexed).
    */
   releaseWebUrl: z.string().nullable().optional(),
   /**

package/src/schemas/taxonomy.ts

@@ -95,7 +95,7 @@ export const UpdateCategoryResponseSchema = z.object({
 /**
  * Aggregated release row on `GET /v1/categories/:slug/releases`. Same wire
  * shape as `CollectionReleaseItem` — both surfaces aggregate across orgs and
- * use `formatAggregateReleaseRow` in `workers/api/src/utils.ts` for the
+ * 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.
  */