jansathi-community-schema 0.1.0

package/README.md

@@ -0,0 +1,41 @@
+# jansathi-community-schema
+
+Shared Zod schemas + TypeScript types for the Jansathi hyperlocal community feature.
+
+Consumed by `reform-backend` and every Jansathi product frontend. Single source of truth for:
+
+- **Feed** — polymorphic union of posts, lost-and-found, and voice-box items
+- **Posts** — text + media (10 images, 5 videos ≤10 min), with `visibilityLevel` and area-lineage snapshot
+- **Engagement** — upvote toggle + 7-emoji reactions + comments with one-level reply nesting
+- **Social graph** — Follow (one-way) + Connection (mutual handshake)
+- **Profiles** — public / private toggle, viewer-relationship state
+- **Groups** — user-created group chats wire-compatible with chat-server conversations
+- **Settings** — profile privacy, default post visibility, notification preferences
+- **Reports** — content moderation queue payloads
+
+## Visibility semantics
+
+Posts carry a `visibilityLevel ∈ { local, district, state, national, global }` and an `areaLineage` snapshot at write time. The feed query uses **cascade-upward** semantics:
+
+> A viewer whose feed level is **L** sees posts at **L** and every broader level matching their area lineage.
+
+So a viewer with `level=local` sees `local + district + state + national + global` content tied to their locality / village / urbanWard / etc.; a viewer with `level=state` sees `state + national + global` content tied to their state, etc.
+
+Accepted Connections override the cascade entirely — friend posts always show regardless of level.
+
+## Build
+
+```bash
+npm install
+npm run build
+```
+
+## Publish (manual, not auto)
+
+Bump version in `package.json`, then:
+
+```bash
+npm publish --access public
+```
+
+After publish, run `npm install jansathi-community-schema@<version>` in both `reform-backend` and any frontend that consumes it. Delete any nested `node_modules` inside the installed package to avoid duplicate Zod instances.

package/dist/area.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Area-lineage snapshot stored on every piece of community content.
+ *
+ * Why a snapshot (not a live lookup): the post's geographic scope is a
+ * write-time property — it travels with the content and survives the
+ * author moving away, the author's primary area being recomputed, or
+ * the AreaEntity being renamed. Mirrors the same denormalization
+ * pattern used by `udp-schema`'s residence step.
+ *
+ * Every level the cascade-upward feed query may filter on is captured
+ * here as a string id (Mongo ObjectId serialized). Indexes on the
+ * backend match: one compound per geo level paired with `createdAt`.
+ *
+ * The two "below district" admin units (locality / village / urbanBody
+ * / urbanWard / ruralWard / gramPanchayat / block / hamlet) are
+ * grouped under `localId` — the deepest admin area below the district
+ * the author resolved to at post time. This is what powers the "local"
+ * filter without forcing the backend to compose nine separate indexes.
+ *
+ * @module community-schema/area
+ */
+import { z } from 'zod';
+/**
+ * Snapshot of the author's primary area lineage at content creation
+ * time. All ids are optional because the author may not have a full
+ * lineage resolved yet (e.g., a brand-new user whose only known field
+ * is country).
+ */
+export declare const areaLineageSnapshotSchema: 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>;
+export type AreaLineageSnapshot = z.infer<typeof areaLineageSnapshotSchema>;
+//# sourceMappingURL=area.d.ts.map

package/dist/area.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"area.d.ts","sourceRoot":"","sources":["../src/area.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB;;;;;;iBAqBpC,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC"}

package/dist/area.js

@@ -0,0 +1,51 @@
+/**
+ * Area-lineage snapshot stored on every piece of community content.
+ *
+ * Why a snapshot (not a live lookup): the post's geographic scope is a
+ * write-time property — it travels with the content and survives the
+ * author moving away, the author's primary area being recomputed, or
+ * the AreaEntity being renamed. Mirrors the same denormalization
+ * pattern used by `udp-schema`'s residence step.
+ *
+ * Every level the cascade-upward feed query may filter on is captured
+ * here as a string id (Mongo ObjectId serialized). Indexes on the
+ * backend match: one compound per geo level paired with `createdAt`.
+ *
+ * The two "below district" admin units (locality / village / urbanBody
+ * / urbanWard / ruralWard / gramPanchayat / block / hamlet) are
+ * grouped under `localId` — the deepest admin area below the district
+ * the author resolved to at post time. This is what powers the "local"
+ * filter without forcing the backend to compose nine separate indexes.
+ *
+ * @module community-schema/area
+ */
+import { z } from 'zod';
+/**
+ * Snapshot of the author's primary area lineage at content creation
+ * time. All ids are optional because the author may not have a full
+ * lineage resolved yet (e.g., a brand-new user whose only known field
+ * is country).
+ */
+export const areaLineageSnapshotSchema = z.object({
+    countryId: z.string().optional(),
+    stateId: z.string().optional(),
+    districtId: z.string().optional(),
+    /**
+     * The deepest area below the district that the author resolved to.
+     * "Local" in this app explicitly means "anywhere below district" —
+     * which level varies by urban / rural / hamlet structure, so the
+     * id is collapsed into a single field for indexing efficiency.
+     *
+     * Resolution order (server-side, at write time): hamlet → village →
+     * locality → ruralWard → urbanWard → gramPanchayat → urbanBody → block.
+     * The first match becomes `localId`.
+     */
+    localId: z.string().optional(),
+    /**
+     * Human-readable label of the deepest matched area (e.g. "Rohini
+     * Sector 15"). Surfaced on the post card so viewers see where it
+     * came from without an extra Area lookup.
+     */
+    localName: z.string().optional(),
+});
+//# sourceMappingURL=area.js.map

package/dist/area.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"area.js","sourceRoot":"","sources":["../src/area.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;GAKG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC;;;;;;;;;OASG;IACH,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B;;;;OAIG;IACH,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC,CAAC","sourcesContent":["/**\n * Area-lineage snapshot stored on every piece of community content.\n *\n * Why a snapshot (not a live lookup): the post's geographic scope is a\n * write-time property — it travels with the content and survives the\n * author moving away, the author's primary area being recomputed, or\n * the AreaEntity being renamed. Mirrors the same denormalization\n * pattern used by `udp-schema`'s residence step.\n *\n * Every level the cascade-upward feed query may filter on is captured\n * here as a string id (Mongo ObjectId serialized). Indexes on the\n * backend match: one compound per geo level paired with `createdAt`.\n *\n * The two \"below district\" admin units (locality / village / urbanBody\n * / urbanWard / ruralWard / gramPanchayat / block / hamlet) are\n * grouped under `localId` — the deepest admin area below the district\n * the author resolved to at post time. This is what powers the \"local\"\n * filter without forcing the backend to compose nine separate indexes.\n *\n * @module community-schema/area\n */\n\nimport { z } from 'zod';\n\n/**\n * Snapshot of the author's primary area lineage at content creation\n * time. All ids are optional because the author may not have a full\n * lineage resolved yet (e.g., a brand-new user whose only known field\n * is country).\n */\nexport const areaLineageSnapshotSchema = z.object({\n  countryId: z.string().optional(),\n  stateId: z.string().optional(),\n  districtId: z.string().optional(),\n  /**\n   * The deepest area below the district that the author resolved to.\n   * \"Local\" in this app explicitly means \"anywhere below district\" —\n   * which level varies by urban / rural / hamlet structure, so the\n   * id is collapsed into a single field for indexing efficiency.\n   *\n   * Resolution order (server-side, at write time): hamlet → village →\n   * locality → ruralWard → urbanWard → gramPanchayat → urbanBody → block.\n   * The first match becomes `localId`.\n   */\n  localId: z.string().optional(),\n  /**\n   * Human-readable label of the deepest matched area (e.g. \"Rohini\n   * Sector 15\"). Surfaced on the post card so viewers see where it\n   * came from without an extra Area lookup.\n   */\n  localName: z.string().optional(),\n});\nexport type AreaLineageSnapshot = z.infer<typeof areaLineageSnapshotSchema>;\n"]}

package/dist/comment.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Comment wire shapes (with one-level reply nesting).
+ *
+ * Comments attach to any feed item via `(contentKind, contentId)` — the
+ * same polymorphic key used by reactions and upvotes. One level of
+ * nesting only: a reply to a comment is allowed; a reply to a reply
+ * is rejected at the server.
+ *
+ * The shape mirrors the post's `viewer` pattern so the client can
+ * render an edit button on own comments and a reaction picker on
+ * every comment.
+ *
+ * @module community-schema/comment
+ */
+import { z } from 'zod';
+export declare const communityCommentWireSchema: z.ZodObject<{
+    _id: z.ZodString;
+    contentKind: z.ZodEnum<{
+        post: "post";
+        lost_found: "lost_found";
+        voice_box: "voice_box";
+    }>;
+    contentId: z.ZodString;
+    parentCommentId: z.ZodNullable<z.ZodString>;
+    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;
+    upvoteCount: z.ZodNumber;
+    replyCount: 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 CommunityCommentWire = z.infer<typeof communityCommentWireSchema>;
+export declare const createCommentBodySchema: z.ZodObject<{
+    text: z.ZodString;
+    parentCommentId: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type CreateCommentBody = z.infer<typeof createCommentBodySchema>;
+export declare const updateCommentBodySchema: z.ZodObject<{
+    text: z.ZodString;
+}, z.core.$strip>;
+export type UpdateCommentBody = z.infer<typeof updateCommentBodySchema>;
+//# sourceMappingURL=comment.d.ts.map

package/dist/comment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comment.d.ts","sourceRoot":"","sources":["../src/comment.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAkCrC,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAI9E,eAAO,MAAM,uBAAuB;;;iBAMlC,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAIxE,eAAO,MAAM,uBAAuB;;iBAElC,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC"}

package/dist/comment.js

@@ -0,0 +1,63 @@
+/**
+ * Comment wire shapes (with one-level reply nesting).
+ *
+ * Comments attach to any feed item via `(contentKind, contentId)` — the
+ * same polymorphic key used by reactions and upvotes. One level of
+ * nesting only: a reply to a comment is allowed; a reply to a reply
+ * is rejected at the server.
+ *
+ * The shape mirrors the post's `viewer` pattern so the client can
+ * render an edit button on own comments and a reaction picker on
+ * every comment.
+ *
+ * @module community-schema/comment
+ */
+import { z } from 'zod';
+import { COMMENT_MAX_BODY_CHARS } from './constants.js';
+import { contentKindSchema } from './enums.js';
+import { postAuthorSnapshotSchema } from './post.js';
+// ─── Wire shape ─────────────────────────────────────────────────────────────
+export const communityCommentWireSchema = z.object({
+    _id: z.string(),
+    /** The feed item this comment belongs to. */
+    contentKind: contentKindSchema,
+    contentId: z.string(),
+    /** The parent comment id, or null if this is a top-level comment.
+     *  A non-null value MAY only point at a top-level comment — the
+     *  server enforces this so the tree never grows to depth 3. */
+    parentCommentId: z.string().nullable(),
+    author: postAuthorSnapshotSchema,
+    // Body
+    text: z.string().max(COMMENT_MAX_BODY_CHARS),
+    // Denormalised engagement
+    upvoteCount: z.number().int().nonnegative(),
+    /** Number of replies. Only meaningful on top-level comments; always
+     *  0 on replies (the server enforces no-nesting). */
+    replyCount: z.number().int().nonnegative(),
+    reactionCounts: z.record(z.string(), z.number().int().nonnegative()),
+    // Lifecycle
+    createdAt: z.string().datetime(),
+    editedAt: z.string().datetime().nullable(),
+    deletedAt: z.string().datetime().nullable(),
+    // Per-viewer state
+    viewer: z
+        .object({
+        upvoted: z.boolean(),
+        reaction: z.string().nullable(),
+        isAuthor: z.boolean(),
+    })
+        .optional(),
+});
+// ─── Create body ────────────────────────────────────────────────────────────
+export const createCommentBodySchema = z.object({
+    text: z.string().min(1).max(COMMENT_MAX_BODY_CHARS),
+    /** Null = top-level comment on the content; a string id = reply to
+     *  a specific top-level comment. Server rejects ids pointing at a
+     *  reply (depth-3 attempt). */
+    parentCommentId: z.string().nullable(),
+});
+// ─── Update body ────────────────────────────────────────────────────────────
+export const updateCommentBodySchema = z.object({
+    text: z.string().min(1).max(COMMENT_MAX_BODY_CHARS),
+});
+//# sourceMappingURL=comment.js.map

package/dist/comment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"comment.js","sourceRoot":"","sources":["../src/comment.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AAErD,+EAA+E;AAE/E,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,6CAA6C;IAC7C,WAAW,EAAE,iBAAiB;IAC9B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB;;mEAE+D;IAC/D,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACtC,MAAM,EAAE,wBAAwB;IAEhC,OAAO;IACP,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,sBAAsB,CAAC;IAE5C,0BAA0B;IAC1B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAC3C;yDACqD;IACrD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAC1C,cAAc,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC;IAEpE,YAAY;IACZ,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC1C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAE3C,mBAAmB;IACnB,MAAM,EAAE,CAAC;SACN,MAAM,CAAC;QACN,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;QACpB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC/B,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE;KACtB,CAAC;SACD,QAAQ,EAAE;CACd,CAAC,CAAC;AAGH,+EAA+E;AAE/E,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,sBAAsB,CAAC;IACnD;;mCAE+B;IAC/B,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACvC,CAAC,CAAC;AAGH,+EAA+E;AAE/E,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,sBAAsB,CAAC;CACpD,CAAC,CAAC","sourcesContent":["/**\n * Comment wire shapes (with one-level reply nesting).\n *\n * Comments attach to any feed item via `(contentKind, contentId)` — the\n * same polymorphic key used by reactions and upvotes. One level of\n * nesting only: a reply to a comment is allowed; a reply to a reply\n * is rejected at the server.\n *\n * The shape mirrors the post's `viewer` pattern so the client can\n * render an edit button on own comments and a reaction picker on\n * every comment.\n *\n * @module community-schema/comment\n */\n\nimport { z } from 'zod';\nimport { COMMENT_MAX_BODY_CHARS } from './constants.js';\nimport { contentKindSchema } from './enums.js';\nimport { postAuthorSnapshotSchema } from './post.js';\n\n// ─── Wire shape ─────────────────────────────────────────────────────────────\n\nexport const communityCommentWireSchema = z.object({\n  _id: z.string(),\n  /** The feed item this comment belongs to. */\n  contentKind: contentKindSchema,\n  contentId: z.string(),\n  /** The parent comment id, or null if this is a top-level comment.\n   *  A non-null value MAY only point at a top-level comment — the\n   *  server enforces this so the tree never grows to depth 3. */\n  parentCommentId: z.string().nullable(),\n  author: postAuthorSnapshotSchema,\n\n  // Body\n  text: z.string().max(COMMENT_MAX_BODY_CHARS),\n\n  // Denormalised engagement\n  upvoteCount: z.number().int().nonnegative(),\n  /** Number of replies. Only meaningful on top-level comments; always\n   *  0 on replies (the server enforces no-nesting). */\n  replyCount: z.number().int().nonnegative(),\n  reactionCounts: z.record(z.string(), z.number().int().nonnegative()),\n\n  // Lifecycle\n  createdAt: z.string().datetime(),\n  editedAt: z.string().datetime().nullable(),\n  deletedAt: z.string().datetime().nullable(),\n\n  // Per-viewer state\n  viewer: z\n    .object({\n      upvoted: z.boolean(),\n      reaction: z.string().nullable(),\n      isAuthor: z.boolean(),\n    })\n    .optional(),\n});\nexport type CommunityCommentWire = z.infer<typeof communityCommentWireSchema>;\n\n// ─── Create body ────────────────────────────────────────────────────────────\n\nexport const createCommentBodySchema = z.object({\n  text: z.string().min(1).max(COMMENT_MAX_BODY_CHARS),\n  /** Null = top-level comment on the content; a string id = reply to\n   *  a specific top-level comment. Server rejects ids pointing at a\n   *  reply (depth-3 attempt). */\n  parentCommentId: z.string().nullable(),\n});\nexport type CreateCommentBody = z.infer<typeof createCommentBodySchema>;\n\n// ─── Update body ────────────────────────────────────────────────────────────\n\nexport const updateCommentBodySchema = z.object({\n  text: z.string().min(1).max(COMMENT_MAX_BODY_CHARS),\n});\nexport type UpdateCommentBody = z.infer<typeof updateCommentBodySchema>;\n"]}

package/dist/constants.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Tunable constants shared across the community feature.
+ *
+ * Live here (not inline in feature code) so backend and every frontend
+ * agree byte-for-byte on the same limits, paginations, and timeouts.
+ * Bump versions of this package when these change.
+ *
+ * @module community-schema/constants
+ */
+/** Feed list default page size. */
+export declare const FEED_PAGE_SIZE = 20;
+/** People list default page size. */
+export declare const PEOPLE_PAGE_SIZE = 30;
+/** Comments per page on a single post. */
+export declare const COMMENTS_PAGE_SIZE = 20;
+/** Replies per top-level comment loaded with the first comments page. */
+export declare const REPLIES_PRELOAD_COUNT = 3;
+/** Max images per post. */
+export declare const POST_MAX_IMAGES = 10;
+/** Max videos per post. */
+export declare const POST_MAX_VIDEOS = 5;
+/** Max duration of a single video in seconds (10 min). */
+export declare const POST_MAX_VIDEO_SECONDS: number;
+/** Per-image hard cap (15 MB). The file service compresses to fit. */
+export declare const POST_MAX_IMAGE_BYTES: number;
+/** Per-video hard cap (200 MB). */
+export declare const POST_MAX_VIDEO_BYTES: number;
+/** Post body character cap. Long enough for long-form, short enough to
+ *  keep feed rendering snappy. */
+export declare const POST_MAX_BODY_CHARS = 5000;
+/** Comment + reply body character cap. */
+export declare const COMMENT_MAX_BODY_CHARS = 2000;
+/** Free-text bio on a public profile. */
+export declare const PROFILE_MAX_BIO_CHARS = 280;
+/** Window during which an author can edit their own post / comment, in ms. */
+export declare const EDIT_GRACE_WINDOW_MS: number;
+/** Max members in a single user-created group chat. */
+export declare const GROUP_MAX_MEMBERS = 256;
+/** Group name length. */
+export declare const GROUP_NAME_MAX_CHARS = 60;
+export declare const GROUP_NAME_MIN_CHARS = 2;
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,mCAAmC;AACnC,eAAO,MAAM,cAAc,KAAK,CAAC;AAEjC,qCAAqC;AACrC,eAAO,MAAM,gBAAgB,KAAK,CAAC;AAEnC,0CAA0C;AAC1C,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAErC,yEAAyE;AACzE,eAAO,MAAM,qBAAqB,IAAI,CAAC;AAIvC,2BAA2B;AAC3B,eAAO,MAAM,eAAe,KAAK,CAAC;AAElC,2BAA2B;AAC3B,eAAO,MAAM,eAAe,IAAI,CAAC;AAEjC,0DAA0D;AAC1D,eAAO,MAAM,sBAAsB,QAAU,CAAC;AAE9C,sEAAsE;AACtE,eAAO,MAAM,oBAAoB,QAAmB,CAAC;AAErD,mCAAmC;AACnC,eAAO,MAAM,oBAAoB,QAAoB,CAAC;AAItD;kCACkC;AAClC,eAAO,MAAM,mBAAmB,OAAO,CAAC;AAExC,0CAA0C;AAC1C,eAAO,MAAM,sBAAsB,OAAO,CAAC;AAE3C,yCAAyC;AACzC,eAAO,MAAM,qBAAqB,MAAM,CAAC;AAIzC,8EAA8E;AAC9E,eAAO,MAAM,oBAAoB,QAAgB,CAAC;AAIlD,uDAAuD;AACvD,eAAO,MAAM,iBAAiB,MAAM,CAAC;AAErC,yBAAyB;AACzB,eAAO,MAAM,oBAAoB,KAAK,CAAC;AACvC,eAAO,MAAM,oBAAoB,IAAI,CAAC"}

package/dist/constants.js

@@ -0,0 +1,47 @@
+/**
+ * Tunable constants shared across the community feature.
+ *
+ * Live here (not inline in feature code) so backend and every frontend
+ * agree byte-for-byte on the same limits, paginations, and timeouts.
+ * Bump versions of this package when these change.
+ *
+ * @module community-schema/constants
+ */
+// ─── Pagination ─────────────────────────────────────────────────────────────
+/** Feed list default page size. */
+export const FEED_PAGE_SIZE = 20;
+/** People list default page size. */
+export const PEOPLE_PAGE_SIZE = 30;
+/** Comments per page on a single post. */
+export const COMMENTS_PAGE_SIZE = 20;
+/** Replies per top-level comment loaded with the first comments page. */
+export const REPLIES_PRELOAD_COUNT = 3;
+// ─── Post media limits ─────────────────────────────────────────────────────
+/** Max images per post. */
+export const POST_MAX_IMAGES = 10;
+/** Max videos per post. */
+export const POST_MAX_VIDEOS = 5;
+/** Max duration of a single video in seconds (10 min). */
+export const POST_MAX_VIDEO_SECONDS = 10 * 60;
+/** Per-image hard cap (15 MB). The file service compresses to fit. */
+export const POST_MAX_IMAGE_BYTES = 15 * 1024 * 1024;
+/** Per-video hard cap (200 MB). */
+export const POST_MAX_VIDEO_BYTES = 200 * 1024 * 1024;
+// ─── Text limits ────────────────────────────────────────────────────────────
+/** Post body character cap. Long enough for long-form, short enough to
+ *  keep feed rendering snappy. */
+export const POST_MAX_BODY_CHARS = 5000;
+/** Comment + reply body character cap. */
+export const COMMENT_MAX_BODY_CHARS = 2000;
+/** Free-text bio on a public profile. */
+export const PROFILE_MAX_BIO_CHARS = 280;
+// ─── Engagement ─────────────────────────────────────────────────────────────
+/** Window during which an author can edit their own post / comment, in ms. */
+export const EDIT_GRACE_WINDOW_MS = 5 * 60 * 1000;
+// ─── Groups ─────────────────────────────────────────────────────────────────
+/** Max members in a single user-created group chat. */
+export const GROUP_MAX_MEMBERS = 256;
+/** Group name length. */
+export const GROUP_NAME_MAX_CHARS = 60;
+export const GROUP_NAME_MIN_CHARS = 2;
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,+EAA+E;AAE/E,mCAAmC;AACnC,MAAM,CAAC,MAAM,cAAc,GAAG,EAAE,CAAC;AAEjC,qCAAqC;AACrC,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAEnC,0CAA0C;AAC1C,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,CAAC;AAErC,yEAAyE;AACzE,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC;AAEvC,8EAA8E;AAE9E,2BAA2B;AAC3B,MAAM,CAAC,MAAM,eAAe,GAAG,EAAE,CAAC;AAElC,2BAA2B;AAC3B,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC;AAEjC,0DAA0D;AAC1D,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAE,GAAG,EAAE,CAAC;AAE9C,sEAAsE;AACtE,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAErD,mCAAmC;AACnC,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,CAAC;AAEtD,+EAA+E;AAE/E;kCACkC;AAClC,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,CAAC;AAExC,0CAA0C;AAC1C,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,CAAC;AAE3C,yCAAyC;AACzC,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,CAAC;AAEzC,+EAA+E;AAE/E,8EAA8E;AAC9E,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;AAElD,+EAA+E;AAE/E,uDAAuD;AACvD,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAErC,yBAAyB;AACzB,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,CAAC;AACvC,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC","sourcesContent":["/**\n * Tunable constants shared across the community feature.\n *\n * Live here (not inline in feature code) so backend and every frontend\n * agree byte-for-byte on the same limits, paginations, and timeouts.\n * Bump versions of this package when these change.\n *\n * @module community-schema/constants\n */\n\n// ─── Pagination ─────────────────────────────────────────────────────────────\n\n/** Feed list default page size. */\nexport const FEED_PAGE_SIZE = 20;\n\n/** People list default page size. */\nexport const PEOPLE_PAGE_SIZE = 30;\n\n/** Comments per page on a single post. */\nexport const COMMENTS_PAGE_SIZE = 20;\n\n/** Replies per top-level comment loaded with the first comments page. */\nexport const REPLIES_PRELOAD_COUNT = 3;\n\n// ─── Post media limits ─────────────────────────────────────────────────────\n\n/** Max images per post. */\nexport const POST_MAX_IMAGES = 10;\n\n/** Max videos per post. */\nexport const POST_MAX_VIDEOS = 5;\n\n/** Max duration of a single video in seconds (10 min). */\nexport const POST_MAX_VIDEO_SECONDS = 10 * 60;\n\n/** Per-image hard cap (15 MB). The file service compresses to fit. */\nexport const POST_MAX_IMAGE_BYTES = 15 * 1024 * 1024;\n\n/** Per-video hard cap (200 MB). */\nexport const POST_MAX_VIDEO_BYTES = 200 * 1024 * 1024;\n\n// ─── Text limits ────────────────────────────────────────────────────────────\n\n/** Post body character cap. Long enough for long-form, short enough to\n *  keep feed rendering snappy. */\nexport const POST_MAX_BODY_CHARS = 5000;\n\n/** Comment + reply body character cap. */\nexport const COMMENT_MAX_BODY_CHARS = 2000;\n\n/** Free-text bio on a public profile. */\nexport const PROFILE_MAX_BIO_CHARS = 280;\n\n// ─── Engagement ─────────────────────────────────────────────────────────────\n\n/** Window during which an author can edit their own post / comment, in ms. */\nexport const EDIT_GRACE_WINDOW_MS = 5 * 60 * 1000;\n\n// ─── Groups ─────────────────────────────────────────────────────────────────\n\n/** Max members in a single user-created group chat. */\nexport const GROUP_MAX_MEMBERS = 256;\n\n/** Group name length. */\nexport const GROUP_NAME_MAX_CHARS = 60;\nexport const GROUP_NAME_MIN_CHARS = 2;\n"]}

package/dist/engagement.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Engagement wire shapes — upvotes and reactions.
+ *
+ * Both are keyed by `(contentKind, contentId)` so the same engagement
+ * bar applies to every kind of feed item (post, lost-and-found,
+ * voice-box) and to comments.
+ *
+ * Per the product decision, upvote and reaction are TWO INDEPENDENT
+ * axes — a viewer can upvote AND react. Upvote drives feed sort;
+ * reaction is the expressive layer.
+ *
+ * @module community-schema/engagement
+ */
+import { z } from 'zod';
+/**
+ * What the client sends to `POST /api/v1/community/:contentKind/:id/upvote`.
+ * The endpoint is a toggle — calling it twice in a row removes the
+ * upvote. Idempotent: the server returns the post-toggle state.
+ */
+export declare const toggleUpvoteResponseSchema: z.ZodObject<{
+    contentKind: z.ZodEnum<{
+        post: "post";
+        lost_found: "lost_found";
+        voice_box: "voice_box";
+    }>;
+    contentId: z.ZodString;
+    upvoted: z.ZodBoolean;
+    upvoteCount: z.ZodNumber;
+}, z.core.$strip>;
+export type ToggleUpvoteResponse = z.infer<typeof toggleUpvoteResponseSchema>;
+/**
+ * What the client sends to `POST /api/v1/community/:contentKind/:id/reactions`.
+ *
+ * Setting `reaction` to a value replaces the user's current reaction
+ * (a user may have at most ONE active reaction per target).
+ * Setting `reaction` to null clears it.
+ */
+export declare const setReactionBodySchema: z.ZodObject<{
+    reaction: z.ZodNullable<z.ZodEnum<{
+        like: "like";
+        love: "love";
+        haha: "haha";
+        wow: "wow";
+        sad: "sad";
+        angry: "angry";
+        support: "support";
+    }>>;
+}, z.core.$strip>;
+export type SetReactionBody = z.infer<typeof setReactionBodySchema>;
+export declare const setReactionResponseSchema: z.ZodObject<{
+    contentKind: z.ZodEnum<{
+        post: "post";
+        lost_found: "lost_found";
+        voice_box: "voice_box";
+    }>;
+    contentId: z.ZodString;
+    reaction: z.ZodNullable<z.ZodEnum<{
+        like: "like";
+        love: "love";
+        haha: "haha";
+        wow: "wow";
+        sad: "sad";
+        angry: "angry";
+        support: "support";
+    }>>;
+    reactionCounts: z.ZodRecord<z.ZodString, z.ZodNumber>;
+}, z.core.$strip>;
+export type SetReactionResponse = z.infer<typeof setReactionResponseSchema>;
+//# sourceMappingURL=engagement.d.ts.map

package/dist/engagement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engagement.d.ts","sourceRoot":"","sources":["../src/engagement.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB;;;;GAIG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;iBAQrC,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAI9E;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;iBAEhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;iBAOpC,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC"}

package/dist/engagement.js

@@ -0,0 +1,50 @@
+/**
+ * Engagement wire shapes — upvotes and reactions.
+ *
+ * Both are keyed by `(contentKind, contentId)` so the same engagement
+ * bar applies to every kind of feed item (post, lost-and-found,
+ * voice-box) and to comments.
+ *
+ * Per the product decision, upvote and reaction are TWO INDEPENDENT
+ * axes — a viewer can upvote AND react. Upvote drives feed sort;
+ * reaction is the expressive layer.
+ *
+ * @module community-schema/engagement
+ */
+import { z } from 'zod';
+import { contentKindSchema, reactionTypeSchema } from './enums.js';
+// ─── Upvote ─────────────────────────────────────────────────────────────────
+/**
+ * What the client sends to `POST /api/v1/community/:contentKind/:id/upvote`.
+ * The endpoint is a toggle — calling it twice in a row removes the
+ * upvote. Idempotent: the server returns the post-toggle state.
+ */
+export const toggleUpvoteResponseSchema = z.object({
+    contentKind: contentKindSchema,
+    contentId: z.string(),
+    /** New upvote state for the calling user. */
+    upvoted: z.boolean(),
+    /** Post-toggle aggregate count, returned so the client can render
+     *  without a follow-up read. */
+    upvoteCount: z.number().int().nonnegative(),
+});
+// ─── Reaction ───────────────────────────────────────────────────────────────
+/**
+ * What the client sends to `POST /api/v1/community/:contentKind/:id/reactions`.
+ *
+ * Setting `reaction` to a value replaces the user's current reaction
+ * (a user may have at most ONE active reaction per target).
+ * Setting `reaction` to null clears it.
+ */
+export const setReactionBodySchema = z.object({
+    reaction: reactionTypeSchema.nullable(),
+});
+export const setReactionResponseSchema = z.object({
+    contentKind: contentKindSchema,
+    contentId: z.string(),
+    /** The viewer's new reaction, or null when cleared. */
+    reaction: reactionTypeSchema.nullable(),
+    /** Post-set aggregate counts, keyed by reaction type. */
+    reactionCounts: z.record(z.string(), z.number().int().nonnegative()),
+});
+//# sourceMappingURL=engagement.js.map

package/dist/engagement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engagement.js","sourceRoot":"","sources":["../src/engagement.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEnE,+EAA+E;AAE/E;;;;GAIG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,WAAW,EAAE,iBAAiB;IAC9B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,6CAA6C;IAC7C,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB;oCACgC;IAChC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;CAC5C,CAAC,CAAC;AAGH,+EAA+E;AAE/E;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,QAAQ,EAAE,kBAAkB,CAAC,QAAQ,EAAE;CACxC,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,WAAW,EAAE,iBAAiB;IAC9B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,uDAAuD;IACvD,QAAQ,EAAE,kBAAkB,CAAC,QAAQ,EAAE;IACvC,yDAAyD;IACzD,cAAc,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC;CACrE,CAAC,CAAC","sourcesContent":["/**\n * Engagement wire shapes — upvotes and reactions.\n *\n * Both are keyed by `(contentKind, contentId)` so the same engagement\n * bar applies to every kind of feed item (post, lost-and-found,\n * voice-box) and to comments.\n *\n * Per the product decision, upvote and reaction are TWO INDEPENDENT\n * axes — a viewer can upvote AND react. Upvote drives feed sort;\n * reaction is the expressive layer.\n *\n * @module community-schema/engagement\n */\n\nimport { z } from 'zod';\nimport { contentKindSchema, reactionTypeSchema } from './enums.js';\n\n// ─── Upvote ─────────────────────────────────────────────────────────────────\n\n/**\n * What the client sends to `POST /api/v1/community/:contentKind/:id/upvote`.\n * The endpoint is a toggle — calling it twice in a row removes the\n * upvote. Idempotent: the server returns the post-toggle state.\n */\nexport const toggleUpvoteResponseSchema = z.object({\n  contentKind: contentKindSchema,\n  contentId: z.string(),\n  /** New upvote state for the calling user. */\n  upvoted: z.boolean(),\n  /** Post-toggle aggregate count, returned so the client can render\n   *  without a follow-up read. */\n  upvoteCount: z.number().int().nonnegative(),\n});\nexport type ToggleUpvoteResponse = z.infer<typeof toggleUpvoteResponseSchema>;\n\n// ─── Reaction ───────────────────────────────────────────────────────────────\n\n/**\n * What the client sends to `POST /api/v1/community/:contentKind/:id/reactions`.\n *\n * Setting `reaction` to a value replaces the user's current reaction\n * (a user may have at most ONE active reaction per target).\n * Setting `reaction` to null clears it.\n */\nexport const setReactionBodySchema = z.object({\n  reaction: reactionTypeSchema.nullable(),\n});\nexport type SetReactionBody = z.infer<typeof setReactionBodySchema>;\n\nexport const setReactionResponseSchema = z.object({\n  contentKind: contentKindSchema,\n  contentId: z.string(),\n  /** The viewer's new reaction, or null when cleared. */\n  reaction: reactionTypeSchema.nullable(),\n  /** Post-set aggregate counts, keyed by reaction type. */\n  reactionCounts: z.record(z.string(), z.number().int().nonnegative()),\n});\nexport type SetReactionResponse = z.infer<typeof setReactionResponseSchema>;\n"]}