@buildinternet/releases-api-types 0.27.0 → 0.28.0

package/package.json

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

@@ -636,7 +636,10 @@ export interface StuckSource {
   isHidden: boolean;
   /** Non-`dry_run` attempts examined in the window (all errors when stuck). */
   recentAttempts: number;
-  /** Errors among the examined attempts (equals `recentAttempts` when stuck). */
+  /**
+   * Failed or degraded attempts (`error`, `crawl_timeout`, `blocked`) among the
+   * examined attempts (equals `recentAttempts` when stuck).
+   */
   recentErrors: number;
   /** Most-recent fetch attempt timestamp (ISO), or null. */
   lastAttemptAt: string | null;
@@ -1169,6 +1172,24 @@ export interface FetchLogEntry {
   createdAt: string;
 }
 
+/**
+ * The managed-agent session currently fetching a source, surfaced read-side on
+ * the fetch-log view so an operator/agent can tell "a fetch is in flight" from
+ * "stuck/dead" without waiting for a terminal `fetch_log` row (#1360). Only
+ * running, non-stale sessions are reported (the StatusHub DO drops sessions idle
+ * past its staleness cutoff), so the presence of this object means a fetch is
+ * live; `startedAt` says how long it has been running.
+ */
+export interface ActiveFetchSession {
+  sessionId: string;
+  /** Always `running` today — only running sessions are surfaced. */
+  status: string;
+  /** Session start, epoch ms. */
+  startedAt: number;
+  /** Last session activity, epoch ms. */
+  lastUpdatedAt: number;
+}
+
 // ── Usage ──
 
 export interface UsageBreakdownRow {

package/src/schemas/lookups.ts

@@ -38,6 +38,8 @@ export const LookupSourceSchema = z.looseObject({
   isHidden: z.boolean().nullable().optional(),
   discovery: z.enum(["curated", "agent", "on_demand"]).optional(),
   metadata: z.string().nullable(),
+  stars: z.number().int().min(0).nullable().optional(),
+  starsFetchedAt: z.string().nullable().optional(),
   createdAt: z.string().optional(),
 });
 

package/src/schemas/search.ts

@@ -60,6 +60,7 @@ export const SearchSourceHitSchema = z.object({
   orgSlug: z.string().nullable(),
   orgName: z.string().nullable(),
   productSlug: z.string().nullable(),
+  stars: z.number().int().min(0).nullable().optional(),
 });
 
 export const SearchReleaseHitSchema = z.object({
@@ -164,6 +165,7 @@ export const LookupResultPayloadSchema = z.object({
       name: z.string(),
       url: z.string(),
       discovery: z.enum(["curated", "agent", "on_demand"]),
+      stars: z.number().int().min(0).nullable().optional(),
     })
     .optional(),
   releases: z

package/src/schemas/sources.ts

@@ -50,6 +50,11 @@ export const SourceListItemSchema = z.object({
   productName: z.string().nullable().optional(),
   productSlug: z.string().nullable().optional(),
   kind: z.enum(KIND_VALUES).nullable().optional(),
+  // GitHub stargazer count. `nullable().optional()` (the house idiom for these
+  // shapes): non-github sources and older responses omit it; a fetched row may
+  // carry `null`. Consumers treat null/undefined as "unknown".
+  stars: z.number().int().min(0).nullable().optional(),
+  starsFetchedAt: z.string().nullable().optional(),
 });
 
 /**
@@ -84,6 +89,11 @@ export const SourceWithOrgSchema = z.object({
   medianGapDays: z.number().nullable(),
   lastRetieredAt: z.string().nullable(),
   kind: z.enum(KIND_VALUES).nullable().optional(),
+  // GitHub stargazer count. `nullable().optional()` (the house idiom for these
+  // shapes): non-github sources and older responses omit it; a fetched row may
+  // carry `null`. Consumers treat null/undefined as "unknown".
+  stars: z.number().int().min(0).nullable().optional(),
+  starsFetchedAt: z.string().nullable().optional(),
 });
 
 export const SourceListResponseSchema = ListResponseSchema(SourceWithOrgSchema);
@@ -161,6 +171,11 @@ export const SourceDetailSchema = z.object({
   pagination: SourceFeedPaginationSchema,
   summaries: SourceDetailSummariesSchema,
   kind: z.enum(KIND_VALUES).nullable().optional(),
+  // GitHub stargazer count. `nullable().optional()` (the house idiom for these
+  // shapes): non-github sources and older responses omit it; a fetched row may
+  // carry `null`. Consumers treat null/undefined as "unknown".
+  stars: z.number().int().min(0).nullable().optional(),
+  starsFetchedAt: z.string().nullable().optional(),
 });
 
 /**