@rocapine/community-core 0.10.0 → 0.11.1

package/README.md

@@ -44,6 +44,10 @@ const config: CommunityConfig = {
     // locales — must equal the backend's COMMUNITY_TRANSLATION_LOCALES.
     // Absent or `false` ⇒ every query and screen behaves as before.
     translation: { locales: ["en", "es-419"] },
+    // One photo per post and per comment. Needs the backend `images` module
+    // and, in the UI package, expo-image-manipulator. Absent or `false` ⇒
+    // every query and screen behaves as before.
+    images: true,
   },
 
   // Host adapters — every field optional, no-op defaults.
@@ -136,7 +140,8 @@ import { COMMUNITY_EVENTS, type CommunityEventName } from "@rocapine/community-c
 `commentPublished`, `profileOpened`, `profileUpdated`, `reactionAdded`,
 `userReported`, `userBlocked`, `contentDeleted`, `inboxOpened`,
 `translationToggled` (`community_translation_toggled`, props `{ postId | commentId, to: "original" | "translation" }`) — forwarded to
-`host.onEvent` by the exported `emitEvent(cfg, name, props)` helper. Route or
+`host.onEvent` by the exported `emitEvent(cfg, name, props)` helper. `postPublished` and `commentPublished` carry
+`hasImage: boolean` (alongside `hasPoll`). Route or
 ignore these in your own tracking plan; nothing else in the package calls an
 analytics provider directly.
 
@@ -160,6 +165,13 @@ runs in production and is silent in degraded mode.
   only when the translation module is on and the reader locale resolves);
   `text`/`content` always stay the original. Poll options carry
   `translatedLabel: string | null` alongside the original `label`.
+  `FeedPost.image` / `ThreadComment.image` are `PostImage | null`
+  (`{ url, width, height }`; `url` is a local `file://` on an optimistic item)
+  — always `null` unless `modules.images` is on. **They are required fields:**
+  a host that builds `FeedPost`/`ThreadComment` literals by hand (tests,
+  fixtures, mocks) must add `image: null`. `LocalImage` is the same shape: a
+  re-encoded local JPEG ready to upload. `mapImage(row, imageBase)` turns the
+  `image_path`/`image_width`/`image_height` columns into a `PostImage`.
 - **Locale** (`locale.ts`): `readerLocale(cfg)` — the locale translations
   are read in (the host's `getLocale()` resolved against
   `modules.translation.locales`), or `null` when the module is off or
@@ -171,7 +183,11 @@ runs in production and is silent in degraded mode.
   `fetchUserPosts`, `searchPosts`, `fetchThread`, `createPost`, `votePoll`,
   `createComment`, `moderateOne`, `setLike`, `setReaction`,
   `fetchReactionSummaries`, `reportContent`, `blockUser`, `deleteOwnPost`,
-  `deleteOwnComment`, `updateProfile`, `uploadAvatar`, `buildFeedSelect`
+  `deleteOwnComment`, `updateProfile`, `uploadAvatar`, `uploadPostImage`
+  (re-encoded JPEG → the public `post-images` bucket, `POST_IMAGES_BUCKET`,
+  under the caller's own folder; `createPost` / `createComment` take its
+  result, and `useCreatePost` / `useCreateComment` take an `image?: LocalImage`
+  and do both steps), `buildFeedSelect`
   (pure helper behind `feed.extraPostColumns`, see below).
 - **React Query hooks** (`hooks.ts`): `useCommunityFeed`, `useSearchPosts`,
   `useNewPostsCount`, `useCommunityUnseenCount`, `useThread`, `useProfile`,

package/lib/config.d.ts

@@ -17,6 +17,10 @@ export type CommunityModules = {
     translation?: {
         locales: string[];
     } | false;
+    /** Images module: one photo per post and per comment (public `post-images`
+     * bucket, columns added by the images migration). Absent or false ⇒ every
+     * query and screen behaves as before. */
+    images?: boolean;
 };
 export type CommunityHostAdapters = {
     getDisplayName?: () => string | null;

package/lib/hooks.d.ts

@@ -1,5 +1,6 @@
-import { type InfiniteData, type QueryClient } from "@tanstack/react-query";
-import { type CommunityProfile, type FeedPost, type ThreadComment } from "./models";
+import { type InfiniteData, type QueryClient, type UseMutationOptions } from "@tanstack/react-query";
+import { type CommunityProfile, type FeedPost, type LocalImage, type ThreadComment } from "./models";
+import type { ResolvedCommunityConfig } from "./config";
 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
@@ -84,20 +85,32 @@ type PostResult = {
  * moderation we reconcile the cache in place, published -> swap the temp id for
  * the real one (stays), rejected -> remove it. Smooth, no loading flicker.
  */
-export declare function useCreatePost(): import("@tanstack/react-query").UseMutationResult<PostResult, Error, {
+export declare function useCreatePost(): import("@tanstack/react-query").UseMutationResult<PostResult, Error, CreatePostVariables, {
+    tempId: string;
+}>;
+export type CreatePostVariables = {
     topic: string;
     text: string;
     authorName: string;
     pollOptions?: string[];
-}, {
+    image?: LocalImage;
+};
+/** The options behind `useCreatePost`, split out so they can be driven without React. */
+export declare function createPostMutationOptions(cfg: ResolvedCommunityConfig, queryClient: QueryClient, locale: string | null): UseMutationOptions<PostResult, Error, CreatePostVariables, {
     tempId: string;
 }>;
 /** Optimistic comment creation, same reconcile-in-place model as posts. */
-export declare function useCreateComment(): import("@tanstack/react-query").UseMutationResult<PostResult, Error, {
+export declare function useCreateComment(): import("@tanstack/react-query").UseMutationResult<PostResult, Error, CreateCommentVariables, {
+    tempId: string;
+}>;
+export type CreateCommentVariables = {
     postId: string;
     text: string;
     authorName: string;
-}, {
+    image?: LocalImage;
+};
+/** The options behind `useCreateComment`, split out so they can be driven without React. */
+export declare function createCommentMutationOptions(cfg: ResolvedCommunityConfig, queryClient: QueryClient, locale: string | null): UseMutationOptions<PostResult, Error, CreateCommentVariables, {
     tempId: string;
 }>;
 /** Optimistic like toggle across every post cache (feed pages of every topic

package/lib/hooks.js

@@ -23,7 +23,9 @@ exports.useNotificationPreferences = useNotificationPreferences;
 exports.useMyUid = useMyUid;
 exports.useUpdateProfile = useUpdateProfile;
 exports.useCreatePost = useCreatePost;
+exports.createPostMutationOptions = createPostMutationOptions;
 exports.useCreateComment = useCreateComment;
+exports.createCommentMutationOptions = createCommentMutationOptions;
 exports.useToggleLike = useToggleLike;
 exports.useVotePoll = useVotePoll;
 exports.useReactToPost = useReactToPost;
@@ -294,9 +296,12 @@ function useUpdateProfile() {
 function useCreatePost() {
     const cfg = (0, provider_1.useCommunityConfig)();
     const queryClient = (0, react_query_1.useQueryClient)();
-    const locale = (0, locale_1.readerLocale)(cfg);
-    return (0, react_query_1.useMutation)({
-        onMutate: async ({ topic, text, authorName, pollOptions }) => {
+    return (0, react_query_1.useMutation)(createPostMutationOptions(cfg, queryClient, (0, locale_1.readerLocale)(cfg)));
+}
+/** The options behind `useCreatePost`, split out so they can be driven without React. */
+function createPostMutationOptions(cfg, queryClient, locale) {
+    return {
+        onMutate: async ({ topic, text, authorName, pollOptions, image }) => {
             await queryClient.cancelQueries({ queryKey: keys_1.FEED_KEY });
             const tempId = `optimistic-${Date.now()}`;
             const optimistic = {
@@ -331,18 +336,23 @@ function useCreatePost() {
                 hasReacted: false,
                 lastReactorName: null,
                 translation: null,
+                // The local file uri until the post is published; the background
+                // refetch in onSuccess swaps in the server image.
+                image: image ?? null,
             };
             const prepend = (key) => queryClient.setQueryData(key, (d) => d ? { ...d, pages: [[optimistic, ...(d.pages[0] ?? [])], ...d.pages.slice(1)] } : d);
             prepend((0, keys_1.feedKey)(undefined, locale));
             prepend((0, keys_1.feedKey)(topic, locale));
             return { tempId };
         },
-        mutationFn: async ({ topic, text, pollOptions }) => {
-            const id = await (0, service_1.createPost)(cfg, { topic, body: text, pollOptions });
+        mutationFn: async ({ topic, text, pollOptions, image }) => {
+            // Upload first: a failed upload must not leave a post row behind.
+            const uploaded = image ? await (0, service_1.uploadPostImage)(cfg, image) : undefined;
+            const id = await (0, service_1.createPost)(cfg, { topic, body: text, pollOptions, image: uploaded });
             const verdict = await (0, service_1.moderateOne)(cfg, { kind: "post", id });
             return { id, verdict };
         },
-        onSuccess: ({ id, verdict }, { topic, text, pollOptions }, { tempId }) => {
+        onSuccess: ({ id, verdict }, { topic, text, pollOptions, image }, { tempId }) => {
             const rejected = verdict.status === "rejected";
             queryClient.setQueriesData({ queryKey: keys_1.FEED_KEY }, (d) => d
                 ? {
@@ -358,11 +368,13 @@ function useCreatePost() {
                     topic,
                     bodyLength: text.trim().length,
                     hasPoll,
+                    hasImage: !!image,
                 });
                 cfg.host.onContentPublished();
-                // 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)
+                // The in-place swap above keeps the optimistic poll's temp option ids
+                // (voting needs the real uuids) and the image's local uri, so a poll or
+                // image post refetches in background.
+                if (hasPoll || image)
                     queryClient.invalidateQueries({ queryKey: keys_1.FEED_KEY });
             }
         },
@@ -371,15 +383,18 @@ function useCreatePost() {
                 ? { ...d, pages: d.pages.map((p) => p.filter((post) => post.id !== context?.tempId)) }
                 : d);
         },
-    });
+    };
 }
 /** Optimistic comment creation, same reconcile-in-place model as posts. */
 function useCreateComment() {
     const cfg = (0, provider_1.useCommunityConfig)();
     const queryClient = (0, react_query_1.useQueryClient)();
-    const locale = (0, locale_1.readerLocale)(cfg);
-    return (0, react_query_1.useMutation)({
-        onMutate: async ({ postId, text, authorName }) => {
+    return (0, react_query_1.useMutation)(createCommentMutationOptions(cfg, queryClient, (0, locale_1.readerLocale)(cfg)));
+}
+/** The options behind `useCreateComment`, split out so they can be driven without React. */
+function createCommentMutationOptions(cfg, queryClient, locale) {
+    return {
+        onMutate: async ({ postId, text, authorName, image }) => {
             await queryClient.cancelQueries({ queryKey: (0, keys_1.threadKey)(postId, locale) });
             await queryClient.cancelQueries({ queryKey: keys_1.FEED_KEY });
             const tempId = `optimistic-${Date.now()}`;
@@ -393,6 +408,7 @@ function useCreateComment() {
                 isOwn: true,
                 createdAt: new Date().toISOString(),
                 translation: null,
+                image: image ?? null,
             };
             queryClient.setQueryData((0, keys_1.threadKey)(postId, locale), (d) => [
                 ...(d ?? []),
@@ -401,12 +417,13 @@ function useCreateComment() {
             bumpFeedCommentCount(queryClient, postId, 1);
             return { tempId };
         },
-        mutationFn: async ({ postId, text }) => {
-            const id = await (0, service_1.createComment)(cfg, postId, text);
+        mutationFn: async ({ postId, text, image }) => {
+            const uploaded = image ? await (0, service_1.uploadPostImage)(cfg, image) : undefined;
+            const id = await (0, service_1.createComment)(cfg, postId, text, uploaded);
             const verdict = await (0, service_1.moderateOne)(cfg, { kind: "comment", id });
             return { id, verdict };
         },
-        onSuccess: ({ id, verdict }, { postId, text }, { tempId }) => {
+        onSuccess: ({ id, verdict }, { postId, text, image }, { tempId }) => {
             const rejected = verdict.status === "rejected";
             queryClient.setQueryData((0, keys_1.threadKey)(postId, locale), (d) => (d ?? [])
                 .filter((c) => !(rejected && c.id === tempId))
@@ -418,15 +435,19 @@ function useCreateComment() {
                 (0, events_1.emitEvent)(cfg, events_1.COMMUNITY_EVENTS.commentPublished, {
                     postId,
                     bodyLength: text.trim().length,
+                    hasImage: !!image,
                 });
                 cfg.host.onContentPublished();
+                // Swap the local image uri for the server one.
+                if (image)
+                    queryClient.invalidateQueries({ queryKey: (0, keys_1.threadKey)(postId, locale) });
             }
         },
         onError: (_e, { postId }, context) => {
             queryClient.setQueryData((0, keys_1.threadKey)(postId, locale), (d) => (d ?? []).filter((c) => c.id !== context?.tempId));
             bumpFeedCommentCount(queryClient, postId, -1);
         },
-    });
+    };
 }
 /** Optimistic like toggle across every post cache (feed pages of every topic
  * filter, user-posts and search — same sweep as votes/reactions, so a like

package/lib/index.d.ts

@@ -2,15 +2,15 @@ export type { CommunityTopicDef, CommunityModules, CommunityHostAdapters, Commun
 export { CommunityDisabledError, resolveConfig } from "./config";
 export { readerLocale, languageOf } from "./locale";
 export { CommunityProvider, useCommunityConfig } from "./provider";
-export type { PostRow, PollOptionRow, CommentRow, ProfileRow, PollOption, FeedPoll, PollData, ReactionData, FeedPost, ThreadComment, CommunityProfile, TranslationInfo, TranslationRowEmbed, } from "./models";
-export { FEED_PAGE_SIZE, POST_MAX_LENGTH, COMMENT_MAX_LENGTH, POLL_MIN_OPTIONS, POLL_MAX_OPTIONS, POLL_OPTION_MAX_LENGTH, EMPTY_POLL_DATA, EMPTY_REACTION_DATA, displayName, normalizeTopic, mapProfileRow, buildPoll, pollPercent, mapPostRow, applyPollVote, applyReaction, mapCommentRow, newPostsLabel, newestCreatedAt, } from "./models";
+export type { PostRow, PollOptionRow, CommentRow, ProfileRow, PollOption, FeedPoll, PollData, ReactionData, FeedPost, ThreadComment, PostImage, LocalImage, CommunityProfile, TranslationInfo, TranslationRowEmbed, } from "./models";
+export { FEED_PAGE_SIZE, POST_MAX_LENGTH, COMMENT_MAX_LENGTH, POLL_MIN_OPTIONS, POLL_MAX_OPTIONS, POLL_OPTION_MAX_LENGTH, EMPTY_POLL_DATA, EMPTY_REACTION_DATA, displayName, normalizeTopic, mapProfileRow, buildPoll, mapImage, pollPercent, mapPostRow, applyPollVote, applyReaction, mapCommentRow, newPostsLabel, newestCreatedAt, } from "./models";
 export type { TimeAgoParts } from "./time";
 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, fetchNotificationPreferences, setNotificationPreference, NOTIFICATION_PREFERENCE_KEYS, uploadAvatar, } from "./service";
-export type { ModerationVerdict, CreatePostInput, ReportReason, ReportInput, UpdateProfileInput, UpdateProfileResult, NotificationPreferenceKey, NotificationPreferences, } from "./service";
+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, uploadPostImage, POST_IMAGES_BUCKET, } from "./service";
+export type { ModerationVerdict, CreatePostInput, UploadedImage, 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";

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.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;
+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.mapImage = 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.useNotificationPreferences = exports.useMyUid = exports.useUserPosts = exports.useProfile = exports.useThread = exports.useCommunityUnseenCount = exports.useNewPostsCount = exports.useSearchPosts = exports.useCommunityFeed = exports.POST_IMAGES_BUCKET = exports.uploadPostImage = exports.uploadAvatar = exports.NOTIFICATION_PREFERENCE_KEYS = exports.setNotificationPreference = exports.fetchNotificationPreferences = exports.updateProfile = exports.deleteOwnComment = 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; } });
@@ -24,6 +24,7 @@ Object.defineProperty(exports, "displayName", { enumerable: true, get: function
 Object.defineProperty(exports, "normalizeTopic", { enumerable: true, get: function () { return models_1.normalizeTopic; } });
 Object.defineProperty(exports, "mapProfileRow", { enumerable: true, get: function () { return models_1.mapProfileRow; } });
 Object.defineProperty(exports, "buildPoll", { enumerable: true, get: function () { return models_1.buildPoll; } });
+Object.defineProperty(exports, "mapImage", { enumerable: true, get: function () { return models_1.mapImage; } });
 Object.defineProperty(exports, "pollPercent", { enumerable: true, get: function () { return models_1.pollPercent; } });
 Object.defineProperty(exports, "mapPostRow", { enumerable: true, get: function () { return models_1.mapPostRow; } });
 Object.defineProperty(exports, "applyPollVote", { enumerable: true, get: function () { return models_1.applyPollVote; } });
@@ -65,6 +66,8 @@ Object.defineProperty(exports, "fetchNotificationPreferences", { enumerable: tru
 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; } });
+Object.defineProperty(exports, "uploadPostImage", { enumerable: true, get: function () { return service_1.uploadPostImage; } });
+Object.defineProperty(exports, "POST_IMAGES_BUCKET", { enumerable: true, get: function () { return service_1.POST_IMAGES_BUCKET; } });
 var hooks_1 = require("./hooks");
 Object.defineProperty(exports, "useCommunityFeed", { enumerable: true, get: function () { return hooks_1.useCommunityFeed; } });
 Object.defineProperty(exports, "useSearchPosts", { enumerable: true, get: function () { return hooks_1.useSearchPosts; } });

package/lib/models.d.ts

@@ -5,6 +5,22 @@ export declare const COMMENT_MAX_LENGTH = 1000;
 export declare const POLL_MIN_OPTIONS = 2;
 export declare const POLL_MAX_OPTIONS = 4;
 export declare const POLL_OPTION_MAX_LENGTH = 60;
+export interface PostImage {
+    /** Public URL, or a local `file://` uri on optimistic items. */
+    url: string;
+    width: number;
+    height: number;
+}
+/** A re-encoded local file, ready to upload. */
+export type LocalImage = PostImage;
+type ImageColumns = {
+    image_path?: string | null;
+    image_width?: number | null;
+    image_height?: number | null;
+};
+/** Null unless the row has a path and both dimensions and the images module
+ * gave a bucket base (`imageBase`, ending in `/`). */
+export declare function mapImage(row: ImageColumns, imageBase: string | undefined): PostImage | null;
 /** Raw shape returned by the feed select (see the services layer). */
 export interface PostRow {
     id: string;
@@ -32,6 +48,10 @@ export interface PostRow {
     /** At most one row: server-filtered to the reader's locale. Absent when the
      * translation module is off. */
     post_translations?: TranslationRowEmbed[];
+    /** Absent when the images module is off (columns not in the select). */
+    image_path?: string | null;
+    image_width?: number | null;
+    image_height?: number | null;
 }
 export interface PollOptionRow {
     id: string;
@@ -69,6 +89,10 @@ export interface CommentRow {
     /** At most one row: server-filtered to the reader's locale. Absent when the
      * translation module is off. */
     comment_translations?: TranslationRowEmbed[];
+    /** Absent when the images module is off (columns not in the select). */
+    image_path?: string | null;
+    image_width?: number | null;
+    image_height?: number | null;
 }
 export interface PollOption {
     id: string;
@@ -133,6 +157,8 @@ export interface FeedPost {
     /** Reader-locale translation; null when the item is already in the reader's language,
      * not translated yet, or the module is off. `text` stays the original. */
     translation: TranslationInfo | null;
+    /** Null when the post has no photo or the images module is off. */
+    image: PostImage | null;
 }
 export interface ThreadComment {
     id: string;
@@ -148,14 +174,19 @@ export interface ThreadComment {
     /** Reader-locale translation; null when the item is already in the reader's language,
      * not translated yet, or the module is off. `text` stays the original. */
     translation: TranslationInfo | null;
+    /** Null when the comment has no photo or the images module is off. */
+    image: PostImage | null;
 }
 /**
  * Public display name, with a host-configured fallback for profiles not yet named.
  * Accepts either a raw username or any profile-shaped object carrying one (a row's
- * `.profiles`, a `ProfileRow`, or a previously-mapped `CommunityProfile`).
+ * `.profiles`, a `ProfileRow`, or a previously-mapped `CommunityProfile`). An unnamed
+ * profile that picked a handle shows the handle before the fallback (handles are only
+ * auto-assigned once a username exists, so this only kicks in for a chosen one).
  */
 export declare function displayName(profile: string | null | undefined | {
     username?: string | null;
+    handle?: string | null;
 }, fallback: string): string;
 /**
  * The topic column is app-defined free text. Unlike the mold (which dropped topics
@@ -190,7 +221,7 @@ export declare function pollPercent(votes: number, totalVotes: number): number;
 export declare function mapPostRow(row: PostRow, myUid: string, fallback: string, topics: readonly CommunityTopicDef[], likedPostIds: ReadonlySet<string>, pollData?: PollData, reactionData?: ReactionData, 
 /** Host extension point (`CommunityConfig.feed.transformPost`), run last with
  * the raw row (including any `extraPostColumns`) this post was built from. */
-transformPost?: (post: FeedPost, row: Record<string, unknown>) => FeedPost): FeedPost;
+transformPost?: (post: FeedPost, row: Record<string, unknown>) => FeedPost, imageBase?: string): FeedPost;
 /**
  * Optimistic vote application: moves my vote to `optionId` on the matching
  * post, shifting per-option counts; the total only grows on a first vote.
@@ -204,7 +235,7 @@ export declare function applyPollVote(post: FeedPost, postId: string, optionId:
  * `posts.map((p) => (p.id === postId ? applyReaction(p) : p))`).
  */
 export declare function applyReaction(post: FeedPost, on?: boolean): FeedPost;
-export declare function mapCommentRow(row: CommentRow, myUid: string, fallback: string): ThreadComment;
+export declare function mapCommentRow(row: CommentRow, myUid: string, fallback: string, imageBase?: string): ThreadComment;
 /** Floating pill label. "1 new post" / "N new posts". */
 export declare function newPostsLabel(count: number): string;
 /**
@@ -215,3 +246,4 @@ export declare function newPostsLabel(count: number): string;
 export declare function newestCreatedAt(posts: readonly {
     createdAt: string;
 }[]): string | null;
+export {};

package/lib/models.js

@@ -3,6 +3,7 @@
 // No React Native / Supabase imports: this module is exercised by vitest in a node env.
 Object.defineProperty(exports, "__esModule", { value: true });
 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 = void 0;
+exports.mapImage = mapImage;
 exports.displayName = displayName;
 exports.normalizeTopic = normalizeTopic;
 exports.mapProfileRow = mapProfileRow;
@@ -25,6 +26,13 @@ exports.COMMENT_MAX_LENGTH = 1000;
 exports.POLL_MIN_OPTIONS = 2;
 exports.POLL_MAX_OPTIONS = 4;
 exports.POLL_OPTION_MAX_LENGTH = 60;
+/** Null unless the row has a path and both dimensions and the images module
+ * gave a bucket base (`imageBase`, ending in `/`). */
+function mapImage(row, imageBase) {
+    if (!imageBase || !row.image_path || !row.image_width || !row.image_height)
+        return null;
+    return { url: imageBase + row.image_path, width: row.image_width, height: row.image_height };
+}
 exports.EMPTY_POLL_DATA = { counts: new Map(), myVotes: new Map() };
 exports.EMPTY_REACTION_DATA = {
     counts: new Map(),
@@ -34,12 +42,14 @@ exports.EMPTY_REACTION_DATA = {
 /**
  * Public display name, with a host-configured fallback for profiles not yet named.
  * Accepts either a raw username or any profile-shaped object carrying one (a row's
- * `.profiles`, a `ProfileRow`, or a previously-mapped `CommunityProfile`).
+ * `.profiles`, a `ProfileRow`, or a previously-mapped `CommunityProfile`). An unnamed
+ * profile that picked a handle shows the handle before the fallback (handles are only
+ * auto-assigned once a username exists, so this only kicks in for a chosen one).
  */
 function displayName(profile, fallback) {
-    const raw = typeof profile === "string" || profile == null ? profile : profile.username;
-    const trimmed = raw?.trim();
-    return trimmed ? trimmed : fallback;
+    if (typeof profile === "string" || profile == null)
+        return profile?.trim() || fallback;
+    return profile.username?.trim() || profile.handle?.trim() || fallback;
 }
 /**
  * The topic column is app-defined free text. Unlike the mold (which dropped topics
@@ -96,7 +106,7 @@ function pollPercent(votes, totalVotes) {
 function mapPostRow(row, myUid, fallback, topics, likedPostIds, pollData = exports.EMPTY_POLL_DATA, reactionData = exports.EMPTY_REACTION_DATA, 
 /** Host extension point (`CommunityConfig.feed.transformPost`), run last with
  * the raw row (including any `extraPostColumns`) this post was built from. */
-transformPost) {
+transformPost, imageBase) {
     const post = {
         id: row.id,
         authorId: row.author_id,
@@ -118,6 +128,7 @@ transformPost) {
         hasReacted: reactionData.mine.has(row.id),
         lastReactorName: reactionData.lastReactorName.get(row.id) ?? null,
         translation: embedToTranslation(row.post_translations),
+        image: mapImage(row, imageBase),
     };
     return transformPost ? transformPost(post, row) : post;
 }
@@ -159,7 +170,7 @@ function applyReaction(post, on = true) {
         reactionCount: Math.max(0, post.reactionCount + (on ? 1 : -1)),
     };
 }
-function mapCommentRow(row, myUid, fallback) {
+function mapCommentRow(row, myUid, fallback, imageBase) {
     return {
         id: row.id,
         postId: row.post_id,
@@ -172,6 +183,7 @@ function mapCommentRow(row, myUid, fallback) {
         isOwn: row.author_id === myUid,
         createdAt: row.created_at,
         translation: embedToTranslation(row.comment_translations),
+        image: mapImage(row, imageBase),
     };
 }
 /** Floating pill label. "1 new post" / "N new posts". */

package/lib/service.d.ts

@@ -1,11 +1,12 @@
 import type { ResolvedCommunityConfig } from "./config";
-import { type CommunityProfile, type FeedPost, type ReactionData, type ThreadComment } from "./models";
+import { type CommunityProfile, type FeedPost, type LocalImage, type ReactionData, type ThreadComment } from "./models";
+export declare const POST_IMAGES_BUCKET = "post-images";
 /**
  * Appends `extraPostColumns` (if any) to the posts feed select. Pure and
  * exported so it's unit-testable without a Supabase client. Invalid column
  * names are dropped with a `console.warn` rather than failing the query.
  */
-export declare function buildFeedSelect(extraPostColumns?: readonly string[], polls?: boolean, translations?: boolean): string;
+export declare function buildFeedSelect(extraPostColumns?: readonly string[], polls?: boolean, translations?: boolean, images?: 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,
@@ -73,10 +74,17 @@ export type ModerationVerdict = {
     status: "published" | "rejected" | "pending";
     reason?: string;
 };
+/** What `uploadPostImage` returns and `createPost`/`createComment` store. */
+export type UploadedImage = {
+    path: string;
+    width: number;
+    height: number;
+};
 export type CreatePostInput = {
     topic: string;
     body: string;
     pollOptions?: string[];
+    image?: UploadedImage;
 };
 /**
  * Insert a post as 'pending' (invisible to others until moderated). Returns id.
@@ -94,7 +102,7 @@ export declare function createPost(cfg: ResolvedCommunityConfig, input: CreatePo
  */
 export declare function votePoll(cfg: ResolvedCommunityConfig, postId: string, optionId: string): Promise<void>;
 /** Insert a comment as 'pending'. Returns id. */
-export declare function createComment(cfg: ResolvedCommunityConfig, postId: string, body: string): Promise<string>;
+export declare function createComment(cfg: ResolvedCommunityConfig, postId: string, body: string, image?: UploadedImage): Promise<string>;
 /** Run synchronous moderation on a just-created pending post/comment. */
 export declare function moderateOne(cfg: ResolvedCommunityConfig, input: {
     kind: "post" | "comment";
@@ -166,3 +174,9 @@ export declare function updateProfile(cfg: ResolvedCommunityConfig, input: Updat
  * the portable way to read local bytes in React Native.
  */
 export declare function uploadAvatar(cfg: ResolvedCommunityConfig, fileUri: string): Promise<string>;
+/**
+ * Upload a re-encoded JPEG (see `LocalImage`) to the public `post-images`
+ * bucket under the caller's own folder. Returns what `createPost` /
+ * `createComment` store; the public URL is rebuilt from `path` on read.
+ */
+export declare function uploadPostImage(cfg: ResolvedCommunityConfig, image: LocalImage): Promise<UploadedImage>;

package/lib/service.js

@@ -8,7 +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.NOTIFICATION_PREFERENCE_KEYS = exports.POST_IMAGES_BUCKET = void 0;
 exports.buildFeedSelect = buildFeedSelect;
 exports.withTranslationFilters = withTranslationFilters;
 exports.fetchReactionSummaries = fetchReactionSummaries;
@@ -33,12 +33,17 @@ exports.deleteOwnPost = deleteOwnPost;
 exports.deleteOwnComment = deleteOwnComment;
 exports.updateProfile = updateProfile;
 exports.uploadAvatar = uploadAvatar;
+exports.uploadPostImage = uploadPostImage;
 const supabase_js_1 = require("@supabase/supabase-js");
 const identity_1 = require("./identity");
 const locale_1 = require("./locale");
 const models_1 = require("./models");
 /** Avatar images live in this Storage bucket on every install (mold value, unchanged). */
 const AVATAR_BUCKET = "avatars";
+exports.POST_IMAGES_BUCKET = "post-images";
+/** Selected only when the images module is on: installs without the module
+ * don't have these columns and PostgREST would reject the whole select. */
+const IMAGE_COLUMNS = "image_path, image_width, image_height";
 async function requireUid(cfg) {
     const uid = await (0, identity_1.ensureIdentity)(cfg);
     if (!uid)
@@ -72,12 +77,14 @@ const VALID_EXTRA_COLUMN = /^[a-z0-9_]+$/;
  * exported so it's unit-testable without a Supabase client. Invalid column
  * names are dropped with a `console.warn` rather than failing the query.
  */
-function buildFeedSelect(extraPostColumns, polls = false, translations = false) {
+function buildFeedSelect(extraPostColumns, polls = false, translations = false, images = false) {
     const parts = [FEED_SELECT];
     if (polls)
         parts.push(translations ? POLL_OPTIONS_TRANSLATED_SELECT : POLL_OPTIONS_SELECT);
     if (translations)
         parts.push(POST_TRANSLATIONS_SELECT);
+    if (images)
+        parts.push(IMAGE_COLUMNS);
     const base = parts.join(", ");
     if (!extraPostColumns || extraPostColumns.length === 0)
         return base;
@@ -95,7 +102,15 @@ function buildFeedSelect(extraPostColumns, polls = false, translations = false)
  * embed iff `modules.polls`, + translation embeds iff the reader has a
  * resolved translation locale. */
 function postsSelect(cfg) {
-    return buildFeedSelect(cfg.feed.extraPostColumns, cfg.modules.polls, (0, locale_1.readerLocale)(cfg) !== null);
+    return buildFeedSelect(cfg.feed.extraPostColumns, cfg.modules.polls, (0, locale_1.readerLocale)(cfg) !== null, !!cfg.modules.images);
+}
+/** Public URL prefix of the `post-images` bucket (ends with `/`); undefined
+ * when the images module is off. */
+function imageBase(cfg) {
+    if (!cfg.modules.images)
+        return undefined;
+    const { publicUrl } = cfg.requireClient().storage.from(exports.POST_IMAGES_BUCKET).getPublicUrl("").data;
+    return publicUrl.endsWith("/") ? publicUrl : `${publicUrl}/`;
 }
 /** Embedded-resource filters: keep only the reader locale's translation rows,
  * so `rows?.[0]` in the mappers is always that locale, never some other
@@ -191,7 +206,8 @@ async function toFeedPosts(cfg, client, rows, uid) {
         fetchPollData(cfg, rows.filter((r) => (r.poll_options ?? []).length > 0).map((r) => r.id), uid),
         fetchReactionSummaries(cfg, postIds),
     ]);
-    return rows.map((r) => (0, models_1.mapPostRow)(r, uid, cfg.authorFallback(), cfg.topics, liked, pollData, reactionData, cfg.feed.transformPost));
+    const base = imageBase(cfg);
+    return rows.map((r) => (0, models_1.mapPostRow)(r, uid, cfg.authorFallback(), cfg.topics, liked, pollData, reactionData, cfg.feed.transformPost, base));
 }
 /**
  * One feed page, newest first. RLS already excludes other users' hidden and
@@ -307,7 +323,12 @@ async function searchPosts(cfg, searchTerm, opts = {}) {
 /** 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;
+    const parts = [COMMENTS_SELECT];
+    if ((0, locale_1.readerLocale)(cfg))
+        parts.push(COMMENT_TRANSLATIONS_SELECT);
+    if (cfg.modules.images)
+        parts.push(IMAGE_COLUMNS);
+    return parts.join(", ");
 }
 /**
  * Note: `cfg.feed.extraPostColumns`/`transformPost` do NOT apply here — this
@@ -330,8 +351,10 @@ async function fetchThread(cfg, postId) {
     const { data, error } = await query;
     if (error)
         throw error;
-    return (data ?? []).map((r) => (0, models_1.mapCommentRow)(r, uid, cfg.authorFallback()));
+    const base = imageBase(cfg);
+    return (data ?? []).map((r) => (0, models_1.mapCommentRow)(r, uid, cfg.authorFallback(), base));
 }
+const imageColumns = (image) => image ? { image_path: image.path, image_width: image.width, image_height: image.height } : {};
 /**
  * Insert a post as 'pending' (invisible to others until moderated). Returns id.
  * With pollOptions, the post and its options are created transactionally by
@@ -339,10 +362,14 @@ async function fetchThread(cfg, postId) {
  * that branch is gated on `cfg.modules.polls`.
  */
 async function createPost(cfg, input) {
-    const { topic, body, pollOptions } = input;
+    const { topic, body, pollOptions, image } = input;
     const hasPoll = !!pollOptions && pollOptions.length > 0;
     if (hasPoll && !cfg.modules.polls)
         throw new Error("polls module is not enabled");
+    if (image && !cfg.modules.images)
+        throw new Error("images module is not enabled");
+    if (image && hasPoll)
+        throw new Error("a post cannot have both a poll and an image");
     const client = cfg.requireClient();
     const uid = await requireUid(cfg);
     if (hasPoll) {
@@ -357,7 +384,7 @@ async function createPost(cfg, input) {
     }
     const { data, error } = await client
         .from("posts")
-        .insert({ author_id: uid, topic, content: body })
+        .insert({ author_id: uid, topic, content: body, ...imageColumns(image) })
         .select("id")
         .single();
     if (error)
@@ -383,12 +410,14 @@ async function votePoll(cfg, postId, optionId) {
         throw error;
 }
 /** Insert a comment as 'pending'. Returns id. */
-async function createComment(cfg, postId, body) {
+async function createComment(cfg, postId, body, image) {
+    if (image && !cfg.modules.images)
+        throw new Error("images module is not enabled");
     const client = cfg.requireClient();
     const uid = await requireUid(cfg);
     const { data, error } = await client
         .from("comments")
-        .insert({ post_id: postId, author_id: uid, content: body })
+        .insert({ post_id: postId, author_id: uid, content: body, ...imageColumns(image) })
         .select("id")
         .single();
     if (error)
@@ -549,3 +578,22 @@ async function uploadAvatar(cfg, fileUri) {
         throw error;
     return path;
 }
+/**
+ * Upload a re-encoded JPEG (see `LocalImage`) to the public `post-images`
+ * bucket under the caller's own folder. Returns what `createPost` /
+ * `createComment` store; the public URL is rebuilt from `path` on read.
+ */
+async function uploadPostImage(cfg, image) {
+    const client = cfg.requireClient();
+    const uid = await requireUid(cfg);
+    const id = globalThis.crypto?.randomUUID?.() ?? `${Date.now()}-${Math.random().toString(36).slice(2)}`;
+    const path = `${uid}/${id}.jpg`;
+    const response = await fetch(image.url);
+    const bytes = await response.arrayBuffer();
+    const { error } = await client.storage
+        .from(exports.POST_IMAGES_BUCKET)
+        .upload(path, bytes, { contentType: "image/jpeg" });
+    if (error)
+        throw error;
+    return { path, width: image.width, height: image.height };
+}

package/package.json

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