@buildinternet/releases-api-types 0.58.0 → 0.58.2

package/README.md

@@ -6,7 +6,7 @@ Wire protocol types for the [Releases](https://releases.sh) registry API.
 
 Pure TypeScript types — zero runtime dependencies — describing request/response
 shapes for the public HTTP API served at `api.releases.sh`. Consumed by the web
-frontend, the remote MCP server, and the [Releases CLI](https://github.com/buildinternet/releases-cli).
+frontend, the remote MCP server, and the [Releases CLI](../../apps/cli).
 
 ## Install
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@buildinternet/releases-api-types",
-  "version": "0.58.0",
-  "description": "Wire protocol — request/response types for the Releases registry API. Shared by web, workers, and clients.",
+  "version": "0.58.2",
+  "description": "Wire protocol — request/response types for the Releases Index API. Shared by web, workers, and clients.",
   "type": "module",
   "license": "MIT",
   "repository": {

package/src/api-types.ts

@@ -1359,6 +1359,25 @@ export interface DigestPrefsRequest {
   cadence: DigestCadence;
 }
 
+/** One collection whose weekly digest the caller gets by email (#2459). */
+export interface CollectionDigestSubscription {
+  collectionSlug: string;
+  collectionName: string;
+  /** ISO-8601. */
+  createdAt: string;
+}
+
+/** GET /v1/me/collection-digests response, newest first. */
+export interface CollectionDigestSubscriptionsResponse {
+  subscriptions: CollectionDigestSubscription[];
+}
+
+/** PUT / DELETE /v1/me/collection-digests/:slug response. Both are idempotent. */
+export interface CollectionDigestSubscriptionResponse {
+  collectionSlug: string;
+  subscribed: boolean;
+}
+
 // ── Semantic alerts (#2304 Phase 1) ──
 
 /** Hard cap on saved semantic alerts per account. Enforced on create. */
@@ -2018,8 +2037,8 @@ export interface Session {
    * it must never be reported as `"haiku"`. Surfaces on the detail GET.
    *
    * This is a logical role label, not the runtime model identifier. The
-   * resolved Anthropic model string (e.g. `claude-sonnet-5`,
-   * `claude-haiku-4-5`) lives on `usage.model` when the session reported
+   * resolved Anthropic model string (e.g. `claude-sonnet-5-5`,
+   * `claude-haiku-5-5`) lives on `usage.model` when the session reported
    * one — consult that field for the concrete model.
    */
   agent?: "sonnet" | "haiku" | "coordinator" | "deterministic";

package/src/schemas/collections.ts

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { ImportanceScoreSchema, ReleaseItemSchema } from "./shared.js";
+import { ImportanceScoreSchema, ReleaseCompositionSchema, ReleaseItemSchema } from "./shared.js";
 
 /**
  * One org as it appears inside a collection's preview list or detail page.
@@ -87,6 +87,8 @@ export const CollectionDetailSchema = z.object({
   isFeatured: z.boolean(),
   /** Per-collection enable toggle for the nightly daily-summary generation. */
   dailySummaryEnabled: z.boolean(),
+  /** Whether the collection generates weekly digests (gates the email-subscribe toggle). */
+  weeklyDigestEnabled: z.boolean(),
   members: z.array(CollectionMemberSchema),
   /** @deprecated Use `members`. Org-only subset, kept for back-compat. */
   orgs: z.array(CollectionMemberOrgSchema),
@@ -169,6 +171,8 @@ export const UpdateCollectionRequestSchema = z.object({
   isFeatured: z.boolean().optional(),
   /** Enable or disable the nightly daily-summary generation for this collection. */
   dailySummaryEnabled: z.boolean().optional(),
+  /** Enable or disable the nightly weekly-digest generation for this collection (on by default for new collections). */
+  weeklyDigestEnabled: z.boolean().optional(),
 });
 
 /**
@@ -291,6 +295,18 @@ export const DigestCoveredReleaseSchema = z.object({
    * marker on the collapsed "Releases covered" list.
    */
   importance: ImportanceScoreSchema,
+  /**
+   * Per-category item counts from the AI release-content pass. Null when the
+   * row hasn't been summarized; optional for older servers. Powers the
+   * digest page's week-at-a-glance treemap.
+   */
+  composition: ReleaseCompositionSchema.nullable().optional(),
+  /**
+   * ISO publish timestamp, as stored. Null when the source gave none;
+   * optional for older servers. A date-only source is stored at exactly
+   * `T00:00:00.000Z`. Powers the digest week replay's day placement.
+   */
+  publishedAt: z.string().nullable().optional(),
 });
 
 /** One `###` section of a digest body, parsed server-side. */