@buildinternet/releases-api-types 0.3.0 → 0.4.0

package/package.json

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

@@ -92,6 +92,12 @@ export interface SourceListItem {
   latestAddedAt?: string | null;
   isPrimary?: boolean;
   isHidden?: boolean;
+  /**
+   * How the row was created. Optional on the wire so older API responses
+   * (mid-deploy or pinned old workers) degrade gracefully — consumers that
+   * see `undefined` should treat it as `"curated"`.
+   */
+  discovery?: "curated" | "agent" | "on_demand";
   fetchPriority?: "normal" | "low" | "paused" | null;
   lastFetchedAt?: string | null;
   lastPolledAt?: string | null;
@@ -123,6 +129,7 @@ export interface SourceWithOrg {
   productSlug: string | null;
   isPrimary: boolean;
   isHidden: boolean | null;
+  discovery?: "curated" | "agent" | "on_demand";
   metadata: string | null;
   releaseCount: number;
   latestVersion: string | null;
@@ -207,6 +214,18 @@ export interface SourceDetail {
   name: string;
   type: string;
   url: string;
+  /**
+   * Hidden sources are reachable by direct URL but excluded from listings,
+   * sitemap, and AI features. Set on on-demand lookups and admin-suppressed
+   * rows; absent on canonical curated/agent sources.
+   */
+  isHidden?: boolean;
+  /**
+   * Pairs with `isHidden` to distinguish admin-suppressed rows (`curated` /
+   * `agent` + hidden) from rows materialized by `/v1/lookups` (`on_demand`).
+   * Optional for graceful degradation against older API responses.
+   */
+  discovery?: "curated" | "agent" | "on_demand";
   changelogUrl?: string | null;
   hasChangelogFile?: boolean;
   org: { slug: string; name: string } | null;
@@ -228,6 +247,13 @@ export interface SourceDetail {
 
 // ── Releases ──
 
+/**
+ * Release type — mirrors `RELEASE_TYPES` in `@buildinternet/releases-core/schema`.
+ * Optional on the wire so older API responses (mid-deploy or pinned old workers)
+ * degrade gracefully — consumers that see `undefined` should treat it as `"feature"`.
+ */
+export type ReleaseType = "feature" | "rollup";
+
 export interface ReleaseItem {
   id?: string;
   version: string | null;
@@ -237,6 +263,8 @@ export interface ReleaseItem {
   publishedAt: string | null;
   url: string | null;
   media?: MediaItem[];
+  /** Release type. See {@link ReleaseType}. */
+  type?: ReleaseType;
 }
 
 export interface ReleaseDetail {
@@ -254,6 +282,8 @@ export interface ReleaseDetail {
   sourceSlug: string;
   sourceType: string;
   org: { slug: string; name: string } | null;
+  /** Release type. See {@link ReleaseType}. */
+  type?: ReleaseType;
 }
 
 export interface ReleaseCoverageRow {
@@ -391,6 +421,8 @@ export interface SearchReleaseHit {
    * use this to interleave release and chunk hits into a single ranked list.
    */
   score?: number;
+  /** Release type. See {@link ReleaseType}. */
+  type?: ReleaseType;
 }
 
 /**
@@ -602,6 +634,36 @@ export interface ProductAdoptResult {
   sourceOrgDeleted: string;
 }
 
+// ── Taxonomy (categories + tags) ──
+
+export interface TaxonomyOrg {
+  slug: string;
+  name: string;
+  domain: string | null;
+  avatarUrl: string | null;
+}
+
+export interface TaxonomyProduct {
+  slug: string;
+  name: string;
+  description: string | null;
+  orgSlug: string;
+  orgName: string;
+}
+
+export interface CategoryDetail {
+  slug: string;
+  orgs: TaxonomyOrg[];
+  products: TaxonomyProduct[];
+}
+
+export interface TagDetail {
+  slug: string;
+  name: string;
+  orgs: TaxonomyOrg[];
+  products: TaxonomyProduct[];
+}
+
 // ── Releases (enriched) ──
 
 /** Flat release shape returned by GET /v1/releases/:id with source metadata. */