@buildinternet/releases-api-types 0.19.0 → 0.20.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buildinternet/releases-api-types",
-  "version": "0.19.0",
+  "version": "0.20.0",
   "description": "Wire protocol — request/response types for the Releases registry API. Shared by web, workers, and clients.",
   "type": "module",
   "license": "MIT",
@@ -18,7 +18,7 @@
   ],
   "dependencies": {
     "@buildinternet/releases-core": "^0.21.0",
-    "zod": "^4.3.6"
+    "zod": "^4.4.3"
   },
   "publishConfig": {
     "access": "public"

package/src/api-types.ts

@@ -16,6 +16,7 @@ import type {
   StatsSchema,
   ErrorResponseSchema,
   ReleaseTypeSchema,
+  ReleaseCompositionSchema,
   ReleaseItemSchema,
   ReleaseSummaryItemSchema,
   OverviewPageItemSchema,
@@ -222,6 +223,7 @@ export {
   StatsSchema,
   ErrorResponseSchema,
   ReleaseTypeSchema,
+  ReleaseCompositionSchema,
   ReleaseItemSchema,
   ReleaseSummaryItemSchema,
   OverviewPageItemSchema,
@@ -571,6 +573,7 @@ export interface OrgsRollupResponse extends ListResponse<OrgsRollupRow> {
 export type ReleaseType = z.infer<typeof ReleaseTypeSchema>;
 
 export type ReleaseItem = z.infer<typeof ReleaseItemSchema>;
+export type ReleaseComposition = z.infer<typeof ReleaseCompositionSchema>;
 
 export interface ReleaseDetail {
   id: string;
@@ -599,6 +602,8 @@ export interface ReleaseDetail {
   org: { slug: string; name: string } | null;
   /** Release type. See {@link ReleaseType}. */
   type?: ReleaseType;
+  /** Per-category item counts from the AI release-content pass. See {@link ReleaseComposition}. */
+  composition?: ReleaseComposition | null;
 }
 
 export type ReleaseCoverageRow = z.infer<typeof ReleaseCoverageRowSchema>;

package/src/schemas/orgs.ts

@@ -78,6 +78,8 @@ export const UpdateOrgBodySchema = z.object({
   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(),
 });
 
 // Org detail's products query selects a strict subset of `ProductListItem` —

package/src/schemas/releases.ts

@@ -1,6 +1,9 @@
 import { z } from "zod";
 import { SOURCE_TYPES } from "@buildinternet/releases-core/source-enums";
-import { MediaItemSchema, ReleaseTypeSchema } from "./shared.js";
+import { MediaItemSchema, ReleaseCompositionSchema, ReleaseTypeSchema } from "./shared.js";
+
+// ReleaseCompositionSchema lives in ./shared.js (single source of truth) — both
+// this file and ReleaseItemSchema reference it from there.
 
 /**
  * Per-row shape returned by `GET /v1/releases/latest`. Distinct from the
@@ -36,6 +39,7 @@ export const ReleaseLatestItemSchema = z.object({
   // same fields on the org / collection feeds. #958.
   contentChars: z.number().int().min(0).nullable().optional(),
   contentTokens: z.number().int().min(0).nullable().optional(),
+  composition: ReleaseCompositionSchema.nullable().optional(),
 });
 
 export const ReleaseLatestResponseSchema = z.object({
@@ -155,6 +159,7 @@ export const ReleaseDetailResponseSchema = z.object({
   sourceSlug: z.string().nullable(),
   sourceType: z.enum(SOURCE_TYPES).nullable(),
   org: ReleaseDetailOrgSchema.nullable(),
+  composition: ReleaseCompositionSchema.nullable(),
 });
 
 /**
@@ -177,6 +182,8 @@ export const UpdateReleaseBodySchema = z
     summary: z.string().nullable().optional(),
     titleGenerated: z.string().nullable().optional(),
     titleShort: z.string().nullable().optional(),
+    // `null` removes `$.composition` from metadata; an object replaces it.
+    composition: ReleaseCompositionSchema.nullable().optional(),
   })
   .strict();
 

package/src/schemas/shared.ts

@@ -46,6 +46,19 @@ export const StatsSchema = z.object({
 
 export const ReleaseTypeSchema = z.enum(RELEASE_TYPES);
 
+/**
+ * Per-category item counts produced by the AI release-content pass and
+ * persisted on `releases.metadata.composition`. Surfaces as a chip on the
+ * release detail UI ("12 fixes · 3 features"); `null` when the row hasn't
+ * been through the AI pass yet, the body was empty/boilerplate, or all
+ * three counts came back zero (we filter that case out on the parse side).
+ */
+export const ReleaseCompositionSchema = z.object({
+  bugs: z.number().int().min(0),
+  features: z.number().int().min(0),
+  enhancements: z.number().int().min(0),
+});
+
 export const ReleaseItemSchema = z.object({
   id: z.string().optional(),
   version: z.string().nullable(),
@@ -89,6 +102,10 @@ export const ReleaseItemSchema = z.object({
   // when null. See #958.
   contentChars: z.number().int().min(0).nullable().optional(),
   contentTokens: z.number().int().min(0).nullable().optional(),
+  // Per-category item counts produced by the AI release-content pass and
+  // stored on `releases.metadata.composition`. `null`/`undefined` when the
+  // row hasn't been through the AI pass yet or the body was boilerplate.
+  composition: ReleaseCompositionSchema.nullable().optional(),
 });
 
 export const ReleaseSummaryItemSchema = z.object({