jansathi-community-schema 0.17.0 → 0.19.0

package/dist/community.d.ts

@@ -27,6 +27,63 @@
  * @module community-schema/community
  */
 import { z } from 'zod';
+/**
+ * Two fundamentally different community shapes share the same wire
+ * schema:
+ *
+ *   user     — topic-of-interest community a regular user creates and
+ *              owns (Reddit subreddit / Facebook group analogue). Owner
+ *              + admins manage; members join. The default kind.
+ *   official — area-based civic community for a specific administrative
+ *              area (village / block / district / urban body / ... up
+ *              to state). Created by the elected area leader; has NO
+ *              owner. Permission is computed at read time from the
+ *              current area-leader binding:
+ *                - admin role = whoever is the area's leader right now
+ *                  (falls back to platform superadmin when no leader is
+ *                  appointed)
+ *                - representative role = the elected official the area
+ *                  leader names (Pradhan / Mayor / MLA / ...); replaced
+ *                  on each new political election
+ *                - moderator role = community-scoped; can hide reported
+ *                  posts. Representative can override moderator
+ *                  decisions from settings.
+ *              Always auto-verified (the leader's act of creating it IS
+ *              the verification) and immune to delete from anyone
+ *              except platform superadmin / manager.
+ */
+export declare const COMMUNITY_KIND_VALUES: readonly ["user", "official"];
+export type CommunityKind = (typeof COMMUNITY_KIND_VALUES)[number];
+export declare const communityKindSchema: z.ZodEnum<{
+    user: "user";
+    official: "official";
+}>;
+/**
+ * Administrative area levels that can host an official community.
+ *
+ * Mirrors a subset of the reform-backend `JURISDICTION_LEVEL` enum —
+ * NATIONAL and GLOBAL are intentionally excluded because they are
+ * virtual tiers (no `Area` row) and don't fit the "community for THIS
+ * area" model. If we ever want national / global civic communities
+ * they should be a separate concept.
+ *
+ * The leader-jurisdiction → area-kind binding is 1:1:
+ *   leader.jurisdictionLevel === community.officialAreaKind   AND
+ *   leader.jurisdictionAreaId  === community.officialAreaId
+ * is the gate for who can create / admin the community.
+ */
+export declare const OFFICIAL_COMMUNITY_AREA_KIND_VALUES: readonly ["STATE", "DISTRICT", "BLOCK", "GRAM_PANCHAYAT", "VILLAGE", "URBAN_BODY", "URBAN_WARD", "LOCALITY"];
+export type OfficialCommunityAreaKind = (typeof OFFICIAL_COMMUNITY_AREA_KIND_VALUES)[number];
+export declare const officialCommunityAreaKindSchema: z.ZodEnum<{
+    STATE: "STATE";
+    DISTRICT: "DISTRICT";
+    BLOCK: "BLOCK";
+    GRAM_PANCHAYAT: "GRAM_PANCHAYAT";
+    VILLAGE: "VILLAGE";
+    URBAN_BODY: "URBAN_BODY";
+    URBAN_WARD: "URBAN_WARD";
+    LOCALITY: "LOCALITY";
+}>;
 /**
  *   public     — anyone can read + post.
  *   restricted — anyone can read; only approved members can post. The
@@ -411,17 +468,37 @@ export declare const communityCenterCoordsSchema: z.ZodObject<{
 export type CommunityCenterCoords = z.infer<typeof communityCenterCoordsSchema>;
 /** Role hierarchy within a single community.
  *
- *   owner   — creator; cannot be demoted by anyone, can transfer
- *             ownership (deferred for v1) and delete the community.
- *   admin   — granted by owner; can edit metadata, kick members,
- *             soft-delete posts authored in the community.
- *   member  — joined; can post and comment, can leave at any time.
+ * The role set is shared across `user` and `official` communities, but
+ * not every role is valid for every kind:
+ *
+ *   owner          — `kind: 'user'` only. The creator; can edit
+ *                    metadata, transfer ownership (deferred), and
+ *                    delete the community.
+ *   admin          — `kind: 'user'`: granted by the owner; can edit
+ *                    metadata, kick members, soft-delete posts.
+ *                    `kind: 'official'`: computed from the current
+ *                    area-leader binding (never stored on a membership
+ *                    row); platform superadmin fills the slot when no
+ *                    leader is appointed.
+ *   representative — `kind: 'official'` only. The elected official the
+ *                    area leader names (Pradhan / Mayor / ...).
+ *                    Replaced on every new political election. Can
+ *                    override moderator decisions from the community
+ *                    settings page.
+ *   moderator      — `kind: 'official'` only. Community-scoped; can
+ *                    hide reported posts. Multiple moderators allowed
+ *                    per community. The current admin (area leader)
+ *                    grants and revokes.
+ *   member         — joined; can post and comment, can leave at any
+ *                    time. Valid for both kinds.
  */
-export declare const COMMUNITY_ROLE_VALUES: readonly ["owner", "admin", "member"];
+export declare const COMMUNITY_ROLE_VALUES: readonly ["owner", "admin", "representative", "moderator", "member"];
 export type CommunityRole = (typeof COMMUNITY_ROLE_VALUES)[number];
 export declare const communityRoleSchema: z.ZodEnum<{
     owner: "owner";
     admin: "admin";
+    representative: "representative";
+    moderator: "moderator";
     member: "member";
 }>;
 /** Membership lifecycle.
@@ -456,7 +533,12 @@ export declare const communityWireSchema: z.ZodObject<{
         restricted: "restricted";
     }>;
     coverImageUrl: z.ZodOptional<z.ZodString>;
-    ownerUserId: z.ZodString;
+    kind: z.ZodEnum<{
+        user: "user";
+        official: "official";
+    }>;
+    ownerUserId: z.ZodNullable<z.ZodString>;
+    createdBy: z.ZodNullable<z.ZodString>;
     memberCount: z.ZodNumber;
     postCount: z.ZodNumber;
     groupId: z.ZodString;
@@ -703,10 +785,23 @@ export declare const communityWireSchema: z.ZodObject<{
         national: "national";
         global: "global";
     }>>;
+    officialAreaKind: z.ZodNullable<z.ZodEnum<{
+        STATE: "STATE";
+        DISTRICT: "DISTRICT";
+        BLOCK: "BLOCK";
+        GRAM_PANCHAYAT: "GRAM_PANCHAYAT";
+        VILLAGE: "VILLAGE";
+        URBAN_BODY: "URBAN_BODY";
+        URBAN_WARD: "URBAN_WARD";
+        LOCALITY: "LOCALITY";
+    }>>;
+    officialAreaId: z.ZodNullable<z.ZodString>;
     viewer: z.ZodOptional<z.ZodObject<{
         role: z.ZodNullable<z.ZodEnum<{
             owner: "owner";
             admin: "admin";
+            representative: "representative";
+            moderator: "moderator";
             member: "member";
         }>>;
         status: z.ZodNullable<z.ZodEnum<{
@@ -750,6 +845,8 @@ export declare const communityMemberWireSchema: z.ZodObject<{
     role: z.ZodEnum<{
         owner: "owner";
         admin: "admin";
+        representative: "representative";
+        moderator: "moderator";
         member: "member";
     }>;
     status: z.ZodEnum<{
@@ -1368,7 +1465,12 @@ export declare const communityListResponseSchema: z.ZodObject<{
             restricted: "restricted";
         }>;
         coverImageUrl: z.ZodOptional<z.ZodString>;
-        ownerUserId: z.ZodString;
+        kind: z.ZodEnum<{
+            user: "user";
+            official: "official";
+        }>;
+        ownerUserId: z.ZodNullable<z.ZodString>;
+        createdBy: z.ZodNullable<z.ZodString>;
         memberCount: z.ZodNumber;
         postCount: z.ZodNumber;
         groupId: z.ZodString;
@@ -1615,10 +1717,23 @@ export declare const communityListResponseSchema: z.ZodObject<{
             national: "national";
             global: "global";
         }>>;
+        officialAreaKind: z.ZodNullable<z.ZodEnum<{
+            STATE: "STATE";
+            DISTRICT: "DISTRICT";
+            BLOCK: "BLOCK";
+            GRAM_PANCHAYAT: "GRAM_PANCHAYAT";
+            VILLAGE: "VILLAGE";
+            URBAN_BODY: "URBAN_BODY";
+            URBAN_WARD: "URBAN_WARD";
+            LOCALITY: "LOCALITY";
+        }>>;
+        officialAreaId: z.ZodNullable<z.ZodString>;
         viewer: z.ZodOptional<z.ZodObject<{
             role: z.ZodNullable<z.ZodEnum<{
                 owner: "owner";
                 admin: "admin";
+                representative: "representative";
+                moderator: "moderator";
                 member: "member";
             }>>;
             status: z.ZodNullable<z.ZodEnum<{
@@ -1673,6 +1788,8 @@ export declare const joinCommunityResponseSchema: z.ZodObject<{
     role: z.ZodNullable<z.ZodEnum<{
         owner: "owner";
         admin: "admin";
+        representative: "representative";
+        moderator: "moderator";
         member: "member";
     }>>;
     joinedAt: z.ZodNullable<z.ZodString>;
@@ -1687,6 +1804,8 @@ export declare const communityMembersListResponseSchema: z.ZodObject<{
         role: z.ZodEnum<{
             owner: "owner";
             admin: "admin";
+            representative: "representative";
+            moderator: "moderator";
             member: "member";
         }>;
         status: z.ZodEnum<{
@@ -1836,4 +1955,96 @@ export declare const areaPickerResponseSchema: z.ZodObject<{
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export type AreaPickerResponse = z.infer<typeof areaPickerResponseSchema>;
+/**
+ * `POST /communities/official` body. Single-step flow.
+ *
+ * The area-leader binding gates the call: the caller's elevated
+ * `serviceRoles['reform']` must include `leader` AND their
+ * `jurisdictionLevel + jurisdictionAreaId` must exactly equal the
+ * `areaKind + areaId` supplied here. Backend resolves the rest:
+ *
+ *  • `name` and `slug` are derived server-side from the area name +
+ *    kind (e.g. "Pataudi Block Community" / `pataudi-block`). The
+ *    caller may override `description` and pick a cover image.
+ *  • `kind` is fixed to `'official'`; no need to send it.
+ *  • `reach`, `category`, `tags`, `mature`, `areaLineage`,
+ *    `centerCoords` are derived from the picked area.
+ *  • `verifiedAt`, `verifiedBy` are auto-set at create time (the
+ *    leader's act of creating it IS the verification).
+ *
+ * Re-creating after an area-level community has been soft-deleted by
+ * superadmin is allowed because the partial unique index excludes
+ * soft-deleted rows.
+ */
+export declare const createOfficialCommunityBodySchema: z.ZodObject<{
+    areaKind: z.ZodEnum<{
+        STATE: "STATE";
+        DISTRICT: "DISTRICT";
+        BLOCK: "BLOCK";
+        GRAM_PANCHAYAT: "GRAM_PANCHAYAT";
+        VILLAGE: "VILLAGE";
+        URBAN_BODY: "URBAN_BODY";
+        URBAN_WARD: "URBAN_WARD";
+        LOCALITY: "LOCALITY";
+    }>;
+    areaId: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    coverImageUrl: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type CreateOfficialCommunityBody = z.infer<typeof createOfficialCommunityBodySchema>;
+/**
+ * Body for `POST /communities/:slug/moderators` — assign a moderator.
+ * The target user must already be an active member of the community.
+ *
+ * Caller authority:
+ *   - `kind: 'official'` admin (the current area leader, or the
+ *     platform superadmin when no leader is appointed) can add or
+ *     remove a moderator. The representative cannot (representative
+ *     can override moderator decisions but does not manage the
+ *     moderator roster).
+ *
+ * To remove a moderator use `DELETE /communities/:slug/moderators/:userId`.
+ */
+export declare const addOfficialModeratorBodySchema: z.ZodObject<{
+    userId: z.ZodString;
+}, z.core.$strip>;
+export type AddOfficialModeratorBody = z.infer<typeof addOfficialModeratorBodySchema>;
+/**
+ * Body for `PUT /communities/:slug/representative` — set or replace
+ * the community's named elected representative (Pradhan / Mayor / ...).
+ *
+ * The representative slot is single-valued: writing a new user ID
+ * replaces whoever held it before (matching the "new election → new
+ * person" lifecycle). Use `DELETE /communities/:slug/representative`
+ * to clear the slot between elections.
+ *
+ * The target user must already be an active member of the community;
+ * the backend will auto-add them as a member if they're not.
+ *
+ * Caller authority: `kind: 'official'` admin only.
+ */
+export declare const setOfficialRepresentativeBodySchema: z.ZodObject<{
+    userId: z.ZodString;
+}, z.core.$strip>;
+export type SetOfficialRepresentativeBody = z.infer<typeof setOfficialRepresentativeBodySchema>;
+/**
+ * Body for `POST /communities/:slug/posts/:postId/hide`.
+ *
+ * Hides a post from the community feed for everyone except the author
+ * (who still sees their own post, marked as "hidden by moderator").
+ *
+ * Caller authority on `kind: 'official'`:
+ *   - moderator    — can hide a post that has at least one open report.
+ *   - representative — can hide or unhide ANY post (including overriding
+ *                      a moderator's hide). The override is what makes
+ *                      the representative's "settings" page useful.
+ *   - admin         — same authority as representative.
+ *
+ * On `kind: 'user'` the existing soft-delete by owner / admin path
+ * continues to apply; this endpoint is `official`-only.
+ */
+export declare const hidePostBodySchema: z.ZodObject<{
+    reason: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type HidePostBody = z.infer<typeof hidePostBodySchema>;
 //# sourceMappingURL=community.d.ts.map

package/dist/community.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"community.d.ts","sourceRoot":"","sources":["../src/community.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"community.d.ts","sourceRoot":"","sources":["../src/community.ts"],"names":[],"mappings":"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"}

package/dist/community.js

@@ -30,6 +30,58 @@ import { z } from 'zod';
 import { areaLineageSnapshotSchema } from './area.js';
 import { COMMUNITIES_PAGE_SIZE, COMMUNITY_DESCRIPTION_MAX_CHARS, COMMUNITY_DESIGNATION_CUSTOM_MAX_CHARS, COMMUNITY_DESIGNATION_CUSTOM_MIN_CHARS, COMMUNITY_DESIGNATION_CUSTOM_PATTERN, COMMUNITY_MAX_TAGS, COMMUNITY_NAME_MAX_CHARS, COMMUNITY_NAME_MIN_CHARS, COMMUNITY_SLUG_MAX_CHARS, COMMUNITY_SLUG_MIN_CHARS, COMMUNITY_SLUG_PATTERN, } from './constants.js';
 // ─── Enums ──────────────────────────────────────────────────────────────────
+/**
+ * Two fundamentally different community shapes share the same wire
+ * schema:
+ *
+ *   user     — topic-of-interest community a regular user creates and
+ *              owns (Reddit subreddit / Facebook group analogue). Owner
+ *              + admins manage; members join. The default kind.
+ *   official — area-based civic community for a specific administrative
+ *              area (village / block / district / urban body / ... up
+ *              to state). Created by the elected area leader; has NO
+ *              owner. Permission is computed at read time from the
+ *              current area-leader binding:
+ *                - admin role = whoever is the area's leader right now
+ *                  (falls back to platform superadmin when no leader is
+ *                  appointed)
+ *                - representative role = the elected official the area
+ *                  leader names (Pradhan / Mayor / MLA / ...); replaced
+ *                  on each new political election
+ *                - moderator role = community-scoped; can hide reported
+ *                  posts. Representative can override moderator
+ *                  decisions from settings.
+ *              Always auto-verified (the leader's act of creating it IS
+ *              the verification) and immune to delete from anyone
+ *              except platform superadmin / manager.
+ */
+export const COMMUNITY_KIND_VALUES = ['user', 'official'];
+export const communityKindSchema = z.enum(COMMUNITY_KIND_VALUES);
+/**
+ * Administrative area levels that can host an official community.
+ *
+ * Mirrors a subset of the reform-backend `JURISDICTION_LEVEL` enum —
+ * NATIONAL and GLOBAL are intentionally excluded because they are
+ * virtual tiers (no `Area` row) and don't fit the "community for THIS
+ * area" model. If we ever want national / global civic communities
+ * they should be a separate concept.
+ *
+ * The leader-jurisdiction → area-kind binding is 1:1:
+ *   leader.jurisdictionLevel === community.officialAreaKind   AND
+ *   leader.jurisdictionAreaId  === community.officialAreaId
+ * is the gate for who can create / admin the community.
+ */
+export const OFFICIAL_COMMUNITY_AREA_KIND_VALUES = [
+    'STATE',
+    'DISTRICT',
+    'BLOCK',
+    'GRAM_PANCHAYAT',
+    'VILLAGE',
+    'URBAN_BODY',
+    'URBAN_WARD',
+    'LOCALITY',
+];
+export const officialCommunityAreaKindSchema = z.enum(OFFICIAL_COMMUNITY_AREA_KIND_VALUES);
 /**
  *   public     — anyone can read + post.
  *   restricted — anyone can read; only approved members can post. The
@@ -404,13 +456,37 @@ export const communityCenterCoordsSchema = z.object({
 });
 /** Role hierarchy within a single community.
  *
- *   owner   — creator; cannot be demoted by anyone, can transfer
- *             ownership (deferred for v1) and delete the community.
- *   admin   — granted by owner; can edit metadata, kick members,
- *             soft-delete posts authored in the community.
- *   member  — joined; can post and comment, can leave at any time.
+ * The role set is shared across `user` and `official` communities, but
+ * not every role is valid for every kind:
+ *
+ *   owner          — `kind: 'user'` only. The creator; can edit
+ *                    metadata, transfer ownership (deferred), and
+ *                    delete the community.
+ *   admin          — `kind: 'user'`: granted by the owner; can edit
+ *                    metadata, kick members, soft-delete posts.
+ *                    `kind: 'official'`: computed from the current
+ *                    area-leader binding (never stored on a membership
+ *                    row); platform superadmin fills the slot when no
+ *                    leader is appointed.
+ *   representative — `kind: 'official'` only. The elected official the
+ *                    area leader names (Pradhan / Mayor / ...).
+ *                    Replaced on every new political election. Can
+ *                    override moderator decisions from the community
+ *                    settings page.
+ *   moderator      — `kind: 'official'` only. Community-scoped; can
+ *                    hide reported posts. Multiple moderators allowed
+ *                    per community. The current admin (area leader)
+ *                    grants and revokes.
+ *   member         — joined; can post and comment, can leave at any
+ *                    time. Valid for both kinds.
  */
-export const COMMUNITY_ROLE_VALUES = ['owner', 'admin', 'member'];
+export const COMMUNITY_ROLE_VALUES = [
+    'owner',
+    'admin',
+    'representative',
+    'moderator',
+    'member',
+];
 export const communityRoleSchema = z.enum(COMMUNITY_ROLE_VALUES);
 /** Membership lifecycle.
  *
@@ -437,7 +513,18 @@ export const communityWireSchema = z.object({
     description: z.string().max(COMMUNITY_DESCRIPTION_MAX_CHARS).optional(),
     type: communityTypeSchema,
     coverImageUrl: z.string().url().optional(),
-    ownerUserId: z.string(),
+    /** Discriminator. `user` = topical / interest community; `official`
+     *  = area-based civic community owned by an area leader. Default at
+     *  read time when omitted by a pre-v3 backend is `user`. */
+    kind: communityKindSchema,
+    /** User communities only — the creator. Null for `kind: 'official'`
+     *  (those have no owner; admin is computed from the area-leader
+     *  binding). */
+    ownerUserId: z.string().nullable(),
+    /** Audit-only userId of whoever created the community. Carries no
+     *  permission on its own — present on both kinds so the wire shape
+     *  stays uniform. For `kind: 'user'` this equals `ownerUserId`. */
+    createdBy: z.string().nullable(),
     /** Active members only. Pending join-requests don't count. */
     memberCount: z.number().int().nonnegative(),
     /** Denormalised post count. Increments on create, decrements on
@@ -468,13 +555,28 @@ export const communityWireSchema = z.object({
      *  the `?nearMe=true` 5 km geospatial filter on discovery. */
     centerCoords: communityCenterCoordsSchema.nullable(),
     /** ISO timestamp set by a state+ leader when verifying the
-     *  community. Null until verified; clearing reverts to null. */
+     *  community. Null until verified; clearing reverts to null. For
+     *  `kind: 'official'` this is auto-set at create time (the leader's
+     *  act of creating it IS the verification). */
     verifiedAt: z.string().datetime().nullable(),
-    /** UserId of the leader who verified. */
+    /** UserId of the leader who verified. For `kind: 'official'` this
+     *  is the leader who created it (same as `createdBy`). */
     verifiedBy: z.string().nullable(),
     /** Which leader tier vouched — drives the badge tooltip ("verified
-     *  by a state leader" vs "by a national leader"). */
+     *  by a state leader" vs "by a national leader"). For
+     *  `kind: 'official'` this is null because the "official" badge
+     *  itself communicates authority. */
     verifiedScope: communityVerifiedScopeSchema.nullable(),
+    // ─── Official community fields ──────────────────────────────────────
+    /** Administrative level of the area this official community is
+     *  bound to. Null for `kind: 'user'`. */
+    officialAreaKind: officialCommunityAreaKindSchema.nullable(),
+    /** ObjectId of the specific Area entity this official community
+     *  represents. Null for `kind: 'user'`. Combined with
+     *  `officialAreaKind`, the pair `(officialAreaKind, officialAreaId)`
+     *  is unique among non-deleted official communities — one official
+     *  community per area, ever. */
+    officialAreaId: z.string().nullable(),
     viewer: z
         .object({
         role: communityRoleSchema.nullable(),
@@ -703,4 +805,93 @@ export const areaPickerItemSchema = z.object({
 export const areaPickerResponseSchema = z.object({
     items: z.array(areaPickerItemSchema),
 });
+// ─── Official community — create + manage ──────────────────────────────────
+/**
+ * `POST /communities/official` body. Single-step flow.
+ *
+ * The area-leader binding gates the call: the caller's elevated
+ * `serviceRoles['reform']` must include `leader` AND their
+ * `jurisdictionLevel + jurisdictionAreaId` must exactly equal the
+ * `areaKind + areaId` supplied here. Backend resolves the rest:
+ *
+ *  • `name` and `slug` are derived server-side from the area name +
+ *    kind (e.g. "Pataudi Block Community" / `pataudi-block`). The
+ *    caller may override `description` and pick a cover image.
+ *  • `kind` is fixed to `'official'`; no need to send it.
+ *  • `reach`, `category`, `tags`, `mature`, `areaLineage`,
+ *    `centerCoords` are derived from the picked area.
+ *  • `verifiedAt`, `verifiedBy` are auto-set at create time (the
+ *    leader's act of creating it IS the verification).
+ *
+ * Re-creating after an area-level community has been soft-deleted by
+ * superadmin is allowed because the partial unique index excludes
+ * soft-deleted rows.
+ */
+export const createOfficialCommunityBodySchema = z.object({
+    /** Administrative level of the picked area. Must equal the caller's
+     *  jurisdictionLevel. */
+    areaKind: officialCommunityAreaKindSchema,
+    /** ObjectId of the picked Area entity. Must equal the caller's
+     *  jurisdictionAreaId. */
+    areaId: z.string(),
+    /** Optional one-line description shown on the community card. */
+    description: z.string().max(COMMUNITY_DESCRIPTION_MAX_CHARS).optional(),
+    /** Optional cover image. */
+    coverImageUrl: z.string().url().optional(),
+});
+/**
+ * Body for `POST /communities/:slug/moderators` — assign a moderator.
+ * The target user must already be an active member of the community.
+ *
+ * Caller authority:
+ *   - `kind: 'official'` admin (the current area leader, or the
+ *     platform superadmin when no leader is appointed) can add or
+ *     remove a moderator. The representative cannot (representative
+ *     can override moderator decisions but does not manage the
+ *     moderator roster).
+ *
+ * To remove a moderator use `DELETE /communities/:slug/moderators/:userId`.
+ */
+export const addOfficialModeratorBodySchema = z.object({
+    userId: z.string(),
+});
+/**
+ * Body for `PUT /communities/:slug/representative` — set or replace
+ * the community's named elected representative (Pradhan / Mayor / ...).
+ *
+ * The representative slot is single-valued: writing a new user ID
+ * replaces whoever held it before (matching the "new election → new
+ * person" lifecycle). Use `DELETE /communities/:slug/representative`
+ * to clear the slot between elections.
+ *
+ * The target user must already be an active member of the community;
+ * the backend will auto-add them as a member if they're not.
+ *
+ * Caller authority: `kind: 'official'` admin only.
+ */
+export const setOfficialRepresentativeBodySchema = z.object({
+    userId: z.string(),
+});
+// ─── Post moderation (hide / unhide for moderator + representative) ────────
+/**
+ * Body for `POST /communities/:slug/posts/:postId/hide`.
+ *
+ * Hides a post from the community feed for everyone except the author
+ * (who still sees their own post, marked as "hidden by moderator").
+ *
+ * Caller authority on `kind: 'official'`:
+ *   - moderator    — can hide a post that has at least one open report.
+ *   - representative — can hide or unhide ANY post (including overriding
+ *                      a moderator's hide). The override is what makes
+ *                      the representative's "settings" page useful.
+ *   - admin         — same authority as representative.
+ *
+ * On `kind: 'user'` the existing soft-delete by owner / admin path
+ * continues to apply; this endpoint is `official`-only.
+ */
+export const hidePostBodySchema = z.object({
+    /** Optional moderator note (visible only to other moderators + the
+     *  representative + admin on the moderation log). Capped at 500. */
+    reason: z.string().max(500).optional(),
+});
 //# sourceMappingURL=community.js.map