@rocapine/community-core 0.8.0 → 0.9.0

package/README.md

@@ -175,7 +175,8 @@ runs in production and is silent in degraded mode.
   (pure helper behind `feed.extraPostColumns`, see below).
 - **React Query hooks** (`hooks.ts`): `useCommunityFeed`, `useSearchPosts`,
   `useNewPostsCount`, `useCommunityUnseenCount`, `useThread`, `useProfile`,
-  `useUserPosts`, `useMyUid`, `useUpdateProfile`, `useCreatePost`,
+  `useUserPosts`, `useMyUid`, `useNotificationPreferences` (push module: the
+  caller's `notify_*` flags), `useUpdateProfile`, `useCreatePost`,
   `useCreateComment`, `useToggleLike`, `useVotePoll`, `useReactToPost`,
   `useReport`, `useBlockUser`, `useDeleteContent`.
 - **Inbox** (opt-in via `modules.inbox`): `fetchInbox`, `markInboxSeen`,

package/lib/hooks.d.ts

@@ -1,6 +1,6 @@
 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";
+import { type NotificationPreferenceKey, type NotificationPreferences, 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,
@@ -54,14 +54,23 @@ export declare function useNewPostsCount(sinceIso: string | null, topic?: string
  * package has no store access at all, so the host now owns that value and
  * passes it in).
  */
-export declare function useCommunityUnseenCount(lastSeenAtIso: string | null): number;
+export declare function useCommunityUnseenCount(lastSeenAtIso: string | null, options?: {
+    enabled?: boolean;
+}): number;
 export declare function useThread(postId: string | null): import("@tanstack/react-query").UseQueryResult<ThreadComment[], Error>;
 export declare function useProfile(userId: string | null): import("@tanstack/react-query").UseQueryResult<CommunityProfile, Error>;
 /**
  * One user's posts, newest first, infinite-scrolling like the feed.
  */
 export declare function useUserPosts(userId: string | null): import("@tanstack/react-query").UseInfiniteQueryResult<InfiniteData<FeedPost[], unknown>, Error>;
-/** Our own stable community uid, resolved once and cached for the app session. */
+/** The caller's push preferences (push module). `preferences` is `null` until the
+ * device has a push row; `setPreference` updates one flag optimistically. */
+export declare function useNotificationPreferences(): {
+    preferences: NotificationPreferences | null;
+    isLoading: boolean;
+    refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<NotificationPreferences | null, Error>>;
+    setPreference: (key: NotificationPreferenceKey, enabled: boolean) => Promise<void>;
+};
 export declare function useMyUid(): string | null;
 /** Profile edits refresh everything derived from a profile row: the profile
  * itself, plus the handle/avatar shown on every cached feed and thread. */

package/lib/hooks.js

@@ -19,6 +19,7 @@ exports.useCommunityUnseenCount = useCommunityUnseenCount;
 exports.useThread = useThread;
 exports.useProfile = useProfile;
 exports.useUserPosts = useUserPosts;
+exports.useNotificationPreferences = useNotificationPreferences;
 exports.useMyUid = useMyUid;
 exports.useUpdateProfile = useUpdateProfile;
 exports.useCreatePost = useCreatePost;
@@ -168,12 +169,13 @@ function useNewPostsCount(sinceIso, topic, polling = true) {
  * package has no store access at all, so the host now owns that value and
  * passes it in).
  */
-function useCommunityUnseenCount(lastSeenAtIso) {
+function useCommunityUnseenCount(lastSeenAtIso, options = {}) {
     const cfg = (0, provider_1.useCommunityConfig)();
     const q = (0, react_query_1.useQuery)({
         queryKey: ["community", "unseen", lastSeenAtIso ?? "never"],
         queryFn: () => (0, service_1.countNewPosts)(cfg, lastSeenAtIso ?? "1970-01-01T00:00:00Z"),
-        enabled: cfg.supabase !== null,
+        // `enabled: false` keeps a host's kill-switch arm from creating the identity or polling.
+        enabled: cfg.supabase !== null && options.enabled !== false,
         staleTime: 1000 * 60,
         refetchInterval: 1000 * 120,
         refetchIntervalInBackground: false,
@@ -219,6 +221,40 @@ function useUserPosts(userId) {
     });
 }
 /** Our own stable community uid, resolved once and cached for the app session. */
+const NOTIFICATION_PREFS_KEY = ["community", "notificationPreferences"];
+/** The caller's push preferences (push module). `preferences` is `null` until the
+ * device has a push row; `setPreference` updates one flag optimistically. */
+function useNotificationPreferences() {
+    const cfg = (0, provider_1.useCommunityConfig)();
+    const queryClient = (0, react_query_1.useQueryClient)();
+    const q = (0, react_query_1.useQuery)({
+        queryKey: NOTIFICATION_PREFS_KEY,
+        queryFn: () => (0, service_1.fetchNotificationPreferences)(cfg),
+        enabled: cfg.supabase !== null && cfg.modules.push,
+        staleTime: 1000 * 60,
+    });
+    const mutation = (0, react_query_1.useMutation)({
+        mutationFn: ({ key, enabled }) => (0, service_1.setNotificationPreference)(cfg, key, enabled),
+        onMutate: async ({ key, enabled }) => {
+            await queryClient.cancelQueries({ queryKey: NOTIFICATION_PREFS_KEY });
+            const previous = queryClient.getQueryData(NOTIFICATION_PREFS_KEY);
+            if (previous)
+                queryClient.setQueryData(NOTIFICATION_PREFS_KEY, { ...previous, [key]: enabled });
+            return { previous };
+        },
+        onError: (_error, _vars, context) => {
+            if (context)
+                queryClient.setQueryData(NOTIFICATION_PREFS_KEY, context.previous);
+        },
+        onSettled: () => queryClient.invalidateQueries({ queryKey: NOTIFICATION_PREFS_KEY }),
+    });
+    return {
+        preferences: q.data ?? null,
+        isLoading: q.isLoading,
+        refetch: q.refetch,
+        setPreference: (key, enabled) => mutation.mutateAsync({ key, enabled }),
+    };
+}
 function useMyUid() {
     const cfg = (0, provider_1.useCommunityConfig)();
     const q = (0, react_query_1.useQuery)({
@@ -245,6 +281,7 @@ function useUpdateProfile() {
                 hasBio: !!input.bio,
                 hasAvatar: !!input.avatarUrl,
                 handleChanged: !!input.handle,
+                usernameChanged: !!input.username,
             });
         },
     });

package/lib/index.d.ts

@@ -9,9 +9,9 @@ export { timeAgo, timeAgoParts } from "./time";
 export { COMMUNITY_EVENTS, emitEvent } from "./events";
 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, isOptimistic, } from "./hooks";
+export { buildFeedSelect, fetchFeedPage, countNewPosts, fetchProfile, fetchUserPosts, searchPosts, fetchThread, createPost, votePoll, createComment, moderateOne, setLike, setReaction, fetchReactionSummaries, reportContent, blockUser, deleteOwnPost, deleteOwnComment, updateProfile, fetchNotificationPreferences, setNotificationPreference, NOTIFICATION_PREFERENCE_KEYS, uploadAvatar, } from "./service";
+export type { ModerationVerdict, CreatePostInput, ReportReason, ReportInput, UpdateProfileInput, UpdateProfileResult, NotificationPreferenceKey, NotificationPreferences, } from "./service";
+export { useCommunityFeed, useSearchPosts, useNewPostsCount, useCommunityUnseenCount, useThread, useProfile, useUserPosts, useMyUid, useNotificationPreferences, 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.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;
+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.useNotificationPreferences = exports.useMyUid = exports.useUserPosts = exports.useProfile = exports.useThread = exports.useCommunityUnseenCount = exports.useNewPostsCount = exports.useSearchPosts = exports.useCommunityFeed = exports.uploadAvatar = exports.NOTIFICATION_PREFERENCE_KEYS = exports.setNotificationPreference = exports.fetchNotificationPreferences = 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; } });
@@ -61,6 +61,9 @@ Object.defineProperty(exports, "blockUser", { enumerable: true, get: function ()
 Object.defineProperty(exports, "deleteOwnPost", { enumerable: true, get: function () { return service_1.deleteOwnPost; } });
 Object.defineProperty(exports, "deleteOwnComment", { enumerable: true, get: function () { return service_1.deleteOwnComment; } });
 Object.defineProperty(exports, "updateProfile", { enumerable: true, get: function () { return service_1.updateProfile; } });
+Object.defineProperty(exports, "fetchNotificationPreferences", { enumerable: true, get: function () { return service_1.fetchNotificationPreferences; } });
+Object.defineProperty(exports, "setNotificationPreference", { enumerable: true, get: function () { return service_1.setNotificationPreference; } });
+Object.defineProperty(exports, "NOTIFICATION_PREFERENCE_KEYS", { enumerable: true, get: function () { return service_1.NOTIFICATION_PREFERENCE_KEYS; } });
 Object.defineProperty(exports, "uploadAvatar", { enumerable: true, get: function () { return service_1.uploadAvatar; } });
 var hooks_1 = require("./hooks");
 Object.defineProperty(exports, "useCommunityFeed", { enumerable: true, get: function () { return hooks_1.useCommunityFeed; } });
@@ -71,6 +74,7 @@ Object.defineProperty(exports, "useThread", { enumerable: true, get: function ()
 Object.defineProperty(exports, "useProfile", { enumerable: true, get: function () { return hooks_1.useProfile; } });
 Object.defineProperty(exports, "useUserPosts", { enumerable: true, get: function () { return hooks_1.useUserPosts; } });
 Object.defineProperty(exports, "useMyUid", { enumerable: true, get: function () { return hooks_1.useMyUid; } });
+Object.defineProperty(exports, "useNotificationPreferences", { enumerable: true, get: function () { return hooks_1.useNotificationPreferences; } });
 Object.defineProperty(exports, "useUpdateProfile", { enumerable: true, get: function () { return hooks_1.useUpdateProfile; } });
 Object.defineProperty(exports, "useCreatePost", { enumerable: true, get: function () { return hooks_1.useCreatePost; } });
 Object.defineProperty(exports, "useCreateComment", { enumerable: true, get: function () { return hooks_1.useCreateComment; } });

package/lib/service.d.ts

@@ -116,6 +116,12 @@ export interface ReportInput {
 }
 export declare function reportContent(cfg: ResolvedCommunityConfig, input: ReportInput): Promise<void>;
 export declare function blockUser(cfg: ResolvedCommunityConfig, blockedId: string): Promise<void>;
+export declare const NOTIFICATION_PREFERENCE_KEYS: readonly ["notify_likes", "notify_comments", "notify_reactions"];
+export type NotificationPreferenceKey = (typeof NOTIFICATION_PREFERENCE_KEYS)[number];
+export type NotificationPreferences = Record<NotificationPreferenceKey, boolean>;
+/** The caller's `push_tokens` preferences (push module); `null` while the device has no push row. */
+export declare function fetchNotificationPreferences(cfg: ResolvedCommunityConfig): Promise<NotificationPreferences | null>;
+export declare function setNotificationPreference(cfg: ResolvedCommunityConfig, key: NotificationPreferenceKey, enabled: boolean): Promise<void>;
 export declare function deleteOwnPost(cfg: ResolvedCommunityConfig, postId: string): Promise<void>;
 export declare function deleteOwnComment(cfg: ResolvedCommunityConfig, commentId: string): Promise<void>;
 /**
@@ -124,19 +130,22 @@ export declare function deleteOwnComment(cfg: ResolvedCommunityConfig, commentId
  * signature and translated to the Edge Function's expected `avatarPath` body
  * key at the call site below.
  */
+/** `username` is the display name shown on posts; `handle` the @handle. All fields are moderated server-side. */
 export type UpdateProfileInput = {
+    username?: string;
     handle?: string;
     bio?: string;
     avatarUrl?: string;
 };
 export type UpdateProfileResult = {
     status: "ok";
+    username: string | null;
     handle: string | null;
     bio: string | null;
     avatarUrl: string | null;
 } | {
     status: "rejected";
-    field: "handle" | "bio" | "avatar";
+    field: "username" | "handle" | "bio" | "avatar";
     reason?: string;
 } | {
     status: "error";

package/lib/service.js

@@ -8,6 +8,7 @@
 // feed/thread composition (search, poll batching via `poll_vote_counts`, reaction batching
 // generalized from that host's prayer-style feature's summary RPC into `post_reaction_summary`).
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.NOTIFICATION_PREFERENCE_KEYS = void 0;
 exports.buildFeedSelect = buildFeedSelect;
 exports.withTranslationFilters = withTranslationFilters;
 exports.fetchReactionSummaries = fetchReactionSummaries;
@@ -26,6 +27,8 @@ exports.setLike = setLike;
 exports.setReaction = setReaction;
 exports.reportContent = reportContent;
 exports.blockUser = blockUser;
+exports.fetchNotificationPreferences = fetchNotificationPreferences;
+exports.setNotificationPreference = setNotificationPreference;
 exports.deleteOwnPost = deleteOwnPost;
 exports.deleteOwnComment = deleteOwnComment;
 exports.updateProfile = updateProfile;
@@ -450,6 +453,34 @@ async function blockUser(cfg, blockedId) {
     if (error && error.code !== "23505")
         throw error; // already blocked is fine
 }
+exports.NOTIFICATION_PREFERENCE_KEYS = [
+    "notify_likes",
+    "notify_comments",
+    "notify_reactions",
+];
+/** The caller's `push_tokens` preferences (push module); `null` while the device has no push row. */
+async function fetchNotificationPreferences(cfg) {
+    const client = cfg.requireClient();
+    const uid = await requireUid(cfg);
+    const { data, error } = await client
+        .from("push_tokens")
+        .select(exports.NOTIFICATION_PREFERENCE_KEYS.join(","))
+        .eq("user_id", uid)
+        .maybeSingle();
+    if (error)
+        throw error;
+    return data ?? null;
+}
+async function setNotificationPreference(cfg, key, enabled) {
+    const client = cfg.requireClient();
+    const uid = await requireUid(cfg);
+    const { error } = await client
+        .from("push_tokens")
+        .update({ [key]: enabled })
+        .eq("user_id", uid);
+    if (error)
+        throw error;
+}
 async function deleteOwnPost(cfg, postId) {
     const client = cfg.requireClient();
     await requireUid(cfg);
@@ -472,9 +503,9 @@ async function deleteOwnComment(cfg, commentId) {
  */
 async function updateProfile(cfg, input) {
     const client = cfg.requireClient();
-    const { handle, bio, avatarUrl } = input;
+    const { username, handle, bio, avatarUrl } = input;
     const { data, error } = await client.functions.invoke("update-profile", {
-        body: { handle, bio, avatarPath: avatarUrl },
+        body: { username, handle, bio, avatarPath: avatarUrl },
     });
     if (!error)
         return data;

package/package.json

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