@buildinternet/releases-api-types 0.50.0 → 0.52.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buildinternet/releases-api-types",
-  "version": "0.50.0",
+  "version": "0.52.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.29.0",
+    "@buildinternet/releases-core": "^0.30.0",
     "zod": "^4.4.3"
   },
   "publishConfig": {

package/src/api-types.ts

@@ -14,6 +14,13 @@ export type {
 import type { SourceType, SourceFetchPriority } from "@buildinternet/releases-core/source-enums";
 import type { ApiScope } from "@buildinternet/releases-core/api-token";
 import type { BreakingLevel } from "@buildinternet/releases-core/breaking";
+import type {
+  AiLaneIdSchema,
+  AiLaneModelsPutSchema,
+  AiLaneStateSchema,
+  OpenRouterCatalogModelSchema,
+  AiLaneModelsResponseSchema,
+} from "./schemas/ai-models.js";
 import type {
   MediaItemSchema,
   PaginationSchema,
@@ -67,6 +74,12 @@ import type {
   PatchWorkspaceProfileBodySchema,
   WorkspaceProfileResponseSchema,
 } from "./schemas/account-profile.js";
+import type {
+  UploadsIntegrationStatusSchema,
+  UploadsOAuthConnectResponseSchema,
+  UploadsOAuthCallbackBodySchema,
+  UploadsOAuthCallbackResponseSchema,
+} from "./schemas/workspace-integrations.js";
 import type {
   SourceListItemSchema,
   SourceWithOrgSchema,
@@ -203,6 +216,10 @@ import type {
   FeedbackUpdateBodySchema,
   FeedbackDeleteResponseSchema,
 } from "./schemas/feedback.js";
+import type {
+  RecommendationNotifyAddedBodySchema,
+  RecommendationNotifyAddedResultSchema,
+} from "./schemas/recommendations.js";
 import type {
   SitemapSourceSchema,
   SitemapPayloadSchema,
@@ -280,6 +297,13 @@ export {
   NoticeSchema,
 } from "./schemas/shared.js";
 export { SiteNoticeSchema, SiteNoticeResponseSchema } from "./schemas/site-notice.js";
+export {
+  AiLaneIdSchema,
+  AiLaneModelsPutSchema,
+  AiLaneStateSchema,
+  OpenRouterCatalogModelSchema,
+  AiLaneModelsResponseSchema,
+} from "./schemas/ai-models.js";
 export {
   OrgListItemSchema,
   OrgListResponseSchema,
@@ -320,6 +344,12 @@ export {
   PatchWorkspaceProfileBodySchema,
   WorkspaceProfileResponseSchema,
 } from "./schemas/account-profile.js";
+export {
+  UploadsIntegrationStatusSchema,
+  UploadsOAuthConnectResponseSchema,
+  UploadsOAuthCallbackBodySchema,
+  UploadsOAuthCallbackResponseSchema,
+} from "./schemas/workspace-integrations.js";
 export {
   CreateStubOrgBodySchema,
   StubFromDomainBodySchema,
@@ -363,6 +393,7 @@ export {
   ListingPromoteLocatorOutcomeSchema,
   ListingPromoteLocatorSchema,
   ListingPromoteResultSchema,
+  ListingCapabilitiesSchema,
   type ListingValidateBody,
   type ListingActivateBody,
   type ListingIssue,
@@ -381,6 +412,7 @@ export {
   type ListingPromoteLocatorOutcome,
   type ListingPromoteLocator,
   type ListingPromoteResult,
+  type ListingCapabilities,
 } from "./schemas/listing.js";
 export {
   SourceListItemSchema,
@@ -519,6 +551,10 @@ export {
   FeedbackUpdateBodySchema,
   FeedbackDeleteResponseSchema,
 } from "./schemas/feedback.js";
+export {
+  RecommendationNotifyAddedBodySchema,
+  RecommendationNotifyAddedResultSchema,
+} from "./schemas/recommendations.js";
 export {
   SitemapSourceSchema,
   SitemapPayloadSchema,
@@ -587,6 +623,12 @@ export type { ResolveResponse } from "./schemas/resolve.js";
 
 export type MediaItem = z.infer<typeof MediaItemSchema>;
 
+export type AiLaneId = z.infer<typeof AiLaneIdSchema>;
+export type AiLaneModelsPut = z.infer<typeof AiLaneModelsPutSchema>;
+export type AiLaneState = z.infer<typeof AiLaneStateSchema>;
+export type OpenRouterCatalogModel = z.infer<typeof OpenRouterCatalogModelSchema>;
+export type AiLaneModelsResponse = z.infer<typeof AiLaneModelsResponseSchema>;
+
 // ── Stub tier (#1947) ──
 
 export type OrgStatus = z.infer<typeof OrgStatusSchema>;
@@ -641,7 +683,9 @@ export interface CreateUserApiKeyBody {
 
 export type SitemapSource = z.infer<typeof SitemapSourceSchema>;
 export type SitemapPayload = z.infer<typeof SitemapPayloadSchema>;
+/** @deprecated The `GET /v1/sitemap/releases` endpoint was retired in #2219. */
 export type SitemapRelease = z.infer<typeof SitemapReleaseSchema>;
+/** @deprecated The `GET /v1/sitemap/releases` endpoint was retired in #2219. */
 export type SitemapReleasesPayload = z.infer<typeof SitemapReleasesPayloadSchema>;
 
 // ── Related (Vectorize neighbors) ──
@@ -673,6 +717,10 @@ export type UploadAvatarResponse = z.infer<typeof UploadAvatarResponseSchema>;
 export type WorkspaceProfileFields = z.infer<typeof WorkspaceProfileFieldsSchema>;
 export type PatchWorkspaceProfileBody = z.infer<typeof PatchWorkspaceProfileBodySchema>;
 export type WorkspaceProfileResponse = z.infer<typeof WorkspaceProfileResponseSchema>;
+export type UploadsIntegrationStatus = z.infer<typeof UploadsIntegrationStatusSchema>;
+export type UploadsOAuthConnectResponse = z.infer<typeof UploadsOAuthConnectResponseSchema>;
+export type UploadsOAuthCallbackBody = z.infer<typeof UploadsOAuthCallbackBodySchema>;
+export type UploadsOAuthCallbackResponse = z.infer<typeof UploadsOAuthCallbackResponseSchema>;
 export type OrgDetail = z.infer<typeof OrgDetailSchema>;
 
 export type OrgCatalogItem = z.infer<typeof OrgCatalogItemSchema>;
@@ -865,6 +913,12 @@ export interface ProviderHealthResponse extends ListResponse<ProviderHealthSourc
     overdueOrgs: number;
     /** Distinct orgs represented among active sources. */
     totalOrgs: number;
+    /**
+     * Active sources that should still be polling but whose SourceActor mirror
+     * is unmanaged / missing `nextAlarmAt` (#2286). Independent of overdue
+     * last-check — a freshly fetched source can still have a dead alarm.
+     */
+    unmanagedActors: number;
   };
 }
 
@@ -1119,7 +1173,7 @@ export type UserWebhookScope = "org" | "follows";
 export type UserWebhookReleaseTypeFilter = "feature" | "rollup";
 
 /** Webhook delivery output format. */
-export type UserWebhookFormat = "json" | "slack";
+export type UserWebhookFormat = "json" | "slack" | "discord";
 
 /** A user-owned webhook subscription row (no signing secret). */
 export interface UserWebhookSubscription {
@@ -1166,7 +1220,7 @@ export interface UserWebhookListResponse {
   subscriptions: UserWebhookListItem[];
 }
 
-/** POST /v1/me/webhooks response — signing key shown once at creation (omitted for slack format). */
+/** POST /v1/me/webhooks response — signing key shown once at creation (omitted for slack/discord). */
 export interface CreateUserWebhookResponse
   extends UserWebhookSubscription, UserWebhookDeliveryHealth {
   orgSlug: string | null;
@@ -1193,7 +1247,7 @@ export interface WebhookDeliveryRow {
   error_message?: string | null;
   error_code?: string | null;
   outcome?: string;
-  /** Delivery format — "json" (signed raw event) or "slack" (Block Kit). Empty on pre-format rows. */
+  /** Delivery format — "json" (signed raw event) or a chat card (`slack` / `discord`). Empty on pre-format rows. */
   format?: UserWebhookFormat | "";
   http_status?: number;
   latency_ms?: number;
@@ -1701,6 +1755,10 @@ export type FeedbackListResponse = z.infer<typeof FeedbackListResponseSchema>;
 export type FeedbackUpdateBody = z.infer<typeof FeedbackUpdateBodySchema>;
 export type FeedbackDeleteResponse = z.infer<typeof FeedbackDeleteResponseSchema>;
 
+// ── Recommendations ──
+export type RecommendationNotifyAddedBody = z.infer<typeof RecommendationNotifyAddedBodySchema>;
+export type RecommendationNotifyAddedResult = z.infer<typeof RecommendationNotifyAddedResultSchema>;
+
 // ── Fetch log ──
 
 export interface FetchLogEntry {

package/src/schemas/ai-models.test.ts

@@ -0,0 +1,29 @@
+import { describe, expect, it } from "bun:test";
+import { AiLaneModelsPutSchema } from "./ai-models";
+
+describe("AiLaneModelsPutSchema", () => {
+  it("accepts a partial map", () => {
+    expect(
+      AiLaneModelsPutSchema.safeParse({
+        models: { summarize: "deepseek/deepseek-v4.1-flash" },
+      }).success,
+    ).toBe(true);
+  });
+
+  it("accepts null to clear an override", () => {
+    expect(AiLaneModelsPutSchema.safeParse({ models: { extract: null } }).success).toBe(true);
+  });
+
+  it("rejects an empty models object", () => {
+    expect(AiLaneModelsPutSchema.safeParse({ models: {} }).success).toBe(false);
+  });
+
+  it("rejects unknown keys", () => {
+    expect(
+      AiLaneModelsPutSchema.safeParse({
+        models: { summarize: "x" },
+        extra: true,
+      }).success,
+    ).toBe(false);
+  });
+});

package/src/schemas/ai-models.ts

@@ -0,0 +1,49 @@
+import { z } from "zod";
+
+export const AiLaneIdSchema = z.enum(["summarize", "extract", "feed-enrich", "marketing"]);
+
+const ModelIdOrClearSchema = z.string().max(200).nullable().optional();
+
+/** PUT /v1/ai/models — partial map; `null` or `""` clears that lane's override. */
+export const AiLaneModelsPutSchema = z
+  .object({
+    models: z
+      .object({
+        summarize: ModelIdOrClearSchema,
+        extract: ModelIdOrClearSchema,
+        "feed-enrich": ModelIdOrClearSchema,
+        marketing: ModelIdOrClearSchema,
+      })
+      .refine((m) => Object.values(m).some((v) => v !== undefined), {
+        message: "at least one lane is required",
+      }),
+  })
+  .strict();
+
+export const AiLaneStateSchema = z.object({
+  id: AiLaneIdSchema,
+  label: z.string(),
+  description: z.string(),
+  envVar: z.string(),
+  wranglerDefault: z.string().nullable(),
+  override: z.string().nullable(),
+  effective: z.string().nullable(),
+});
+
+export const OpenRouterCatalogModelSchema = z.object({
+  id: z.string(),
+  name: z.string(),
+  contextLength: z.number().nullable(),
+  promptPricePerMillion: z.number().nullable(),
+  completionPricePerMillion: z.number().nullable(),
+  vision: z.boolean(),
+});
+
+/** GET /v1/ai/models — current assignments plus the OpenRouter catalog. */
+export const AiLaneModelsResponseSchema = z.object({
+  lanes: z.array(AiLaneStateSchema),
+  catalog: z.array(OpenRouterCatalogModelSchema),
+  catalogFetchedAt: z.string().nullable(),
+  catalogError: z.string().nullable(),
+  updatedAt: z.string().nullable(),
+});

package/src/schemas/listing.ts

@@ -168,3 +168,16 @@ export const ListingPromoteResultSchema = z.strictObject({
   locators: z.array(ListingPromoteLocatorSchema),
 });
 export type ListingPromoteResult = z.infer<typeof ListingPromoteResultSchema>;
+
+/**
+ * Public capability flags for the listing lane. Anonymous + always reachable
+ * (does NOT 404 when either kill switch is off) so the web UI can hide CTAs
+ * instead of offering a button that fails with "Not found".
+ */
+export const ListingCapabilitiesSchema = z.strictObject({
+  /** `listing-self-serve-enabled` — validate / activate / claim / verify. */
+  selfServeEnabled: z.boolean(),
+  /** `listing-self-serve-promotion-enabled` — POST /v1/listing/promote. */
+  promotionEnabled: z.boolean(),
+});
+export type ListingCapabilities = z.infer<typeof ListingCapabilitiesSchema>;

package/src/schemas/recommendations.ts

@@ -0,0 +1,39 @@
+import { z } from "zod";
+
+/**
+ * `POST /v1/admin/recommendations/:id/notify-added` body.
+ *
+ * Resolves a live registry listing (org required, source optional) and
+ * emails the submitter's `contactEmail` that their suggestion was added.
+ * Opt-in only — triage / close / archive never send this.
+ */
+export const RecommendationNotifyAddedBodySchema = z.object({
+  orgSlug: z
+    .string()
+    .min(1)
+    .describe(
+      "Org slug or `org_…` id of the onboarded listing. Required so the email can link a live registry URL.",
+    ),
+  sourceSlug: z
+    .string()
+    .min(1)
+    .optional()
+    .describe(
+      "Optional source slug or `src_…` id under that org. When set, the email links the source page.",
+    ),
+});
+
+/**
+ * `POST /v1/admin/recommendations/:id/notify-added` success body.
+ *
+ * `sent: false` + `reason: "already_notified"` is the idempotent replay —
+ * a second call does not email again.
+ */
+export const RecommendationNotifyAddedResultSchema = z.object({
+  ok: z.literal(true),
+  sent: z.boolean(),
+  reason: z.enum(["already_notified"]).optional(),
+  notifiedAt: z.number().nullable(),
+  registryUrl: z.string().optional(),
+  contactEmail: z.string().optional(),
+});

package/src/schemas/sitemap.ts

@@ -57,9 +57,14 @@ export const SitemapPayloadSchema = z.object({
 });
 
 /**
- * Per-release row in `GET /v1/sitemap/releases` (#1181, scoped down). Carries
- * exactly what the web needs to build the slugged canonical `/release/...`
- * URL (`releasePath()` inputs) plus `fetchedAt` for `<lastmod>`.
+ * Per-release row previously returned by `GET /v1/sitemap/releases` (#1181,
+ * scoped down). Carries what the web needed to build the slugged canonical
+ * `/release/...` URL (`releasePath()` inputs) plus `fetchedAt` for `<lastmod>`.
+ *
+ * @deprecated The endpoint was retired in #2219 — its only consumer
+ * (`sitemap-releases.xml`) was removed in #2218 when release pages went
+ * `noindex`. Kept for one minor version per the deprecation lane; will be
+ * removed in a future minor.
  */
 export const SitemapReleaseSchema = z.object({
   id: z.string(),
@@ -72,8 +77,12 @@ export const SitemapReleaseSchema = z.object({
 });
 
 /**
- * Payload for the curated release sitemap: visible releases with a summary
- * and importance at or above the experiment threshold, newest first, capped.
+ * Payload previously returned by the curated release sitemap endpoint.
+ *
+ * @deprecated The endpoint was retired in #2219 — its only consumer
+ * (`sitemap-releases.xml`) was removed in #2218 when release pages went
+ * `noindex`. Kept for one minor version per the deprecation lane; will be
+ * removed in a future minor.
  */
 export const SitemapReleasesPayloadSchema = z.object({
   releases: z.array(SitemapReleaseSchema),

package/src/schemas/workspace-integrations.ts

@@ -0,0 +1,26 @@
+import { z } from "zod";
+
+export const UploadsIntegrationStatusSchema = z.object({
+  provider: z.literal("uploads"),
+  connected: z.boolean(),
+  /** False when the token-encryption key is missing. */
+  configured: z.boolean(),
+  connectedAt: z.string().nullable(),
+  scope: z.string().nullable(),
+  /** uploads.sh workspace slug from the access-token JWT (`workspace`, else `workspaces[]`). */
+  uploadsWorkspace: z.string().nullable(),
+});
+
+export const UploadsOAuthConnectResponseSchema = z.object({
+  authorizeUrl: z.string(),
+  redirectUri: z.string(),
+});
+
+export const UploadsOAuthCallbackBodySchema = z.object({
+  code: z.string().min(1),
+  state: z.string().min(1),
+});
+
+export const UploadsOAuthCallbackResponseSchema = UploadsIntegrationStatusSchema.extend({
+  workspaceId: z.string(),
+});