@buildinternet/releases-api-types 0.58.3 → 0.60.0

package/dist/schemas/feedback.js

@@ -0,0 +1,76 @@
+import { z } from "zod";
+import { FEEDBACK_TYPES, FEEDBACK_STATUSES, TELEMETRY_CLIENT_KINDS, } 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(),
+});
+/** `POST /v1/feedback` field limits, shared with the handler's sanitizer. */
+export const FEEDBACK_MESSAGE_MIN_CHARS = 5;
+export const FEEDBACK_MESSAGE_MAX_CHARS = 4000;
+export const FEEDBACK_CONTACT_MAX_CHARS = 200;
+/**
+ * `POST /v1/feedback` body. Documentation shape: the handler sanitizes each
+ * field and coerces unknown `type` / `clientKind` values to their defaults
+ * rather than rejecting them; only a short or missing `message` is a 400.
+ */
+export const FeedbackSubmitBodySchema = z.object({
+    message: z.string().min(FEEDBACK_MESSAGE_MIN_CHARS).max(FEEDBACK_MESSAGE_MAX_CHARS),
+    type: FeedbackTypeSchema.optional(),
+    contact: z.string().max(FEEDBACK_CONTACT_MAX_CHARS).optional(),
+    clientKind: z.enum(TELEMETRY_CLIENT_KINDS).optional(),
+    surface: z.string().max(32).optional(),
+    cliVersion: z.string().max(32).optional(),
+    anonId: z.string().max(64).optional(),
+    os: z.string().max(64).optional(),
+    arch: z.string().max(64).optional(),
+    runtime: z.string().max(64).optional(),
+});
+/** `POST /v1/feedback` 202 response. */
+export const FeedbackSubmitResponseSchema = z.object({
+    ok: z.literal(true),
+    id: z.string(),
+});

package/dist/schemas/follows.d.ts

@@ -0,0 +1,154 @@
+import { z } from "zod";
+/** Follows and the personalized feed, served under `/v1/me/follows` and `/v1/me/feed`. */
+/** What a user can follow. */
+export declare const FollowTargetSchema: z.ZodEnum<{
+    org: "org";
+    product: "product";
+}>;
+/** A user's follow, enriched for rendering (returned by GET /v1/me/follows). */
+export declare const FollowSchema: z.ZodObject<{
+    targetType: z.ZodEnum<{
+        org: "org";
+        product: "product";
+    }>;
+    targetId: z.ZodString;
+    name: z.ZodString;
+    slug: z.ZodString;
+    avatarUrl: z.ZodNullable<z.ZodString>;
+    orgSlug: z.ZodNullable<z.ZodString>;
+    createdAt: z.ZodString;
+}, z.core.$strip>;
+/** GET /v1/me/follows response. */
+export declare const FollowsListResponseSchema: z.ZodObject<{
+    follows: z.ZodArray<z.ZodObject<{
+        targetType: z.ZodEnum<{
+            org: "org";
+            product: "product";
+        }>;
+        targetId: z.ZodString;
+        name: z.ZodString;
+        slug: z.ZodString;
+        avatarUrl: z.ZodNullable<z.ZodString>;
+        orgSlug: z.ZodNullable<z.ZodString>;
+        createdAt: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/** POST /v1/me/follows request body. Following an org also follows its products. */
+export declare const FollowRequestSchema: z.ZodObject<{
+    targetType: z.ZodEnum<{
+        org: "org";
+        product: "product";
+    }>;
+    targetId: z.ZodString;
+}, z.core.$strip>;
+/** POST/DELETE /v1/me/follows response. */
+export declare const FollowMutationResponseSchema: z.ZodObject<{
+    success: z.ZodLiteral<true>;
+    following: z.ZodBoolean;
+}, z.core.$strip>;
+/** Cursor pagination shape for GET /v1/me/feed (same as other release feeds). */
+export declare const PersonalizedFeedPaginationSchema: z.ZodObject<{
+    nextCursor: z.ZodNullable<z.ZodString>;
+    limit: z.ZodNumber;
+}, z.core.$strip>;
+/**
+ * GET /v1/me/feed response — the personalized release feed. Reuses the same item
+ * shape as /v1/releases/latest (ReleaseLatestItem); cursor-paginated like other
+ * feed-shaped surfaces.
+ */
+export declare const PersonalizedFeedResponseSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        version: z.ZodNullable<z.ZodString>;
+        type: z.ZodEnum<{
+            feature: "feature";
+            rollup: "rollup";
+        }>;
+        title: z.ZodString;
+        summary: z.ZodNullable<z.ZodString>;
+        titleGenerated: z.ZodNullable<z.ZodString>;
+        titleShort: z.ZodNullable<z.ZodString>;
+        breaking: z.ZodOptional<z.ZodEnum<{
+            major: "major";
+            minor: "minor";
+            none: "none";
+            unknown: "unknown";
+        }>>;
+        importance: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        publishedAt: z.ZodNullable<z.ZodString>;
+        url: z.ZodNullable<z.ZodString>;
+        webUrl: z.ZodOptional<z.ZodString>;
+        media: z.ZodArray<z.ZodObject<{
+            type: z.ZodEnum<{
+                gif: "gif";
+                image: "image";
+                video: "video";
+            }>;
+            url: z.ZodString;
+            alt: z.ZodOptional<z.ZodString>;
+            r2Key: z.ZodOptional<z.ZodString>;
+            r2Url: z.ZodOptional<z.ZodString>;
+            linkUrl: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        source: z.ZodObject<{
+            slug: z.ZodString;
+            name: z.ZodString;
+            type: z.ZodEnum<{
+                agent: "agent";
+                appstore: "appstore";
+                feed: "feed";
+                github: "github";
+                scrape: "scrape";
+                video: "video";
+            }>;
+            orgSlug: z.ZodNullable<z.ZodString>;
+            orgName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            orgAvatarUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            orgGithubHandle: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            kind: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+                desktop: "desktop";
+                docs: "docs";
+                integration: "integration";
+                mobile: "mobile";
+                platform: "platform";
+                sdk: "sdk";
+                tool: "tool";
+            }>>>;
+        }, z.core.$strip>;
+        product: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            slug: z.ZodString;
+            name: z.ZodString;
+            kind: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+                desktop: "desktop";
+                docs: "docs";
+                integration: "integration";
+                mobile: "mobile";
+                platform: "platform";
+                sdk: "sdk";
+                tool: "tool";
+            }>>>;
+        }, z.core.$strip>>>;
+        groupSlug: z.ZodOptional<z.ZodString>;
+        groupName: z.ZodOptional<z.ZodString>;
+        coverageCount: z.ZodOptional<z.ZodNumber>;
+        contentChars: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        contentTokens: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        composition: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            bugs: z.ZodNumber;
+            features: z.ZodNumber;
+            enhancements: z.ZodNumber;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+    pagination: z.ZodObject<{
+        nextCursor: z.ZodNullable<z.ZodString>;
+        limit: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type FollowTarget = z.infer<typeof FollowTargetSchema>;
+export type Follow = z.infer<typeof FollowSchema>;
+export type FollowsListResponse = z.infer<typeof FollowsListResponseSchema>;
+export type FollowRequest = z.infer<typeof FollowRequestSchema>;
+export type FollowMutationResponse = z.infer<typeof FollowMutationResponseSchema>;
+export type PersonalizedFeedPagination = z.infer<typeof PersonalizedFeedPaginationSchema>;
+export type PersonalizedFeedResponse = z.infer<typeof PersonalizedFeedResponseSchema>;
+//# sourceMappingURL=follows.d.ts.map

package/dist/schemas/follows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"follows.d.ts","sourceRoot":"","sources":["../../src/schemas/follows.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,0FAA0F;AAE1F,8BAA8B;AAC9B,eAAO,MAAM,kBAAkB;;;EAA6B,CAAC;AAE7D,gFAAgF;AAChF,eAAO,MAAM,YAAY;;;;;;;;;;;iBASvB,CAAC;AAEH,mCAAmC;AACnC,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;iBAEpC,CAAC;AAEH,oFAAoF;AACpF,eAAO,MAAM,mBAAmB;;;;;;iBAG9B,CAAC;AAEH,2CAA2C;AAC3C,eAAO,MAAM,4BAA4B;;;iBAGvC,CAAC;AAEH,iFAAiF;AACjF,eAAO,MAAM,gCAAgC;;;iBAA0B,CAAC;AAExE;;;;GAIG;AACH,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAGzC,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAClD,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC5E,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAClF,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAC;AAC1F,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC"}

package/dist/schemas/follows.js

@@ -0,0 +1,42 @@
+import { z } from "zod";
+import { OrgFeedPaginationSchema } from "./orgs.js";
+import { ReleaseLatestItemSchema } from "./releases.js";
+/** Follows and the personalized feed, served under `/v1/me/follows` and `/v1/me/feed`. */
+/** What a user can follow. */
+export const FollowTargetSchema = z.enum(["org", "product"]);
+/** A user's follow, enriched for rendering (returned by GET /v1/me/follows). */
+export const FollowSchema = z.object({
+    targetType: FollowTargetSchema,
+    targetId: z.string(),
+    name: z.string(),
+    slug: z.string(),
+    avatarUrl: z.string().nullable(),
+    /** Owning org slug for product follows (null for org follows). */
+    orgSlug: z.string().nullable(),
+    createdAt: z.string(),
+});
+/** GET /v1/me/follows response. */
+export const FollowsListResponseSchema = z.object({
+    follows: z.array(FollowSchema),
+});
+/** POST /v1/me/follows request body. Following an org also follows its products. */
+export const FollowRequestSchema = z.object({
+    targetType: FollowTargetSchema,
+    targetId: z.string().min(1).describe("The org or product id (`org_…` / `prod_…`)."),
+});
+/** POST/DELETE /v1/me/follows response. */
+export const FollowMutationResponseSchema = z.object({
+    success: z.literal(true),
+    following: z.boolean(),
+});
+/** Cursor pagination shape for GET /v1/me/feed (same as other release feeds). */
+export const PersonalizedFeedPaginationSchema = OrgFeedPaginationSchema;
+/**
+ * GET /v1/me/feed response — the personalized release feed. Reuses the same item
+ * shape as /v1/releases/latest (ReleaseLatestItem); cursor-paginated like other
+ * feed-shaped surfaces.
+ */
+export const PersonalizedFeedResponseSchema = z.object({
+    items: z.array(ReleaseLatestItemSchema),
+    pagination: PersonalizedFeedPaginationSchema,
+});

package/dist/schemas/listing.d.ts

@@ -0,0 +1,374 @@
+import { z } from "zod";
+/**
+ * Public wire contract for the self-serve listing lane (#1947):
+ * 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 declare const ListingValidateBodySchema: z.ZodObject<{
+    domain: z.ZodString;
+}, z.core.$strict>;
+export type ListingValidateBody = z.infer<typeof ListingValidateBodySchema>;
+export declare const ListingActivateBodySchema: z.ZodObject<{
+    domain: z.ZodString;
+    requestTracking: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+export type ListingActivateBody = z.infer<typeof ListingActivateBodySchema>;
+export declare const ListingIssueSchema: z.ZodObject<{
+    path: z.ZodString;
+    message: z.ZodString;
+}, z.core.$strict>;
+export type ListingIssue = z.infer<typeof ListingIssueSchema>;
+/** One follow-up the owner takes after declaring `publish: "push"`. */
+export declare const ListingSetupStepSchema: z.ZodObject<{
+    id: z.ZodEnum<{
+        action: "action";
+        token: "token";
+        verify: "verify";
+    }>;
+    title: z.ZodString;
+    detail: z.ZodString;
+}, z.core.$strict>;
+export type ListingSetupStep = z.infer<typeof ListingSetupStepSchema>;
+export declare const ListingLocationSchema: z.ZodObject<{
+    locator: z.ZodString;
+    kind: z.ZodEnum<{
+        appstore: "appstore";
+        feed: "feed";
+        file: "file";
+        github: "github";
+        push: "push";
+        url: "url";
+    }>;
+    classification: z.ZodEnum<{
+        "push-setup": "push-setup";
+        "tier1-live": "tier1-live";
+        "tier2-paused-review": "tier2-paused-review";
+    }>;
+    becomes: z.ZodString;
+    productName: z.ZodOptional<z.ZodString>;
+    path: z.ZodOptional<z.ZodString>;
+    setupSteps: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodEnum<{
+            action: "action";
+            token: "token";
+            verify: "verify";
+        }>;
+        title: z.ZodString;
+        detail: z.ZodString;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+export type ListingLocation = z.infer<typeof ListingLocationSchema>;
+export declare const ListingOrgPointerSchema: z.ZodObject<{
+    slug: z.ZodString;
+    name: z.ZodString;
+    webUrl: z.ZodString;
+}, z.core.$strict>;
+export type ListingOrgPointer = z.infer<typeof ListingOrgPointerSchema>;
+export declare const ListingValidationResultSchema: z.ZodObject<{
+    valid: z.ZodBoolean;
+    errors: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        message: z.ZodString;
+    }, z.core.$strict>>;
+    domainStatus: z.ZodEnum<{
+        listed: "listed";
+        stub: "stub";
+        unlisted: "unlisted";
+    }>;
+    org: z.ZodOptional<z.ZodObject<{
+        slug: z.ZodString;
+        name: z.ZodString;
+        webUrl: z.ZodString;
+    }, z.core.$strict>>;
+    identity: z.ZodOptional<z.ZodObject<{
+        name: z.ZodString;
+        slug: z.ZodString;
+        domain: z.ZodString;
+    }, z.core.$strict>>;
+    products: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        locationCount: z.ZodNumber;
+    }, z.core.$strict>>>;
+    locations: z.ZodArray<z.ZodObject<{
+        locator: z.ZodString;
+        kind: z.ZodEnum<{
+            appstore: "appstore";
+            feed: "feed";
+            file: "file";
+            github: "github";
+            push: "push";
+            url: "url";
+        }>;
+        classification: z.ZodEnum<{
+            "push-setup": "push-setup";
+            "tier1-live": "tier1-live";
+            "tier2-paused-review": "tier2-paused-review";
+        }>;
+        becomes: z.ZodString;
+        productName: z.ZodOptional<z.ZodString>;
+        path: z.ZodOptional<z.ZodString>;
+        setupSteps: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodEnum<{
+                action: "action";
+                token: "token";
+                verify: "verify";
+            }>;
+            title: z.ZodString;
+            detail: z.ZodString;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type ListingValidationResult = z.infer<typeof ListingValidationResultSchema>;
+export declare const ListingActivateResultSchema: z.ZodObject<{
+    activated: z.ZodBoolean;
+    org: z.ZodObject<{
+        slug: z.ZodString;
+        name: z.ZodString;
+        status: z.ZodEnum<{
+            stub: "stub";
+            tracked: "tracked";
+        }>;
+        webUrl: z.ZodString;
+    }, z.core.$strict>;
+    trackingRequested: z.ZodBoolean;
+}, z.core.$strict>;
+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 declare const ListingClaimBodySchema: z.ZodObject<{
+    domain: z.ZodString;
+}, z.core.$strict>;
+export type ListingClaimBody = z.infer<typeof ListingClaimBodySchema>;
+export declare const ListingClaimVerifyBodySchema: z.ZodObject<{
+    claimId: z.ZodString;
+}, z.core.$strict>;
+export type ListingClaimVerifyBody = z.infer<typeof ListingClaimVerifyBodySchema>;
+export declare const OrgClaimStatusSchema: z.ZodEnum<{
+    expired: "expired";
+    pending: "pending";
+    revoked: "revoked";
+    verified: "verified";
+}>;
+export type OrgClaimStatus = z.infer<typeof OrgClaimStatusSchema>;
+export declare const ClaimMethodSchema: z.ZodEnum<{
+    "dns-txt": "dns-txt";
+    "well-known": "well-known";
+}>;
+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 declare const OrgClaimSchema: z.ZodObject<{
+    id: z.ZodString;
+    org: z.ZodObject<{
+        slug: z.ZodString;
+        name: z.ZodString;
+        webUrl: z.ZodString;
+    }, z.core.$strict>;
+    status: z.ZodEnum<{
+        expired: "expired";
+        pending: "pending";
+        revoked: "revoked";
+        verified: "verified";
+    }>;
+    method: z.ZodOptional<z.ZodEnum<{
+        "dns-txt": "dns-txt";
+        "well-known": "well-known";
+    }>>;
+    token: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodString;
+    verifiedAt: z.ZodOptional<z.ZodString>;
+    revokedAt: z.ZodOptional<z.ZodString>;
+    expiresAt: z.ZodString;
+    instructions: z.ZodOptional<z.ZodObject<{
+        wellKnownUrl: z.ZodString;
+        dnsRecordName: z.ZodString;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type OrgClaim = z.infer<typeof OrgClaimSchema>;
+export declare const ClaimCheckOutcomeSchema: z.ZodEnum<{
+    mismatch: "mismatch";
+    ok: "ok";
+    unreachable: "unreachable";
+}>;
+export type ClaimCheckOutcome = z.infer<typeof ClaimCheckOutcomeSchema>;
+export declare const ClaimVerifyResultSchema: z.ZodObject<{
+    verified: z.ZodBoolean;
+    checked: z.ZodObject<{
+        wellKnown: z.ZodEnum<{
+            mismatch: "mismatch";
+            ok: "ok";
+            unreachable: "unreachable";
+        }>;
+        dnsTxt: z.ZodEnum<{
+            mismatch: "mismatch";
+            ok: "ok";
+            unreachable: "unreachable";
+        }>;
+    }, z.core.$strict>;
+    claim: z.ZodObject<{
+        id: z.ZodString;
+        org: z.ZodObject<{
+            slug: z.ZodString;
+            name: z.ZodString;
+            webUrl: z.ZodString;
+        }, z.core.$strict>;
+        status: z.ZodEnum<{
+            expired: "expired";
+            pending: "pending";
+            revoked: "revoked";
+            verified: "verified";
+        }>;
+        method: z.ZodOptional<z.ZodEnum<{
+            "dns-txt": "dns-txt";
+            "well-known": "well-known";
+        }>>;
+        token: z.ZodOptional<z.ZodString>;
+        createdAt: z.ZodString;
+        verifiedAt: z.ZodOptional<z.ZodString>;
+        revokedAt: z.ZodOptional<z.ZodString>;
+        expiresAt: z.ZodString;
+        instructions: z.ZodOptional<z.ZodObject<{
+            wellKnownUrl: z.ZodString;
+            dnsRecordName: z.ZodString;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type ClaimVerifyResult = z.infer<typeof ClaimVerifyResultSchema>;
+export declare const ListingClaimsResultSchema: z.ZodObject<{
+    claims: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        org: z.ZodObject<{
+            slug: z.ZodString;
+            name: z.ZodString;
+            webUrl: z.ZodString;
+        }, z.core.$strict>;
+        status: z.ZodEnum<{
+            expired: "expired";
+            pending: "pending";
+            revoked: "revoked";
+            verified: "verified";
+        }>;
+        method: z.ZodOptional<z.ZodEnum<{
+            "dns-txt": "dns-txt";
+            "well-known": "well-known";
+        }>>;
+        token: z.ZodOptional<z.ZodString>;
+        createdAt: z.ZodString;
+        verifiedAt: z.ZodOptional<z.ZodString>;
+        revokedAt: z.ZodOptional<z.ZodString>;
+        expiresAt: z.ZodString;
+        instructions: z.ZodOptional<z.ZodObject<{
+            wellKnownUrl: z.ZodString;
+            dnsRecordName: z.ZodString;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+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 declare const AdminOrgClaimSchema: z.ZodObject<{
+    id: z.ZodString;
+    userId: z.ZodString;
+    status: z.ZodEnum<{
+        expired: "expired";
+        pending: "pending";
+        revoked: "revoked";
+        verified: "verified";
+    }>;
+    method: z.ZodNullable<z.ZodEnum<{
+        "dns-txt": "dns-txt";
+        "well-known": "well-known";
+    }>>;
+    createdAt: z.ZodString;
+    verifiedAt: z.ZodNullable<z.ZodString>;
+    expiresAt: z.ZodString;
+    revokedAt: z.ZodNullable<z.ZodString>;
+    revokedBy: z.ZodNullable<z.ZodString>;
+    revokeReason: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>;
+export type AdminOrgClaim = z.infer<typeof AdminOrgClaimSchema>;
+export declare const ListOrgClaimsResponseSchema: z.ZodObject<{
+    claims: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        userId: z.ZodString;
+        status: z.ZodEnum<{
+            expired: "expired";
+            pending: "pending";
+            revoked: "revoked";
+            verified: "verified";
+        }>;
+        method: z.ZodNullable<z.ZodEnum<{
+            "dns-txt": "dns-txt";
+            "well-known": "well-known";
+        }>>;
+        createdAt: z.ZodString;
+        verifiedAt: z.ZodNullable<z.ZodString>;
+        expiresAt: z.ZodString;
+        revokedAt: z.ZodNullable<z.ZodString>;
+        revokedBy: z.ZodNullable<z.ZodString>;
+        revokeReason: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type ListOrgClaimsResponse = z.infer<typeof ListOrgClaimsResponseSchema>;
+/** `DELETE /v1/orgs/:slug/claims/:id` body — admins must say why. */
+export declare const RevokeOrgClaimBodySchema: z.ZodObject<{
+    reason: z.ZodString;
+}, z.core.$strict>;
+export type RevokeOrgClaimBody = z.infer<typeof RevokeOrgClaimBodySchema>;
+/**
+ * Self-serve Tier-1 promotion (#1947): a verified owner
+ * promotes their claimed stub to `tracked`. Independent of the internal
+ * materialization plan — this is the stable public projection.
+ */
+export declare const ListingPromoteBodySchema: z.ZodObject<{
+    domain: z.ZodString;
+}, z.core.$strict>;
+export type ListingPromoteBody = z.infer<typeof ListingPromoteBodySchema>;
+export declare const ListingPromoteLocatorOutcomeSchema: z.ZodEnum<{
+    live: "live";
+    "queued-for-review": "queued-for-review";
+}>;
+export type ListingPromoteLocatorOutcome = z.infer<typeof ListingPromoteLocatorOutcomeSchema>;
+export declare const ListingPromoteLocatorSchema: z.ZodObject<{
+    locator: z.ZodString;
+    outcome: z.ZodEnum<{
+        live: "live";
+        "queued-for-review": "queued-for-review";
+    }>;
+}, z.core.$strict>;
+export type ListingPromoteLocator = z.infer<typeof ListingPromoteLocatorSchema>;
+export declare const ListingPromoteResultSchema: z.ZodObject<{
+    promoted: z.ZodBoolean;
+    alreadyTracked: z.ZodOptional<z.ZodBoolean>;
+    sources: z.ZodObject<{
+        created: z.ZodNumber;
+        matched: z.ZodNumber;
+    }, z.core.$strict>;
+    locators: z.ZodArray<z.ZodObject<{
+        locator: z.ZodString;
+        outcome: z.ZodEnum<{
+            live: "live";
+            "queued-for-review": "queued-for-review";
+        }>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+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 declare const ListingCapabilitiesSchema: z.ZodObject<{
+    selfServeEnabled: z.ZodBoolean;
+    promotionEnabled: z.ZodBoolean;
+}, z.core.$strict>;
+export type ListingCapabilities = z.infer<typeof ListingCapabilitiesSchema>;
+//# sourceMappingURL=listing.d.ts.map

package/dist/schemas/listing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"listing.d.ts","sourceRoot":"","sources":["../../src/schemas/listing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;GAKG;AAEH,eAAO,MAAM,yBAAyB;;kBAEpC,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,eAAO,MAAM,yBAAyB;;;kBAGpC,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,eAAO,MAAM,kBAAkB;;;kBAG7B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,uEAAuE;AACvE,eAAO,MAAM,sBAAsB;;;;;;;;kBAIjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAahC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,eAAO,MAAM,uBAAuB;;;;kBAIlC,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAgBxC,CAAC;AACH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAEpF,eAAO,MAAM,2BAA2B;;;;;;;;;;;;kBAUtC,CAAC;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF;;;GAGG;AAEH,eAAO,MAAM,sBAAsB;;kBAEjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,eAAO,MAAM,4BAA4B;;kBAEvC,CAAC;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAElF,eAAO,MAAM,oBAAoB;;;;;EAAwD,CAAC;AAC1F,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,eAAO,MAAM,iBAAiB;;;EAAoC,CAAC;AACnE,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D;;;;GAIG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;kBAiBzB,CAAC;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD,eAAO,MAAM,uBAAuB;;;;EAA4C,CAAC;AACjF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAOlC,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAEpC,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;kBAW9B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;kBAEtC,CAAC;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF,qEAAqE;AACrE,eAAO,MAAM,wBAAwB;;kBAEnC,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E;;;;GAIG;AAEH,eAAO,MAAM,wBAAwB;;kBAEnC,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,eAAO,MAAM,kCAAkC;;;EAAwC,CAAC;AACxF,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAC;AAE9F,eAAO,MAAM,2BAA2B;;;;;;kBAGtC,CAAC;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;kBASrC,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E;;;;GAIG;AACH,eAAO,MAAM,yBAAyB;;;kBAKpC,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC"}