founder-schema 0.8.0 → 0.10.0

package/dist/domains/communities/communities.d.ts

@@ -0,0 +1,1537 @@
+/**
+ * founder-schema — Communities: official spaces inside Founder Circle (0.9.0)
+ *
+ * THE USER'S DECISIONS (2026-10-08), each asked on its own:
+ *
+ *   - OFFICIAL: managers, super admins, and members given the
+ *     `create_communities` capability create them. Everyone else SUGGESTS one;
+ *     managers and super admins review the suggestions.
+ *   - THREE TYPES, three separate questions answered per type:
+ *
+ *                              public          private          hidden
+ *       listed in Discover     yes             yes              no
+ *       header (name, about,   signed-in       signed-in        members and
+ *       rules, admins, count)  members         members          invitees (404 otherwise)
+ *       posts, polls, members  signed-in       members only     members only
+ *       joining                one tap         request, then    invite only,
+ *                                              approval         then accept
+ *
+ *     Taking part (post, poll, comment, react, vote, save, report) is for
+ *     members of every type. "Members" means ACTIVE members: someone who
+ *     requested, was invited or is banned is a non-member for every rule.
+ *   - PUBLIC MEANS PUBLIC INSIDE FOUNDER CIRCLE: a signed-out visitor sees no
+ *     community content of any type, even by a shared link.
+ *   - THE HOME FEED adds only the communities the member joined.
+ *   - NO CHAT IN 0.9.0 (feed-first). Announcements are pinned posts
+ *     (`COMMUNITY_PINS_MAX`), optionally notifying every member.
+ *
+ * A banned member sees the community as hidden (404 everywhere) until
+ * unbanned. Platform staff acting as moderator, manager or super admin READ
+ * every community, as they read every post, and moderate its content through
+ * the staff moderation queue; to take part they join like anyone else.
+ *
+ * Refusals follow what the caller can SEE: 404 for something they may not
+ * see (the same as for something that does not exist, so nothing is
+ * probed), 403 `COMMUNITY_JOIN_REQUIRED` for something they see but must join
+ * to read or to take part in.
+ *
+ * Content in a community carries no product and no ask, and cannot be
+ * reposted (a repost is general content, readable signed out): two leak paths
+ * closed by construction. Design: founder-circle-backend `docs/communities.md`.
+ *
+ * Inside a community:
+ *
+ *                                         member  moderator  admin  manager,
+ *                                                                     super admin
+ *   post, poll, comment, react, vote        ✓        ✓         ✓      ✓ (a member)
+ *   approve requests, invite, pin, hide              ✓         ✓      ✓
+ *   remove a member (not a moderator)                ✓         ✓      ✓
+ *   remove a moderator                                         ✓      ✓
+ *   remove or ban an admin                                            ✓
+ *   notify all, ban, roles, edit, type                         ✓      ✓
+ *   archive, delete                                                   ✓
+ *
+ * An admin may unmake another admin (then act on them as on a member). Each
+ * member row says what this viewer may do to it (`communityMemberSchema.viewer`):
+ * a client never works it out from roles.
+ *
+ * A community always keeps an admin while anyone can be one
+ * (`COMMUNITY_LAST_ADMIN`): an admin leaves, steps down, or deletes their
+ * account only once someone else is admin (the user's rule, 2026-10-08). When
+ * nobody else is active, or the account was deleted where it cannot be
+ * refused (central sign-in), the community is ORPHANED: managers and super
+ * admins run it (they can act on any community), it is flagged in the audit
+ * log (`community.orphaned`), and the page says so to them (`orphaned`).
+ *
+ * Routes (all signed in):
+ *   GET    /api/v1/communities                          communityDiscoverQuerySchema -> communityCardPageSchema
+ *   GET    /api/v1/communities/mine                     paginationQuerySchema -> communityCardPageSchema
+ *   GET    /api/v1/communities/invites                  communityInvitesSchema (mine, waiting)
+ *   GET    /api/v1/communities/orphaned                 paginationQuerySchema -> communityCardPageSchema
+ *          (managers, super admins: communities left with no admin, newest first)
+ *   POST   /api/v1/communities                          createCommunityBodySchema -> IdResponse
+ *   GET    /api/v1/communities/:communityId             communitySchema
+ *   PATCH  /api/v1/communities/:communityId             updateCommunityBodySchema -> communitySchema
+ *   PUT    /api/v1/communities/:communityId/icon        setCommunityIconBodySchema -> communitySchema
+ *   DELETE /api/v1/communities/:communityId/icon        -> communitySchema
+ *   PUT    /api/v1/communities/:communityId/visibility  setCommunityVisibilityBodySchema -> communitySchema
+ *   PUT    /api/v1/communities/:communityId/status      setCommunityStatusBodySchema -> communitySchema (staff)
+ *   DELETE /api/v1/communities/:communityId             -> IdResponse (staff)
+ *   GET    /api/v1/communities/:communityId/feed        paginationQuerySchema -> FeedPage (newest first;
+ *                                                        pinned items are in it too, in their place)
+ *   GET    /api/v1/communities/:communityId/pinned      PinnedItems (feed)
+ *   POST   /api/v1/communities/:communityId/pins        pinCommunityContentBodySchema -> PinnedItems
+ *   DELETE /api/v1/communities/:communityId/pins/:contentId  -> PinnedItems
+ *   POST   /api/v1/communities/:communityId/join        -> communitySchema (public: joined; private: requested)
+ *   DELETE /api/v1/communities/:communityId/join        cancel a request -> communitySchema
+ *   POST   /api/v1/communities/:communityId/leave       -> IdResponse
+ *   GET    /api/v1/communities/:communityId/members     communityMembersQuerySchema -> communityMemberPageSchema
+ *   GET    /api/v1/communities/:communityId/requests    paginationQuerySchema -> communityRequestPageSchema
+ *   PUT    /api/v1/communities/:communityId/requests/:userId     approve -> IdResponse
+ *   DELETE /api/v1/communities/:communityId/requests/:userId     decline -> IdResponse
+ *   GET    /api/v1/communities/:communityId/invites     paginationQuerySchema -> communityPendingInvitePageSchema
+ *   POST   /api/v1/communities/:communityId/invites     inviteCommunityMemberBodySchema -> communityPendingInviteSchema
+ *   DELETE /api/v1/communities/:communityId/invites/:userId      cancel -> IdResponse
+ *   PUT    /api/v1/communities/:communityId/invite      accept (the invitee) -> communitySchema
+ *   DELETE /api/v1/communities/:communityId/invite      decline (the invitee) -> IdResponse
+ *   PUT    /api/v1/communities/:communityId/members/:userId/role setCommunityMemberRoleBodySchema -> IdResponse
+ *   DELETE /api/v1/communities/:communityId/members/:userId      remove -> IdResponse
+ *   GET    /api/v1/communities/:communityId/bans        paginationQuerySchema -> communityBanPageSchema
+ *   POST   /api/v1/communities/:communityId/bans        banCommunityMemberBodySchema -> IdResponse
+ *   DELETE /api/v1/communities/:communityId/bans/:userId         unban -> IdResponse
+ *   PUT    /api/v1/communities/:communityId/content/:contentId/hidden   hide in the community -> IdResponse
+ *   DELETE /api/v1/communities/:communityId/content/:contentId/hidden   restore -> IdResponse
+ *   PUT    /api/v1/communities/:communityId/comments/:commentId/hidden  hide a comment in it -> IdResponse
+ *   DELETE /api/v1/communities/:communityId/comments/:commentId/hidden  restore -> IdResponse
+ *   GET    /api/v1/communities/:communityId/hidden       paginationQuerySchema -> FeedPage (moderators:
+ *          what ITS moderators hid, newest first; a staff hide is staff's to undo and is not listed)
+ *   GET    /api/v1/communities/:communityId/hidden/comments  paginationQuerySchema -> commentPageSchema
+ *   POST   /api/v1/community-suggestions                createCommunitySuggestionBodySchema -> communitySuggestionSchema
+ *   GET    /api/v1/community-suggestions/mine           paginationQuerySchema -> communitySuggestionPageSchema
+ *   GET    /api/v1/community-suggestions                communitySuggestionsQuerySchema -> communitySuggestionPageSchema (staff)
+ *   POST   /api/v1/community-suggestions/:suggestionId/approve  createCommunityBodySchema -> IdResponse (the community)
+ *   POST   /api/v1/community-suggestions/:suggestionId/decline  declineCommunitySuggestionBodySchema -> communitySuggestionSchema
+ *   (posting into a community: `communityId` on the feed's create bodies)
+ *
+ * @module founder-schema/domains/communities
+ */
+import { z } from 'zod';
+/** Topics a community carries: what Discover filters by. */
+export declare const COMMUNITY_TOPICS_MAX = 3;
+/** Announcements pinned to the top of one community at once. */
+export declare const COMMUNITY_PINS_MAX = 3;
+/** Suggestions one member may have waiting for review at once. */
+export declare const COMMUNITY_SUGGESTIONS_OPEN_MAX = 3;
+/**
+ * The shortest time between two notify-everyone announcements in one
+ * community, so members are not spammed (`COMMUNITY_ANNOUNCE_TOO_SOON`).
+ */
+export declare const COMMUNITY_ANNOUNCE_INTERVAL_MS: number;
+/** See the module note's table. */
+export declare const COMMUNITY_VISIBILITY_VALUES: readonly ["public", "private", "hidden"];
+export declare const communityVisibilitySchema: z.ZodEnum<{
+    public: "public";
+    private: "private";
+    hidden: "hidden";
+}>;
+export type CommunityVisibility = z.infer<typeof communityVisibilitySchema>;
+/**
+ * How private each type is, least first. A change to a LOWER rank exposes what
+ * was already posted, so it needs `confirmExposure` (and is audited).
+ */
+export declare const COMMUNITY_VISIBILITY_RANK: {
+    readonly public: 0;
+    readonly private: 1;
+    readonly hidden: 2;
+};
+/** Whether moving from one type to another exposes what was already there. */
+export declare function communityChangeExposes(from: CommunityVisibility, to: CommunityVisibility): boolean;
+/** A member's role inside one community. */
+export declare const COMMUNITY_ROLE_VALUES: readonly ["admin", "moderator", "member"];
+export declare const communityRoleSchema: z.ZodEnum<{
+    moderator: "moderator";
+    member: "member";
+    admin: "admin";
+}>;
+export type CommunityRole = z.infer<typeof communityRoleSchema>;
+/**
+ * Where someone stands with one community. `requested` (private: waiting for
+ * approval), `invited` (waiting for their answer), `banned` (the community is
+ * hidden from them). Leaving or being removed deletes the row.
+ */
+export declare const COMMUNITY_MEMBER_STATUS_VALUES: readonly ["active", "requested", "invited", "banned"];
+export declare const communityMemberStatusSchema: z.ZodEnum<{
+    active: "active";
+    requested: "requested";
+    invited: "invited";
+    banned: "banned";
+}>;
+export type CommunityMemberStatus = z.infer<typeof communityMemberStatusSchema>;
+/** `archived`: read-only and out of Discover; members still read it. Staff only. */
+export declare const COMMUNITY_STATUS_VALUES: readonly ["active", "archived"];
+export declare const communityStatusSchema: z.ZodEnum<{
+    active: "active";
+    archived: "archived";
+}>;
+export type CommunityStatus = z.infer<typeof communityStatusSchema>;
+export declare const COMMUNITY_SUGGESTION_STATUS_VALUES: readonly ["open", "approved", "declined"];
+export declare const communitySuggestionStatusSchema: z.ZodEnum<{
+    open: "open";
+    approved: "approved";
+    declined: "declined";
+}>;
+export type CommunitySuggestionStatus = z.infer<typeof communitySuggestionStatusSchema>;
+/**
+ * A community named on something else: "in AI Builders" on a post or poll, a
+ * notification. `iconUrl` is the icon's smallest size.
+ */
+export declare const communityChipSchema: z.ZodObject<{
+    id: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+    slug: z.ZodString;
+    name: z.ZodString;
+    iconUrl: z.ZodOptional<z.ZodURL>;
+    visibility: z.ZodEnum<{
+        public: "public";
+        private: "private";
+        hidden: "hidden";
+    }>;
+    archived: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type CommunityChip = z.infer<typeof communityChipSchema>;
+/** Where THIS viewer stands with a community, on a card. Banned viewers never see it. */
+export declare const communityCardViewerSchema: z.ZodObject<{
+    status: z.ZodNullable<z.ZodEnum<{
+        active: "active";
+        requested: "requested";
+        invited: "invited";
+    }>>;
+    role: z.ZodNullable<z.ZodEnum<{
+        moderator: "moderator";
+        member: "member";
+        admin: "admin";
+    }>>;
+}, z.core.$strip>;
+export type CommunityCardViewer = z.infer<typeof communityCardViewerSchema>;
+/** A community on Discover and in "your communities". */
+export declare const communityCardSchema: z.ZodObject<{
+    id: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+    slug: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodString;
+    icon: z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        url: z.ZodURL;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+        variants: z.ZodArray<z.ZodObject<{
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+            url: z.ZodURL;
+        }, z.core.$strip>>;
+        placeholder: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    visibility: z.ZodEnum<{
+        public: "public";
+        private: "private";
+        hidden: "hidden";
+    }>;
+    status: z.ZodEnum<{
+        active: "active";
+        archived: "archived";
+    }>;
+    topics: z.ZodArray<z.ZodEnum<{
+        ai_ml: "ai_ml";
+        b2b_saas: "b2b_saas";
+        d2c: "d2c";
+        deeptech: "deeptech";
+        robotics: "robotics";
+        growth: "growth";
+        sales: "sales";
+        marketing: "marketing";
+        supply_chain: "supply_chain";
+        fundraising: "fundraising";
+        mentoring: "mentoring";
+        leadership: "leadership";
+        networking: "networking";
+        public_speaking: "public_speaking";
+        teaching: "teaching";
+        hiring_talent: "hiring_talent";
+        personal_branding: "personal_branding";
+        career_transition: "career_transition";
+        remote_work: "remote_work";
+        blockchain: "blockchain";
+        crypto_web3: "crypto_web3";
+        data_science: "data_science";
+        cybersecurity: "cybersecurity";
+        game_dev: "game_dev";
+        ux_design: "ux_design";
+        app_development: "app_development";
+        open_source: "open_source";
+        electronics: "electronics";
+        space_exploration: "space_exploration";
+        green_tech: "green_tech";
+        no_code: "no_code";
+        entrepreneurship: "entrepreneurship";
+        investing: "investing";
+        stock_trading: "stock_trading";
+        personal_finance: "personal_finance";
+        consulting: "consulting";
+        ecommerce: "ecommerce";
+        retail: "retail";
+        real_estate: "real_estate";
+        product_management: "product_management";
+        meditation: "meditation";
+        journaling: "journaling";
+        self_improvement: "self_improvement";
+        productivity: "productivity";
+        reading: "reading";
+        online_courses: "online_courses";
+        philosophy: "philosophy";
+        psychology: "psychology";
+        therapy: "therapy";
+        sleep_optimization: "sleep_optimization";
+        gym: "gym";
+        yoga: "yoga";
+        photography: "photography";
+        writing: "writing";
+        graphic_design: "graphic_design";
+        filmmaking: "filmmaking";
+        digital_art: "digital_art";
+        content_creation: "content_creation";
+        blogging: "blogging";
+        vlogging: "vlogging";
+        podcasts: "podcasts";
+        animation: "animation";
+        music_production: "music_production";
+        volunteering: "volunteering";
+        ngo_work: "ngo_work";
+        environmental: "environmental";
+        women_empowerment: "women_empowerment";
+        community_service: "community_service";
+        social_enterprise: "social_enterprise";
+        education_access: "education_access";
+    }>>;
+    memberCount: z.ZodNumber;
+    postCount: z.ZodNumber;
+    viewer: z.ZodOptional<z.ZodObject<{
+        status: z.ZodNullable<z.ZodEnum<{
+            active: "active";
+            requested: "requested";
+            invited: "invited";
+        }>>;
+        role: z.ZodNullable<z.ZodEnum<{
+            moderator: "moderator";
+            member: "member";
+            admin: "admin";
+        }>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type CommunityCard = z.infer<typeof communityCardSchema>;
+/**
+ * What THIS viewer may do on the community page, decided by the server and
+ * sent as plain answers (the rule of `viewerStateSchema` on a post): a client
+ * never derives a power from `role`.
+ */
+export declare const communityViewerSchema: z.ZodObject<{
+    status: z.ZodNullable<z.ZodEnum<{
+        active: "active";
+        requested: "requested";
+        invited: "invited";
+    }>>;
+    role: z.ZodNullable<z.ZodEnum<{
+        moderator: "moderator";
+        member: "member";
+        admin: "admin";
+    }>>;
+    canRead: z.ZodBoolean;
+    canSeeMembers: z.ZodBoolean;
+    canJoin: z.ZodBoolean;
+    canRequest: z.ZodBoolean;
+    canPost: z.ZodBoolean;
+    canLeave: z.ZodBoolean;
+    canModerate: z.ZodBoolean;
+    canManage: z.ZodBoolean;
+    canAnnounce: z.ZodBoolean;
+    canArchive: z.ZodBoolean;
+}, z.core.$strip>;
+export type CommunityViewer = z.infer<typeof communityViewerSchema>;
+/**
+ * One person in a community, live-joined like every byline. In the member
+ * list, admins first, then moderators, then members, each by when they joined.
+ * `viewer` (0.9.0, on the member list only) is what THIS viewer may do to
+ * them, the server's own rules (who outranks whom, never oneself, never the
+ * last admin).
+ */
+export declare const communityMemberSchema: z.ZodObject<{
+    userId: z.ZodString;
+    username: z.ZodString;
+    displayName: z.ZodString;
+    avatarUrl: z.ZodOptional<z.ZodURL>;
+    headline: z.ZodOptional<z.ZodString>;
+    role: z.ZodEnum<{
+        moderator: "moderator";
+        member: "member";
+        admin: "admin";
+    }>;
+    joinedAt: z.ZodISODateTime;
+    viewer: z.ZodOptional<z.ZodObject<{
+        canSetRole: z.ZodBoolean;
+        canRemove: z.ZodBoolean;
+        canBan: z.ZodBoolean;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type CommunityMember = z.infer<typeof communityMemberSchema>;
+/** The community page. The header is what a non-member of a private one may see too. */
+export declare const communitySchema: z.ZodObject<{
+    id: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+    slug: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodString;
+    icon: z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        url: z.ZodURL;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+        variants: z.ZodArray<z.ZodObject<{
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+            url: z.ZodURL;
+        }, z.core.$strip>>;
+        placeholder: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    visibility: z.ZodEnum<{
+        public: "public";
+        private: "private";
+        hidden: "hidden";
+    }>;
+    status: z.ZodEnum<{
+        active: "active";
+        archived: "archived";
+    }>;
+    topics: z.ZodArray<z.ZodEnum<{
+        ai_ml: "ai_ml";
+        b2b_saas: "b2b_saas";
+        d2c: "d2c";
+        deeptech: "deeptech";
+        robotics: "robotics";
+        growth: "growth";
+        sales: "sales";
+        marketing: "marketing";
+        supply_chain: "supply_chain";
+        fundraising: "fundraising";
+        mentoring: "mentoring";
+        leadership: "leadership";
+        networking: "networking";
+        public_speaking: "public_speaking";
+        teaching: "teaching";
+        hiring_talent: "hiring_talent";
+        personal_branding: "personal_branding";
+        career_transition: "career_transition";
+        remote_work: "remote_work";
+        blockchain: "blockchain";
+        crypto_web3: "crypto_web3";
+        data_science: "data_science";
+        cybersecurity: "cybersecurity";
+        game_dev: "game_dev";
+        ux_design: "ux_design";
+        app_development: "app_development";
+        open_source: "open_source";
+        electronics: "electronics";
+        space_exploration: "space_exploration";
+        green_tech: "green_tech";
+        no_code: "no_code";
+        entrepreneurship: "entrepreneurship";
+        investing: "investing";
+        stock_trading: "stock_trading";
+        personal_finance: "personal_finance";
+        consulting: "consulting";
+        ecommerce: "ecommerce";
+        retail: "retail";
+        real_estate: "real_estate";
+        product_management: "product_management";
+        meditation: "meditation";
+        journaling: "journaling";
+        self_improvement: "self_improvement";
+        productivity: "productivity";
+        reading: "reading";
+        online_courses: "online_courses";
+        philosophy: "philosophy";
+        psychology: "psychology";
+        therapy: "therapy";
+        sleep_optimization: "sleep_optimization";
+        gym: "gym";
+        yoga: "yoga";
+        photography: "photography";
+        writing: "writing";
+        graphic_design: "graphic_design";
+        filmmaking: "filmmaking";
+        digital_art: "digital_art";
+        content_creation: "content_creation";
+        blogging: "blogging";
+        vlogging: "vlogging";
+        podcasts: "podcasts";
+        animation: "animation";
+        music_production: "music_production";
+        volunteering: "volunteering";
+        ngo_work: "ngo_work";
+        environmental: "environmental";
+        women_empowerment: "women_empowerment";
+        community_service: "community_service";
+        social_enterprise: "social_enterprise";
+        education_access: "education_access";
+    }>>;
+    memberCount: z.ZodNumber;
+    postCount: z.ZodNumber;
+    rules: z.ZodArray<z.ZodString>;
+    team: z.ZodArray<z.ZodObject<{
+        userId: z.ZodString;
+        username: z.ZodString;
+        displayName: z.ZodString;
+        avatarUrl: z.ZodOptional<z.ZodURL>;
+        headline: z.ZodOptional<z.ZodString>;
+        role: z.ZodEnum<{
+            moderator: "moderator";
+            member: "member";
+            admin: "admin";
+        }>;
+        joinedAt: z.ZodISODateTime;
+        viewer: z.ZodOptional<z.ZodObject<{
+            canSetRole: z.ZodBoolean;
+            canRemove: z.ZodBoolean;
+            canBan: z.ZodBoolean;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    createdAt: z.ZodISODateTime;
+    updatedAt: z.ZodISODateTime;
+    archivedAt: z.ZodNullable<z.ZodISODateTime>;
+    orphaned: z.ZodOptional<z.ZodBoolean>;
+    viewer: z.ZodOptional<z.ZodObject<{
+        status: z.ZodNullable<z.ZodEnum<{
+            active: "active";
+            requested: "requested";
+            invited: "invited";
+        }>>;
+        role: z.ZodNullable<z.ZodEnum<{
+            moderator: "moderator";
+            member: "member";
+            admin: "admin";
+        }>>;
+        canRead: z.ZodBoolean;
+        canSeeMembers: z.ZodBoolean;
+        canJoin: z.ZodBoolean;
+        canRequest: z.ZodBoolean;
+        canPost: z.ZodBoolean;
+        canLeave: z.ZodBoolean;
+        canModerate: z.ZodBoolean;
+        canManage: z.ZodBoolean;
+        canAnnounce: z.ZodBoolean;
+        canArchive: z.ZodBoolean;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type Community = z.infer<typeof communitySchema>;
+/** A request to join a private community, as its moderators see it. */
+export declare const communityRequestSchema: z.ZodObject<{
+    member: z.ZodObject<{
+        userId: z.ZodString;
+        username: z.ZodString;
+        displayName: z.ZodString;
+        avatarUrl: z.ZodOptional<z.ZodURL>;
+        headline: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    requestedAt: z.ZodISODateTime;
+}, z.core.$strip>;
+export type CommunityRequest = z.infer<typeof communityRequestSchema>;
+/** An invitation nobody has answered yet, as its moderators see it. */
+export declare const communityPendingInviteSchema: z.ZodObject<{
+    member: z.ZodObject<{
+        userId: z.ZodString;
+        username: z.ZodString;
+        displayName: z.ZodString;
+        avatarUrl: z.ZodOptional<z.ZodURL>;
+        headline: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    invitedBy: z.ZodNullable<z.ZodObject<{
+        userId: z.ZodString;
+        username: z.ZodString;
+        displayName: z.ZodString;
+        avatarUrl: z.ZodOptional<z.ZodURL>;
+        headline: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    invitedAt: z.ZodISODateTime;
+}, z.core.$strip>;
+export type CommunityPendingInvite = z.infer<typeof communityPendingInviteSchema>;
+/** An invitation waiting for the viewer's answer. */
+export declare const communityInviteSchema: z.ZodObject<{
+    community: z.ZodObject<{
+        id: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+        slug: z.ZodString;
+        name: z.ZodString;
+        iconUrl: z.ZodOptional<z.ZodURL>;
+        visibility: z.ZodEnum<{
+            public: "public";
+            private: "private";
+            hidden: "hidden";
+        }>;
+        archived: z.ZodOptional<z.ZodBoolean>;
+        description: z.ZodString;
+    }, z.core.$strip>;
+    invitedBy: z.ZodNullable<z.ZodObject<{
+        userId: z.ZodString;
+        username: z.ZodString;
+        displayName: z.ZodString;
+        avatarUrl: z.ZodOptional<z.ZodURL>;
+        headline: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    invitedAt: z.ZodISODateTime;
+}, z.core.$strip>;
+export type CommunityInvite = z.infer<typeof communityInviteSchema>;
+/** `GET /communities/invites`. Never paged: invitations are few, and each needs an answer. */
+export declare const communityInvitesSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        community: z.ZodObject<{
+            id: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+            slug: z.ZodString;
+            name: z.ZodString;
+            iconUrl: z.ZodOptional<z.ZodURL>;
+            visibility: z.ZodEnum<{
+                public: "public";
+                private: "private";
+                hidden: "hidden";
+            }>;
+            archived: z.ZodOptional<z.ZodBoolean>;
+            description: z.ZodString;
+        }, z.core.$strip>;
+        invitedBy: z.ZodNullable<z.ZodObject<{
+            userId: z.ZodString;
+            username: z.ZodString;
+            displayName: z.ZodString;
+            avatarUrl: z.ZodOptional<z.ZodURL>;
+            headline: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        invitedAt: z.ZodISODateTime;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type CommunityInvites = z.infer<typeof communityInvitesSchema>;
+/** Someone banned from a community, as its admins see it. */
+export declare const communityBanSchema: z.ZodObject<{
+    member: z.ZodObject<{
+        userId: z.ZodString;
+        username: z.ZodString;
+        displayName: z.ZodString;
+        avatarUrl: z.ZodOptional<z.ZodURL>;
+        headline: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    bannedBy: z.ZodNullable<z.ZodObject<{
+        userId: z.ZodString;
+        username: z.ZodString;
+        displayName: z.ZodString;
+        avatarUrl: z.ZodOptional<z.ZodURL>;
+        headline: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    bannedAt: z.ZodISODateTime;
+    reason: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type CommunityBan = z.infer<typeof communityBanSchema>;
+/** A suggestion, as its author and the reviewers see it. */
+export declare const communitySuggestionSchema: z.ZodObject<{
+    id: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+    suggestedBy: z.ZodNullable<z.ZodObject<{
+        userId: z.ZodString;
+        username: z.ZodString;
+        displayName: z.ZodString;
+        avatarUrl: z.ZodOptional<z.ZodURL>;
+        headline: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    name: z.ZodString;
+    description: z.ZodString;
+    why: z.ZodOptional<z.ZodString>;
+    visibility: z.ZodEnum<{
+        public: "public";
+        private: "private";
+        hidden: "hidden";
+    }>;
+    topics: z.ZodArray<z.ZodEnum<{
+        ai_ml: "ai_ml";
+        b2b_saas: "b2b_saas";
+        d2c: "d2c";
+        deeptech: "deeptech";
+        robotics: "robotics";
+        growth: "growth";
+        sales: "sales";
+        marketing: "marketing";
+        supply_chain: "supply_chain";
+        fundraising: "fundraising";
+        mentoring: "mentoring";
+        leadership: "leadership";
+        networking: "networking";
+        public_speaking: "public_speaking";
+        teaching: "teaching";
+        hiring_talent: "hiring_talent";
+        personal_branding: "personal_branding";
+        career_transition: "career_transition";
+        remote_work: "remote_work";
+        blockchain: "blockchain";
+        crypto_web3: "crypto_web3";
+        data_science: "data_science";
+        cybersecurity: "cybersecurity";
+        game_dev: "game_dev";
+        ux_design: "ux_design";
+        app_development: "app_development";
+        open_source: "open_source";
+        electronics: "electronics";
+        space_exploration: "space_exploration";
+        green_tech: "green_tech";
+        no_code: "no_code";
+        entrepreneurship: "entrepreneurship";
+        investing: "investing";
+        stock_trading: "stock_trading";
+        personal_finance: "personal_finance";
+        consulting: "consulting";
+        ecommerce: "ecommerce";
+        retail: "retail";
+        real_estate: "real_estate";
+        product_management: "product_management";
+        meditation: "meditation";
+        journaling: "journaling";
+        self_improvement: "self_improvement";
+        productivity: "productivity";
+        reading: "reading";
+        online_courses: "online_courses";
+        philosophy: "philosophy";
+        psychology: "psychology";
+        therapy: "therapy";
+        sleep_optimization: "sleep_optimization";
+        gym: "gym";
+        yoga: "yoga";
+        photography: "photography";
+        writing: "writing";
+        graphic_design: "graphic_design";
+        filmmaking: "filmmaking";
+        digital_art: "digital_art";
+        content_creation: "content_creation";
+        blogging: "blogging";
+        vlogging: "vlogging";
+        podcasts: "podcasts";
+        animation: "animation";
+        music_production: "music_production";
+        volunteering: "volunteering";
+        ngo_work: "ngo_work";
+        environmental: "environmental";
+        women_empowerment: "women_empowerment";
+        community_service: "community_service";
+        social_enterprise: "social_enterprise";
+        education_access: "education_access";
+    }>>;
+    status: z.ZodEnum<{
+        open: "open";
+        approved: "approved";
+        declined: "declined";
+    }>;
+    decidedBy: z.ZodNullable<z.ZodObject<{
+        userId: z.ZodString;
+        username: z.ZodString;
+        displayName: z.ZodString;
+        avatarUrl: z.ZodOptional<z.ZodURL>;
+        headline: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    decidedAt: z.ZodNullable<z.ZodISODateTime>;
+    declineReason: z.ZodOptional<z.ZodString>;
+    community: z.ZodOptional<z.ZodObject<{
+        id: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+        slug: z.ZodString;
+        name: z.ZodString;
+        iconUrl: z.ZodOptional<z.ZodURL>;
+        visibility: z.ZodEnum<{
+            public: "public";
+            private: "private";
+            hidden: "hidden";
+        }>;
+        archived: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    createdAt: z.ZodISODateTime;
+}, z.core.$strip>;
+export type CommunitySuggestion = z.infer<typeof communitySuggestionSchema>;
+export declare const communityCardPageSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        id: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+        slug: z.ZodString;
+        name: z.ZodString;
+        description: z.ZodString;
+        icon: z.ZodOptional<z.ZodObject<{
+            id: z.ZodString;
+            url: z.ZodURL;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+            variants: z.ZodArray<z.ZodObject<{
+                width: z.ZodNumber;
+                height: z.ZodNumber;
+                url: z.ZodURL;
+            }, z.core.$strip>>;
+            placeholder: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        visibility: z.ZodEnum<{
+            public: "public";
+            private: "private";
+            hidden: "hidden";
+        }>;
+        status: z.ZodEnum<{
+            active: "active";
+            archived: "archived";
+        }>;
+        topics: z.ZodArray<z.ZodEnum<{
+            ai_ml: "ai_ml";
+            b2b_saas: "b2b_saas";
+            d2c: "d2c";
+            deeptech: "deeptech";
+            robotics: "robotics";
+            growth: "growth";
+            sales: "sales";
+            marketing: "marketing";
+            supply_chain: "supply_chain";
+            fundraising: "fundraising";
+            mentoring: "mentoring";
+            leadership: "leadership";
+            networking: "networking";
+            public_speaking: "public_speaking";
+            teaching: "teaching";
+            hiring_talent: "hiring_talent";
+            personal_branding: "personal_branding";
+            career_transition: "career_transition";
+            remote_work: "remote_work";
+            blockchain: "blockchain";
+            crypto_web3: "crypto_web3";
+            data_science: "data_science";
+            cybersecurity: "cybersecurity";
+            game_dev: "game_dev";
+            ux_design: "ux_design";
+            app_development: "app_development";
+            open_source: "open_source";
+            electronics: "electronics";
+            space_exploration: "space_exploration";
+            green_tech: "green_tech";
+            no_code: "no_code";
+            entrepreneurship: "entrepreneurship";
+            investing: "investing";
+            stock_trading: "stock_trading";
+            personal_finance: "personal_finance";
+            consulting: "consulting";
+            ecommerce: "ecommerce";
+            retail: "retail";
+            real_estate: "real_estate";
+            product_management: "product_management";
+            meditation: "meditation";
+            journaling: "journaling";
+            self_improvement: "self_improvement";
+            productivity: "productivity";
+            reading: "reading";
+            online_courses: "online_courses";
+            philosophy: "philosophy";
+            psychology: "psychology";
+            therapy: "therapy";
+            sleep_optimization: "sleep_optimization";
+            gym: "gym";
+            yoga: "yoga";
+            photography: "photography";
+            writing: "writing";
+            graphic_design: "graphic_design";
+            filmmaking: "filmmaking";
+            digital_art: "digital_art";
+            content_creation: "content_creation";
+            blogging: "blogging";
+            vlogging: "vlogging";
+            podcasts: "podcasts";
+            animation: "animation";
+            music_production: "music_production";
+            volunteering: "volunteering";
+            ngo_work: "ngo_work";
+            environmental: "environmental";
+            women_empowerment: "women_empowerment";
+            community_service: "community_service";
+            social_enterprise: "social_enterprise";
+            education_access: "education_access";
+        }>>;
+        memberCount: z.ZodNumber;
+        postCount: z.ZodNumber;
+        viewer: z.ZodOptional<z.ZodObject<{
+            status: z.ZodNullable<z.ZodEnum<{
+                active: "active";
+                requested: "requested";
+                invited: "invited";
+            }>>;
+            role: z.ZodNullable<z.ZodEnum<{
+                moderator: "moderator";
+                member: "member";
+                admin: "admin";
+            }>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    nextCursor: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type CommunityCardPage = z.infer<typeof communityCardPageSchema>;
+export declare const communityMemberPageSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        userId: z.ZodString;
+        username: z.ZodString;
+        displayName: z.ZodString;
+        avatarUrl: z.ZodOptional<z.ZodURL>;
+        headline: z.ZodOptional<z.ZodString>;
+        role: z.ZodEnum<{
+            moderator: "moderator";
+            member: "member";
+            admin: "admin";
+        }>;
+        joinedAt: z.ZodISODateTime;
+        viewer: z.ZodOptional<z.ZodObject<{
+            canSetRole: z.ZodBoolean;
+            canRemove: z.ZodBoolean;
+            canBan: z.ZodBoolean;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    nextCursor: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type CommunityMemberPage = z.infer<typeof communityMemberPageSchema>;
+export declare const communityRequestPageSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        member: z.ZodObject<{
+            userId: z.ZodString;
+            username: z.ZodString;
+            displayName: z.ZodString;
+            avatarUrl: z.ZodOptional<z.ZodURL>;
+            headline: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        requestedAt: z.ZodISODateTime;
+    }, z.core.$strip>>;
+    nextCursor: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type CommunityRequestPage = z.infer<typeof communityRequestPageSchema>;
+export declare const communityPendingInvitePageSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        member: z.ZodObject<{
+            userId: z.ZodString;
+            username: z.ZodString;
+            displayName: z.ZodString;
+            avatarUrl: z.ZodOptional<z.ZodURL>;
+            headline: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        invitedBy: z.ZodNullable<z.ZodObject<{
+            userId: z.ZodString;
+            username: z.ZodString;
+            displayName: z.ZodString;
+            avatarUrl: z.ZodOptional<z.ZodURL>;
+            headline: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        invitedAt: z.ZodISODateTime;
+    }, z.core.$strip>>;
+    nextCursor: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type CommunityPendingInvitePage = z.infer<typeof communityPendingInvitePageSchema>;
+export declare const communityBanPageSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        member: z.ZodObject<{
+            userId: z.ZodString;
+            username: z.ZodString;
+            displayName: z.ZodString;
+            avatarUrl: z.ZodOptional<z.ZodURL>;
+            headline: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        bannedBy: z.ZodNullable<z.ZodObject<{
+            userId: z.ZodString;
+            username: z.ZodString;
+            displayName: z.ZodString;
+            avatarUrl: z.ZodOptional<z.ZodURL>;
+            headline: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        bannedAt: z.ZodISODateTime;
+        reason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    nextCursor: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type CommunityBanPage = z.infer<typeof communityBanPageSchema>;
+export declare const communitySuggestionPageSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        id: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+        suggestedBy: z.ZodNullable<z.ZodObject<{
+            userId: z.ZodString;
+            username: z.ZodString;
+            displayName: z.ZodString;
+            avatarUrl: z.ZodOptional<z.ZodURL>;
+            headline: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        name: z.ZodString;
+        description: z.ZodString;
+        why: z.ZodOptional<z.ZodString>;
+        visibility: z.ZodEnum<{
+            public: "public";
+            private: "private";
+            hidden: "hidden";
+        }>;
+        topics: z.ZodArray<z.ZodEnum<{
+            ai_ml: "ai_ml";
+            b2b_saas: "b2b_saas";
+            d2c: "d2c";
+            deeptech: "deeptech";
+            robotics: "robotics";
+            growth: "growth";
+            sales: "sales";
+            marketing: "marketing";
+            supply_chain: "supply_chain";
+            fundraising: "fundraising";
+            mentoring: "mentoring";
+            leadership: "leadership";
+            networking: "networking";
+            public_speaking: "public_speaking";
+            teaching: "teaching";
+            hiring_talent: "hiring_talent";
+            personal_branding: "personal_branding";
+            career_transition: "career_transition";
+            remote_work: "remote_work";
+            blockchain: "blockchain";
+            crypto_web3: "crypto_web3";
+            data_science: "data_science";
+            cybersecurity: "cybersecurity";
+            game_dev: "game_dev";
+            ux_design: "ux_design";
+            app_development: "app_development";
+            open_source: "open_source";
+            electronics: "electronics";
+            space_exploration: "space_exploration";
+            green_tech: "green_tech";
+            no_code: "no_code";
+            entrepreneurship: "entrepreneurship";
+            investing: "investing";
+            stock_trading: "stock_trading";
+            personal_finance: "personal_finance";
+            consulting: "consulting";
+            ecommerce: "ecommerce";
+            retail: "retail";
+            real_estate: "real_estate";
+            product_management: "product_management";
+            meditation: "meditation";
+            journaling: "journaling";
+            self_improvement: "self_improvement";
+            productivity: "productivity";
+            reading: "reading";
+            online_courses: "online_courses";
+            philosophy: "philosophy";
+            psychology: "psychology";
+            therapy: "therapy";
+            sleep_optimization: "sleep_optimization";
+            gym: "gym";
+            yoga: "yoga";
+            photography: "photography";
+            writing: "writing";
+            graphic_design: "graphic_design";
+            filmmaking: "filmmaking";
+            digital_art: "digital_art";
+            content_creation: "content_creation";
+            blogging: "blogging";
+            vlogging: "vlogging";
+            podcasts: "podcasts";
+            animation: "animation";
+            music_production: "music_production";
+            volunteering: "volunteering";
+            ngo_work: "ngo_work";
+            environmental: "environmental";
+            women_empowerment: "women_empowerment";
+            community_service: "community_service";
+            social_enterprise: "social_enterprise";
+            education_access: "education_access";
+        }>>;
+        status: z.ZodEnum<{
+            open: "open";
+            approved: "approved";
+            declined: "declined";
+        }>;
+        decidedBy: z.ZodNullable<z.ZodObject<{
+            userId: z.ZodString;
+            username: z.ZodString;
+            displayName: z.ZodString;
+            avatarUrl: z.ZodOptional<z.ZodURL>;
+            headline: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        decidedAt: z.ZodNullable<z.ZodISODateTime>;
+        declineReason: z.ZodOptional<z.ZodString>;
+        community: z.ZodOptional<z.ZodObject<{
+            id: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+            slug: z.ZodString;
+            name: z.ZodString;
+            iconUrl: z.ZodOptional<z.ZodURL>;
+            visibility: z.ZodEnum<{
+                public: "public";
+                private: "private";
+                hidden: "hidden";
+            }>;
+            archived: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>;
+        createdAt: z.ZodISODateTime;
+    }, z.core.$strip>>;
+    nextCursor: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type CommunitySuggestionPage = z.infer<typeof communitySuggestionPageSchema>;
+/**
+ * `GET /communities`: public and private communities that are not archived
+ * (hidden ones never), most members first. `q` matches the start of the
+ * name; an emptied box (`?q=`) is no search, never a 400. `topic` means "any of".
+ */
+export declare const communityDiscoverQuerySchema: z.ZodObject<{
+    limit: z.ZodPreprocess<z.ZodDefault<z.ZodCoercedNumber<unknown>>, unknown>;
+    cursor: z.ZodOptional<z.ZodString>;
+    q: z.ZodPreprocess<z.ZodOptional<z.ZodString>, unknown>;
+    topic: z.ZodPreprocess<z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        ai_ml: "ai_ml";
+        b2b_saas: "b2b_saas";
+        d2c: "d2c";
+        deeptech: "deeptech";
+        robotics: "robotics";
+        growth: "growth";
+        sales: "sales";
+        marketing: "marketing";
+        supply_chain: "supply_chain";
+        fundraising: "fundraising";
+        mentoring: "mentoring";
+        leadership: "leadership";
+        networking: "networking";
+        public_speaking: "public_speaking";
+        teaching: "teaching";
+        hiring_talent: "hiring_talent";
+        personal_branding: "personal_branding";
+        career_transition: "career_transition";
+        remote_work: "remote_work";
+        blockchain: "blockchain";
+        crypto_web3: "crypto_web3";
+        data_science: "data_science";
+        cybersecurity: "cybersecurity";
+        game_dev: "game_dev";
+        ux_design: "ux_design";
+        app_development: "app_development";
+        open_source: "open_source";
+        electronics: "electronics";
+        space_exploration: "space_exploration";
+        green_tech: "green_tech";
+        no_code: "no_code";
+        entrepreneurship: "entrepreneurship";
+        investing: "investing";
+        stock_trading: "stock_trading";
+        personal_finance: "personal_finance";
+        consulting: "consulting";
+        ecommerce: "ecommerce";
+        retail: "retail";
+        real_estate: "real_estate";
+        product_management: "product_management";
+        meditation: "meditation";
+        journaling: "journaling";
+        self_improvement: "self_improvement";
+        productivity: "productivity";
+        reading: "reading";
+        online_courses: "online_courses";
+        philosophy: "philosophy";
+        psychology: "psychology";
+        therapy: "therapy";
+        sleep_optimization: "sleep_optimization";
+        gym: "gym";
+        yoga: "yoga";
+        photography: "photography";
+        writing: "writing";
+        graphic_design: "graphic_design";
+        filmmaking: "filmmaking";
+        digital_art: "digital_art";
+        content_creation: "content_creation";
+        blogging: "blogging";
+        vlogging: "vlogging";
+        podcasts: "podcasts";
+        animation: "animation";
+        music_production: "music_production";
+        volunteering: "volunteering";
+        ngo_work: "ngo_work";
+        environmental: "environmental";
+        women_empowerment: "women_empowerment";
+        community_service: "community_service";
+        social_enterprise: "social_enterprise";
+        education_access: "education_access";
+    }>>>, unknown>;
+}, z.core.$strip>;
+export type CommunityDiscoverQuery = z.infer<typeof communityDiscoverQuerySchema>;
+export type CommunityDiscoverQueryInput = z.input<typeof communityDiscoverQuerySchema>;
+/** `GET /communities/:id/members`: everyone, or one role (`?role=admin`). */
+export declare const communityMembersQuerySchema: z.ZodObject<{
+    limit: z.ZodPreprocess<z.ZodDefault<z.ZodCoercedNumber<unknown>>, unknown>;
+    cursor: z.ZodOptional<z.ZodString>;
+    role: z.ZodPreprocess<z.ZodOptional<z.ZodEnum<{
+        moderator: "moderator";
+        member: "member";
+        admin: "admin";
+    }>>, unknown>;
+}, z.core.$strip>;
+export type CommunityMembersQuery = z.infer<typeof communityMembersQuerySchema>;
+export type CommunityMembersQueryInput = z.input<typeof communityMembersQuerySchema>;
+/** `GET /community-suggestions` (staff): waiting ones by default, oldest first. */
+export declare const communitySuggestionsQuerySchema: z.ZodObject<{
+    limit: z.ZodPreprocess<z.ZodDefault<z.ZodCoercedNumber<unknown>>, unknown>;
+    cursor: z.ZodOptional<z.ZodString>;
+    status: z.ZodPreprocess<z.ZodDefault<z.ZodEnum<{
+        open: "open";
+        approved: "approved";
+        declined: "declined";
+    }>>, unknown>;
+}, z.core.$strip>;
+export type CommunitySuggestionsQuery = z.infer<typeof communitySuggestionsQuerySchema>;
+export type CommunitySuggestionsQueryInput = z.input<typeof communitySuggestionsQuerySchema>;
+export declare const communityParamsSchema: z.ZodObject<{
+    communityId: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+}, z.core.$strip>;
+export type CommunityParams = z.infer<typeof communityParamsSchema>;
+/** `/communities/:communityId/{members,requests,invites,bans}/:userId`. */
+export declare const communityMemberParamsSchema: z.ZodObject<{
+    communityId: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+    userId: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+}, z.core.$strip>;
+export type CommunityMemberParams = z.infer<typeof communityMemberParamsSchema>;
+/** `/communities/:communityId/{pins,content}/:contentId`. */
+export declare const communityContentParamsSchema: z.ZodObject<{
+    communityId: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+    contentId: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+}, z.core.$strip>;
+export type CommunityContentParams = z.infer<typeof communityContentParamsSchema>;
+/** `/communities/:communityId/comments/:commentId/hidden` (0.9.0). */
+export declare const communityCommentParamsSchema: z.ZodObject<{
+    communityId: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+    commentId: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+}, z.core.$strip>;
+export type CommunityCommentParams = z.infer<typeof communityCommentParamsSchema>;
+export declare const communitySuggestionParamsSchema: z.ZodObject<{
+    suggestionId: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+}, z.core.$strip>;
+export type CommunitySuggestionParams = z.infer<typeof communitySuggestionParamsSchema>;
+/**
+ * `POST /communities` (managers, super admins and capability holders), and
+ * the reviewer's edited version when approving a suggestion. The creator
+ * becomes its first admin. A name a live PUBLIC or PRIVATE community has is
+ * `COMMUNITY_NAME_TAKEN` (letter case ignored, runs of spaces read as one);
+ * hidden communities' names are never compared, so no name probes for one.
+ * Approving a private or hidden one invites its suggester. The icon is a
+ * processed `community_icon` upload.
+ */
+export declare const createCommunityBodySchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    visibility: z.ZodEnum<{
+        public: "public";
+        private: "private";
+        hidden: "hidden";
+    }>;
+    rules: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    topics: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        ai_ml: "ai_ml";
+        b2b_saas: "b2b_saas";
+        d2c: "d2c";
+        deeptech: "deeptech";
+        robotics: "robotics";
+        growth: "growth";
+        sales: "sales";
+        marketing: "marketing";
+        supply_chain: "supply_chain";
+        fundraising: "fundraising";
+        mentoring: "mentoring";
+        leadership: "leadership";
+        networking: "networking";
+        public_speaking: "public_speaking";
+        teaching: "teaching";
+        hiring_talent: "hiring_talent";
+        personal_branding: "personal_branding";
+        career_transition: "career_transition";
+        remote_work: "remote_work";
+        blockchain: "blockchain";
+        crypto_web3: "crypto_web3";
+        data_science: "data_science";
+        cybersecurity: "cybersecurity";
+        game_dev: "game_dev";
+        ux_design: "ux_design";
+        app_development: "app_development";
+        open_source: "open_source";
+        electronics: "electronics";
+        space_exploration: "space_exploration";
+        green_tech: "green_tech";
+        no_code: "no_code";
+        entrepreneurship: "entrepreneurship";
+        investing: "investing";
+        stock_trading: "stock_trading";
+        personal_finance: "personal_finance";
+        consulting: "consulting";
+        ecommerce: "ecommerce";
+        retail: "retail";
+        real_estate: "real_estate";
+        product_management: "product_management";
+        meditation: "meditation";
+        journaling: "journaling";
+        self_improvement: "self_improvement";
+        productivity: "productivity";
+        reading: "reading";
+        online_courses: "online_courses";
+        philosophy: "philosophy";
+        psychology: "psychology";
+        therapy: "therapy";
+        sleep_optimization: "sleep_optimization";
+        gym: "gym";
+        yoga: "yoga";
+        photography: "photography";
+        writing: "writing";
+        graphic_design: "graphic_design";
+        filmmaking: "filmmaking";
+        digital_art: "digital_art";
+        content_creation: "content_creation";
+        blogging: "blogging";
+        vlogging: "vlogging";
+        podcasts: "podcasts";
+        animation: "animation";
+        music_production: "music_production";
+        volunteering: "volunteering";
+        ngo_work: "ngo_work";
+        environmental: "environmental";
+        women_empowerment: "women_empowerment";
+        community_service: "community_service";
+        social_enterprise: "social_enterprise";
+        education_access: "education_access";
+    }>>>;
+    iconMediaId: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
+}, z.core.$strip>;
+export type CreateCommunityBody = z.infer<typeof createCommunityBodySchema>;
+/** `PATCH /communities/:id` (admins): only the keys that changed. Type and icon have their own routes. */
+export declare const updateCommunityBodySchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    rules: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    topics: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        ai_ml: "ai_ml";
+        b2b_saas: "b2b_saas";
+        d2c: "d2c";
+        deeptech: "deeptech";
+        robotics: "robotics";
+        growth: "growth";
+        sales: "sales";
+        marketing: "marketing";
+        supply_chain: "supply_chain";
+        fundraising: "fundraising";
+        mentoring: "mentoring";
+        leadership: "leadership";
+        networking: "networking";
+        public_speaking: "public_speaking";
+        teaching: "teaching";
+        hiring_talent: "hiring_talent";
+        personal_branding: "personal_branding";
+        career_transition: "career_transition";
+        remote_work: "remote_work";
+        blockchain: "blockchain";
+        crypto_web3: "crypto_web3";
+        data_science: "data_science";
+        cybersecurity: "cybersecurity";
+        game_dev: "game_dev";
+        ux_design: "ux_design";
+        app_development: "app_development";
+        open_source: "open_source";
+        electronics: "electronics";
+        space_exploration: "space_exploration";
+        green_tech: "green_tech";
+        no_code: "no_code";
+        entrepreneurship: "entrepreneurship";
+        investing: "investing";
+        stock_trading: "stock_trading";
+        personal_finance: "personal_finance";
+        consulting: "consulting";
+        ecommerce: "ecommerce";
+        retail: "retail";
+        real_estate: "real_estate";
+        product_management: "product_management";
+        meditation: "meditation";
+        journaling: "journaling";
+        self_improvement: "self_improvement";
+        productivity: "productivity";
+        reading: "reading";
+        online_courses: "online_courses";
+        philosophy: "philosophy";
+        psychology: "psychology";
+        therapy: "therapy";
+        sleep_optimization: "sleep_optimization";
+        gym: "gym";
+        yoga: "yoga";
+        photography: "photography";
+        writing: "writing";
+        graphic_design: "graphic_design";
+        filmmaking: "filmmaking";
+        digital_art: "digital_art";
+        content_creation: "content_creation";
+        blogging: "blogging";
+        vlogging: "vlogging";
+        podcasts: "podcasts";
+        animation: "animation";
+        music_production: "music_production";
+        volunteering: "volunteering";
+        ngo_work: "ngo_work";
+        environmental: "environmental";
+        women_empowerment: "women_empowerment";
+        community_service: "community_service";
+        social_enterprise: "social_enterprise";
+        education_access: "education_access";
+    }>>>;
+}, z.core.$strip>;
+export type UpdateCommunityBody = z.infer<typeof updateCommunityBodySchema>;
+/** `PUT /communities/:id/icon`: a processed `community_icon` upload. The old icon's files are deleted. */
+export declare const setCommunityIconBodySchema: z.ZodObject<{
+    mediaId: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+}, z.core.$strip>;
+export type SetCommunityIconBody = z.infer<typeof setCommunityIconBodySchema>;
+/**
+ * `PUT /communities/:id/visibility` (admins). A change that exposes what was
+ * already posted (`communityChangeExposes`: toward public, or hidden to
+ * private) needs `confirmExposure: true`, else `COMMUNITY_EXPOSURE_UNCONFIRMED`:
+ * the web asks first, and a client cannot skip the question. Audited.
+ */
+export declare const setCommunityVisibilityBodySchema: z.ZodObject<{
+    visibility: z.ZodEnum<{
+        public: "public";
+        private: "private";
+        hidden: "hidden";
+    }>;
+    confirmExposure: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type SetCommunityVisibilityBody = z.infer<typeof setCommunityVisibilityBodySchema>;
+/** `PUT /communities/:id/status` (staff). Audited. */
+export declare const setCommunityStatusBodySchema: z.ZodObject<{
+    status: z.ZodEnum<{
+        active: "active";
+        archived: "archived";
+    }>;
+}, z.core.$strip>;
+export type SetCommunityStatusBody = z.infer<typeof setCommunityStatusBodySchema>;
+/**
+ * `POST /communities/:id/invites` (moderators, private and hidden only;
+ * a public community needs none: `COMMUNITY_INVITE_NOT_NEEDED`). Someone who
+ * cannot join (not onboarded, paused, suspended, deleted) is
+ * `COMMUNITY_MEMBER_NOT_INVITABLE`; banned, `COMMUNITY_MEMBER_BANNED`; already
+ * a member, requested or invited, `COMMUNITY_ALREADY_MEMBER`.
+ */
+export declare const inviteCommunityMemberBodySchema: z.ZodObject<{
+    userId: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+}, z.core.$strip>;
+export type InviteCommunityMemberBody = z.infer<typeof inviteCommunityMemberBodySchema>;
+/** `PUT /communities/:id/members/:userId/role` (admins). Never the last admin's own step down. */
+export declare const setCommunityMemberRoleBodySchema: z.ZodObject<{
+    role: z.ZodEnum<{
+        moderator: "moderator";
+        member: "member";
+        admin: "admin";
+    }>;
+}, z.core.$strip>;
+export type SetCommunityMemberRoleBody = z.infer<typeof setCommunityMemberRoleBodySchema>;
+/** `POST /communities/:id/bans` (admins): removes them if active, and keeps them out. */
+export declare const banCommunityMemberBodySchema: z.ZodObject<{
+    userId: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+    reason: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type BanCommunityMemberBody = z.infer<typeof banCommunityMemberBodySchema>;
+/**
+ * `POST /communities/:id/pins` (moderators): pin one of the community's posts
+ * or polls as an announcement (`COMMUNITY_PINS_FULL` past `COMMUNITY_PINS_MAX`).
+ * `notifyMembers` (admins only) rings every active member's bell, at most once
+ * per `COMMUNITY_ANNOUNCE_INTERVAL_MS` (`COMMUNITY_ANNOUNCE_TOO_SOON`).
+ */
+export declare const pinCommunityContentBodySchema: z.ZodObject<{
+    contentId: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+    notifyMembers: z.ZodBoolean;
+}, z.core.$strip>;
+export type PinCommunityContentBody = z.infer<typeof pinCommunityContentBodySchema>;
+/**
+ * `POST /community-suggestions`: any onboarded member, at most
+ * `COMMUNITY_SUGGESTIONS_OPEN_MAX` waiting at once (`COMMUNITY_SUGGESTIONS_FULL`).
+ */
+export declare const createCommunitySuggestionBodySchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    why: z.ZodOptional<z.ZodString>;
+    visibility: z.ZodEnum<{
+        public: "public";
+        private: "private";
+        hidden: "hidden";
+    }>;
+    topics: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        ai_ml: "ai_ml";
+        b2b_saas: "b2b_saas";
+        d2c: "d2c";
+        deeptech: "deeptech";
+        robotics: "robotics";
+        growth: "growth";
+        sales: "sales";
+        marketing: "marketing";
+        supply_chain: "supply_chain";
+        fundraising: "fundraising";
+        mentoring: "mentoring";
+        leadership: "leadership";
+        networking: "networking";
+        public_speaking: "public_speaking";
+        teaching: "teaching";
+        hiring_talent: "hiring_talent";
+        personal_branding: "personal_branding";
+        career_transition: "career_transition";
+        remote_work: "remote_work";
+        blockchain: "blockchain";
+        crypto_web3: "crypto_web3";
+        data_science: "data_science";
+        cybersecurity: "cybersecurity";
+        game_dev: "game_dev";
+        ux_design: "ux_design";
+        app_development: "app_development";
+        open_source: "open_source";
+        electronics: "electronics";
+        space_exploration: "space_exploration";
+        green_tech: "green_tech";
+        no_code: "no_code";
+        entrepreneurship: "entrepreneurship";
+        investing: "investing";
+        stock_trading: "stock_trading";
+        personal_finance: "personal_finance";
+        consulting: "consulting";
+        ecommerce: "ecommerce";
+        retail: "retail";
+        real_estate: "real_estate";
+        product_management: "product_management";
+        meditation: "meditation";
+        journaling: "journaling";
+        self_improvement: "self_improvement";
+        productivity: "productivity";
+        reading: "reading";
+        online_courses: "online_courses";
+        philosophy: "philosophy";
+        psychology: "psychology";
+        therapy: "therapy";
+        sleep_optimization: "sleep_optimization";
+        gym: "gym";
+        yoga: "yoga";
+        photography: "photography";
+        writing: "writing";
+        graphic_design: "graphic_design";
+        filmmaking: "filmmaking";
+        digital_art: "digital_art";
+        content_creation: "content_creation";
+        blogging: "blogging";
+        vlogging: "vlogging";
+        podcasts: "podcasts";
+        animation: "animation";
+        music_production: "music_production";
+        volunteering: "volunteering";
+        ngo_work: "ngo_work";
+        environmental: "environmental";
+        women_empowerment: "women_empowerment";
+        community_service: "community_service";
+        social_enterprise: "social_enterprise";
+        education_access: "education_access";
+    }>>>;
+}, z.core.$strip>;
+export type CreateCommunitySuggestionBody = z.infer<typeof createCommunitySuggestionBodySchema>;
+/**
+ * `POST /community-suggestions/:id/decline` (staff): the reason is shown to the
+ * suggester. A decided suggestion is `COMMUNITY_SUGGESTION_DECIDED`.
+ */
+export declare const declineCommunitySuggestionBodySchema: z.ZodObject<{
+    reason: z.ZodString;
+}, z.core.$strip>;
+export type DeclineCommunitySuggestionBody = z.infer<typeof declineCommunitySuggestionBodySchema>;
+//# sourceMappingURL=communities.d.ts.map