jansathi-community-schema 0.1.0

package/dist/feed.js

@@ -0,0 +1,102 @@
+/**
+ * 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';
+import { feedSortSchema, visibilityLevelSchema } from './enums.js';
+import { communityPostWireSchema, postAuthorSnapshotSchema } from './post.js';
+// ─── Per-kind feed envelopes ───────────────────────────────────────────────
+/**
+ * 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 const lostFoundFeedItemSchema = z.object({
+    _id: z.string(),
+    contentKind: z.literal('lost_found'),
+    author: postAuthorSnapshotSchema,
+    /** `'lost'` or `'found'` — drives the card chip colour. */
+    kind: z.enum(['lost', 'found']),
+    title: z.string(),
+    description: z.string(),
+    /** Single primary image rendered on the card. */
+    imageUrl: z.string().url().optional(),
+    /** Inherited engagement axis — same shape as posts. */
+    upvoteCount: z.number().int().nonnegative(),
+    commentCount: z.number().int().nonnegative(),
+    reactionCounts: z.record(z.string(), z.number().int().nonnegative()),
+    createdAt: z.string().datetime(),
+    viewer: z
+        .object({
+        upvoted: z.boolean(),
+        reaction: z.string().nullable(),
+        isAuthor: z.boolean(),
+    })
+        .optional(),
+});
+/**
+ * Voice-box (complaint or suggestion) item projected into the feed.
+ */
+export const voiceBoxFeedItemSchema = z.object({
+    _id: z.string(),
+    contentKind: z.literal('voice_box'),
+    author: postAuthorSnapshotSchema,
+    /** `'complaint'` or `'suggestion'` — drives the card chip colour. */
+    kind: z.enum(['complaint', 'suggestion']),
+    title: z.string(),
+    description: z.string(),
+    upvoteCount: z.number().int().nonnegative(),
+    commentCount: z.number().int().nonnegative(),
+    reactionCounts: z.record(z.string(), z.number().int().nonnegative()),
+    createdAt: z.string().datetime(),
+    viewer: z
+        .object({
+        upvoted: z.boolean(),
+        reaction: z.string().nullable(),
+        isAuthor: z.boolean(),
+    })
+        .optional(),
+});
+// ─── Polymorphic union ─────────────────────────────────────────────────────
+export const feedItemSchema = z.discriminatedUnion('contentKind', [
+    communityPostWireSchema,
+    lostFoundFeedItemSchema,
+    voiceBoxFeedItemSchema,
+]);
+// ─── Query + response ──────────────────────────────────────────────────────
+export const feedQueryParamsSchema = z.object({
+    /** The viewer's chosen feed level. Cascade-upward semantics apply. */
+    level: visibilityLevelSchema,
+    /** Sort algorithm. Defaults to `hot` server-side when omitted. */
+    sort: feedSortSchema.optional(),
+    /** Opaque pagination cursor returned by the previous page. */
+    cursor: z.string().optional(),
+    /** Page size; defaults to `FEED_PAGE_SIZE` server-side. */
+    pageSize: z.number().int().positive().max(50).optional(),
+});
+export const feedResponseSchema = z.object({
+    items: z.array(feedItemSchema),
+    nextCursor: z.string().nullable(),
+});
+// Re-export so consumers don't have to also import constants.ts.
+export { FEED_PAGE_SIZE };
+//# sourceMappingURL=feed.js.map

package/dist/feed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feed.js","sourceRoot":"","sources":["../src/feed.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Feed wire shapes — polymorphic union of community posts, lost-and-\n * found reports, and voice-box (complaints + suggestions).\n *\n * The feed is a SINGLE list typed as `FeedItem = Post | LostFound | VoiceBox`.\n * The client discriminates on `contentKind` and renders the matching\n * card component.\n *\n * Strategy notes (server-side):\n *   - Read-time fanout. The server runs ONE parallel query per kind\n *     filtered by the same area-lineage match and the same cascade-\n *     upward visibility rule, then merges and sorts by `hot` score.\n *   - Cursor-based pagination. The cursor is opaque (base64 of\n *     `<sortKey>|<_id>`) so we can swap sort algorithms without a\n *     breaking change.\n *   - LostFound / VoiceBox shapes are pruned to the fields the feed\n *     card needs — they keep their richer detail-page shape in their\n *     own schemas (lost-found-schema, voice-box-schema if/when those\n *     get factored out).\n *\n * @module community-schema/feed\n */\n\nimport { z } from 'zod';\nimport { FEED_PAGE_SIZE } from './constants.js';\nimport { feedSortSchema, visibilityLevelSchema } from './enums.js';\nimport { communityPostWireSchema, postAuthorSnapshotSchema } from './post.js';\n\n// ─── Per-kind feed envelopes ───────────────────────────────────────────────\n\n/**\n * Lost-and-found item projected into the feed. Mirrors the engagement\n * + author shape every feed card needs, plus a small handful of\n * lost-found-specific fields used by the card.\n */\nexport const lostFoundFeedItemSchema = z.object({\n  _id: z.string(),\n  contentKind: z.literal('lost_found'),\n  author: postAuthorSnapshotSchema,\n\n  /** `'lost'` or `'found'` — drives the card chip colour. */\n  kind: z.enum(['lost', 'found']),\n  title: z.string(),\n  description: z.string(),\n  /** Single primary image rendered on the card. */\n  imageUrl: z.string().url().optional(),\n\n  /** Inherited engagement axis — same shape as posts. */\n  upvoteCount: z.number().int().nonnegative(),\n  commentCount: z.number().int().nonnegative(),\n  reactionCounts: z.record(z.string(), z.number().int().nonnegative()),\n\n  createdAt: z.string().datetime(),\n\n  viewer: z\n    .object({\n      upvoted: z.boolean(),\n      reaction: z.string().nullable(),\n      isAuthor: z.boolean(),\n    })\n    .optional(),\n});\nexport type LostFoundFeedItem = z.infer<typeof lostFoundFeedItemSchema>;\n\n/**\n * Voice-box (complaint or suggestion) item projected into the feed.\n */\nexport const voiceBoxFeedItemSchema = z.object({\n  _id: z.string(),\n  contentKind: z.literal('voice_box'),\n  author: postAuthorSnapshotSchema,\n\n  /** `'complaint'` or `'suggestion'` — drives the card chip colour. */\n  kind: z.enum(['complaint', 'suggestion']),\n  title: z.string(),\n  description: z.string(),\n\n  upvoteCount: z.number().int().nonnegative(),\n  commentCount: z.number().int().nonnegative(),\n  reactionCounts: z.record(z.string(), z.number().int().nonnegative()),\n\n  createdAt: z.string().datetime(),\n\n  viewer: z\n    .object({\n      upvoted: z.boolean(),\n      reaction: z.string().nullable(),\n      isAuthor: z.boolean(),\n    })\n    .optional(),\n});\nexport type VoiceBoxFeedItem = z.infer<typeof voiceBoxFeedItemSchema>;\n\n// ─── Polymorphic union ─────────────────────────────────────────────────────\n\nexport const feedItemSchema = z.discriminatedUnion('contentKind', [\n  communityPostWireSchema,\n  lostFoundFeedItemSchema,\n  voiceBoxFeedItemSchema,\n]);\nexport type FeedItem = z.infer<typeof feedItemSchema>;\n\n// ─── Query + response ──────────────────────────────────────────────────────\n\nexport const feedQueryParamsSchema = z.object({\n  /** The viewer's chosen feed level. Cascade-upward semantics apply. */\n  level: visibilityLevelSchema,\n  /** Sort algorithm. Defaults to `hot` server-side when omitted. */\n  sort: feedSortSchema.optional(),\n  /** Opaque pagination cursor returned by the previous page. */\n  cursor: z.string().optional(),\n  /** Page size; defaults to `FEED_PAGE_SIZE` server-side. */\n  pageSize: z.number().int().positive().max(50).optional(),\n});\nexport type FeedQueryParams = z.infer<typeof feedQueryParamsSchema>;\n\nexport const feedResponseSchema = z.object({\n  items: z.array(feedItemSchema),\n  nextCursor: z.string().nullable(),\n});\nexport type FeedResponse = z.infer<typeof feedResponseSchema>;\n\n// Re-export so consumers don't have to also import constants.ts.\nexport { FEED_PAGE_SIZE };\n"]}

package/dist/group.d.ts

@@ -0,0 +1,48 @@
+/**
+ * User-created group chat wire shapes for the Community → Chat tab.
+ *
+ * The community-scoped group chats are wire-compatible with the
+ * generic `Conversation` shape on chat-server (so a community group
+ * shows up in the inbox like any other conversation). What lives here
+ * is the COMMUNITY-side metadata used to create + administer the group
+ * before chat-server takes over.
+ *
+ * @module community-schema/group
+ */
+import { z } from 'zod';
+export declare const groupRoleSchema: z.ZodEnum<{
+    owner: "owner";
+    admin: "admin";
+    member: "member";
+}>;
+export type GroupRole = z.infer<typeof groupRoleSchema>;
+export declare const communityGroupWireSchema: z.ZodObject<{
+    _id: z.ZodString;
+    conversationId: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    imageUrl: z.ZodOptional<z.ZodString>;
+    createdByUserId: z.ZodString;
+    memberCount: z.ZodNumber;
+    createdAt: z.ZodString;
+    viewer: z.ZodOptional<z.ZodObject<{
+        role: z.ZodEnum<{
+            owner: "owner";
+            admin: "admin";
+            member: "member";
+        }>;
+        joinedAt: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type CommunityGroupWire = z.infer<typeof communityGroupWireSchema>;
+export declare const createGroupBodySchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    memberUserIds: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type CreateGroupBody = z.infer<typeof createGroupBodySchema>;
+export declare const addGroupMembersBodySchema: z.ZodObject<{
+    userIds: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type AddGroupMembersBody = z.infer<typeof addGroupMembersBodySchema>;
+//# sourceMappingURL=group.d.ts.map

package/dist/group.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"group.d.ts","sourceRoot":"","sources":["../src/group.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,eAAO,MAAM,eAAe;;;;EAAuC,CAAC;AACpE,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;iBAmBnC,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAI1E,eAAO,MAAM,qBAAqB;;;;iBAKhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAIpE,eAAO,MAAM,yBAAyB;;iBAEpC,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC"}

package/dist/group.js

@@ -0,0 +1,45 @@
+/**
+ * User-created group chat wire shapes for the Community → Chat tab.
+ *
+ * The community-scoped group chats are wire-compatible with the
+ * generic `Conversation` shape on chat-server (so a community group
+ * shows up in the inbox like any other conversation). What lives here
+ * is the COMMUNITY-side metadata used to create + administer the group
+ * before chat-server takes over.
+ *
+ * @module community-schema/group
+ */
+import { z } from 'zod';
+import { GROUP_MAX_MEMBERS, GROUP_NAME_MAX_CHARS, GROUP_NAME_MIN_CHARS, } from './constants.js';
+export const groupRoleSchema = z.enum(['owner', 'admin', 'member']);
+export const communityGroupWireSchema = z.object({
+    _id: z.string(),
+    /** The chat-server conversation id this group is bound to. */
+    conversationId: z.string(),
+    name: z.string().min(GROUP_NAME_MIN_CHARS).max(GROUP_NAME_MAX_CHARS),
+    description: z.string().max(500).optional(),
+    /** Group avatar / cover image. */
+    imageUrl: z.string().url().optional(),
+    createdByUserId: z.string(),
+    memberCount: z.number().int().nonnegative(),
+    createdAt: z.string().datetime(),
+    /** Per-viewer state — included when the viewer is a member. */
+    viewer: z
+        .object({
+        role: groupRoleSchema,
+        joinedAt: z.string().datetime(),
+    })
+        .optional(),
+});
+// ─── Create body ────────────────────────────────────────────────────────────
+export const createGroupBodySchema = z.object({
+    name: z.string().min(GROUP_NAME_MIN_CHARS).max(GROUP_NAME_MAX_CHARS),
+    description: z.string().max(500).optional(),
+    /** Initial member user ids (excluding the creator who becomes owner). */
+    memberUserIds: z.array(z.string()).max(GROUP_MAX_MEMBERS - 1),
+});
+// ─── Add / remove members ──────────────────────────────────────────────────
+export const addGroupMembersBodySchema = z.object({
+    userIds: z.array(z.string()).min(1).max(50),
+});
+//# sourceMappingURL=group.js.map

package/dist/group.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"group.js","sourceRoot":"","sources":["../src/group.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AAExB,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;AAGpE,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,8DAA8D;IAC9D,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE;IAC1B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC,GAAG,CAAC,oBAAoB,CAAC;IACpE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IAC3C,kCAAkC;IAClC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACrC,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE;IAC3B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAC3C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAEhC,+DAA+D;IAC/D,MAAM,EAAE,CAAC;SACN,MAAM,CAAC;QACN,IAAI,EAAE,eAAe;QACrB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAChC,CAAC;SACD,QAAQ,EAAE;CACd,CAAC,CAAC;AAGH,+EAA+E;AAE/E,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC,GAAG,CAAC,oBAAoB,CAAC;IACpE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IAC3C,yEAAyE;IACzE,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,iBAAiB,GAAG,CAAC,CAAC;CAC9D,CAAC,CAAC;AAGH,8EAA8E;AAE9E,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;CAC5C,CAAC,CAAC","sourcesContent":["/**\n * User-created group chat wire shapes for the Community → Chat tab.\n *\n * The community-scoped group chats are wire-compatible with the\n * generic `Conversation` shape on chat-server (so a community group\n * shows up in the inbox like any other conversation). What lives here\n * is the COMMUNITY-side metadata used to create + administer the group\n * before chat-server takes over.\n *\n * @module community-schema/group\n */\n\nimport { z } from 'zod';\nimport {\n  GROUP_MAX_MEMBERS,\n  GROUP_NAME_MAX_CHARS,\n  GROUP_NAME_MIN_CHARS,\n} from './constants.js';\n\nexport const groupRoleSchema = z.enum(['owner', 'admin', 'member']);\nexport type GroupRole = z.infer<typeof groupRoleSchema>;\n\nexport const communityGroupWireSchema = z.object({\n  _id: z.string(),\n  /** The chat-server conversation id this group is bound to. */\n  conversationId: z.string(),\n  name: z.string().min(GROUP_NAME_MIN_CHARS).max(GROUP_NAME_MAX_CHARS),\n  description: z.string().max(500).optional(),\n  /** Group avatar / cover image. */\n  imageUrl: z.string().url().optional(),\n  createdByUserId: z.string(),\n  memberCount: z.number().int().nonnegative(),\n  createdAt: z.string().datetime(),\n\n  /** Per-viewer state — included when the viewer is a member. */\n  viewer: z\n    .object({\n      role: groupRoleSchema,\n      joinedAt: z.string().datetime(),\n    })\n    .optional(),\n});\nexport type CommunityGroupWire = z.infer<typeof communityGroupWireSchema>;\n\n// ─── Create body ────────────────────────────────────────────────────────────\n\nexport const createGroupBodySchema = z.object({\n  name: z.string().min(GROUP_NAME_MIN_CHARS).max(GROUP_NAME_MAX_CHARS),\n  description: z.string().max(500).optional(),\n  /** Initial member user ids (excluding the creator who becomes owner). */\n  memberUserIds: z.array(z.string()).max(GROUP_MAX_MEMBERS - 1),\n});\nexport type CreateGroupBody = z.infer<typeof createGroupBodySchema>;\n\n// ─── Add / remove members ──────────────────────────────────────────────────\n\nexport const addGroupMembersBodySchema = z.object({\n  userIds: z.array(z.string()).min(1).max(50),\n});\nexport type AddGroupMembersBody = z.infer<typeof addGroupMembersBodySchema>;\n"]}

package/dist/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * community-schema — Shared Zod schemas + TypeScript types for the
+ * Jansathi hyperlocal community feature (feed, posts, engagement,
+ * social graph, groups, settings).
+ *
+ * Single source of truth consumed by reform-backend and every product
+ * frontend. The schemas mirror MongoDB / Mongoose document shapes
+ * 1:1 so the same Zod validation runs at the controller boundary on
+ * the backend and in the form handlers on the client.
+ *
+ * Cascade-upward visibility semantics: a viewer whose feed level is L
+ * sees posts at L and every BROADER level matching their area lineage.
+ * See `./enums.ts#VISIBILITY_LEVEL_VALUES` for the level rank table.
+ *
+ * @module community-schema
+ */
+export { type AreaLineageSnapshot, areaLineageSnapshotSchema, } from './area.js';
+export { type CommunityCommentWire, communityCommentWireSchema, type CreateCommentBody, createCommentBodySchema, type UpdateCommentBody, updateCommentBodySchema, } from './comment.js';
+export { COMMENT_MAX_BODY_CHARS, COMMENTS_PAGE_SIZE, EDIT_GRACE_WINDOW_MS, FEED_PAGE_SIZE, GROUP_MAX_MEMBERS, GROUP_NAME_MAX_CHARS, GROUP_NAME_MIN_CHARS, PEOPLE_PAGE_SIZE, POST_MAX_BODY_CHARS, POST_MAX_IMAGE_BYTES, POST_MAX_IMAGES, POST_MAX_VIDEO_BYTES, POST_MAX_VIDEO_SECONDS, POST_MAX_VIDEOS, PROFILE_MAX_BIO_CHARS, REPLIES_PRELOAD_COUNT, } from './constants.js';
+export { type SetReactionBody, setReactionBodySchema, type SetReactionResponse, setReactionResponseSchema, type ToggleUpvoteResponse, toggleUpvoteResponseSchema, } from './engagement.js';
+export { CONNECTION_STATUS_VALUES, type ConnectionStatus, connectionStatusSchema, CONTENT_KIND_VALUES, type ContentKind, contentKindSchema, FEED_SORT_VALUES, type FeedSort, feedSortSchema, PROFILE_PRIVACY_VALUES, type ProfilePrivacy, profilePrivacySchema, REACTION_TYPE_VALUES, type ReactionType, reactionTypeSchema, REPORT_REASON_VALUES, type ReportReason, reportReasonSchema, REPORT_STATUS_VALUES, type ReportStatus, reportStatusSchema, VISIBILITY_LEVEL_RANK, VISIBILITY_LEVEL_VALUES, type VisibilityLevel, visibilityLevelSchema, } from './enums.js';
+export { type FeedItem, type FeedQueryParams, type FeedResponse, feedItemSchema, feedQueryParamsSchema, feedResponseSchema, type LostFoundFeedItem, lostFoundFeedItemSchema, type VoiceBoxFeedItem, voiceBoxFeedItemSchema, } from './feed.js';
+export { type AddGroupMembersBody, addGroupMembersBodySchema, type CommunityGroupWire, communityGroupWireSchema, type CreateGroupBody, createGroupBodySchema, type GroupRole, groupRoleSchema, } from './group.js';
+export { type PostImage, postImageSchema, type PostVideo, postVideoSchema, } from './media.js';
+export { type CommunityPostWire, communityPostWireSchema, type CreatePostBody, createPostBodySchema, type PostAuthorSnapshot, postAuthorSnapshotSchema, type UpdatePostBody, updatePostBodySchema, } from './post.js';
+export { type PeopleListItem, type PeopleListResponse, type PeopleQueryParams, peopleListItemSchema, peopleListResponseSchema, peopleQueryParamsSchema, type PublicProfileWire, publicProfileWireSchema, } from './profile.js';
+export { type ReportContentBody, reportContentBodySchema, type ReportRecordWire, reportRecordWireSchema, } from './report.js';
+export { COMMUNITY_SETTINGS_DEFAULTS, type CommunitySettingsWire, communitySettingsWireSchema, type UpdateCommunitySettingsBody, updateCommunitySettingsBodySchema, } from './settings.js';
+export { type ConnectionDecisionBody, connectionDecisionBodySchema, type ConnectionRecordWire, connectionRecordWireSchema, type SendConnectionRequestResponse, sendConnectionRequestResponseSchema, type ToggleFollowResponse, toggleFollowResponseSchema, type ViewerSocialState, viewerSocialStateSchema, } from './social.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,43 @@
+/**
+ * community-schema — Shared Zod schemas + TypeScript types for the
+ * Jansathi hyperlocal community feature (feed, posts, engagement,
+ * social graph, groups, settings).
+ *
+ * Single source of truth consumed by reform-backend and every product
+ * frontend. The schemas mirror MongoDB / Mongoose document shapes
+ * 1:1 so the same Zod validation runs at the controller boundary on
+ * the backend and in the form handlers on the client.
+ *
+ * Cascade-upward visibility semantics: a viewer whose feed level is L
+ * sees posts at L and every BROADER level matching their area lineage.
+ * See `./enums.ts#VISIBILITY_LEVEL_VALUES` for the level rank table.
+ *
+ * @module community-schema
+ */
+// ─── Area lineage snapshot ─────────────────────────────────────────────────
+export { areaLineageSnapshotSchema, } from './area.js';
+// ─── Comment ───────────────────────────────────────────────────────────────
+export { communityCommentWireSchema, createCommentBodySchema, updateCommentBodySchema, } from './comment.js';
+// ─── Constants ─────────────────────────────────────────────────────────────
+export { COMMENT_MAX_BODY_CHARS, COMMENTS_PAGE_SIZE, EDIT_GRACE_WINDOW_MS, FEED_PAGE_SIZE, GROUP_MAX_MEMBERS, GROUP_NAME_MAX_CHARS, GROUP_NAME_MIN_CHARS, PEOPLE_PAGE_SIZE, POST_MAX_BODY_CHARS, POST_MAX_IMAGE_BYTES, POST_MAX_IMAGES, POST_MAX_VIDEO_BYTES, POST_MAX_VIDEO_SECONDS, POST_MAX_VIDEOS, PROFILE_MAX_BIO_CHARS, REPLIES_PRELOAD_COUNT, } from './constants.js';
+// ─── Engagement (upvote + reactions) ───────────────────────────────────────
+export { setReactionBodySchema, setReactionResponseSchema, toggleUpvoteResponseSchema, } from './engagement.js';
+// ─── Enums ─────────────────────────────────────────────────────────────────
+export { CONNECTION_STATUS_VALUES, connectionStatusSchema, CONTENT_KIND_VALUES, contentKindSchema, FEED_SORT_VALUES, feedSortSchema, PROFILE_PRIVACY_VALUES, profilePrivacySchema, REACTION_TYPE_VALUES, reactionTypeSchema, REPORT_REASON_VALUES, reportReasonSchema, REPORT_STATUS_VALUES, reportStatusSchema, VISIBILITY_LEVEL_RANK, VISIBILITY_LEVEL_VALUES, visibilityLevelSchema, } from './enums.js';
+// ─── Feed (polymorphic union) ──────────────────────────────────────────────
+export { feedItemSchema, feedQueryParamsSchema, feedResponseSchema, lostFoundFeedItemSchema, voiceBoxFeedItemSchema, } from './feed.js';
+// ─── Groups ────────────────────────────────────────────────────────────────
+export { addGroupMembersBodySchema, communityGroupWireSchema, createGroupBodySchema, groupRoleSchema, } from './group.js';
+// ─── Media ─────────────────────────────────────────────────────────────────
+export { postImageSchema, postVideoSchema, } from './media.js';
+// ─── Post ──────────────────────────────────────────────────────────────────
+export { communityPostWireSchema, createPostBodySchema, postAuthorSnapshotSchema, updatePostBodySchema, } from './post.js';
+// ─── Profile + People list ─────────────────────────────────────────────────
+export { peopleListItemSchema, peopleListResponseSchema, peopleQueryParamsSchema, publicProfileWireSchema, } from './profile.js';
+// ─── Reports (moderation) ──────────────────────────────────────────────────
+export { reportContentBodySchema, reportRecordWireSchema, } from './report.js';
+// ─── Settings ──────────────────────────────────────────────────────────────
+export { COMMUNITY_SETTINGS_DEFAULTS, communitySettingsWireSchema, updateCommunitySettingsBodySchema, } from './settings.js';
+// ─── Social (follow + connection) ──────────────────────────────────────────
+export { connectionDecisionBodySchema, connectionRecordWireSchema, sendConnectionRequestResponseSchema, toggleFollowResponseSchema, viewerSocialStateSchema, } from './social.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,8EAA8E;AAC9E,OAAO,EAEL,yBAAyB,GAC1B,MAAM,WAAW,CAAC;AAEnB,8EAA8E;AAC9E,OAAO,EAEL,0BAA0B,EAE1B,uBAAuB,EAEvB,uBAAuB,GACxB,MAAM,cAAc,CAAC;AAEtB,8EAA8E;AAC9E,OAAO,EACL,sBAAsB,EACtB,kBAAkB,EAClB,oBAAoB,EACpB,cAAc,EACd,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,eAAe,EACf,oBAAoB,EACpB,sBAAsB,EACtB,eAAe,EACf,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,gBAAgB,CAAC;AAExB,8EAA8E;AAC9E,OAAO,EAEL,qBAAqB,EAErB,yBAAyB,EAEzB,0BAA0B,GAC3B,MAAM,iBAAiB,CAAC;AAEzB,8EAA8E;AAC9E,OAAO,EACL,wBAAwB,EAExB,sBAAsB,EACtB,mBAAmB,EAEnB,iBAAiB,EACjB,gBAAgB,EAEhB,cAAc,EACd,sBAAsB,EAEtB,oBAAoB,EACpB,oBAAoB,EAEpB,kBAAkB,EAClB,oBAAoB,EAEpB,kBAAkB,EAClB,oBAAoB,EAEpB,kBAAkB,EAClB,qBAAqB,EACrB,uBAAuB,EAEvB,qBAAqB,GACtB,MAAM,YAAY,CAAC;AAEpB,8EAA8E;AAC9E,OAAO,EAIL,cAAc,EACd,qBAAqB,EACrB,kBAAkB,EAElB,uBAAuB,EAEvB,sBAAsB,GACvB,MAAM,WAAW,CAAC;AAEnB,8EAA8E;AAC9E,OAAO,EAEL,yBAAyB,EAEzB,wBAAwB,EAExB,qBAAqB,EAErB,eAAe,GAChB,MAAM,YAAY,CAAC;AAEpB,8EAA8E;AAC9E,OAAO,EAEL,eAAe,EAEf,eAAe,GAChB,MAAM,YAAY,CAAC;AAEpB,8EAA8E;AAC9E,OAAO,EAEL,uBAAuB,EAEvB,oBAAoB,EAEpB,wBAAwB,EAExB,oBAAoB,GACrB,MAAM,WAAW,CAAC;AAEnB,8EAA8E;AAC9E,OAAO,EAIL,oBAAoB,EACpB,wBAAwB,EACxB,uBAAuB,EAEvB,uBAAuB,GACxB,MAAM,cAAc,CAAC;AAEtB,8EAA8E;AAC9E,OAAO,EAEL,uBAAuB,EAEvB,sBAAsB,GACvB,MAAM,aAAa,CAAC;AAErB,8EAA8E;AAC9E,OAAO,EACL,2BAA2B,EAE3B,2BAA2B,EAE3B,iCAAiC,GAClC,MAAM,eAAe,CAAC;AAEvB,8EAA8E;AAC9E,OAAO,EAEL,4BAA4B,EAE5B,0BAA0B,EAE1B,mCAAmC,EAEnC,0BAA0B,EAE1B,uBAAuB,GACxB,MAAM,aAAa,CAAC","sourcesContent":["/**\n * community-schema — Shared Zod schemas + TypeScript types for the\n * Jansathi hyperlocal community feature (feed, posts, engagement,\n * social graph, groups, settings).\n *\n * Single source of truth consumed by reform-backend and every product\n * frontend. The schemas mirror MongoDB / Mongoose document shapes\n * 1:1 so the same Zod validation runs at the controller boundary on\n * the backend and in the form handlers on the client.\n *\n * Cascade-upward visibility semantics: a viewer whose feed level is L\n * sees posts at L and every BROADER level matching their area lineage.\n * See `./enums.ts#VISIBILITY_LEVEL_VALUES` for the level rank table.\n *\n * @module community-schema\n */\n\n// ─── Area lineage snapshot ─────────────────────────────────────────────────\nexport {\n  type AreaLineageSnapshot,\n  areaLineageSnapshotSchema,\n} from './area.js';\n\n// ─── Comment ───────────────────────────────────────────────────────────────\nexport {\n  type CommunityCommentWire,\n  communityCommentWireSchema,\n  type CreateCommentBody,\n  createCommentBodySchema,\n  type UpdateCommentBody,\n  updateCommentBodySchema,\n} from './comment.js';\n\n// ─── Constants ─────────────────────────────────────────────────────────────\nexport {\n  COMMENT_MAX_BODY_CHARS,\n  COMMENTS_PAGE_SIZE,\n  EDIT_GRACE_WINDOW_MS,\n  FEED_PAGE_SIZE,\n  GROUP_MAX_MEMBERS,\n  GROUP_NAME_MAX_CHARS,\n  GROUP_NAME_MIN_CHARS,\n  PEOPLE_PAGE_SIZE,\n  POST_MAX_BODY_CHARS,\n  POST_MAX_IMAGE_BYTES,\n  POST_MAX_IMAGES,\n  POST_MAX_VIDEO_BYTES,\n  POST_MAX_VIDEO_SECONDS,\n  POST_MAX_VIDEOS,\n  PROFILE_MAX_BIO_CHARS,\n  REPLIES_PRELOAD_COUNT,\n} from './constants.js';\n\n// ─── Engagement (upvote + reactions) ───────────────────────────────────────\nexport {\n  type SetReactionBody,\n  setReactionBodySchema,\n  type SetReactionResponse,\n  setReactionResponseSchema,\n  type ToggleUpvoteResponse,\n  toggleUpvoteResponseSchema,\n} from './engagement.js';\n\n// ─── Enums ─────────────────────────────────────────────────────────────────\nexport {\n  CONNECTION_STATUS_VALUES,\n  type ConnectionStatus,\n  connectionStatusSchema,\n  CONTENT_KIND_VALUES,\n  type ContentKind,\n  contentKindSchema,\n  FEED_SORT_VALUES,\n  type FeedSort,\n  feedSortSchema,\n  PROFILE_PRIVACY_VALUES,\n  type ProfilePrivacy,\n  profilePrivacySchema,\n  REACTION_TYPE_VALUES,\n  type ReactionType,\n  reactionTypeSchema,\n  REPORT_REASON_VALUES,\n  type ReportReason,\n  reportReasonSchema,\n  REPORT_STATUS_VALUES,\n  type ReportStatus,\n  reportStatusSchema,\n  VISIBILITY_LEVEL_RANK,\n  VISIBILITY_LEVEL_VALUES,\n  type VisibilityLevel,\n  visibilityLevelSchema,\n} from './enums.js';\n\n// ─── Feed (polymorphic union) ──────────────────────────────────────────────\nexport {\n  type FeedItem,\n  type FeedQueryParams,\n  type FeedResponse,\n  feedItemSchema,\n  feedQueryParamsSchema,\n  feedResponseSchema,\n  type LostFoundFeedItem,\n  lostFoundFeedItemSchema,\n  type VoiceBoxFeedItem,\n  voiceBoxFeedItemSchema,\n} from './feed.js';\n\n// ─── Groups ────────────────────────────────────────────────────────────────\nexport {\n  type AddGroupMembersBody,\n  addGroupMembersBodySchema,\n  type CommunityGroupWire,\n  communityGroupWireSchema,\n  type CreateGroupBody,\n  createGroupBodySchema,\n  type GroupRole,\n  groupRoleSchema,\n} from './group.js';\n\n// ─── Media ─────────────────────────────────────────────────────────────────\nexport {\n  type PostImage,\n  postImageSchema,\n  type PostVideo,\n  postVideoSchema,\n} from './media.js';\n\n// ─── Post ──────────────────────────────────────────────────────────────────\nexport {\n  type CommunityPostWire,\n  communityPostWireSchema,\n  type CreatePostBody,\n  createPostBodySchema,\n  type PostAuthorSnapshot,\n  postAuthorSnapshotSchema,\n  type UpdatePostBody,\n  updatePostBodySchema,\n} from './post.js';\n\n// ─── Profile + People list ─────────────────────────────────────────────────\nexport {\n  type PeopleListItem,\n  type PeopleListResponse,\n  type PeopleQueryParams,\n  peopleListItemSchema,\n  peopleListResponseSchema,\n  peopleQueryParamsSchema,\n  type PublicProfileWire,\n  publicProfileWireSchema,\n} from './profile.js';\n\n// ─── Reports (moderation) ──────────────────────────────────────────────────\nexport {\n  type ReportContentBody,\n  reportContentBodySchema,\n  type ReportRecordWire,\n  reportRecordWireSchema,\n} from './report.js';\n\n// ─── Settings ──────────────────────────────────────────────────────────────\nexport {\n  COMMUNITY_SETTINGS_DEFAULTS,\n  type CommunitySettingsWire,\n  communitySettingsWireSchema,\n  type UpdateCommunitySettingsBody,\n  updateCommunitySettingsBodySchema,\n} from './settings.js';\n\n// ─── Social (follow + connection) ──────────────────────────────────────────\nexport {\n  type ConnectionDecisionBody,\n  connectionDecisionBodySchema,\n  type ConnectionRecordWire,\n  connectionRecordWireSchema,\n  type SendConnectionRequestResponse,\n  sendConnectionRequestResponseSchema,\n  type ToggleFollowResponse,\n  toggleFollowResponseSchema,\n  type ViewerSocialState,\n  viewerSocialStateSchema,\n} from './social.js';\n"]}

package/dist/media.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Media-asset wire shapes for community posts.
+ *
+ * Uploads land in the shared file service (same GCS bucket the rest of
+ * Jansathi uses) and the result — a signed URL + thumbnail + a small
+ * set of metadata — is what the post-create endpoint accepts.
+ *
+ * Why the wire shape carries width/height/duration: feed cards need
+ * those to size the preview without loading the full asset (avoids
+ * layout shift). Thumbnails are server-generated for videos and
+ * server-compressed-variants for images.
+ *
+ * @module community-schema/media
+ */
+import { z } from 'zod';
+/**
+ * An image attached to a community post.
+ *
+ * `width` / `height` are reported by the upload pipeline (sharp on the
+ * backend or Image-API on the client) so the feed card can render an
+ * intrinsic-size box and avoid CLS.
+ */
+export declare const postImageSchema: 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>;
+export type PostImage = z.infer<typeof postImageSchema>;
+/**
+ * A video attached to a community post.
+ *
+ * Required `duration` is enforced at upload time so we never have to
+ * probe the asset in the feed query. `thumbnailUrl` is a poster frame
+ * extracted on the backend.
+ */
+export declare const postVideoSchema: z.ZodObject<{
+    url: z.ZodString;
+    thumbnailUrl: z.ZodString;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    bytes: z.ZodNumber;
+    duration: z.ZodNumber;
+}, z.core.$strip>;
+export type PostVideo = z.infer<typeof postVideoSchema>;
+//# sourceMappingURL=media.d.ts.map

package/dist/media.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media.d.ts","sourceRoot":"","sources":["../src/media.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB;;;;;;GAMG;AACH,eAAO,MAAM,eAAe;;;;;;;iBAS1B,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD;;;;;;GAMG;AACH,eAAO,MAAM,eAAe;;;;;;;iBAQ1B,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC"}

package/dist/media.js

@@ -0,0 +1,50 @@
+/**
+ * Media-asset wire shapes for community posts.
+ *
+ * Uploads land in the shared file service (same GCS bucket the rest of
+ * Jansathi uses) and the result — a signed URL + thumbnail + a small
+ * set of metadata — is what the post-create endpoint accepts.
+ *
+ * Why the wire shape carries width/height/duration: feed cards need
+ * those to size the preview without loading the full asset (avoids
+ * layout shift). Thumbnails are server-generated for videos and
+ * server-compressed-variants for images.
+ *
+ * @module community-schema/media
+ */
+import { z } from 'zod';
+import { POST_MAX_IMAGE_BYTES, POST_MAX_VIDEO_BYTES, POST_MAX_VIDEO_SECONDS, } from './constants.js';
+/**
+ * An image attached to a community post.
+ *
+ * `width` / `height` are reported by the upload pipeline (sharp on the
+ * backend or Image-API on the client) so the feed card can render an
+ * intrinsic-size box and avoid CLS.
+ */
+export const postImageSchema = z.object({
+    url: z.string().url(),
+    thumbnailUrl: z.string().url().optional(),
+    width: z.number().int().positive(),
+    height: z.number().int().positive(),
+    /** Original byte size at upload time. The pipeline rejects >cap. */
+    bytes: z.number().int().positive().max(POST_MAX_IMAGE_BYTES),
+    /** Author-supplied alt text. Optional but recommended for a11y. */
+    alt: z.string().max(280).optional(),
+});
+/**
+ * A video attached to a community post.
+ *
+ * Required `duration` is enforced at upload time so we never have to
+ * probe the asset in the feed query. `thumbnailUrl` is a poster frame
+ * extracted on the backend.
+ */
+export const postVideoSchema = z.object({
+    url: z.string().url(),
+    thumbnailUrl: z.string().url(),
+    width: z.number().int().positive(),
+    height: z.number().int().positive(),
+    bytes: z.number().int().positive().max(POST_MAX_VIDEO_BYTES),
+    /** Duration in seconds. Hard-capped per `POST_MAX_VIDEO_SECONDS`. */
+    duration: z.number().positive().max(POST_MAX_VIDEO_SECONDS),
+});
+//# sourceMappingURL=media.js.map

package/dist/media.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media.js","sourceRoot":"","sources":["../src/media.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,gBAAgB,CAAC;AAExB;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACrB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACzC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IAClC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACnC,oEAAoE;IACpE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,oBAAoB,CAAC;IAC5D,mEAAmE;IACnE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;CACpC,CAAC,CAAC;AAGH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACrB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IAC9B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IAClC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACnC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,oBAAoB,CAAC;IAC5D,qEAAqE;IACrE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,sBAAsB,CAAC;CAC5D,CAAC,CAAC","sourcesContent":["/**\n * Media-asset wire shapes for community posts.\n *\n * Uploads land in the shared file service (same GCS bucket the rest of\n * Jansathi uses) and the result — a signed URL + thumbnail + a small\n * set of metadata — is what the post-create endpoint accepts.\n *\n * Why the wire shape carries width/height/duration: feed cards need\n * those to size the preview without loading the full asset (avoids\n * layout shift). Thumbnails are server-generated for videos and\n * server-compressed-variants for images.\n *\n * @module community-schema/media\n */\n\nimport { z } from 'zod';\nimport {\n  POST_MAX_IMAGE_BYTES,\n  POST_MAX_VIDEO_BYTES,\n  POST_MAX_VIDEO_SECONDS,\n} from './constants.js';\n\n/**\n * An image attached to a community post.\n *\n * `width` / `height` are reported by the upload pipeline (sharp on the\n * backend or Image-API on the client) so the feed card can render an\n * intrinsic-size box and avoid CLS.\n */\nexport const postImageSchema = z.object({\n  url: z.string().url(),\n  thumbnailUrl: z.string().url().optional(),\n  width: z.number().int().positive(),\n  height: z.number().int().positive(),\n  /** Original byte size at upload time. The pipeline rejects >cap. */\n  bytes: z.number().int().positive().max(POST_MAX_IMAGE_BYTES),\n  /** Author-supplied alt text. Optional but recommended for a11y. */\n  alt: z.string().max(280).optional(),\n});\nexport type PostImage = z.infer<typeof postImageSchema>;\n\n/**\n * A video attached to a community post.\n *\n * Required `duration` is enforced at upload time so we never have to\n * probe the asset in the feed query. `thumbnailUrl` is a poster frame\n * extracted on the backend.\n */\nexport const postVideoSchema = z.object({\n  url: z.string().url(),\n  thumbnailUrl: z.string().url(),\n  width: z.number().int().positive(),\n  height: z.number().int().positive(),\n  bytes: z.number().int().positive().max(POST_MAX_VIDEO_BYTES),\n  /** Duration in seconds. Hard-capped per `POST_MAX_VIDEO_SECONDS`. */\n  duration: z.number().positive().max(POST_MAX_VIDEO_SECONDS),\n});\nexport type PostVideo = z.infer<typeof postVideoSchema>;\n"]}

package/dist/post.d.ts

@@ -0,0 +1,130 @@
+/**
+ * Community post wire shapes.
+ *
+ * A "post" is the native community content kind (text-primary + media).
+ * Lost-and-found and voice-box items show up in the same feed via
+ * polymorphic union; their shapes live in their own schema packages
+ * and are projected into a `FeedItem` envelope (see `./feed.ts`).
+ *
+ * @module community-schema/post
+ */
+import { z } from 'zod';
+/**
+ * The author's display info captured at post time. Denormalising
+ * `displayName` / `avatarUrl` / `localName` here avoids a $lookup
+ * against the User collection on every feed read — feed scans 20–40
+ * posts per page and population would be a hot path.
+ *
+ * The User document remains the source of truth; a background job
+ * (or a hook on User.findOneAndUpdate) refreshes recent posts when
+ * a user changes their display name or avatar.
+ */
+export declare const postAuthorSnapshotSchema: z.ZodObject<{
+    userId: z.ZodString;
+    displayName: z.ZodString;
+    avatarUrl: z.ZodOptional<z.ZodString>;
+    localName: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type PostAuthorSnapshot = z.infer<typeof postAuthorSnapshotSchema>;
+/**
+ * A community post as it appears in the feed and on the single-post
+ * page. Engagement counts are denormalised onto the document for
+ * fast feed sorting; the per-user reaction state ("did I upvote this?")
+ * is computed at read time and returned in the `viewer` block.
+ */
+export declare const communityPostWireSchema: 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>;
+export type CommunityPostWire = z.infer<typeof communityPostWireSchema>;
+/**
+ * What the client sends to `POST /api/v1/community/posts`. The author
+ * is taken from the authenticated request; visibility area is resolved
+ * server-side from the user's primary area lineage (the client cannot
+ * spoof a different area).
+ */
+export declare const createPostBodySchema: z.ZodObject<{
+    text: z.ZodString;
+    images: z.ZodOptional<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.ZodOptional<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";
+    }>;
+}, z.core.$strip>;
+export type CreatePostBody = z.infer<typeof createPostBodySchema>;
+/**
+ * What the client sends to `PATCH /api/v1/community/posts/:id`. Only
+ * the text body is editable — media additions / removals require a new
+ * post (matches Twitter / FB convention).
+ */
+export declare const updatePostBodySchema: z.ZodObject<{
+    text: z.ZodString;
+}, z.core.$strip>;
+export type UpdatePostBody = z.infer<typeof updatePostBodySchema>;
+//# sourceMappingURL=post.d.ts.map

package/dist/post.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"post.d.ts","sourceRoot":"","sources":["../src/post.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAYxB;;;;;;;;;GASG;AACH,eAAO,MAAM,wBAAwB;;;;;iBAWnC,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAI1E;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAuClC,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAIxE;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;iBAM/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE;;;;GAIG;AACH,eAAO,MAAM,oBAAoB;;iBAE/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC"}