@buildinternet/releases-api-types 0.58.3 → 0.60.0

package/src/schemas/feedback.ts

@@ -1,56 +0,0 @@
-import { z } from "zod";
-import { FEEDBACK_TYPES, FEEDBACK_STATUSES } from "@buildinternet/releases-core/schema";
-
-/** Feedback category — mirrors `FEEDBACK_TYPES` in `@buildinternet/releases-core/schema`. */
-export const FeedbackTypeSchema = z.enum(FEEDBACK_TYPES);
-
-/** Triage lifecycle — mirrors `FEEDBACK_STATUSES` in `@buildinternet/releases-core/schema`. */
-export const FeedbackStatusSchema = z.enum(FEEDBACK_STATUSES);
-
-/**
- * One submitted feedback row, as returned by `GET /v1/admin/feedback` and by
- * the triage write-path (`PATCH /v1/feedback/:id` echoes the updated row).
- * `archived` soft-removes the row from the default admin read view and is
- * orthogonal to triage `status` — a row can be `closed` and visible, or `new`
- * and archived. `createdAt` is epoch milliseconds.
- */
-export const FeedbackItemSchema = z.object({
-  id: z.string(),
-  createdAt: z.number(),
-  message: z.string(),
-  contact: z.string().nullable(),
-  type: FeedbackTypeSchema,
-  status: FeedbackStatusSchema,
-  archived: z.boolean(),
-  cliVersion: z.string().nullable(),
-  clientKind: z.string(),
-  anonId: z.string().nullable(),
-  os: z.string().nullable(),
-  arch: z.string().nullable(),
-  runtime: z.string().nullable(),
-  surface: z.string(),
-});
-
-/**
- * `GET /v1/admin/feedback` — cursor-paginated, newest-first. Archived rows are
- * hidden unless the request passes `?includeArchived=true`.
- */
-export const FeedbackListResponseSchema = z.object({
-  items: z.array(FeedbackItemSchema),
-  nextCursor: z.string().nullable(),
-});
-
-/**
- * `PATCH /v1/feedback/:id` body — partial triage update. At least one field
- * must be present; the response echoes the updated `FeedbackItem`.
- */
-export const FeedbackUpdateBodySchema = z.object({
-  status: FeedbackStatusSchema.optional(),
-  archived: z.boolean().optional(),
-});
-
-/** `DELETE /v1/feedback/:id` response — hard delete of a single row. */
-export const FeedbackDeleteResponseSchema = z.object({
-  deleted: z.literal(true),
-  id: z.string(),
-});

package/src/schemas/listing.ts

@@ -1,226 +0,0 @@
-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>;
-
-/** One follow-up the owner takes after declaring `publish: "push"`. */
-export const ListingSetupStepSchema = z.strictObject({
-  id: z.enum(["verify", "token", "action"]),
-  title: z.string(),
-  detail: z.string(),
-});
-export type ListingSetupStep = z.infer<typeof ListingSetupStepSchema>;
-
-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", "push"]),
-  classification: z.enum(["tier1-live", "tier2-paused-review", "push-setup"]),
-  /** 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(),
-  /** Changelog file or glob. Present on `kind: "push"`. */
-  path: z.string().optional(),
-  /** Present on `kind: "push"`: verify ownership, mint a token, add the Action. */
-  setupSteps: z.array(ListingSetupStepSchema).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>;
-
-/**
- * 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", "revoked"]);
-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(),
-  /** Set once the claim was ended by its owner or an admin (#2389). */
-  revokedAt: 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>;
-
-/**
- * Admin view of every claim on an org (`GET /v1/orgs/:slug/claims`, #2389).
- * Never includes the proof token.
- */
-export const AdminOrgClaimSchema = z.strictObject({
-  id: z.string(),
-  userId: z.string(),
-  status: OrgClaimStatusSchema,
-  method: ClaimMethodSchema.nullable(),
-  createdAt: z.string(),
-  verifiedAt: z.string().nullable(),
-  expiresAt: z.string(),
-  revokedAt: z.string().nullable(),
-  revokedBy: z.string().nullable(),
-  revokeReason: z.string().nullable(),
-});
-export type AdminOrgClaim = z.infer<typeof AdminOrgClaimSchema>;
-
-export const ListOrgClaimsResponseSchema = z.strictObject({
-  claims: z.array(AdminOrgClaimSchema),
-});
-export type ListOrgClaimsResponse = z.infer<typeof ListOrgClaimsResponseSchema>;
-
-/** `DELETE /v1/orgs/:slug/claims/:id` body — admins must say why. */
-export const RevokeOrgClaimBodySchema = z.strictObject({
-  reason: z.string().trim().min(1).max(500),
-});
-export type RevokeOrgClaimBody = z.infer<typeof RevokeOrgClaimBodySchema>;
-
-/**
- * Self-serve Tier-1 promotion (#1947 epic item 3, PR B): a verified owner
- * promotes their claimed stub to `tracked`. Independent of the internal
- * materialization plan — this is the stable public projection.
- */
-
-export const ListingPromoteBodySchema = z.strictObject({
-  domain: z.string().min(1).max(255),
-});
-export type ListingPromoteBody = z.infer<typeof ListingPromoteBodySchema>;
-
-export const ListingPromoteLocatorOutcomeSchema = z.enum(["live", "queued-for-review"]);
-export type ListingPromoteLocatorOutcome = z.infer<typeof ListingPromoteLocatorOutcomeSchema>;
-
-export const ListingPromoteLocatorSchema = z.strictObject({
-  locator: z.string(),
-  outcome: ListingPromoteLocatorOutcomeSchema,
-});
-export type ListingPromoteLocator = z.infer<typeof ListingPromoteLocatorSchema>;
-
-export const ListingPromoteResultSchema = z.strictObject({
-  promoted: z.boolean(),
-  /** Present and true only for the idempotent already-`tracked` no-op. */
-  alreadyTracked: z.boolean().optional(),
-  sources: z.strictObject({
-    created: z.number(),
-    matched: z.number(),
-  }),
-  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>;