@buildinternet/releases-api-types 0.38.0 → 0.39.0

package/package.json

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

@@ -334,6 +334,21 @@ export type {
   ReleasesJsonRepo,
   ReleasesJsonRepoRelease,
 } from "./schemas/well-known.js";
+export {
+  ListingValidateBodySchema,
+  ListingActivateBodySchema,
+  ListingIssueSchema,
+  ListingLocationSchema,
+  ListingOrgPointerSchema,
+  ListingValidationResultSchema,
+  ListingActivateResultSchema,
+  type ListingValidateBody,
+  type ListingActivateBody,
+  type ListingIssue,
+  type ListingLocation,
+  type ListingValidationResult,
+  type ListingActivateResult,
+} from "./schemas/listing.js";
 export {
   SourceListItemSchema,
   SourceWithOrgSchema,

package/src/schemas/listing.ts

@@ -0,0 +1,76 @@
+import { z } from "zod";
+
+/**
+ * Public wire contract for the self-serve listing lane (#1947 phase 2):
+ * POST /v1/listing/validate and POST /v1/listing/activate. This projection is
+ * deliberately independent of the internal materialization plan — it is the
+ * stable shape web/CLI consume while internals stay free to change.
+ */
+
+export const ListingValidateBodySchema = z.strictObject({
+  domain: z.string().min(1).max(255),
+});
+export type ListingValidateBody = z.infer<typeof ListingValidateBodySchema>;
+
+export const ListingActivateBodySchema = z.strictObject({
+  domain: z.string().min(1).max(255),
+  requestTracking: z.boolean().optional(),
+});
+export type ListingActivateBody = z.infer<typeof ListingActivateBodySchema>;
+
+export const ListingIssueSchema = z.strictObject({
+  path: z.string(),
+  message: z.string(),
+});
+export type ListingIssue = z.infer<typeof ListingIssueSchema>;
+
+export const ListingLocationSchema = z.strictObject({
+  /** The declared locator value (feed URL, github ref, url, appstore id, file). */
+  locator: z.string(),
+  kind: z.enum(["feed", "github", "appstore", "url", "file"]),
+  classification: z.enum(["tier1-live", "tier2-paused-review"]),
+  /** Plain-English "what this becomes" for the preview UI. */
+  becomes: z.string(),
+  /** Present when the locator is nested under a manifest product. */
+  productName: z.string().optional(),
+});
+export type ListingLocation = z.infer<typeof ListingLocationSchema>;
+
+export const ListingOrgPointerSchema = z.strictObject({
+  slug: z.string(),
+  name: z.string(),
+  webUrl: z.string(),
+});
+export type ListingOrgPointer = z.infer<typeof ListingOrgPointerSchema>;
+
+export const ListingValidationResultSchema = z.strictObject({
+  valid: z.boolean(),
+  errors: z.array(ListingIssueSchema),
+  domainStatus: z.enum(["unlisted", "listed", "stub"]),
+  /** Present when domainStatus is "listed" or "stub". */
+  org: ListingOrgPointerSchema.optional(),
+  /** Present when valid: identity fields as they would land. */
+  identity: z
+    .strictObject({
+      name: z.string(),
+      slug: z.string(),
+      domain: z.string(),
+    })
+    .optional(),
+  products: z.array(z.strictObject({ name: z.string(), locationCount: z.number() })).optional(),
+  locations: z.array(ListingLocationSchema),
+});
+export type ListingValidationResult = z.infer<typeof ListingValidationResultSchema>;
+
+export const ListingActivateResultSchema = z.strictObject({
+  /** True when this call created the stub; false for the existing-stub carve-out. */
+  activated: z.boolean(),
+  org: z.strictObject({
+    slug: z.string(),
+    name: z.string(),
+    status: z.enum(["stub", "tracked"]),
+    webUrl: z.string(),
+  }),
+  trackingRequested: z.boolean(),
+});
+export type ListingActivateResult = z.infer<typeof ListingActivateResultSchema>;

package/src/schemas/orgs.ts

@@ -38,6 +38,12 @@ export const OrgListItemSchema = z.object({
   lastActivity: z.string().nullable(),
   topProducts: z.array(z.string()),
   sparkline: z.array(z.number().int().min(0)).length(30),
+  /**
+   * Additive, admin-only field (#1947 phase 2). Only populated on the
+   * `GET /v1/orgs?trackingRequested=1` demand-queue projection — absent on
+   * the public catalog listing.
+   */
+  trackingRequestedAt: z.string().nullable().optional(),
 });
 
 /**