@buildinternet/releases-api-types 0.31.0 → 0.32.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buildinternet/releases-api-types",
-  "version": "0.31.0",
+  "version": "0.32.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

@@ -748,7 +748,16 @@ export interface ReleaseDetail {
   sourceName: string;
   sourceSlug: string;
   sourceType: string;
-  org: { slug: string; name: string } | null;
+  /**
+   * Owning org. `avatarUrl` is the resolved `organizations.avatar_url`
+   * (nullable; `.optional()` for mid-deploy / pinned-worker tolerance).
+   */
+  org: { slug: string; name: string; avatarUrl?: string | null } | null;
+  /**
+   * Owning product, when the source is grouped under one (`sources.product_id`).
+   * `null` when ungrouped; `.optional()` so older servers that omit it still type.
+   */
+  product?: { 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}. */
@@ -786,6 +795,46 @@ export type ReleaseStreamMessage = z.infer<typeof ReleaseStreamMessageSchema>;
 
 export type ReleaseSummaryItem = z.infer<typeof ReleaseSummaryItemSchema>;
 
+// ── Follows ──
+
+/** What a user can follow. */
+export type FollowTarget = "org" | "product";
+
+/** A user's follow, enriched for rendering (returned by GET /v1/me/follows). */
+export interface Follow {
+  targetType: FollowTarget;
+  targetId: string;
+  name: string;
+  slug: string;
+  avatarUrl: string | null;
+  /** Owning org slug for product follows (null for org follows). */
+  orgSlug: string | null;
+  createdAt: string;
+}
+
+/** GET /v1/me/follows response. */
+export interface FollowsListResponse {
+  follows: Follow[];
+}
+
+/** POST /v1/me/follows request body. */
+export interface FollowRequest {
+  targetType: FollowTarget;
+  targetId: string;
+}
+
+/** POST/DELETE /v1/me/follows response. */
+export interface FollowMutationResponse {
+  success: true;
+  following: boolean;
+}
+
+/**
+ * GET /v1/me/feed response — the personalized release feed. Reuses the same item
+ * shape as /v1/releases/latest (ReleaseLatestItem) inside the standard list envelope.
+ */
+export type PersonalizedFeedResponse = ListResponse<ReleaseLatestItem>;
+
 // ── Search ──
 
 export type SearchOrgHit = z.infer<typeof SearchOrgHitSchema>;

package/src/schemas/releases.ts

@@ -168,6 +168,13 @@ export const ReleasesWithMediaResponseSchema = z.array(ReleaseWithMediaRowSchema
 export const ReleaseDetailOrgSchema = z.object({
   slug: z.string(),
   name: z.string(),
+  /**
+   * Resolved org avatar URL (the `organizations.avatar_url` column). `null`
+   * when the org has no stored avatar. Additive — older servers omit it, so
+   * treat `undefined` as `null`. Mirrors the `orgAvatarUrl` field on the
+   * related-rail feed.
+   */
+  avatarUrl: z.string().nullable().optional(),
 });
 
 /**
@@ -199,6 +206,13 @@ export const ReleaseDetailResponseSchema = z.object({
   sourceSlug: z.string().nullable(),
   sourceType: z.enum(SOURCE_TYPES).nullable(),
   org: ReleaseDetailOrgSchema.nullable(),
+  /**
+   * Owning product, when the release's source is grouped under a product
+   * (`sources.product_id`). `null` when the source has no product. Additive —
+   * older servers omit this field; treat `undefined` as `null`. Reuses the
+   * `{ slug, name }` shape from the latest feed.
+   */
+  product: ReleaseLatestProductSchema.nullable().optional(),
   composition: ReleaseCompositionSchema.nullable(),
   appStore: AppStoreSourceInfoSchema.nullable().optional(),
   video: VideoSourceInfoSchema.nullable().optional(),