@buildinternet/releases-api-types 0.9.0 → 0.11.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buildinternet/releases-api-types",
-  "version": "0.9.0",
+  "version": "0.11.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.18.0",
+    "@buildinternet/releases-core": "^0.19.0",
     "zod": "^4.3.6"
   },
   "publishConfig": {

package/src/api-types.ts

@@ -19,6 +19,7 @@ import type {
   ReleaseItemSchema,
   ReleaseSummaryItemSchema,
   OverviewPageItemSchema,
+  OverviewCitationSchema,
 } from "./schemas/shared.js";
 import type {
   OrgListItemSchema,
@@ -68,6 +69,7 @@ export {
   ReleaseItemSchema,
   ReleaseSummaryItemSchema,
   OverviewPageItemSchema,
+  OverviewCitationSchema,
   CategorySchema,
 } from "./schemas/shared.js";
 export {
@@ -133,6 +135,7 @@ export interface SitemapPayload {
   orgs: Array<{ slug: string; lastActivity: string | null }>;
   sources: Array<{ orgSlug: string; slug: string; latestDate: string | null }>;
   products: Array<{ orgSlug: string; slug: string }>;
+  collections: Array<{ slug: string; updatedAt: string }>;
 }
 
 // ── Organizations ──
@@ -491,6 +494,7 @@ export interface UnifiedSearchResponse {
 // ── Overview Pages ──
 
 export type OverviewPageItem = z.infer<typeof OverviewPageItemSchema>;
+export type OverviewCitation = z.infer<typeof OverviewCitationSchema>;
 
 /** @deprecated Use OverviewPageItem */
 export type KnowledgePageItem = OverviewPageItem;
@@ -684,15 +688,19 @@ export interface CollectionMemberOrg {
   name: string;
   domain: string | null;
   avatarUrl: string | null;
+  /** GitHub handle from org_accounts; lets the avatar fall back to github.com/<handle>.png. */
+  githubHandle: string | null;
   description: string | null;
 }
 
-/** Item shape on GET /v1/collections (list). */
+/** Item shape on GET /v1/collections (list) and GET /v1/orgs/:slug/collections. */
 export interface CollectionListItem {
   slug: string;
   name: string;
   description: string | null;
   memberCount: number;
+  /** First few members for inline preview on the list page (capped at 3). */
+  previewMembers?: CollectionMemberOrg[];
 }
 
 /** Detail shape on GET /v1/collections/:slug. */
@@ -703,6 +711,30 @@ export interface CollectionDetail {
   orgs: CollectionMemberOrg[];
 }
 
+/**
+ * Cross-org release feed row. Same shape as `OrgReleaseItem` plus the origin
+ * `org` block, so the web's release card can render it identically — full
+ * `content` lets "Show more" expand to the body instead of the truncated
+ * `summary`.
+ */
+export interface CollectionReleaseItem extends OrgReleaseItem {
+  org: { slug: string; name: string };
+  /**
+   * Product the release belongs to, if the source is bound to one. Powers
+   * the timeline's same-product rollup ("3 earlier Claude Code releases
+   * today") on the collections view. `null` for orgs without products or
+   * standalone sources. Optional on the wire so older workers mid-rollout
+   * (and hand-constructed test fixtures) don't trip the typecheck — clients
+   * should treat missing and `null` identically.
+   */
+  product?: { slug: string; name: string } | null;
+}
+
+export interface CollectionReleasesResponse {
+  releases: CollectionReleaseItem[];
+  pagination: { nextCursor: string | null; limit: number };
+}
+
 /** Body for POST /v1/collections. `slug` derives from `name` via toSlug() if omitted. */
 export interface CreateCollectionRequest {
   slug?: string;

package/src/schemas/shared.ts

@@ -68,6 +68,22 @@ export const ReleaseSummaryItemSchema = z.object({
   generatedAt: z.string(),
 });
 
+/**
+ * Inline citation attached to an overview page (#846). Each row maps a
+ * character span in `OverviewPageItem.content` back to a release URL the
+ * model cited via Anthropic's search_result blocks. Optional everywhere it
+ * appears — pages generated before #846 lands have none, and consumers
+ * should degrade gracefully.
+ */
+export const OverviewCitationSchema = z.object({
+  startIndex: z.number().int().min(0),
+  endIndex: z.number().int().min(0),
+  sourceUrl: z.string(),
+  title: z.string().nullable().optional(),
+  citedText: z.string(),
+  releaseId: z.string().nullable().optional(),
+});
+
 export const OverviewPageItemSchema = z.object({
   scope: z.enum(["org", "product"]),
   orgSlug: z.string().nullable().optional(),
@@ -77,4 +93,5 @@ export const OverviewPageItemSchema = z.object({
   lastContributingReleaseAt: z.string().nullable(),
   generatedAt: z.string(),
   updatedAt: z.string(),
+  citations: z.array(OverviewCitationSchema).optional(),
 });