@buildinternet/releases-api-types 0.6.0 → 0.7.0

package/package.json

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

@@ -264,13 +264,40 @@ export interface SourceDetail {
   lastPolledAt: string | null;
   trackingSince: string;
   releases: ReleaseItem[];
-  pagination: { page: number; pageSize: number; totalPages: number; totalItems: number };
+  pagination: Pagination;
   summaries: {
     rolling: ReleaseSummaryItem | null;
     monthly: ReleaseSummaryItem[];
   };
 }
 
+// ── Admin telemetry: orgs rollup ──
+
+export interface OrgsRollupRow {
+  /** Org slug, or "—" for sources without an org. */
+  orgSlug: string;
+  sourceCount: number;
+  /** Sources with no release on file or `latestDate` older than `staleDays`. */
+  staleCount: number;
+  /** Most-recent release across all of the org's sources, or null. */
+  mostRecentRelease: string | null;
+  mostRecentAgeDays: number | null;
+  /** True iff every source in the org is stale (and the org has at least one source). */
+  allStale: boolean;
+}
+
+export interface OrgsRollupResponse extends ListResponse<OrgsRollupRow> {
+  meta: {
+    /** Stale cutoff used server-side, in days. */
+    staleDays: number;
+    totalOrgs: number;
+    /** Orgs where every source is stale. */
+    dormantOrgs: number;
+    /** Orgs with at least one stale source. */
+    anyStaleOrgs: number;
+  };
+}
+
 // ── Releases ──
 
 /**
@@ -939,3 +966,23 @@ export interface EmbedStatusResponse {
   };
   chunks: { total: number; embedded: number; unembedded: number };
 }
+
+// ── Evaluate (URL recommendation) ──
+
+/**
+ * Returned verbatim by GET /v1/evaluate. Lives in the public api-types package
+ * so external consumers (CLI, third-party clients) can import the shape
+ * without depending on worker-internal AI helpers.
+ */
+export interface EvaluationResult {
+  recommendedMethod: "feed" | "github" | "markdown" | "scrape" | "crawl";
+  recommendedUrl: string;
+  feedUrl?: string;
+  feedType?: "rss" | "atom" | "jsonfeed";
+  githubRepo?: string;
+  pageStructure: "single-page" | "index" | "unknown";
+  alternatives: Array<{ url: string; method: string; note: string }>;
+  confidence: "high" | "medium" | "low";
+  provider?: string;
+  notes?: string;
+}