founder-schema 0.3.0 → 0.5.0

package/dist/domains/feed/feed.d.ts

@@ -0,0 +1,1695 @@
+/**
+ * founder-schema — Feed wire shapes: post, poll, comment, reaction
+ *
+ * ADAPTED FROM `jansathi-community-schema`, NOT DEPENDENT ON IT.
+ *
+ * The user ruled on 2026-09-21 that Founder Circle is a standalone app, so
+ * these shapes are copied and cut down rather than imported. The reason is
+ * worth keeping: `jansathi-community-schema` encodes Jansathi's reach levels,
+ * community designations, official-area kinds and crowdfunding audiences.
+ * Depending on it would put all of that permanently inside our contract for a
+ * feed that has none of those concepts, and would mean a Jansathi publish can
+ * break this product.
+ *
+ * DELIBERATELY NOT PORTED, so nobody "restores" them:
+ *   - the five civic verticals (lost_found, suggestions_complaints,
+ *     donate_item, crowdfunding, event). `contentKind` here is post | poll
+ *     only; comment threads and bookmarks key off it, and reactions and
+ *     reports off the same union plus `comment`.
+ *   - official communities, designations, identity verification badges.
+ *   - social score, and the whole area-proximity ranking vocabulary
+ *     (local / district / state / national / global).
+ *   - `areaLineage` as a REQUIRED authorship snapshot. Jansathi gates its
+ *     composer on a declared residence resolving to Indian district level or
+ *     deeper; the user ruled location is never mandatory here, so nothing in
+ *     this file requires one.
+ *   - anonymous posting, which in Jansathi is gated on identity verification
+ *     we do not have. A founders' network is an identified network.
+ *
+ * @module founder-schema/domains/feed
+ */
+import { z } from 'zod';
+/**
+ * Exported because the composer must count down to the SAME number the server
+ * rejects at. A client-side limit that disagrees with the server is a message
+ * a member cannot send and cannot see why.
+ */
+export declare const POST_MAX_BODY_CHARS = 5000;
+/**
+ * Total attachments on one post, images and videos together.
+ *
+ * ONE cap over ONE ordered list, rather than Jansathi's separate image and
+ * video arrays. A member who posts a screenshot, then a clip, then another
+ * screenshot means that order, and two parallel arrays cannot express it: the
+ * card would show both images and then the video, which is not what was
+ * written.
+ */
+export declare const POST_MAX_MEDIA = 10;
+/**
+ * Topics per item.
+ *
+ * Capped low on purpose: a post tagged with everything is about nothing, and
+ * one tagged with ten matches every member, which is how a relevance feature
+ * turns back into a chronological one.
+ */
+export declare const MAX_TOPICS = 3;
+export declare const COMMENT_MAX_BODY_CHARS = 2000;
+export declare const POLL_QUESTION_MAX_CHARS = 280;
+export declare const POLL_OPTION_MAX_CHARS = 80;
+export declare const POLL_MIN_OPTIONS = 2;
+export declare const POLL_MAX_OPTIONS = 6;
+/** 5 minutes. Below this a poll closes before anyone sees it. */
+export declare const POLL_MIN_DURATION_MS: number;
+/** 30 days. */
+export declare const POLL_MAX_DURATION_MS: number;
+/**
+ * How long after writing it the author may still edit a post or a comment.
+ *
+ * A window rather than forever: an edit after people have reacted changes what
+ * they reacted to. Deletion has no window, because a member must always be able
+ * to remove their own words. The server is the gate (`EDIT_WINDOW_CLOSED`);
+ * a client uses this to stop offering Edit at the moment the server would
+ * start refusing it, instead of on the next reload.
+ */
+export declare const EDIT_WINDOW_MS: number;
+/**
+ * What can appear in the feed. Two kinds, not seven.
+ *
+ * Engagement is keyed by `(contentKind, contentId)` so one engagement bar
+ * serves both, and comments hang off the same pair. Adding a kind later is
+ * additive; the union is deliberately narrow now so the client never has to
+ * handle a kind this product does not have.
+ */
+export declare const CONTENT_KIND_VALUES: readonly ["post", "poll"];
+export declare const contentKindSchema: z.ZodEnum<{
+    post: "post";
+    poll: "poll";
+}>;
+export type ContentKind = z.infer<typeof contentKindSchema>;
+/**
+ * What a reaction or a report can point at: a feed item, or a comment on one.
+ *
+ * Wider than `ContentKind` on purpose. A comment carries reaction counts and a
+ * viewer reaction, and a comment can be abusive, so both reach it. A bookmark
+ * and a comment thread cannot: they take `ContentKind`. Until 0.2.0 the
+ * reaction and report RESPONSES were typed `ContentKind` while the routes
+ * accepted comments, so every answer about a comment broke this contract.
+ */
+export declare const ENGAGEMENT_TARGET_KIND_VALUES: readonly ["post", "poll", "comment"];
+export declare const engagementTargetKindSchema: z.ZodEnum<{
+    post: "post";
+    poll: "poll";
+    comment: "comment";
+}>;
+export type EngagementTargetKind = z.infer<typeof engagementTargetKindSchema>;
+/**
+ * Reactions. Jansathi's `support` is dropped: it exists for reacting to a
+ * civic complaint or a lost-and-found notice, which this feed does not carry.
+ *
+ * ⚠️ These values are stored per reaction row, so removing one orphans data.
+ * Append only.
+ */
+export declare const REACTION_TYPE_VALUES: readonly ["like", "celebrate", "insightful", "curious"];
+export declare const reactionTypeSchema: z.ZodEnum<{
+    like: "like";
+    celebrate: "celebrate";
+    insightful: "insightful";
+    curious: "curious";
+}>;
+export type ReactionType = z.infer<typeof reactionTypeSchema>;
+/**
+ * Feed ordering.
+ *
+ * `new` is the default here, unlike Jansathi where `hot` leads. A hot ranking
+ * needs volume to be meaningful, and a brand-new network ranking a handful of
+ * posts by a blended score mostly hides the newest thing somebody just wrote.
+ * Revisit when there is enough content for `hot` to mean anything.
+ */
+export declare const FEED_SORT_VALUES: readonly ["new", "top"];
+export declare const feedSortSchema: z.ZodEnum<{
+    new: "new";
+    top: "top";
+}>;
+export type FeedSort = z.infer<typeof feedSortSchema>;
+/**
+ * Counts keyed by reaction type, e.g. `{ like: 4, celebrate: 1 }`. Only the
+ * reactions an item actually has need appear.
+ *
+ * ⚠️ `partialRecord`, NOT `record`. In Zod 4 an enum-keyed `z.record` is
+ * EXHAUSTIVE: it demands every key, so `{ like: 4 }` fails with three missing
+ * keys and `{}` fails with four. That would force the server to ship a zero for
+ * every reaction on every item, and the day a fifth reaction is added every
+ * previously stored payload and every older client stops parsing.
+ * `partialRecord` keeps the key validation without the exhaustiveness, so an
+ * unknown key like Jansathi's `support` is still refused.
+ */
+export declare const reactionCountsSchema: z.ZodRecord<z.ZodEnum<{
+    like: "like";
+    celebrate: "celebrate";
+    insightful: "insightful";
+    curious: "curious";
+}> & z.core.$partial, z.ZodNumber>;
+export type ReactionCounts = z.infer<typeof reactionCountsSchema>;
+/**
+ * The author as a card renders them.
+ *
+ * Every field here is LIVE, joined against the profile at read time rather
+ * than frozen onto the post at write time. So a renamed handle, a new avatar
+ * or an edited headline updates on old posts, and the byline link always
+ * targets the current username instead of 404ing on a handle that moved.
+ *
+ * Jansathi additionally snapshots `localName` ("where the author was when
+ * posting"). Not ported: location is optional here, so a byline that depends
+ * on one would be blank for anyone who never set it.
+ */
+export declare const feedAuthorSchema: z.ZodObject<{
+    userId: z.ZodString;
+    username: z.ZodString;
+    displayName: z.ZodString;
+    avatarUrl: z.ZodOptional<z.ZodURL>;
+    headline: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type FeedAuthor = z.infer<typeof feedAuthorSchema>;
+/**
+ * A post's image: a processed `mediaImageSchema` (every stored size, ready for
+ * `srcset`, plus a placeholder) with the post's own alt text.
+ *
+ * `width` and `height` are required so a card can reserve the right box before
+ * the image loads. Without them every image arrival shifts the feed under the
+ * reader's thumb.
+ *
+ * `thumbnailUrl` is the smallest stored size, for a grid or a notification.
+ *
+ * URLs here come from our own upload pipeline, so they take a plain `z.url()`
+ * rather than `httpUrlSchema`. ⚠️ If a "paste an image link" path is ever
+ * added, these become member-supplied and must move to `httpUrlSchema`.
+ */
+export declare const feedImageSchema: 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>;
+    kind: z.ZodLiteral<"image">;
+    thumbnailUrl: z.ZodOptional<z.ZodURL>;
+    alt: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type FeedImage = z.infer<typeof feedImageSchema>;
+export declare const feedVideoSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"video">;
+    url: z.ZodURL;
+    thumbnailUrl: z.ZodURL;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    duration: z.ZodNumber;
+}, z.core.$strip>;
+export type FeedVideo = z.infer<typeof feedVideoSchema>;
+/**
+ * One ordered list, discriminated on `kind`, so the carousel renders
+ * attachments in the order they were attached and can switch on the kind
+ * without inspecting fields.
+ */
+export declare const feedMediaSchema: z.ZodDiscriminatedUnion<[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>;
+    kind: z.ZodLiteral<"image">;
+    thumbnailUrl: z.ZodOptional<z.ZodURL>;
+    alt: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"video">;
+    url: z.ZodURL;
+    thumbnailUrl: z.ZodURL;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    duration: z.ZodNumber;
+}, z.core.$strip>], "kind">;
+export type FeedMedia = z.infer<typeof feedMediaSchema>;
+/**
+ * Preview for the first link in a post body. Server-derived at write time and
+ * stored, never re-fetched at render: a card that fetches a third-party page
+ * per scroll leaks every reader's address to that site and blocks the feed on
+ * somebody else's latency.
+ *
+ * Both URLs take `safeUrlSchema`: the scheme and host rules, WITHOUT the
+ * typed-URL cap. `url` came out of a post body, which is already capped as a
+ * whole, and `imageUrl` is whatever the remote page advertised; a long CDN URL
+ * is ordinary, and one over `LINK_URL_MAX` would otherwise fail the whole feed
+ * page it sits on. Neither is ours, so a consumer still treats both as
+ * untrusted at render.
+ */
+export declare const linkPreviewSchema: z.ZodObject<{
+    url: z.ZodURL;
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    imageUrl: z.ZodOptional<z.ZodURL>;
+}, z.core.$strip>;
+export type LinkPreview = z.infer<typeof linkPreviewSchema>;
+/**
+ * What THIS viewer has done to this item, computed per request.
+ *
+ * Optional as a block, because an unauthenticated or server-rendered read has
+ * no viewer. ⚠️ A client must treat an absent `viewer` as "no state known",
+ * never as "has not reacted": rendering an empty reaction button off a missing
+ * block is how a member sees their own reaction disappear on reload.
+ */
+export declare const viewerStateSchema: z.ZodObject<{
+    reaction: z.ZodNullable<z.ZodEnum<{
+        like: "like";
+        celebrate: "celebrate";
+        insightful: "insightful";
+        curious: "curious";
+    }>>;
+    bookmarked: z.ZodBoolean;
+    isAuthor: z.ZodBoolean;
+    canEdit: z.ZodBoolean;
+    canDelete: z.ZodBoolean;
+    canReport: z.ZodBoolean;
+}, z.core.$strip>;
+export type ViewerState = z.infer<typeof viewerStateSchema>;
+/**
+ * A post as the feed and the single-post page receive it.
+ *
+ * Counts are denormalised onto the row so one document serves a whole card.
+ *
+ * No `score` and no up/down vote. Jansathi's signed score exists to rank civic
+ * content by community judgement, and a downvote arrow on a founder's first
+ * post is a different product. Reactions and comments are the engagement axes
+ * here. Adding a score later is additive; removing a visible downvote after
+ * members have used it is not.
+ */
+export declare const feedPostSchema: z.ZodObject<{
+    id: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+    contentKind: z.ZodLiteral<"post">;
+    author: z.ZodObject<{
+        userId: z.ZodString;
+        username: z.ZodString;
+        displayName: z.ZodString;
+        avatarUrl: z.ZodOptional<z.ZodURL>;
+        headline: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    text: z.ZodString;
+    media: z.ZodArray<z.ZodDiscriminatedUnion<[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>;
+        kind: z.ZodLiteral<"image">;
+        thumbnailUrl: z.ZodOptional<z.ZodURL>;
+        alt: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"video">;
+        url: z.ZodURL;
+        thumbnailUrl: z.ZodURL;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+        duration: z.ZodNumber;
+    }, z.core.$strip>], "kind">>;
+    linkPreview: z.ZodOptional<z.ZodObject<{
+        url: z.ZodURL;
+        title: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        imageUrl: z.ZodOptional<z.ZodURL>;
+    }, z.core.$strip>>;
+    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";
+    }>>;
+    commentCount: z.ZodNumber;
+    reactionCounts: z.ZodRecord<z.ZodEnum<{
+        like: "like";
+        celebrate: "celebrate";
+        insightful: "insightful";
+        curious: "curious";
+    }> & z.core.$partial, z.ZodNumber>;
+    createdAt: z.ZodISODateTime;
+    editedAt: z.ZodNullable<z.ZodISODateTime>;
+    viewer: z.ZodOptional<z.ZodObject<{
+        reaction: z.ZodNullable<z.ZodEnum<{
+            like: "like";
+            celebrate: "celebrate";
+            insightful: "insightful";
+            curious: "curious";
+        }>>;
+        bookmarked: z.ZodBoolean;
+        isAuthor: z.ZodBoolean;
+        canEdit: z.ZodBoolean;
+        canDelete: z.ZodBoolean;
+        canReport: z.ZodBoolean;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type FeedPost = z.infer<typeof feedPostSchema>;
+/**
+ * One choice. `index` is the identifier a vote refers to, not the label:
+ * sending indices avoids ambiguity between two options whose labels differ
+ * only by case, spacing or an invisible character.
+ */
+export declare const pollOptionSchema: z.ZodObject<{
+    index: z.ZodNumber;
+    label: z.ZodString;
+    voteCount: z.ZodNumber;
+}, z.core.$strip>;
+export type PollOption = z.infer<typeof pollOptionSchema>;
+/**
+ * A poll. Its own kind, not a post with extra fields, because votes are their
+ * own records keyed by (poll, voter) and a post has nothing equivalent.
+ *
+ * Polls are not editable. Changing a question or an option after a vote has
+ * been cast silently re-purposes that vote. Closing early is allowed; editing
+ * is not.
+ */
+export declare const feedPollSchema: z.ZodObject<{
+    id: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+    contentKind: z.ZodLiteral<"poll">;
+    author: z.ZodObject<{
+        userId: z.ZodString;
+        username: z.ZodString;
+        displayName: z.ZodString;
+        avatarUrl: z.ZodOptional<z.ZodURL>;
+        headline: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    question: z.ZodString;
+    options: z.ZodArray<z.ZodObject<{
+        index: z.ZodNumber;
+        label: z.ZodString;
+        voteCount: z.ZodNumber;
+    }, z.core.$strip>>;
+    totalVoters: z.ZodNumber;
+    allowsMultipleChoices: z.ZodBoolean;
+    closesAt: z.ZodISODateTime;
+    isClosed: z.ZodBoolean;
+    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";
+    }>>;
+    commentCount: z.ZodNumber;
+    reactionCounts: z.ZodRecord<z.ZodEnum<{
+        like: "like";
+        celebrate: "celebrate";
+        insightful: "insightful";
+        curious: "curious";
+    }> & z.core.$partial, z.ZodNumber>;
+    createdAt: z.ZodISODateTime;
+    editedAt: z.ZodNullable<z.ZodISODateTime>;
+    viewer: z.ZodOptional<z.ZodObject<{
+        reaction: z.ZodNullable<z.ZodEnum<{
+            like: "like";
+            celebrate: "celebrate";
+            insightful: "insightful";
+            curious: "curious";
+        }>>;
+        bookmarked: z.ZodBoolean;
+        isAuthor: z.ZodBoolean;
+        canEdit: z.ZodBoolean;
+        canDelete: z.ZodBoolean;
+        canReport: z.ZodBoolean;
+        votedOptionIndices: z.ZodArray<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type FeedPoll = z.infer<typeof feedPollSchema>;
+/**
+ * Discriminated on `contentKind`, so a client narrows with a switch and the
+ * compiler catches an unhandled kind the day one is added. A plain union would
+ * need every field checked by hand and would silently accept a hybrid.
+ */
+export declare const feedItemSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    id: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+    contentKind: z.ZodLiteral<"post">;
+    author: z.ZodObject<{
+        userId: z.ZodString;
+        username: z.ZodString;
+        displayName: z.ZodString;
+        avatarUrl: z.ZodOptional<z.ZodURL>;
+        headline: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    text: z.ZodString;
+    media: z.ZodArray<z.ZodDiscriminatedUnion<[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>;
+        kind: z.ZodLiteral<"image">;
+        thumbnailUrl: z.ZodOptional<z.ZodURL>;
+        alt: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"video">;
+        url: z.ZodURL;
+        thumbnailUrl: z.ZodURL;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+        duration: z.ZodNumber;
+    }, z.core.$strip>], "kind">>;
+    linkPreview: z.ZodOptional<z.ZodObject<{
+        url: z.ZodURL;
+        title: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        imageUrl: z.ZodOptional<z.ZodURL>;
+    }, z.core.$strip>>;
+    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";
+    }>>;
+    commentCount: z.ZodNumber;
+    reactionCounts: z.ZodRecord<z.ZodEnum<{
+        like: "like";
+        celebrate: "celebrate";
+        insightful: "insightful";
+        curious: "curious";
+    }> & z.core.$partial, z.ZodNumber>;
+    createdAt: z.ZodISODateTime;
+    editedAt: z.ZodNullable<z.ZodISODateTime>;
+    viewer: z.ZodOptional<z.ZodObject<{
+        reaction: z.ZodNullable<z.ZodEnum<{
+            like: "like";
+            celebrate: "celebrate";
+            insightful: "insightful";
+            curious: "curious";
+        }>>;
+        bookmarked: z.ZodBoolean;
+        isAuthor: z.ZodBoolean;
+        canEdit: z.ZodBoolean;
+        canDelete: z.ZodBoolean;
+        canReport: z.ZodBoolean;
+    }, z.core.$strip>>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+    contentKind: z.ZodLiteral<"poll">;
+    author: z.ZodObject<{
+        userId: z.ZodString;
+        username: z.ZodString;
+        displayName: z.ZodString;
+        avatarUrl: z.ZodOptional<z.ZodURL>;
+        headline: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    question: z.ZodString;
+    options: z.ZodArray<z.ZodObject<{
+        index: z.ZodNumber;
+        label: z.ZodString;
+        voteCount: z.ZodNumber;
+    }, z.core.$strip>>;
+    totalVoters: z.ZodNumber;
+    allowsMultipleChoices: z.ZodBoolean;
+    closesAt: z.ZodISODateTime;
+    isClosed: z.ZodBoolean;
+    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";
+    }>>;
+    commentCount: z.ZodNumber;
+    reactionCounts: z.ZodRecord<z.ZodEnum<{
+        like: "like";
+        celebrate: "celebrate";
+        insightful: "insightful";
+        curious: "curious";
+    }> & z.core.$partial, z.ZodNumber>;
+    createdAt: z.ZodISODateTime;
+    editedAt: z.ZodNullable<z.ZodISODateTime>;
+    viewer: z.ZodOptional<z.ZodObject<{
+        reaction: z.ZodNullable<z.ZodEnum<{
+            like: "like";
+            celebrate: "celebrate";
+            insightful: "insightful";
+            curious: "curious";
+        }>>;
+        bookmarked: z.ZodBoolean;
+        isAuthor: z.ZodBoolean;
+        canEdit: z.ZodBoolean;
+        canDelete: z.ZodBoolean;
+        canReport: z.ZodBoolean;
+        votedOptionIndices: z.ZodArray<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>], "contentKind">;
+export type FeedItem = z.infer<typeof feedItemSchema>;
+/**
+ * A comment, one level of nesting only: a reply to a comment is allowed, a
+ * reply to a reply is not. Two levels stay readable on a phone; three do not,
+ * and the server is what enforces it.
+ */
+export declare const feedCommentSchema: z.ZodObject<{
+    id: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+    contentKind: z.ZodEnum<{
+        post: "post";
+        poll: "poll";
+    }>;
+    contentId: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+    parentCommentId: z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
+    author: z.ZodObject<{
+        userId: z.ZodString;
+        username: z.ZodString;
+        displayName: z.ZodString;
+        avatarUrl: z.ZodOptional<z.ZodURL>;
+        headline: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    text: z.ZodString;
+    replyCount: z.ZodNumber;
+    reactionCounts: z.ZodRecord<z.ZodEnum<{
+        like: "like";
+        celebrate: "celebrate";
+        insightful: "insightful";
+        curious: "curious";
+    }> & z.core.$partial, z.ZodNumber>;
+    createdAt: z.ZodISODateTime;
+    editedAt: z.ZodNullable<z.ZodISODateTime>;
+    viewer: z.ZodOptional<z.ZodObject<{
+        reaction: z.ZodNullable<z.ZodEnum<{
+            like: "like";
+            celebrate: "celebrate";
+            insightful: "insightful";
+            curious: "curious";
+        }>>;
+        isAuthor: z.ZodBoolean;
+        canEdit: z.ZodBoolean;
+        canDelete: z.ZodBoolean;
+        canReport: z.ZodBoolean;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type FeedComment = z.infer<typeof feedCommentSchema>;
+/**
+ * `GET /api/v1/feed`. Inherits `limit` and `cursor`, which already tolerate an
+ * emptied control rather than answering 400.
+ *
+ * `interests=true` narrows to the viewer's topics (falling back to the plain
+ * feed when they have none). `z.stringbool`, so `true`/`false`/`1`/`0` all
+ * read as a person means them; until 0.2.0 the backend read this parameter
+ * raw, outside the schema, and only the exact string `true` counted.
+ *
+ * ⚠ NO `authorId`. It was accepted here and then ignored by the server, so a
+ * profile page asking for one founder's posts silently got everybody's. A
+ * member's own posts are `GET /api/v1/feed/by-author/:userId`.
+ */
+export declare const feedQuerySchema: z.ZodObject<{
+    limit: z.ZodPreprocess<z.ZodDefault<z.ZodCoercedNumber<unknown>>, unknown>;
+    cursor: z.ZodOptional<z.ZodString>;
+    sort: z.ZodPreprocess<z.ZodDefault<z.ZodEnum<{
+        new: "new";
+        top: "top";
+    }>>, unknown>;
+    interests: z.ZodPreprocess<z.ZodDefault<z.ZodCodec<z.ZodString, z.ZodBoolean>>, unknown>;
+}, z.core.$strip>;
+export type FeedQuery = z.infer<typeof feedQuerySchema>;
+export type FeedQueryInput = z.input<typeof feedQuerySchema>;
+/** `GET /api/v1/feed/:contentKind/:contentId/comments`. */
+export declare const commentsQuerySchema: z.ZodObject<{
+    limit: z.ZodPreprocess<z.ZodDefault<z.ZodCoercedNumber<unknown>>, unknown>;
+    cursor: z.ZodOptional<z.ZodString>;
+    parentCommentId: z.ZodPreprocess<z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>, unknown>;
+}, z.core.$strip>;
+export type CommentsQuery = z.infer<typeof commentsQuerySchema>;
+export type CommentsQueryInput = z.input<typeof commentsQuerySchema>;
+/**
+ * Every id and kind in a feed URL, as a schema, so a bad one answers exactly
+ * as a bad body field does: 400 `VALIDATION_ERROR`, the issue at
+ * `location: 'params'`. Until 0.2.0 these were hand checks that answered
+ * "Invalid id." with no issues at all, and the comment routes never looked at
+ * `:contentKind`.
+ */
+/** `GET /feed/:id`, the permalink. */
+export declare const feedItemParamsSchema: z.ZodObject<{
+    id: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+}, z.core.$strip>;
+/** `PATCH|DELETE /feed/:contentId`. */
+export declare const contentParamsSchema: z.ZodObject<{
+    contentId: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+}, z.core.$strip>;
+/** A bookmark and a comment thread: a post or a poll. */
+export declare const contentTargetParamsSchema: z.ZodObject<{
+    contentKind: z.ZodEnum<{
+        post: "post";
+        poll: "poll";
+    }>;
+    contentId: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+}, z.core.$strip>;
+/** A reaction and a report: a post, a poll or a comment. */
+export declare const engagementTargetParamsSchema: z.ZodObject<{
+    contentKind: z.ZodEnum<{
+        post: "post";
+        poll: "poll";
+        comment: "comment";
+    }>;
+    contentId: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+}, z.core.$strip>;
+/** `POST|DELETE /feed/poll/:pollId/vote`. */
+export declare const pollParamsSchema: z.ZodObject<{
+    pollId: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+}, z.core.$strip>;
+/** `DELETE /feed/comments/:commentId`. */
+export declare const commentParamsSchema: z.ZodObject<{
+    commentId: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+}, z.core.$strip>;
+/** `GET /feed/by-author/:userId`. */
+export declare const authorParamsSchema: z.ZodObject<{
+    userId: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+}, z.core.$strip>;
+export type FeedItemParams = z.infer<typeof feedItemParamsSchema>;
+export type ContentParams = z.infer<typeof contentParamsSchema>;
+export type ContentTargetParams = z.infer<typeof contentTargetParamsSchema>;
+export type EngagementTargetParams = z.infer<typeof engagementTargetParamsSchema>;
+export type PollParams = z.infer<typeof pollParamsSchema>;
+export type CommentParams = z.infer<typeof commentParamsSchema>;
+export type AuthorParams = z.infer<typeof authorParamsSchema>;
+/**
+ * A page of the feed, and of one member's posts (`by-author`), which is the
+ * same shape. `nextCursor` is null on the last page.
+ */
+export declare const feedPageSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        id: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+        contentKind: z.ZodLiteral<"post">;
+        author: z.ZodObject<{
+            userId: z.ZodString;
+            username: z.ZodString;
+            displayName: z.ZodString;
+            avatarUrl: z.ZodOptional<z.ZodURL>;
+            headline: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        text: z.ZodString;
+        media: z.ZodArray<z.ZodDiscriminatedUnion<[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>;
+            kind: z.ZodLiteral<"image">;
+            thumbnailUrl: z.ZodOptional<z.ZodURL>;
+            alt: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"video">;
+            url: z.ZodURL;
+            thumbnailUrl: z.ZodURL;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+            duration: z.ZodNumber;
+        }, z.core.$strip>], "kind">>;
+        linkPreview: z.ZodOptional<z.ZodObject<{
+            url: z.ZodURL;
+            title: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            imageUrl: z.ZodOptional<z.ZodURL>;
+        }, z.core.$strip>>;
+        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";
+        }>>;
+        commentCount: z.ZodNumber;
+        reactionCounts: z.ZodRecord<z.ZodEnum<{
+            like: "like";
+            celebrate: "celebrate";
+            insightful: "insightful";
+            curious: "curious";
+        }> & z.core.$partial, z.ZodNumber>;
+        createdAt: z.ZodISODateTime;
+        editedAt: z.ZodNullable<z.ZodISODateTime>;
+        viewer: z.ZodOptional<z.ZodObject<{
+            reaction: z.ZodNullable<z.ZodEnum<{
+                like: "like";
+                celebrate: "celebrate";
+                insightful: "insightful";
+                curious: "curious";
+            }>>;
+            bookmarked: z.ZodBoolean;
+            isAuthor: z.ZodBoolean;
+            canEdit: z.ZodBoolean;
+            canDelete: z.ZodBoolean;
+            canReport: z.ZodBoolean;
+        }, z.core.$strip>>;
+    }, z.core.$strip>, z.ZodObject<{
+        id: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+        contentKind: z.ZodLiteral<"poll">;
+        author: z.ZodObject<{
+            userId: z.ZodString;
+            username: z.ZodString;
+            displayName: z.ZodString;
+            avatarUrl: z.ZodOptional<z.ZodURL>;
+            headline: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        question: z.ZodString;
+        options: z.ZodArray<z.ZodObject<{
+            index: z.ZodNumber;
+            label: z.ZodString;
+            voteCount: z.ZodNumber;
+        }, z.core.$strip>>;
+        totalVoters: z.ZodNumber;
+        allowsMultipleChoices: z.ZodBoolean;
+        closesAt: z.ZodISODateTime;
+        isClosed: z.ZodBoolean;
+        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";
+        }>>;
+        commentCount: z.ZodNumber;
+        reactionCounts: z.ZodRecord<z.ZodEnum<{
+            like: "like";
+            celebrate: "celebrate";
+            insightful: "insightful";
+            curious: "curious";
+        }> & z.core.$partial, z.ZodNumber>;
+        createdAt: z.ZodISODateTime;
+        editedAt: z.ZodNullable<z.ZodISODateTime>;
+        viewer: z.ZodOptional<z.ZodObject<{
+            reaction: z.ZodNullable<z.ZodEnum<{
+                like: "like";
+                celebrate: "celebrate";
+                insightful: "insightful";
+                curious: "curious";
+            }>>;
+            bookmarked: z.ZodBoolean;
+            isAuthor: z.ZodBoolean;
+            canEdit: z.ZodBoolean;
+            canDelete: z.ZodBoolean;
+            canReport: z.ZodBoolean;
+            votedOptionIndices: z.ZodArray<z.ZodNumber>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>], "contentKind">>;
+    nextCursor: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type FeedPage = z.infer<typeof feedPageSchema>;
+/** A page of a thread: top-level comments, or one comment's replies. */
+export declare const commentPageSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        id: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+        contentKind: z.ZodEnum<{
+            post: "post";
+            poll: "poll";
+        }>;
+        contentId: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+        parentCommentId: z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
+        author: z.ZodObject<{
+            userId: z.ZodString;
+            username: z.ZodString;
+            displayName: z.ZodString;
+            avatarUrl: z.ZodOptional<z.ZodURL>;
+            headline: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        text: z.ZodString;
+        replyCount: z.ZodNumber;
+        reactionCounts: z.ZodRecord<z.ZodEnum<{
+            like: "like";
+            celebrate: "celebrate";
+            insightful: "insightful";
+            curious: "curious";
+        }> & z.core.$partial, z.ZodNumber>;
+        createdAt: z.ZodISODateTime;
+        editedAt: z.ZodNullable<z.ZodISODateTime>;
+        viewer: z.ZodOptional<z.ZodObject<{
+            reaction: z.ZodNullable<z.ZodEnum<{
+                like: "like";
+                celebrate: "celebrate";
+                insightful: "insightful";
+                curious: "curious";
+            }>>;
+            isAuthor: z.ZodBoolean;
+            canEdit: z.ZodBoolean;
+            canDelete: z.ZodBoolean;
+            canReport: z.ZodBoolean;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    nextCursor: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type CommentPage = z.infer<typeof commentPageSchema>;
+/**
+ * ⚠️ Every write body below is its own object with NO defaults, and none of
+ * them is built with `.pick().partial()`. `.partial()` does not switch off
+ * `.default()`, so a patch body built that way rewrites defaulted fields on
+ * every request. See `updateFounderProfileBodySchema` for the incident.
+ */
+/**
+ * An attachment on the way IN: the id of an image already uploaded and
+ * completed (`media`), and deliberately not a URL.
+ *
+ * ⚠ The first draft of this took the full read shape, URL included. That is
+ * the same hole that was closed on the profile: a URL in a write body is a
+ * member-supplied URL, so a post could have carried `javascript:` in an image
+ * source, and nothing downstream re-checks a value the server itself stored.
+ * Taking an id instead removes the question rather than validating it.
+ *
+ * `width`, `height` and the URLs are NOT accepted either: the server measured
+ * them when it processed the upload, and taking them from the client would let
+ * a caller claim a 1x1 image and collapse the card.
+ *
+ * The server attaches each id only if it is the caller's, processed, uploaded
+ * for a post, and not attached anywhere yet (`UPLOAD_NOT_ATTACHABLE`
+ * otherwise), so one upload can never appear on two posts.
+ */
+export declare const attachedMediaSchema: z.ZodObject<{
+    mediaId: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+    alt: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type AttachedMedia = z.infer<typeof attachedMediaSchema>;
+/**
+ * A post must carry something. Text alone, media alone, or both; empty is
+ * refused here rather than reaching the feed as a blank card.
+ */
+export declare const createPostBodySchema: z.ZodObject<{
+    text: z.ZodOptional<z.ZodString>;
+    media: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        mediaId: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+        alt: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    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 CreatePostBody = z.infer<typeof createPostBodySchema>;
+/** Only the text is editable. Changing media after the fact makes every
+ *  earlier reply look like a reply to something else. */
+export declare const updatePostBodySchema: z.ZodObject<{
+    text: z.ZodString;
+}, z.core.$strip>;
+export type UpdatePostBody = z.infer<typeof updatePostBodySchema>;
+export declare const createPollBodySchema: z.ZodObject<{
+    question: z.ZodString;
+    options: z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+    }, z.core.$strip>>;
+    durationMs: z.ZodNumber;
+    allowsMultipleChoices: z.ZodBoolean;
+    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 CreatePollBody = z.infer<typeof createPollBodySchema>;
+/** Cast or change a vote. The server upserts on (poll, voter), so voting
+ *  twice replaces rather than doubles. */
+export declare const castVoteBodySchema: z.ZodObject<{
+    optionIndices: z.ZodArray<z.ZodNumber>;
+}, z.core.$strip>;
+export type CastVoteBody = z.infer<typeof castVoteBodySchema>;
+export declare const createCommentBodySchema: z.ZodObject<{
+    text: z.ZodString;
+    parentCommentId: z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
+}, z.core.$strip>;
+export type CreateCommentBody = z.infer<typeof createCommentBodySchema>;
+export declare const updateCommentBodySchema: z.ZodObject<{
+    text: z.ZodString;
+}, z.core.$strip>;
+export type UpdateCommentBody = z.infer<typeof updateCommentBodySchema>;
+/** Set or clear a reaction. `null` clears it; at most one per viewer per item. */
+export declare const setReactionBodySchema: z.ZodObject<{
+    reaction: z.ZodNullable<z.ZodEnum<{
+        like: "like";
+        celebrate: "celebrate";
+        insightful: "insightful";
+        curious: "curious";
+    }>>;
+}, z.core.$strip>;
+export type SetReactionBody = z.infer<typeof setReactionBodySchema>;
+/**
+ * Returned by the reaction endpoint so the card can render the authoritative
+ * result without a follow-up read. Without the fresh counts a client has to
+ * guess the new total, and two quick taps leave it showing a number the server
+ * never had.
+ */
+export declare const setReactionResponseSchema: z.ZodObject<{
+    contentKind: z.ZodEnum<{
+        post: "post";
+        poll: "poll";
+        comment: "comment";
+    }>;
+    contentId: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+    reaction: z.ZodNullable<z.ZodEnum<{
+        like: "like";
+        celebrate: "celebrate";
+        insightful: "insightful";
+        curious: "curious";
+    }>>;
+    reactionCounts: z.ZodRecord<z.ZodEnum<{
+        like: "like";
+        celebrate: "celebrate";
+        insightful: "insightful";
+        curious: "curious";
+    }> & z.core.$partial, z.ZodNumber>;
+}, z.core.$strip>;
+export type SetReactionResponse = z.infer<typeof setReactionResponseSchema>;
+/**
+ * Why a member reported something.
+ *
+ * ⚠️ Stored on every report row, so this is data, not a label: removing a value
+ * orphans reports already filed under it, and the counts nobody can recover are
+ * exactly the ones a moderation review needs. Append only.
+ *
+ * ⚠️ A REASON THAT IS MISSING DOES NOT DISAPPEAR, it lands in `other`. Whatever
+ * is not named here becomes an undifferentiated pile that no aggregate can see
+ * a pattern in, which is the one thing report categories exist for. Worth being
+ * deliberate about the absences rather than discovering them later.
+ */
+export declare const REPORT_REASON_VALUES: readonly ["spam", "harassment", "misinformation", "off_topic", "impersonation", "other"];
+export declare const reportReasonSchema: z.ZodEnum<{
+    other: "other";
+    spam: "spam";
+    harassment: "harassment";
+    misinformation: "misinformation";
+    off_topic: "off_topic";
+    impersonation: "impersonation";
+}>;
+export type ReportReason = z.infer<typeof reportReasonSchema>;
+/**
+ * What a member sends to report a post, poll or comment.
+ *
+ * The target is the URL's, not the body's: a report is filed against a specific
+ * thing at a specific address, and taking the target from the body would let a
+ * caller report one item while the route thinks it is another.
+ *
+ * `note` is free text and optional, which is the pressure valve for everything
+ * the enum does not name. ⚠️ It is written by a member, so it is untrusted at
+ * render: a moderation queue displays it, and a moderation queue is a screen
+ * staff read quickly.
+ */
+export declare const createReportBodySchema: z.ZodObject<{
+    reason: z.ZodEnum<{
+        other: "other";
+        spam: "spam";
+        harassment: "harassment";
+        misinformation: "misinformation";
+        off_topic: "off_topic";
+        impersonation: "impersonation";
+    }>;
+    note: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type CreateReportBody = z.infer<typeof createReportBodySchema>;
+/**
+ * The answer to filing one.
+ *
+ * `alreadyReported` distinguishes "we have taken this" from "you already told
+ * us", because one report per member per target means a second press is a
+ * no-op, and a silent no-op reads as a failure to somebody who pressed twice
+ * deliberately. It is NOT a count: how many OTHER people reported an item is
+ * moderation's business and telling a reporter would turn the count into a
+ * score anyone could farm.
+ */
+export declare const createReportResponseSchema: z.ZodObject<{
+    contentKind: z.ZodEnum<{
+        post: "post";
+        poll: "poll";
+        comment: "comment";
+    }>;
+    contentId: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+    alreadyReported: z.ZodBoolean;
+}, z.core.$strip>;
+export type CreateReportResponse = z.infer<typeof createReportResponseSchema>;
+/** The bookmark endpoint is a toggle and returns the state it settled on. */
+export declare const toggleBookmarkResponseSchema: z.ZodObject<{
+    contentKind: z.ZodEnum<{
+        post: "post";
+        poll: "poll";
+    }>;
+    contentId: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+    bookmarked: z.ZodBoolean;
+}, z.core.$strip>;
+export type ToggleBookmarkResponse = z.infer<typeof toggleBookmarkResponseSchema>;
+/** A vote returns the whole poll: counts, totals and the viewer's own choices
+ *  all move together, and reassembling them client-side drifts. */
+export declare const castVoteResponseSchema: z.ZodObject<{
+    poll: z.ZodObject<{
+        id: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+        contentKind: z.ZodLiteral<"poll">;
+        author: z.ZodObject<{
+            userId: z.ZodString;
+            username: z.ZodString;
+            displayName: z.ZodString;
+            avatarUrl: z.ZodOptional<z.ZodURL>;
+            headline: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        question: z.ZodString;
+        options: z.ZodArray<z.ZodObject<{
+            index: z.ZodNumber;
+            label: z.ZodString;
+            voteCount: z.ZodNumber;
+        }, z.core.$strip>>;
+        totalVoters: z.ZodNumber;
+        allowsMultipleChoices: z.ZodBoolean;
+        closesAt: z.ZodISODateTime;
+        isClosed: z.ZodBoolean;
+        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";
+        }>>;
+        commentCount: z.ZodNumber;
+        reactionCounts: z.ZodRecord<z.ZodEnum<{
+            like: "like";
+            celebrate: "celebrate";
+            insightful: "insightful";
+            curious: "curious";
+        }> & z.core.$partial, z.ZodNumber>;
+        createdAt: z.ZodISODateTime;
+        editedAt: z.ZodNullable<z.ZodISODateTime>;
+        viewer: z.ZodOptional<z.ZodObject<{
+            reaction: z.ZodNullable<z.ZodEnum<{
+                like: "like";
+                celebrate: "celebrate";
+                insightful: "insightful";
+                curious: "curious";
+            }>>;
+            bookmarked: z.ZodBoolean;
+            isAuthor: z.ZodBoolean;
+            canEdit: z.ZodBoolean;
+            canDelete: z.ZodBoolean;
+            canReport: z.ZodBoolean;
+            votedOptionIndices: z.ZodArray<z.ZodNumber>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type CastVoteResponse = z.infer<typeof castVoteResponseSchema>;
+//# sourceMappingURL=feed.d.ts.map