@rocapine/community-core 0.3.0 → 0.5.0

package/README.md

@@ -73,14 +73,14 @@ backend configured — the pattern `examples/expo-app` uses when
 
 All optional, all default to a no-op:
 
-| Field                | Signature                                                | Purpose                                                                                                                                                                               |
-| -------------------- | -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `getDisplayName`     | `() => string \| null`                                   | Feeds the display name shown for the current user before their community username is set                                                                                              |
-| `getAnalyticsIds`    | `() => { amplitudeId?: string; revenuecatId?: string }`  | Cross-referencing ids attached where the host wants them                                                                                                                              |
-| `onEvent`            | `(name: string, props: Record<string, unknown>) => void` | **The only analytics seam.** Every product event goes through this; the SDK never depends on any analytics provider. Never throws through to the UI even if the adapter itself throws |
-| `rulesAcceptance`    | `{ get(): Promise<boolean>; set(): Promise<void> }`      | Persists whether the user has accepted the one-time community guidelines sheet                                                                                                        |
-| `onContentPublished` | `() => void`                                             | Fired after a post/comment is successfully published (e.g. to arm a review-gate)                                                                                                      |
-| `getLocale`          | `() => string`                                           | Selects which locale-specific behavior the _host_ wants (distinct from the UI package's own `translations.locale` prop)                                                               |
+| Field                | Signature                                                | Purpose                                                                                                                                                                                                                                                                                                             |
+| -------------------- | -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `getDisplayName`     | `() => string \| null`                                   | Feeds the display name shown for the current user before their community username is set                                                                                                                                                                                                                            |
+| `getAnalyticsIds`    | `() => { amplitudeId?: string; revenuecatId?: string }`  | Cross-referencing ids attached where the host wants them                                                                                                                                                                                                                                                            |
+| `onEvent`            | `(name: string, props: Record<string, unknown>) => void` | **The only analytics seam.** Every product event goes through this; the SDK never depends on any analytics provider. Never throws through to the UI even if the adapter itself throws                                                                                                                               |
+| `rulesAcceptance`    | `{ get(): Promise<boolean>; set(): Promise<void> }`      | Persists whether the user has accepted the one-time community guidelines sheet                                                                                                                                                                                                                                      |
+| `onContentPublished` | `() => void`                                             | Fired after a post/comment is successfully published (e.g. to arm a review-gate)                                                                                                                                                                                                                                    |
+| `getLocale`          | `() => string`                                           | The app's language. Resolved against `modules.translation.locales` to choose the language content is read in (`readerLocale`), and mirrored to `profiles.locale` by `syncProfileFromHost` so pushes arrive in each recipient's language. Distinct from the UI package's `translations.locale` prop (interface copy) |
 
 ### Feed row extension point (`CommunityConfig.feed`)
 

package/lib/hooks.d.ts

@@ -1,6 +1,21 @@
-import { type InfiniteData } from "@tanstack/react-query";
+import { type InfiniteData, type QueryClient } from "@tanstack/react-query";
 import { type CommunityProfile, type FeedPost, type ThreadComment } from "./models";
 import { type ModerationVerdict, type ReportInput, type UpdateProfileInput, type UpdateProfileResult } from "./service";
+/** True while a post/comment is still the optimistic placeholder inserted by
+ * `useCreatePost`/`useCreateComment` (its temp id is swapped for the real one
+ * once moderation answers). Server actions keyed on the id (reactions, likes,
+ * votes) must wait until this is false. */
+export declare function isOptimistic(item: {
+    id: string;
+}): boolean;
+/** Our own author fields for an optimistic row, read from the query cache
+ * (`useMyUid` + `useProfile`), so the placeholder links to our profile and
+ * shows our avatar instead of an empty author until the next refetch. */
+export declare function ownAuthorFields(queryClient: QueryClient): {
+    authorId: string;
+    authorHandle: string | null;
+    authorAvatarUrl: string | null;
+};
 type PostCacheEntry = [readonly unknown[], InfiniteData<FeedPost[]> | undefined];
 /**
  * Snapshot of every post-holding cache, for optimistic-update rollback on

package/lib/hooks.js

@@ -10,6 +10,8 @@
 // `applyReaction`) and unseen-count hook (parameterized on `lastSeenAtIso` instead of
 // reading that host's own store). No React Native / analytics-SDK / store imports here.
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.isOptimistic = isOptimistic;
+exports.ownAuthorFields = ownAuthorFields;
 exports.useCommunityFeed = useCommunityFeed;
 exports.useSearchPosts = useSearchPosts;
 exports.useNewPostsCount = useNewPostsCount;
@@ -30,17 +32,32 @@ exports.useDeleteContent = useDeleteContent;
 const react_query_1 = require("@tanstack/react-query");
 const events_1 = require("./events");
 const identity_1 = require("./identity");
+const keys_1 = require("./keys");
 const locale_1 = require("./locale");
 const models_1 = require("./models");
 const provider_1 = require("./provider");
 const service_1 = require("./service");
-const FEED_KEY = ["community", "feed"];
-const feedKey = (topic, locale) => [...FEED_KEY, topic ?? "all", locale ?? "src"];
-const threadKey = (postId, locale) => ["community", "thread", postId, locale ?? "src"];
 const profileKey = (userId) => ["community", "profile", userId];
-const USER_POSTS_KEY = ["community", "userPosts"];
-const userPostsKey = (userId, locale) => [...USER_POSTS_KEY, userId, locale ?? "src"];
-const SEARCH_KEY = ["community", "search"];
+const MY_UID_KEY = ["community", "myUid"];
+/** True while a post/comment is still the optimistic placeholder inserted by
+ * `useCreatePost`/`useCreateComment` (its temp id is swapped for the real one
+ * once moderation answers). Server actions keyed on the id (reactions, likes,
+ * votes) must wait until this is false. */
+function isOptimistic(item) {
+    return item.id.startsWith("optimistic-");
+}
+/** Our own author fields for an optimistic row, read from the query cache
+ * (`useMyUid` + `useProfile`), so the placeholder links to our profile and
+ * shows our avatar instead of an empty author until the next refetch. */
+function ownAuthorFields(queryClient) {
+    const uid = queryClient.getQueryData(MY_UID_KEY) ?? "";
+    const profile = uid ? queryClient.getQueryData(profileKey(uid)) : undefined;
+    return {
+        authorId: uid,
+        authorHandle: profile?.handle ?? null,
+        authorAvatarUrl: profile?.avatarUrl ?? null,
+    };
+}
 /**
  * Adjust a post's commentCount across every cached feed page (all topic
  * filters). The feed is never refetched after commenting (kept smooth), so the
@@ -49,7 +66,7 @@ const SEARCH_KEY = ["community", "search"];
  * change is not reflected in the user-posts/search caches, same as upstream.
  */
 function bumpFeedCommentCount(queryClient, postId, delta) {
-    queryClient.setQueriesData({ queryKey: FEED_KEY }, (data) => data
+    queryClient.setQueriesData({ queryKey: keys_1.FEED_KEY }, (data) => data
         ? {
             ...data,
             pages: data.pages.map((page) => page.map((post) => post.id === postId
@@ -68,19 +85,19 @@ function bumpFeedCommentCount(queryClient, postId, delta) {
  */
 async function applyOptimisticToAllPostCaches(queryClient, mapPost) {
     await Promise.all([
-        queryClient.cancelQueries({ queryKey: FEED_KEY }),
-        queryClient.cancelQueries({ queryKey: USER_POSTS_KEY }),
-        queryClient.cancelQueries({ queryKey: SEARCH_KEY }),
+        queryClient.cancelQueries({ queryKey: keys_1.FEED_KEY }),
+        queryClient.cancelQueries({ queryKey: keys_1.USER_POSTS_KEY }),
+        queryClient.cancelQueries({ queryKey: keys_1.SEARCH_KEY }),
     ]);
     const entries = [
-        ...queryClient.getQueriesData({ queryKey: FEED_KEY }),
-        ...queryClient.getQueriesData({ queryKey: USER_POSTS_KEY }),
-        ...queryClient.getQueriesData({ queryKey: SEARCH_KEY }),
+        ...queryClient.getQueriesData({ queryKey: keys_1.FEED_KEY }),
+        ...queryClient.getQueriesData({ queryKey: keys_1.USER_POSTS_KEY }),
+        ...queryClient.getQueriesData({ queryKey: keys_1.SEARCH_KEY }),
     ];
     const applyToPages = (data) => data ? { ...data, pages: data.pages.map((page) => page.map(mapPost)) } : data;
-    queryClient.setQueriesData({ queryKey: FEED_KEY }, applyToPages);
-    queryClient.setQueriesData({ queryKey: USER_POSTS_KEY }, applyToPages);
-    queryClient.setQueriesData({ queryKey: SEARCH_KEY }, applyToPages);
+    queryClient.setQueriesData({ queryKey: keys_1.FEED_KEY }, applyToPages);
+    queryClient.setQueriesData({ queryKey: keys_1.USER_POSTS_KEY }, applyToPages);
+    queryClient.setQueriesData({ queryKey: keys_1.SEARCH_KEY }, applyToPages);
     return { entries };
 }
 function rollbackPostCaches(queryClient, snapshot) {
@@ -97,7 +114,7 @@ function useCommunityFeed(topic, enabled = true) {
     const cfg = (0, provider_1.useCommunityConfig)();
     const locale = (0, locale_1.readerLocale)(cfg);
     return (0, react_query_1.useInfiniteQuery)({
-        queryKey: feedKey(topic, locale),
+        queryKey: (0, keys_1.feedKey)(topic, locale),
         queryFn: ({ pageParam }) => (0, service_1.fetchFeedPage)(cfg, { topic, cursor: pageParam }),
         initialPageParam: 0,
         getNextPageParam: (lastPage, pages) => lastPage.length === models_1.FEED_PAGE_SIZE ? pages.length : undefined,
@@ -115,7 +132,7 @@ function useSearchPosts(term) {
     const cleaned = term.trim();
     const locale = (0, locale_1.readerLocale)(cfg);
     return (0, react_query_1.useInfiniteQuery)({
-        queryKey: [...SEARCH_KEY, cleaned, locale ?? "src"],
+        queryKey: (0, keys_1.searchKey)(cleaned, locale),
         queryFn: ({ pageParam }) => (0, service_1.searchPosts)(cfg, cleaned, { cursor: pageParam }),
         initialPageParam: 0,
         getNextPageParam: (lastPage, pages) => lastPage.length === models_1.FEED_PAGE_SIZE ? pages.length : undefined,
@@ -168,7 +185,7 @@ function useThread(postId) {
     const cfg = (0, provider_1.useCommunityConfig)();
     const locale = (0, locale_1.readerLocale)(cfg);
     return (0, react_query_1.useQuery)({
-        queryKey: threadKey(postId ?? "none", locale),
+        queryKey: (0, keys_1.threadKey)(postId ?? "none", locale),
         queryFn: () => (0, service_1.fetchThread)(cfg, postId),
         enabled: cfg.supabase !== null && !!postId,
         staleTime: 1000 * 15,
@@ -192,7 +209,7 @@ function useUserPosts(userId) {
     const cfg = (0, provider_1.useCommunityConfig)();
     const locale = (0, locale_1.readerLocale)(cfg);
     return (0, react_query_1.useInfiniteQuery)({
-        queryKey: userPostsKey(userId ?? "none", locale),
+        queryKey: (0, keys_1.userPostsKey)(userId ?? "none", locale),
         queryFn: ({ pageParam }) => (0, service_1.fetchUserPosts)(cfg, userId, { cursor: pageParam }),
         initialPageParam: 0,
         getNextPageParam: (lastPage, pages) => lastPage.length === models_1.FEED_PAGE_SIZE ? pages.length : undefined,
@@ -205,7 +222,7 @@ function useUserPosts(userId) {
 function useMyUid() {
     const cfg = (0, provider_1.useCommunityConfig)();
     const q = (0, react_query_1.useQuery)({
-        queryKey: ["community", "myUid"],
+        queryKey: MY_UID_KEY,
         queryFn: () => (0, identity_1.ensureIdentity)(cfg),
         enabled: cfg.supabase !== null,
         staleTime: Infinity,
@@ -243,15 +260,13 @@ function useCreatePost() {
     const locale = (0, locale_1.readerLocale)(cfg);
     return (0, react_query_1.useMutation)({
         onMutate: async ({ topic, text, authorName, pollOptions }) => {
-            await queryClient.cancelQueries({ queryKey: FEED_KEY });
+            await queryClient.cancelQueries({ queryKey: keys_1.FEED_KEY });
             const tempId = `optimistic-${Date.now()}`;
             const optimistic = {
                 id: tempId,
-                authorId: "",
                 authorName,
                 authorOfficial: false,
-                authorHandle: null,
-                authorAvatarUrl: null,
+                ...ownAuthorFields(queryClient),
                 topic,
                 text,
                 status: "visible",
@@ -281,8 +296,8 @@ function useCreatePost() {
                 translation: null,
             };
             const prepend = (key) => queryClient.setQueryData(key, (d) => d ? { ...d, pages: [[optimistic, ...(d.pages[0] ?? [])], ...d.pages.slice(1)] } : d);
-            prepend(feedKey(undefined, locale));
-            prepend(feedKey(topic, locale));
+            prepend((0, keys_1.feedKey)(undefined, locale));
+            prepend((0, keys_1.feedKey)(topic, locale));
             return { tempId };
         },
         mutationFn: async ({ topic, text, pollOptions }) => {
@@ -292,7 +307,7 @@ function useCreatePost() {
         },
         onSuccess: ({ id, verdict }, { topic, text, pollOptions }, { tempId }) => {
             const rejected = verdict.status === "rejected";
-            queryClient.setQueriesData({ queryKey: FEED_KEY }, (d) => d
+            queryClient.setQueriesData({ queryKey: keys_1.FEED_KEY }, (d) => d
                 ? {
                     ...d,
                     pages: d.pages.map((p) => rejected
@@ -311,11 +326,11 @@ function useCreatePost() {
                 // The in-place swap above keeps the optimistic poll's temp option ids;
                 // voting needs the real uuids, so a poll post refetches in background.
                 if (hasPoll)
-                    queryClient.invalidateQueries({ queryKey: FEED_KEY });
+                    queryClient.invalidateQueries({ queryKey: keys_1.FEED_KEY });
             }
         },
         onError: (_e, _v, context) => {
-            queryClient.setQueriesData({ queryKey: FEED_KEY }, (d) => d
+            queryClient.setQueriesData({ queryKey: keys_1.FEED_KEY }, (d) => d
                 ? { ...d, pages: d.pages.map((p) => p.filter((post) => post.id !== context?.tempId)) }
                 : d);
         },
@@ -328,23 +343,21 @@ function useCreateComment() {
     const locale = (0, locale_1.readerLocale)(cfg);
     return (0, react_query_1.useMutation)({
         onMutate: async ({ postId, text, authorName }) => {
-            await queryClient.cancelQueries({ queryKey: threadKey(postId, locale) });
-            await queryClient.cancelQueries({ queryKey: FEED_KEY });
+            await queryClient.cancelQueries({ queryKey: (0, keys_1.threadKey)(postId, locale) });
+            await queryClient.cancelQueries({ queryKey: keys_1.FEED_KEY });
             const tempId = `optimistic-${Date.now()}`;
             const optimistic = {
                 id: tempId,
                 postId,
-                authorId: "",
                 authorName,
                 authorOfficial: false,
-                authorHandle: null,
-                authorAvatarUrl: null,
+                ...ownAuthorFields(queryClient),
                 text,
                 isOwn: true,
                 createdAt: new Date().toISOString(),
                 translation: null,
             };
-            queryClient.setQueryData(threadKey(postId, locale), (d) => [
+            queryClient.setQueryData((0, keys_1.threadKey)(postId, locale), (d) => [
                 ...(d ?? []),
                 optimistic,
             ]);
@@ -358,7 +371,7 @@ function useCreateComment() {
         },
         onSuccess: ({ id, verdict }, { postId, text }, { tempId }) => {
             const rejected = verdict.status === "rejected";
-            queryClient.setQueryData(threadKey(postId, locale), (d) => (d ?? [])
+            queryClient.setQueryData((0, keys_1.threadKey)(postId, locale), (d) => (d ?? [])
                 .filter((c) => !(rejected && c.id === tempId))
                 .map((c) => (c.id === tempId ? { ...c, id } : c)));
             // A rejected comment never becomes visible, so undo the optimistic bump.
@@ -373,7 +386,7 @@ function useCreateComment() {
             }
         },
         onError: (_e, { postId }, context) => {
-            queryClient.setQueryData(threadKey(postId, locale), (d) => (d ?? []).filter((c) => c.id !== context?.tempId));
+            queryClient.setQueryData((0, keys_1.threadKey)(postId, locale), (d) => (d ?? []).filter((c) => c.id !== context?.tempId));
             bumpFeedCommentCount(queryClient, postId, -1);
         },
     });
@@ -492,10 +505,10 @@ function useDeleteContent() {
         mutationFn: ({ kind, id }) => kind === "post" ? (0, service_1.deleteOwnPost)(cfg, id) : (0, service_1.deleteOwnComment)(cfg, id),
         onSuccess: (_data, { kind, postId }) => {
             (0, events_1.emitEvent)(cfg, events_1.COMMUNITY_EVENTS.contentDeleted, { contentType: kind });
-            queryClient.invalidateQueries({ queryKey: threadKey(postId, locale) });
-            queryClient.invalidateQueries({ queryKey: FEED_KEY });
-            queryClient.invalidateQueries({ queryKey: USER_POSTS_KEY });
-            queryClient.invalidateQueries({ queryKey: SEARCH_KEY });
+            queryClient.invalidateQueries({ queryKey: (0, keys_1.threadKey)(postId, locale) });
+            queryClient.invalidateQueries({ queryKey: keys_1.FEED_KEY });
+            queryClient.invalidateQueries({ queryKey: keys_1.USER_POSTS_KEY });
+            queryClient.invalidateQueries({ queryKey: keys_1.SEARCH_KEY });
         },
     });
 }

package/lib/index.d.ts

@@ -11,7 +11,7 @@ export type { CommunityEventName } from "./events";
 export { ensureIdentity, resetIdentity, syncProfileFromHost } from "./identity";
 export { buildFeedSelect, fetchFeedPage, countNewPosts, fetchProfile, fetchUserPosts, searchPosts, fetchThread, createPost, votePoll, createComment, moderateOne, setLike, setReaction, fetchReactionSummaries, reportContent, blockUser, deleteOwnPost, deleteOwnComment, updateProfile, uploadAvatar, } from "./service";
 export type { ModerationVerdict, CreatePostInput, ReportReason, ReportInput, UpdateProfileInput, UpdateProfileResult, } from "./service";
-export { useCommunityFeed, useSearchPosts, useNewPostsCount, useCommunityUnseenCount, useThread, useProfile, useUserPosts, useMyUid, useUpdateProfile, useCreatePost, useCreateComment, useToggleLike, useVotePoll, useReactToPost, useReport, useBlockUser, useDeleteContent, } from "./hooks";
+export { useCommunityFeed, useSearchPosts, useNewPostsCount, useCommunityUnseenCount, useThread, useProfile, useUserPosts, useMyUid, useUpdateProfile, useCreatePost, useCreateComment, useToggleLike, useVotePoll, useReactToPost, useReport, useBlockUser, useDeleteContent, isOptimistic, } from "./hooks";
 export { fetchInbox, localizeExcerpts, markInboxSeen, unreadCount } from "./inbox-service";
 export type { InboxItem, InboxState } from "./inbox-service";
 export { useNotificationInbox, useUnreadNotificationCount, useMarkInboxSeen } from "./inbox-hooks";

package/lib/index.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.deleteOwnComment = exports.deleteOwnPost = exports.blockUser = exports.reportContent = exports.fetchReactionSummaries = exports.setReaction = exports.setLike = exports.moderateOne = exports.createComment = exports.votePoll = exports.createPost = exports.fetchThread = exports.searchPosts = exports.fetchUserPosts = exports.fetchProfile = exports.countNewPosts = exports.fetchFeedPage = exports.buildFeedSelect = exports.syncProfileFromHost = exports.resetIdentity = exports.ensureIdentity = exports.emitEvent = exports.COMMUNITY_EVENTS = exports.timeAgoParts = exports.timeAgo = exports.newestCreatedAt = exports.newPostsLabel = exports.mapCommentRow = exports.applyReaction = exports.applyPollVote = exports.mapPostRow = exports.pollPercent = exports.buildPoll = exports.mapProfileRow = exports.normalizeTopic = exports.displayName = exports.EMPTY_REACTION_DATA = exports.EMPTY_POLL_DATA = exports.POLL_OPTION_MAX_LENGTH = exports.POLL_MAX_OPTIONS = exports.POLL_MIN_OPTIONS = exports.COMMENT_MAX_LENGTH = exports.POST_MAX_LENGTH = exports.FEED_PAGE_SIZE = exports.useCommunityConfig = exports.CommunityProvider = exports.languageOf = exports.readerLocale = exports.resolveConfig = exports.CommunityDisabledError = void 0;
-exports.REQUIRED_SCHEMA_VERSION = exports.useMarkInboxSeen = exports.useUnreadNotificationCount = exports.useNotificationInbox = exports.unreadCount = exports.markInboxSeen = exports.localizeExcerpts = exports.fetchInbox = exports.useDeleteContent = exports.useBlockUser = exports.useReport = exports.useReactToPost = exports.useVotePoll = exports.useToggleLike = exports.useCreateComment = exports.useCreatePost = exports.useUpdateProfile = exports.useMyUid = exports.useUserPosts = exports.useProfile = exports.useThread = exports.useCommunityUnseenCount = exports.useNewPostsCount = exports.useSearchPosts = exports.useCommunityFeed = exports.uploadAvatar = exports.updateProfile = void 0;
+exports.REQUIRED_SCHEMA_VERSION = exports.useMarkInboxSeen = exports.useUnreadNotificationCount = exports.useNotificationInbox = exports.unreadCount = exports.markInboxSeen = exports.localizeExcerpts = exports.fetchInbox = exports.isOptimistic = exports.useDeleteContent = exports.useBlockUser = exports.useReport = exports.useReactToPost = exports.useVotePoll = exports.useToggleLike = exports.useCreateComment = exports.useCreatePost = exports.useUpdateProfile = exports.useMyUid = exports.useUserPosts = exports.useProfile = exports.useThread = exports.useCommunityUnseenCount = exports.useNewPostsCount = exports.useSearchPosts = exports.useCommunityFeed = exports.uploadAvatar = exports.updateProfile = void 0;
 var config_1 = require("./config");
 Object.defineProperty(exports, "CommunityDisabledError", { enumerable: true, get: function () { return config_1.CommunityDisabledError; } });
 Object.defineProperty(exports, "resolveConfig", { enumerable: true, get: function () { return config_1.resolveConfig; } });
@@ -80,6 +80,7 @@ Object.defineProperty(exports, "useReactToPost", { enumerable: true, get: functi
 Object.defineProperty(exports, "useReport", { enumerable: true, get: function () { return hooks_1.useReport; } });
 Object.defineProperty(exports, "useBlockUser", { enumerable: true, get: function () { return hooks_1.useBlockUser; } });
 Object.defineProperty(exports, "useDeleteContent", { enumerable: true, get: function () { return hooks_1.useDeleteContent; } });
+Object.defineProperty(exports, "isOptimistic", { enumerable: true, get: function () { return hooks_1.isOptimistic; } });
 var inbox_service_1 = require("./inbox-service");
 Object.defineProperty(exports, "fetchInbox", { enumerable: true, get: function () { return inbox_service_1.fetchInbox; } });
 Object.defineProperty(exports, "localizeExcerpts", { enumerable: true, get: function () { return inbox_service_1.localizeExcerpts; } });

package/lib/keys.d.ts

@@ -0,0 +1,7 @@
+export declare const FEED_KEY: readonly ["community", "feed"];
+export declare const feedKey: (topic?: string, locale?: string | null) => readonly ["community", "feed", string, string];
+export declare const threadKey: (postId: string, locale?: string | null) => readonly ["community", "thread", string, string];
+export declare const USER_POSTS_KEY: readonly ["community", "userPosts"];
+export declare const userPostsKey: (userId: string, locale?: string | null) => readonly ["community", "userPosts", string, string];
+export declare const SEARCH_KEY: readonly ["community", "search"];
+export declare const searchKey: (cleaned: string, locale?: string | null) => readonly ["community", "search", string, string];

package/lib/keys.js

@@ -0,0 +1,18 @@
+"use strict";
+// React Query keys (internal, not exported from the package). Every full key
+// ends with the reader locale ("src" = originals) so switching locale never
+// serves another locale's cached translations; the *_KEY prefixes stay
+// prefixes of the full keys so setQueriesData/invalidateQueries match them all.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.searchKey = exports.SEARCH_KEY = exports.userPostsKey = exports.USER_POSTS_KEY = exports.threadKey = exports.feedKey = exports.FEED_KEY = void 0;
+exports.FEED_KEY = ["community", "feed"];
+const feedKey = (topic, locale) => [...exports.FEED_KEY, topic ?? "all", locale ?? "src"];
+exports.feedKey = feedKey;
+const threadKey = (postId, locale) => ["community", "thread", postId, locale ?? "src"];
+exports.threadKey = threadKey;
+exports.USER_POSTS_KEY = ["community", "userPosts"];
+const userPostsKey = (userId, locale) => [...exports.USER_POSTS_KEY, userId, locale ?? "src"];
+exports.userPostsKey = userPostsKey;
+exports.SEARCH_KEY = ["community", "search"];
+const searchKey = (cleaned, locale) => [...exports.SEARCH_KEY, cleaned, locale ?? "src"];
+exports.searchKey = searchKey;

package/lib/service.d.ts

@@ -6,6 +6,15 @@ import { type CommunityProfile, type FeedPost, type ReactionData, type ThreadCom
  * names are dropped with a `console.warn` rather than failing the query.
  */
 export declare function buildFeedSelect(extraPostColumns?: readonly string[], polls?: boolean, translations?: boolean): string;
+/** Embedded-resource filters: keep only the reader locale's translation rows,
+ * so `rows?.[0]` in the mappers is always that locale, never some other
+ * locale's leftover row. PostgREST accepts dotted paths for nested embeds,
+ * the same mechanism as the existing `.eq("comments.status", "visible")`. A
+ * no-op (module off / no resolved locale) leaves the query, and therefore
+ * every byte of it, unchanged from before translations existed. */
+export declare function withTranslationFilters<Q extends {
+    eq(column: string, value: string): Q;
+}>(query: Q, cfg: ResolvedCommunityConfig): Q;
 /**
  * Batched reaction state for one page: count + last reactor's display name + my-reaction
  * flag, all from the single security-definer `post_reaction_summary` RPC (the backend
@@ -49,6 +58,9 @@ export declare function fetchUserPosts(cfg: ResolvedCommunityConfig, userId: str
 export declare function searchPosts(cfg: ResolvedCommunityConfig, searchTerm: string, opts?: {
     cursor?: number;
 }): Promise<FeedPost[]>;
+/** The thread (comments) select: + the translation embed iff the reader has a
+ * resolved translation locale. */
+export declare function threadSelect(cfg: ResolvedCommunityConfig): string;
 /**
  * Note: `cfg.feed.extraPostColumns`/`transformPost` do NOT apply here — this
  * queries `comments`, not `posts` (the thread's parent post is passed in by

package/lib/service.js

@@ -9,12 +9,14 @@
 // generalized from that host's prayer-style feature's summary RPC into `post_reaction_summary`).
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.buildFeedSelect = buildFeedSelect;
+exports.withTranslationFilters = withTranslationFilters;
 exports.fetchReactionSummaries = fetchReactionSummaries;
 exports.fetchFeedPage = fetchFeedPage;
 exports.countNewPosts = countNewPosts;
 exports.fetchProfile = fetchProfile;
 exports.fetchUserPosts = fetchUserPosts;
 exports.searchPosts = searchPosts;
+exports.threadSelect = threadSelect;
 exports.fetchThread = fetchThread;
 exports.createPost = createPost;
 exports.votePoll = votePoll;
@@ -299,6 +301,11 @@ async function searchPosts(cfg, searchTerm, opts = {}) {
         throw error;
     return toFeedPosts(cfg, client, (data ?? []), uid);
 }
+/** The thread (comments) select: + the translation embed iff the reader has a
+ * resolved translation locale. */
+function threadSelect(cfg) {
+    return (0, locale_1.readerLocale)(cfg) ? `${COMMENTS_SELECT}, ${COMMENT_TRANSLATIONS_SELECT}` : COMMENTS_SELECT;
+}
 /**
  * Note: `cfg.feed.extraPostColumns`/`transformPost` do NOT apply here — this
  * queries `comments`, not `posts` (the thread's parent post is passed in by
@@ -309,10 +316,9 @@ async function fetchThread(cfg, postId) {
     const client = cfg.requireClient();
     const uid = await requireUid(cfg);
     const locale = (0, locale_1.readerLocale)(cfg);
-    const select = locale ? `${COMMENTS_SELECT}, ${COMMENT_TRANSLATIONS_SELECT}` : COMMENTS_SELECT;
     let query = client
         .from("comments")
-        .select(select)
+        .select(threadSelect(cfg))
         .eq("post_id", postId)
         .in("status", ["visible", "pending"])
         .order("created_at", { ascending: true });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rocapine/community-core",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "Headless Supabase-backed community backend: identity, feed/thread/moderation services, and React Query hooks.",
   "license": "MIT",
   "repository": {