jansathi-community-schema 0.1.0

package/dist/enums.d.ts

@@ -0,0 +1,149 @@
+/**
+ * Enum value arrays shared across the community feature.
+ *
+ * Each enum is exported as both a `*_VALUES` tuple and the corresponding
+ * Zod schema so backend Mongoose models and frontend forms validate
+ * against the exact same set.
+ *
+ * @module community-schema/enums
+ */
+import { z } from 'zod';
+/**
+ * The geographic level at which a piece of content is posted.
+ *
+ * Cascade-upward semantics: a viewer whose feed filter is set to L
+ * sees every post at L and every BROADER level that matches their
+ * area lineage. So:
+ *   - `local`    → matches local + district + state + national + global within the viewer's locality / village / urbanBody / etc.
+ *   - `district` → matches district + state + national + global within the viewer's district
+ *   - `state`    → matches state + national + global within the viewer's state
+ *   - `national` → matches national + global within the viewer's country
+ *   - `global`   → matches global only
+ *
+ * The full meaning of "local" is "anything below district" — i.e., the
+ * deepest area-lineage match (locality, village, urbanWard, …).
+ */
+export declare const VISIBILITY_LEVEL_VALUES: readonly ["local", "district", "state", "national", "global"];
+export declare const visibilityLevelSchema: z.ZodEnum<{
+    local: "local";
+    district: "district";
+    state: "state";
+    national: "national";
+    global: "global";
+}>;
+export type VisibilityLevel = z.infer<typeof visibilityLevelSchema>;
+/**
+ * Numeric ranking used for the cascade-upward query and for sorting
+ * filter chips. `local` is the deepest (most specific), `global` the
+ * shallowest. Higher rank = broader scope.
+ */
+export declare const VISIBILITY_LEVEL_RANK: Record<VisibilityLevel, number>;
+/**
+ * The kinds of items that show up in the feed. `post` is the new
+ * community-native kind; `lost_found` and `voice_box` are existing
+ * features surfaced into the feed via polymorphic union.
+ *
+ * Engagement (upvote / reaction / comment) is keyed by
+ * (contentKind, contentId) so every kind gets the same engagement bar.
+ */
+export declare const CONTENT_KIND_VALUES: readonly ["post", "lost_found", "voice_box"];
+export declare const contentKindSchema: z.ZodEnum<{
+    post: "post";
+    lost_found: "lost_found";
+    voice_box: "voice_box";
+}>;
+export type ContentKind = z.infer<typeof contentKindSchema>;
+/**
+ * Reaction types available on every feed item.
+ *
+ * `support` replaces Facebook's "Care" — better-suited to a civic /
+ * hyperlocal context where reacting to a complaint or lost-and-found
+ * post deserves a distinct "I support you" signal.
+ */
+export declare const REACTION_TYPE_VALUES: readonly ["like", "love", "haha", "wow", "sad", "angry", "support"];
+export declare const reactionTypeSchema: z.ZodEnum<{
+    like: "like";
+    love: "love";
+    haha: "haha";
+    wow: "wow";
+    sad: "sad";
+    angry: "angry";
+    support: "support";
+}>;
+export type ReactionType = z.infer<typeof reactionTypeSchema>;
+/**
+ * Connection (mutual friend) lifecycle.
+ *
+ * `pending` — requester sent it, recipient hasn't acted yet.
+ * `accepted` — both sides confirmed; full visibility regardless of level.
+ * `declined` — recipient rejected; surfaces as "you can't reconnect for X days" on the requester side.
+ * `blocked` — either side blocked; permanently prevents reconnection.
+ */
+export declare const CONNECTION_STATUS_VALUES: readonly ["pending", "accepted", "declined", "blocked"];
+export declare const connectionStatusSchema: z.ZodEnum<{
+    pending: "pending";
+    accepted: "accepted";
+    declined: "declined";
+    blocked: "blocked";
+}>;
+export type ConnectionStatus = z.infer<typeof connectionStatusSchema>;
+/**
+ * Profile-level privacy (single toggle in Settings).
+ *
+ * `public` — anyone in the matching geo scope sees this user's posts.
+ * `private` — only accepted Connections see this user's posts. Visibility
+ *             level on each post still applies on top (a private post at
+ *             state level is visible only to Connections who are in the
+ *             same state).
+ */
+export declare const PROFILE_PRIVACY_VALUES: readonly ["public", "private"];
+export declare const profilePrivacySchema: z.ZodEnum<{
+    public: "public";
+    private: "private";
+}>;
+export type ProfilePrivacy = z.infer<typeof profilePrivacySchema>;
+/**
+ * Reasons a piece of content can be reported. The list is deliberately
+ * short — finer categorization can come from the optional `details`
+ * free-text field on a report.
+ */
+export declare const REPORT_REASON_VALUES: readonly ["spam", "harassment", "hate_speech", "misinformation", "sexual_content", "violence", "self_harm", "illegal_content", "other"];
+export declare const reportReasonSchema: z.ZodEnum<{
+    spam: "spam";
+    harassment: "harassment";
+    hate_speech: "hate_speech";
+    misinformation: "misinformation";
+    sexual_content: "sexual_content";
+    violence: "violence";
+    self_harm: "self_harm";
+    illegal_content: "illegal_content";
+    other: "other";
+}>;
+export type ReportReason = z.infer<typeof reportReasonSchema>;
+/** Moderator decision states on a report. */
+export declare const REPORT_STATUS_VALUES: readonly ["pending", "reviewing", "actioned", "dismissed"];
+export declare const reportStatusSchema: z.ZodEnum<{
+    pending: "pending";
+    reviewing: "reviewing";
+    actioned: "actioned";
+    dismissed: "dismissed";
+}>;
+export type ReportStatus = z.infer<typeof reportStatusSchema>;
+/**
+ * Sort options exposed in the feed UI.
+ *
+ * `hot` — the default. Reddit-style score blending upvotes, comment count,
+ *         and recency. Best surface for civic / community engagement.
+ * `new` — strict reverse-chronological. Useful when the viewer wants to
+ *         catch up on everything fresh.
+ * `top` — highest upvote count over a configurable window (defaults to
+ *         24 hours on the client).
+ */
+export declare const FEED_SORT_VALUES: readonly ["hot", "new", "top"];
+export declare const feedSortSchema: z.ZodEnum<{
+    hot: "hot";
+    new: "new";
+    top: "top";
+}>;
+export type FeedSort = z.infer<typeof feedSortSchema>;
+//# sourceMappingURL=enums.d.ts.map

package/dist/enums.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enums.d.ts","sourceRoot":"","sources":["../src/enums.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,uBAAuB,+DAM1B,CAAC;AACX,eAAO,MAAM,qBAAqB;;;;;;EAAkC,CAAC;AACrE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,eAAe,EAAE,MAAM,CAMjE,CAAC;AAIF;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,8CAA+C,CAAC;AAChF,eAAO,MAAM,iBAAiB;;;;EAA8B,CAAC;AAC7D,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAI5D;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,qEAQvB,CAAC;AACX,eAAO,MAAM,kBAAkB;;;;;;;;EAA+B,CAAC;AAC/D,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAI9D;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB,yDAK3B,CAAC;AACX,eAAO,MAAM,sBAAsB;;;;;EAAmC,CAAC;AACvE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAItE;;;;;;;;GAQG;AACH,eAAO,MAAM,sBAAsB,gCAAiC,CAAC;AACrE,eAAO,MAAM,oBAAoB;;;EAAiC,CAAC;AACnE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAIlE;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,yIAUvB,CAAC;AACX,eAAO,MAAM,kBAAkB;;;;;;;;;;EAA+B,CAAC;AAC/D,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,6CAA6C;AAC7C,eAAO,MAAM,oBAAoB,4DAKvB,CAAC;AACX,eAAO,MAAM,kBAAkB;;;;;EAA+B,CAAC;AAC/D,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAI9D;;;;;;;;;GASG;AACH,eAAO,MAAM,gBAAgB,gCAAiC,CAAC;AAC/D,eAAO,MAAM,cAAc;;;;EAA2B,CAAC;AACvD,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC"}

package/dist/enums.js

@@ -0,0 +1,143 @@
+/**
+ * Enum value arrays shared across the community feature.
+ *
+ * Each enum is exported as both a `*_VALUES` tuple and the corresponding
+ * Zod schema so backend Mongoose models and frontend forms validate
+ * against the exact same set.
+ *
+ * @module community-schema/enums
+ */
+import { z } from 'zod';
+// ─── Visibility scope ───────────────────────────────────────────────────────
+/**
+ * The geographic level at which a piece of content is posted.
+ *
+ * Cascade-upward semantics: a viewer whose feed filter is set to L
+ * sees every post at L and every BROADER level that matches their
+ * area lineage. So:
+ *   - `local`    → matches local + district + state + national + global within the viewer's locality / village / urbanBody / etc.
+ *   - `district` → matches district + state + national + global within the viewer's district
+ *   - `state`    → matches state + national + global within the viewer's state
+ *   - `national` → matches national + global within the viewer's country
+ *   - `global`   → matches global only
+ *
+ * The full meaning of "local" is "anything below district" — i.e., the
+ * deepest area-lineage match (locality, village, urbanWard, …).
+ */
+export const VISIBILITY_LEVEL_VALUES = [
+    'local',
+    'district',
+    'state',
+    'national',
+    'global',
+];
+export const visibilityLevelSchema = z.enum(VISIBILITY_LEVEL_VALUES);
+/**
+ * Numeric ranking used for the cascade-upward query and for sorting
+ * filter chips. `local` is the deepest (most specific), `global` the
+ * shallowest. Higher rank = broader scope.
+ */
+export const VISIBILITY_LEVEL_RANK = {
+    local: 0,
+    district: 1,
+    state: 2,
+    national: 3,
+    global: 4,
+};
+// ─── Polymorphic content kind ───────────────────────────────────────────────
+/**
+ * The kinds of items that show up in the feed. `post` is the new
+ * community-native kind; `lost_found` and `voice_box` are existing
+ * features surfaced into the feed via polymorphic union.
+ *
+ * Engagement (upvote / reaction / comment) is keyed by
+ * (contentKind, contentId) so every kind gets the same engagement bar.
+ */
+export const CONTENT_KIND_VALUES = ['post', 'lost_found', 'voice_box'];
+export const contentKindSchema = z.enum(CONTENT_KIND_VALUES);
+// ─── Reactions ──────────────────────────────────────────────────────────────
+/**
+ * Reaction types available on every feed item.
+ *
+ * `support` replaces Facebook's "Care" — better-suited to a civic /
+ * hyperlocal context where reacting to a complaint or lost-and-found
+ * post deserves a distinct "I support you" signal.
+ */
+export const REACTION_TYPE_VALUES = [
+    'like',
+    'love',
+    'haha',
+    'wow',
+    'sad',
+    'angry',
+    'support',
+];
+export const reactionTypeSchema = z.enum(REACTION_TYPE_VALUES);
+// ─── Social graph ──────────────────────────────────────────────────────────
+/**
+ * Connection (mutual friend) lifecycle.
+ *
+ * `pending` — requester sent it, recipient hasn't acted yet.
+ * `accepted` — both sides confirmed; full visibility regardless of level.
+ * `declined` — recipient rejected; surfaces as "you can't reconnect for X days" on the requester side.
+ * `blocked` — either side blocked; permanently prevents reconnection.
+ */
+export const CONNECTION_STATUS_VALUES = [
+    'pending',
+    'accepted',
+    'declined',
+    'blocked',
+];
+export const connectionStatusSchema = z.enum(CONNECTION_STATUS_VALUES);
+// ─── Profile privacy ───────────────────────────────────────────────────────
+/**
+ * Profile-level privacy (single toggle in Settings).
+ *
+ * `public` — anyone in the matching geo scope sees this user's posts.
+ * `private` — only accepted Connections see this user's posts. Visibility
+ *             level on each post still applies on top (a private post at
+ *             state level is visible only to Connections who are in the
+ *             same state).
+ */
+export const PROFILE_PRIVACY_VALUES = ['public', 'private'];
+export const profilePrivacySchema = z.enum(PROFILE_PRIVACY_VALUES);
+// ─── Moderation ────────────────────────────────────────────────────────────
+/**
+ * Reasons a piece of content can be reported. The list is deliberately
+ * short — finer categorization can come from the optional `details`
+ * free-text field on a report.
+ */
+export const REPORT_REASON_VALUES = [
+    'spam',
+    'harassment',
+    'hate_speech',
+    'misinformation',
+    'sexual_content',
+    'violence',
+    'self_harm',
+    'illegal_content',
+    'other',
+];
+export const reportReasonSchema = z.enum(REPORT_REASON_VALUES);
+/** Moderator decision states on a report. */
+export const REPORT_STATUS_VALUES = [
+    'pending',
+    'reviewing',
+    'actioned',
+    'dismissed',
+];
+export const reportStatusSchema = z.enum(REPORT_STATUS_VALUES);
+// ─── Feed sort ─────────────────────────────────────────────────────────────
+/**
+ * Sort options exposed in the feed UI.
+ *
+ * `hot` — the default. Reddit-style score blending upvotes, comment count,
+ *         and recency. Best surface for civic / community engagement.
+ * `new` — strict reverse-chronological. Useful when the viewer wants to
+ *         catch up on everything fresh.
+ * `top` — highest upvote count over a configurable window (defaults to
+ *         24 hours on the client).
+ */
+export const FEED_SORT_VALUES = ['hot', 'new', 'top'];
+export const feedSortSchema = z.enum(FEED_SORT_VALUES);
+//# sourceMappingURL=enums.js.map

package/dist/enums.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enums.js","sourceRoot":"","sources":["../src/enums.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,+EAA+E;AAE/E;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,OAAO;IACP,UAAU;IACV,OAAO;IACP,UAAU;IACV,QAAQ;CACA,CAAC;AACX,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;AAGrE;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAoC;IACpE,KAAK,EAAE,CAAC;IACR,QAAQ,EAAE,CAAC;IACX,KAAK,EAAE,CAAC;IACR,QAAQ,EAAE,CAAC;IACX,MAAM,EAAE,CAAC;CACV,CAAC;AAEF,+EAA+E;AAE/E;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,MAAM,EAAE,YAAY,EAAE,WAAW,CAAU,CAAC;AAChF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;AAG7D,+EAA+E;AAE/E;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,MAAM;IACN,MAAM;IACN,MAAM;IACN,KAAK;IACL,KAAK;IACL,OAAO;IACP,SAAS;CACD,CAAC;AACX,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;AAG/D,8EAA8E;AAE9E;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,SAAS;IACT,UAAU;IACV,UAAU;IACV,SAAS;CACD,CAAC;AACX,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;AAGvE,8EAA8E;AAE9E;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,QAAQ,EAAE,SAAS,CAAU,CAAC;AACrE,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;AAGnE,8EAA8E;AAE9E;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,MAAM;IACN,YAAY;IACZ,aAAa;IACb,gBAAgB;IAChB,gBAAgB;IAChB,UAAU;IACV,WAAW;IACX,iBAAiB;IACjB,OAAO;CACC,CAAC;AACX,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;AAG/D,6CAA6C;AAC7C,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,SAAS;IACT,WAAW;IACX,UAAU;IACV,WAAW;CACH,CAAC;AACX,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;AAG/D,8EAA8E;AAE9E;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAU,CAAC;AAC/D,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC","sourcesContent":["/**\n * Enum value arrays shared across the community feature.\n *\n * Each enum is exported as both a `*_VALUES` tuple and the corresponding\n * Zod schema so backend Mongoose models and frontend forms validate\n * against the exact same set.\n *\n * @module community-schema/enums\n */\n\nimport { z } from 'zod';\n\n// ─── Visibility scope ───────────────────────────────────────────────────────\n\n/**\n * The geographic level at which a piece of content is posted.\n *\n * Cascade-upward semantics: a viewer whose feed filter is set to L\n * sees every post at L and every BROADER level that matches their\n * area lineage. So:\n *   - `local`    → matches local + district + state + national + global within the viewer's locality / village / urbanBody / etc.\n *   - `district` → matches district + state + national + global within the viewer's district\n *   - `state`    → matches state + national + global within the viewer's state\n *   - `national` → matches national + global within the viewer's country\n *   - `global`   → matches global only\n *\n * The full meaning of \"local\" is \"anything below district\" — i.e., the\n * deepest area-lineage match (locality, village, urbanWard, …).\n */\nexport const VISIBILITY_LEVEL_VALUES = [\n  'local',\n  'district',\n  'state',\n  'national',\n  'global',\n] as const;\nexport const visibilityLevelSchema = z.enum(VISIBILITY_LEVEL_VALUES);\nexport type VisibilityLevel = z.infer<typeof visibilityLevelSchema>;\n\n/**\n * Numeric ranking used for the cascade-upward query and for sorting\n * filter chips. `local` is the deepest (most specific), `global` the\n * shallowest. Higher rank = broader scope.\n */\nexport const VISIBILITY_LEVEL_RANK: Record<VisibilityLevel, number> = {\n  local: 0,\n  district: 1,\n  state: 2,\n  national: 3,\n  global: 4,\n};\n\n// ─── Polymorphic content kind ───────────────────────────────────────────────\n\n/**\n * The kinds of items that show up in the feed. `post` is the new\n * community-native kind; `lost_found` and `voice_box` are existing\n * features surfaced into the feed via polymorphic union.\n *\n * Engagement (upvote / reaction / comment) is keyed by\n * (contentKind, contentId) so every kind gets the same engagement bar.\n */\nexport const CONTENT_KIND_VALUES = ['post', 'lost_found', 'voice_box'] as const;\nexport const contentKindSchema = z.enum(CONTENT_KIND_VALUES);\nexport type ContentKind = z.infer<typeof contentKindSchema>;\n\n// ─── Reactions ──────────────────────────────────────────────────────────────\n\n/**\n * Reaction types available on every feed item.\n *\n * `support` replaces Facebook's \"Care\" — better-suited to a civic /\n * hyperlocal context where reacting to a complaint or lost-and-found\n * post deserves a distinct \"I support you\" signal.\n */\nexport const REACTION_TYPE_VALUES = [\n  'like',\n  'love',\n  'haha',\n  'wow',\n  'sad',\n  'angry',\n  'support',\n] as const;\nexport const reactionTypeSchema = z.enum(REACTION_TYPE_VALUES);\nexport type ReactionType = z.infer<typeof reactionTypeSchema>;\n\n// ─── Social graph ──────────────────────────────────────────────────────────\n\n/**\n * Connection (mutual friend) lifecycle.\n *\n * `pending` — requester sent it, recipient hasn't acted yet.\n * `accepted` — both sides confirmed; full visibility regardless of level.\n * `declined` — recipient rejected; surfaces as \"you can't reconnect for X days\" on the requester side.\n * `blocked` — either side blocked; permanently prevents reconnection.\n */\nexport const CONNECTION_STATUS_VALUES = [\n  'pending',\n  'accepted',\n  'declined',\n  'blocked',\n] as const;\nexport const connectionStatusSchema = z.enum(CONNECTION_STATUS_VALUES);\nexport type ConnectionStatus = z.infer<typeof connectionStatusSchema>;\n\n// ─── Profile privacy ───────────────────────────────────────────────────────\n\n/**\n * Profile-level privacy (single toggle in Settings).\n *\n * `public` — anyone in the matching geo scope sees this user's posts.\n * `private` — only accepted Connections see this user's posts. Visibility\n *             level on each post still applies on top (a private post at\n *             state level is visible only to Connections who are in the\n *             same state).\n */\nexport const PROFILE_PRIVACY_VALUES = ['public', 'private'] as const;\nexport const profilePrivacySchema = z.enum(PROFILE_PRIVACY_VALUES);\nexport type ProfilePrivacy = z.infer<typeof profilePrivacySchema>;\n\n// ─── Moderation ────────────────────────────────────────────────────────────\n\n/**\n * Reasons a piece of content can be reported. The list is deliberately\n * short — finer categorization can come from the optional `details`\n * free-text field on a report.\n */\nexport const REPORT_REASON_VALUES = [\n  'spam',\n  'harassment',\n  'hate_speech',\n  'misinformation',\n  'sexual_content',\n  'violence',\n  'self_harm',\n  'illegal_content',\n  'other',\n] as const;\nexport const reportReasonSchema = z.enum(REPORT_REASON_VALUES);\nexport type ReportReason = z.infer<typeof reportReasonSchema>;\n\n/** Moderator decision states on a report. */\nexport const REPORT_STATUS_VALUES = [\n  'pending',\n  'reviewing',\n  'actioned',\n  'dismissed',\n] as const;\nexport const reportStatusSchema = z.enum(REPORT_STATUS_VALUES);\nexport type ReportStatus = z.infer<typeof reportStatusSchema>;\n\n// ─── Feed sort ─────────────────────────────────────────────────────────────\n\n/**\n * Sort options exposed in the feed UI.\n *\n * `hot` — the default. Reddit-style score blending upvotes, comment count,\n *         and recency. Best surface for civic / community engagement.\n * `new` — strict reverse-chronological. Useful when the viewer wants to\n *         catch up on everything fresh.\n * `top` — highest upvote count over a configurable window (defaults to\n *         24 hours on the client).\n */\nexport const FEED_SORT_VALUES = ['hot', 'new', 'top'] as const;\nexport const feedSortSchema = z.enum(FEED_SORT_VALUES);\nexport type FeedSort = z.infer<typeof feedSortSchema>;\n"]}

package/dist/feed.d.ts

@@ -0,0 +1,311 @@
+/**
+ * Feed wire shapes — polymorphic union of community posts, lost-and-
+ * found reports, and voice-box (complaints + suggestions).
+ *
+ * The feed is a SINGLE list typed as `FeedItem = Post | LostFound | VoiceBox`.
+ * The client discriminates on `contentKind` and renders the matching
+ * card component.
+ *
+ * Strategy notes (server-side):
+ *   - Read-time fanout. The server runs ONE parallel query per kind
+ *     filtered by the same area-lineage match and the same cascade-
+ *     upward visibility rule, then merges and sorts by `hot` score.
+ *   - Cursor-based pagination. The cursor is opaque (base64 of
+ *     `<sortKey>|<_id>`) so we can swap sort algorithms without a
+ *     breaking change.
+ *   - LostFound / VoiceBox shapes are pruned to the fields the feed
+ *     card needs — they keep their richer detail-page shape in their
+ *     own schemas (lost-found-schema, voice-box-schema if/when those
+ *     get factored out).
+ *
+ * @module community-schema/feed
+ */
+import { z } from 'zod';
+import { FEED_PAGE_SIZE } from './constants.js';
+/**
+ * Lost-and-found item projected into the feed. Mirrors the engagement
+ * + author shape every feed card needs, plus a small handful of
+ * lost-found-specific fields used by the card.
+ */
+export declare const lostFoundFeedItemSchema: z.ZodObject<{
+    _id: z.ZodString;
+    contentKind: z.ZodLiteral<"lost_found">;
+    author: z.ZodObject<{
+        userId: z.ZodString;
+        displayName: z.ZodString;
+        avatarUrl: z.ZodOptional<z.ZodString>;
+        localName: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    kind: z.ZodEnum<{
+        lost: "lost";
+        found: "found";
+    }>;
+    title: z.ZodString;
+    description: z.ZodString;
+    imageUrl: z.ZodOptional<z.ZodString>;
+    upvoteCount: z.ZodNumber;
+    commentCount: z.ZodNumber;
+    reactionCounts: z.ZodRecord<z.ZodString, z.ZodNumber>;
+    createdAt: z.ZodString;
+    viewer: z.ZodOptional<z.ZodObject<{
+        upvoted: z.ZodBoolean;
+        reaction: z.ZodNullable<z.ZodString>;
+        isAuthor: z.ZodBoolean;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type LostFoundFeedItem = z.infer<typeof lostFoundFeedItemSchema>;
+/**
+ * Voice-box (complaint or suggestion) item projected into the feed.
+ */
+export declare const voiceBoxFeedItemSchema: z.ZodObject<{
+    _id: z.ZodString;
+    contentKind: z.ZodLiteral<"voice_box">;
+    author: z.ZodObject<{
+        userId: z.ZodString;
+        displayName: z.ZodString;
+        avatarUrl: z.ZodOptional<z.ZodString>;
+        localName: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    kind: z.ZodEnum<{
+        complaint: "complaint";
+        suggestion: "suggestion";
+    }>;
+    title: z.ZodString;
+    description: z.ZodString;
+    upvoteCount: z.ZodNumber;
+    commentCount: z.ZodNumber;
+    reactionCounts: z.ZodRecord<z.ZodString, z.ZodNumber>;
+    createdAt: z.ZodString;
+    viewer: z.ZodOptional<z.ZodObject<{
+        upvoted: z.ZodBoolean;
+        reaction: z.ZodNullable<z.ZodString>;
+        isAuthor: z.ZodBoolean;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type VoiceBoxFeedItem = z.infer<typeof voiceBoxFeedItemSchema>;
+export declare const feedItemSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    _id: z.ZodString;
+    contentKind: z.ZodLiteral<"post">;
+    author: z.ZodObject<{
+        userId: z.ZodString;
+        displayName: z.ZodString;
+        avatarUrl: z.ZodOptional<z.ZodString>;
+        localName: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    text: z.ZodString;
+    images: z.ZodArray<z.ZodObject<{
+        url: z.ZodString;
+        thumbnailUrl: z.ZodOptional<z.ZodString>;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+        bytes: z.ZodNumber;
+        alt: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    videos: z.ZodArray<z.ZodObject<{
+        url: z.ZodString;
+        thumbnailUrl: z.ZodString;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+        bytes: z.ZodNumber;
+        duration: z.ZodNumber;
+    }, z.core.$strip>>;
+    visibilityLevel: z.ZodEnum<{
+        local: "local";
+        district: "district";
+        state: "state";
+        national: "national";
+        global: "global";
+    }>;
+    areaLineage: z.ZodObject<{
+        countryId: z.ZodOptional<z.ZodString>;
+        stateId: z.ZodOptional<z.ZodString>;
+        districtId: z.ZodOptional<z.ZodString>;
+        localId: z.ZodOptional<z.ZodString>;
+        localName: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    upvoteCount: z.ZodNumber;
+    commentCount: z.ZodNumber;
+    reactionCounts: z.ZodRecord<z.ZodString, z.ZodNumber>;
+    createdAt: z.ZodString;
+    editedAt: z.ZodNullable<z.ZodString>;
+    deletedAt: z.ZodNullable<z.ZodString>;
+    viewer: z.ZodOptional<z.ZodObject<{
+        upvoted: z.ZodBoolean;
+        reaction: z.ZodNullable<z.ZodString>;
+        isAuthor: z.ZodBoolean;
+    }, z.core.$strip>>;
+}, z.core.$strip>, z.ZodObject<{
+    _id: z.ZodString;
+    contentKind: z.ZodLiteral<"lost_found">;
+    author: z.ZodObject<{
+        userId: z.ZodString;
+        displayName: z.ZodString;
+        avatarUrl: z.ZodOptional<z.ZodString>;
+        localName: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    kind: z.ZodEnum<{
+        lost: "lost";
+        found: "found";
+    }>;
+    title: z.ZodString;
+    description: z.ZodString;
+    imageUrl: z.ZodOptional<z.ZodString>;
+    upvoteCount: z.ZodNumber;
+    commentCount: z.ZodNumber;
+    reactionCounts: z.ZodRecord<z.ZodString, z.ZodNumber>;
+    createdAt: z.ZodString;
+    viewer: z.ZodOptional<z.ZodObject<{
+        upvoted: z.ZodBoolean;
+        reaction: z.ZodNullable<z.ZodString>;
+        isAuthor: z.ZodBoolean;
+    }, z.core.$strip>>;
+}, z.core.$strip>, z.ZodObject<{
+    _id: z.ZodString;
+    contentKind: z.ZodLiteral<"voice_box">;
+    author: z.ZodObject<{
+        userId: z.ZodString;
+        displayName: z.ZodString;
+        avatarUrl: z.ZodOptional<z.ZodString>;
+        localName: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    kind: z.ZodEnum<{
+        complaint: "complaint";
+        suggestion: "suggestion";
+    }>;
+    title: z.ZodString;
+    description: z.ZodString;
+    upvoteCount: z.ZodNumber;
+    commentCount: z.ZodNumber;
+    reactionCounts: z.ZodRecord<z.ZodString, z.ZodNumber>;
+    createdAt: z.ZodString;
+    viewer: z.ZodOptional<z.ZodObject<{
+        upvoted: z.ZodBoolean;
+        reaction: z.ZodNullable<z.ZodString>;
+        isAuthor: z.ZodBoolean;
+    }, z.core.$strip>>;
+}, z.core.$strip>], "contentKind">;
+export type FeedItem = z.infer<typeof feedItemSchema>;
+export declare const feedQueryParamsSchema: z.ZodObject<{
+    level: z.ZodEnum<{
+        local: "local";
+        district: "district";
+        state: "state";
+        national: "national";
+        global: "global";
+    }>;
+    sort: z.ZodOptional<z.ZodEnum<{
+        hot: "hot";
+        new: "new";
+        top: "top";
+    }>>;
+    cursor: z.ZodOptional<z.ZodString>;
+    pageSize: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type FeedQueryParams = z.infer<typeof feedQueryParamsSchema>;
+export declare const feedResponseSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        _id: z.ZodString;
+        contentKind: z.ZodLiteral<"post">;
+        author: z.ZodObject<{
+            userId: z.ZodString;
+            displayName: z.ZodString;
+            avatarUrl: z.ZodOptional<z.ZodString>;
+            localName: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        text: z.ZodString;
+        images: z.ZodArray<z.ZodObject<{
+            url: z.ZodString;
+            thumbnailUrl: z.ZodOptional<z.ZodString>;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+            bytes: z.ZodNumber;
+            alt: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        videos: z.ZodArray<z.ZodObject<{
+            url: z.ZodString;
+            thumbnailUrl: z.ZodString;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+            bytes: z.ZodNumber;
+            duration: z.ZodNumber;
+        }, z.core.$strip>>;
+        visibilityLevel: z.ZodEnum<{
+            local: "local";
+            district: "district";
+            state: "state";
+            national: "national";
+            global: "global";
+        }>;
+        areaLineage: z.ZodObject<{
+            countryId: z.ZodOptional<z.ZodString>;
+            stateId: z.ZodOptional<z.ZodString>;
+            districtId: z.ZodOptional<z.ZodString>;
+            localId: z.ZodOptional<z.ZodString>;
+            localName: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        upvoteCount: z.ZodNumber;
+        commentCount: z.ZodNumber;
+        reactionCounts: z.ZodRecord<z.ZodString, z.ZodNumber>;
+        createdAt: z.ZodString;
+        editedAt: z.ZodNullable<z.ZodString>;
+        deletedAt: z.ZodNullable<z.ZodString>;
+        viewer: z.ZodOptional<z.ZodObject<{
+            upvoted: z.ZodBoolean;
+            reaction: z.ZodNullable<z.ZodString>;
+            isAuthor: z.ZodBoolean;
+        }, z.core.$strip>>;
+    }, z.core.$strip>, z.ZodObject<{
+        _id: z.ZodString;
+        contentKind: z.ZodLiteral<"lost_found">;
+        author: z.ZodObject<{
+            userId: z.ZodString;
+            displayName: z.ZodString;
+            avatarUrl: z.ZodOptional<z.ZodString>;
+            localName: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        kind: z.ZodEnum<{
+            lost: "lost";
+            found: "found";
+        }>;
+        title: z.ZodString;
+        description: z.ZodString;
+        imageUrl: z.ZodOptional<z.ZodString>;
+        upvoteCount: z.ZodNumber;
+        commentCount: z.ZodNumber;
+        reactionCounts: z.ZodRecord<z.ZodString, z.ZodNumber>;
+        createdAt: z.ZodString;
+        viewer: z.ZodOptional<z.ZodObject<{
+            upvoted: z.ZodBoolean;
+            reaction: z.ZodNullable<z.ZodString>;
+            isAuthor: z.ZodBoolean;
+        }, z.core.$strip>>;
+    }, z.core.$strip>, z.ZodObject<{
+        _id: z.ZodString;
+        contentKind: z.ZodLiteral<"voice_box">;
+        author: z.ZodObject<{
+            userId: z.ZodString;
+            displayName: z.ZodString;
+            avatarUrl: z.ZodOptional<z.ZodString>;
+            localName: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        kind: z.ZodEnum<{
+            complaint: "complaint";
+            suggestion: "suggestion";
+        }>;
+        title: z.ZodString;
+        description: z.ZodString;
+        upvoteCount: z.ZodNumber;
+        commentCount: z.ZodNumber;
+        reactionCounts: z.ZodRecord<z.ZodString, z.ZodNumber>;
+        createdAt: z.ZodString;
+        viewer: z.ZodOptional<z.ZodObject<{
+            upvoted: z.ZodBoolean;
+            reaction: z.ZodNullable<z.ZodString>;
+            isAuthor: z.ZodBoolean;
+        }, z.core.$strip>>;
+    }, z.core.$strip>], "contentKind">>;
+    nextCursor: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type FeedResponse = z.infer<typeof feedResponseSchema>;
+export { FEED_PAGE_SIZE };
+//# sourceMappingURL=feed.d.ts.map

package/dist/feed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feed.d.ts","sourceRoot":"","sources":["../src/feed.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAMhD;;;;GAIG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;iBA0BlC,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;iBAuBjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAItE,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kCAIzB,CAAC;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAItD,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;iBAShC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAG7B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAG9D,OAAO,EAAE,cAAc,EAAE,CAAC"}