@buildinternet/releases-api-types 0.39.0 → 0.40.0

package/package.json

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

@@ -342,12 +342,28 @@ export {
   ListingOrgPointerSchema,
   ListingValidationResultSchema,
   ListingActivateResultSchema,
+  ListingClaimBodySchema,
+  ListingClaimVerifyBodySchema,
+  OrgClaimStatusSchema,
+  ClaimMethodSchema,
+  OrgClaimSchema,
+  ClaimCheckOutcomeSchema,
+  ClaimVerifyResultSchema,
+  ListingClaimsResultSchema,
   type ListingValidateBody,
   type ListingActivateBody,
   type ListingIssue,
   type ListingLocation,
   type ListingValidationResult,
   type ListingActivateResult,
+  type ListingClaimBody,
+  type ListingClaimVerifyBody,
+  type OrgClaimStatus,
+  type ClaimMethod,
+  type OrgClaim,
+  type ClaimCheckOutcome,
+  type ClaimVerifyResult,
+  type ListingClaimsResult,
 } from "./schemas/listing.js";
 export {
   SourceListItemSchema,

package/src/schemas/listing.ts

@@ -74,3 +74,65 @@ export const ListingActivateResultSchema = z.strictObject({
   trackingRequested: z.boolean(),
 });
 export type ListingActivateResult = z.infer<typeof ListingActivateResultSchema>;
+
+/**
+ * Ownership claim flow (#1947 epic item 2): a signed-in user proves control
+ * of a listed domain via a well-known token file OR a DNS TXT record.
+ */
+
+export const ListingClaimBodySchema = z.strictObject({
+  domain: z.string().min(1).max(255),
+});
+export type ListingClaimBody = z.infer<typeof ListingClaimBodySchema>;
+
+export const ListingClaimVerifyBodySchema = z.strictObject({
+  claimId: z.string().min(1),
+});
+export type ListingClaimVerifyBody = z.infer<typeof ListingClaimVerifyBodySchema>;
+
+export const OrgClaimStatusSchema = z.enum(["pending", "verified", "expired"]);
+export type OrgClaimStatus = z.infer<typeof OrgClaimStatusSchema>;
+
+export const ClaimMethodSchema = z.enum(["well-known", "dns-txt"]);
+export type ClaimMethod = z.infer<typeof ClaimMethodSchema>;
+
+/**
+ * `token` + `instructions` are only present while the claim is `pending` (or
+ * on mint) — once verified there's nothing left to prove, and an expired
+ * claim's token is stale.
+ */
+export const OrgClaimSchema = z.strictObject({
+  id: z.string(),
+  org: ListingOrgPointerSchema,
+  status: OrgClaimStatusSchema,
+  method: ClaimMethodSchema.optional(),
+  token: z.string().optional(),
+  createdAt: z.string(),
+  verifiedAt: z.string().optional(),
+  expiresAt: z.string(),
+  instructions: z
+    .strictObject({
+      wellKnownUrl: z.string(),
+      dnsRecordName: z.string(),
+    })
+    .optional(),
+});
+export type OrgClaim = z.infer<typeof OrgClaimSchema>;
+
+export const ClaimCheckOutcomeSchema = z.enum(["ok", "mismatch", "unreachable"]);
+export type ClaimCheckOutcome = z.infer<typeof ClaimCheckOutcomeSchema>;
+
+export const ClaimVerifyResultSchema = z.strictObject({
+  verified: z.boolean(),
+  checked: z.strictObject({
+    wellKnown: ClaimCheckOutcomeSchema,
+    dnsTxt: ClaimCheckOutcomeSchema,
+  }),
+  claim: OrgClaimSchema,
+});
+export type ClaimVerifyResult = z.infer<typeof ClaimVerifyResultSchema>;
+
+export const ListingClaimsResultSchema = z.strictObject({
+  claims: z.array(OrgClaimSchema),
+});
+export type ListingClaimsResult = z.infer<typeof ListingClaimsResultSchema>;

package/src/schemas/sources.ts

@@ -171,6 +171,8 @@ export const SourceDetailSchema = z.object({
   latestDate: z.string().nullable(),
   lastFetchedAt: z.string().nullable(),
   lastPolledAt: z.string().nullable(),
+  // #1969: additive so pinned old workers/clients degrade gracefully.
+  changeDetectedAt: z.string().nullable().optional(),
   trackingSince: z.string(),
   releases: z.array(ReleaseItemSchema),
   pagination: SourceFeedPaginationSchema,