@sublay/core 7.0.3

package/dist/cjs/hooks/chat/useMarkConversationAsRead.js

@@ -0,0 +1,37 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const react_1 = require("react");
+const hooks_1 = require("../../store/hooks");
+const chatSlice_1 = require("../../store/slices/chatSlice");
+const useAxiosPrivate_1 = __importDefault(require("../../config/useAxiosPrivate"));
+const useProject_1 = __importDefault(require("../projects/useProject"));
+const handleError_1 = require("../../utils/handleError");
+/**
+ * Internal hook — called by ConversationProvider, not intended for direct use.
+ * Advances the server-side lastReadAt to the given message's createdAt and
+ * resets the local unread count to 0 immediately (optimistic clear).
+ */
+function useMarkConversationAsRead({ conversationId, }) {
+    const dispatch = (0, hooks_1.useSublayDispatch)();
+    const { projectId } = (0, useProject_1.default)();
+    const axios = (0, useAxiosPrivate_1.default)();
+    const mark = (0, react_1.useCallback)(async ({ messageId }) => {
+        if (!projectId || !conversationId || !messageId)
+            return;
+        // Clear unread count locally for immediate UI update
+        dispatch((0, chatSlice_1.clearUnread)(conversationId));
+        try {
+            await axios.post(`/${projectId}/chat/conversations/${conversationId}/read`, { messageId });
+        }
+        catch (err) {
+            // Non-critical — don't re-throw; the local clear still stands
+            (0, handleError_1.handleError)(err, "Failed to mark conversation as read");
+        }
+    }, [projectId, conversationId, axios, dispatch]);
+    return mark;
+}
+exports.default = useMarkConversationAsRead;
+//# sourceMappingURL=useMarkConversationAsRead.js.map

package/dist/cjs/hooks/chat/useMarkConversationAsRead.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMarkConversationAsRead.js","sourceRoot":"","sources":["../../../../src/hooks/chat/useMarkConversationAsRead.tsx"],"names":[],"mappings":";;;;;AAAA,iCAAoC;AACpC,6CAAsD;AACtD,4DAA2D;AAC3D,mFAA2D;AAC3D,wEAAgD;AAChD,yDAAsD;AAMtD;;;;GAIG;AACH,SAAS,yBAAyB,CAAC,EACjC,cAAc,GACiB;IAC/B,MAAM,QAAQ,GAAG,IAAA,yBAAiB,GAAE,CAAC;IACrC,MAAM,EAAE,SAAS,EAAE,GAAG,IAAA,oBAAU,GAAE,CAAC;IACnC,MAAM,KAAK,GAAG,IAAA,yBAAe,GAAE,CAAC;IAEhC,MAAM,IAAI,GAAG,IAAA,mBAAW,EACtB,KAAK,EAAE,EAAE,SAAS,EAAyB,EAAiB,EAAE;QAC5D,IAAI,CAAC,SAAS,IAAI,CAAC,cAAc,IAAI,CAAC,SAAS;YAAE,OAAO;QAExD,qDAAqD;QACrD,QAAQ,CAAC,IAAA,uBAAW,EAAC,cAAc,CAAC,CAAC,CAAC;QAEtC,IAAI,CAAC;YACH,MAAM,KAAK,CAAC,IAAI,CACd,IAAI,SAAS,uBAAuB,cAAc,OAAO,EACzD,EAAE,SAAS,EAAE,CACd,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,8DAA8D;YAC9D,IAAA,yBAAW,EAAC,GAAG,EAAE,qCAAqC,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC,EACD,CAAC,SAAS,EAAE,cAAc,EAAE,KAAK,EAAE,QAAQ,CAAC,CAC7C,CAAC;IAEF,OAAO,IAAI,CAAC;AACd,CAAC;AAED,kBAAe,yBAAyB,CAAC"}

package/dist/cjs/hooks/chat/useReportMessage.d.ts

@@ -0,0 +1,8 @@
+export interface ReportMessageParams {
+    conversationId: string;
+    messageId: string;
+    reason?: string;
+    details?: string;
+}
+declare function useReportMessage(): (params: ReportMessageParams) => Promise<void>;
+export default useReportMessage;

package/dist/cjs/hooks/chat/useReportMessage.js

@@ -0,0 +1,27 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const react_1 = require("react");
+const useAxiosPrivate_1 = __importDefault(require("../../config/useAxiosPrivate"));
+const useProject_1 = __importDefault(require("../projects/useProject"));
+const handleError_1 = require("../../utils/handleError");
+function useReportMessage() {
+    const { projectId } = (0, useProject_1.default)();
+    const axios = (0, useAxiosPrivate_1.default)();
+    const report = (0, react_1.useCallback)(async ({ conversationId, messageId, reason, details, }) => {
+        if (!projectId)
+            throw new Error("No projectId available.");
+        try {
+            await axios.post(`/${projectId}/chat/conversations/${conversationId}/messages/${messageId}/report`, { reason, details });
+        }
+        catch (err) {
+            (0, handleError_1.handleError)(err, "Failed to report message");
+            throw err;
+        }
+    }, [projectId, axios]);
+    return report;
+}
+exports.default = useReportMessage;
+//# sourceMappingURL=useReportMessage.js.map

package/dist/cjs/hooks/chat/useReportMessage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useReportMessage.js","sourceRoot":"","sources":["../../../../src/hooks/chat/useReportMessage.tsx"],"names":[],"mappings":";;;;;AAAA,iCAAoC;AACpC,mFAA2D;AAC3D,wEAAgD;AAChD,yDAAsD;AAStD,SAAS,gBAAgB;IACvB,MAAM,EAAE,SAAS,EAAE,GAAG,IAAA,oBAAU,GAAE,CAAC;IACnC,MAAM,KAAK,GAAG,IAAA,yBAAe,GAAE,CAAC;IAEhC,MAAM,MAAM,GAAG,IAAA,mBAAW,EACxB,KAAK,EAAE,EACL,cAAc,EACd,SAAS,EACT,MAAM,EACN,OAAO,GACa,EAAiB,EAAE;QACvC,IAAI,CAAC,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;QAE3D,IAAI,CAAC;YACH,MAAM,KAAK,CAAC,IAAI,CACd,IAAI,SAAS,uBAAuB,cAAc,aAAa,SAAS,SAAS,EACjF,EAAE,MAAM,EAAE,OAAO,EAAE,CACpB,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAA,yBAAW,EAAC,GAAG,EAAE,0BAA0B,CAAC,CAAC;YAC7C,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC,EACD,CAAC,SAAS,EAAE,KAAK,CAAC,CACnB,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,kBAAe,gBAAgB,CAAC"}

package/dist/cjs/hooks/chat/useTotalUnreadCount.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Returns the total number of unread messages across all conversations.
+ * Initialized from the server on ChatProvider mount — accurate before the
+ * conversation list is ever loaded. Kept in sync via socket events.
+ */
+declare function useTotalUnreadCount(): number;
+export default useTotalUnreadCount;

package/dist/cjs/hooks/chat/useTotalUnreadCount.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const hooks_1 = require("../../store/hooks");
+const chatSlice_1 = require("../../store/slices/chatSlice");
+/**
+ * Returns the total number of unread messages across all conversations.
+ * Initialized from the server on ChatProvider mount — accurate before the
+ * conversation list is ever loaded. Kept in sync via socket events.
+ */
+function useTotalUnreadCount() {
+    return (0, hooks_1.useSublaySelector)(chatSlice_1.selectTotalUnreadCount) ?? 0;
+}
+exports.default = useTotalUnreadCount;
+//# sourceMappingURL=useTotalUnreadCount.js.map

package/dist/cjs/hooks/chat/useTotalUnreadCount.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTotalUnreadCount.js","sourceRoot":"","sources":["../../../../src/hooks/chat/useTotalUnreadCount.tsx"],"names":[],"mappings":";;AAAA,6CAAsD;AACtD,4DAAsE;AAEtE;;;;GAIG;AACH,SAAS,mBAAmB;IAC1B,OAAO,IAAA,yBAAiB,EAAC,kCAAsB,CAAC,IAAI,CAAC,CAAC;AACxD,CAAC;AAED,kBAAe,mBAAmB,CAAC"}

package/dist/cjs/hooks/chat/useTypingIndicator.d.ts

@@ -0,0 +1,21 @@
+export interface UseTypingIndicatorProps {
+    conversationId: string;
+}
+export interface UseTypingIndicatorValues {
+    /** userIds of people currently typing (current user is excluded) */
+    typingUsers: string[];
+    /** Call on each keystroke — internally throttles the keep-alive emit to every 2 s */
+    startTyping: () => void;
+    /** Call on send, input clear, or blur */
+    stopTyping: () => void;
+}
+/**
+ * Manages the typing indicator for a conversation.
+ *
+ * Sender side protocol (§6.5 of design):
+ * 1. On first keystroke after idle: emit `typing:start` immediately.
+ * 2. Re-emit `typing:start` every 2 s as a keep-alive while typing continues.
+ * 3. On send / blur / input clear: cancel keep-alive, emit `typing:stop`.
+ */
+declare function useTypingIndicator({ conversationId, }: UseTypingIndicatorProps): UseTypingIndicatorValues;
+export default useTypingIndicator;

package/dist/cjs/hooks/chat/useTypingIndicator.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const react_1 = require("react");
+const hooks_1 = require("../../store/hooks");
+const chatSlice_1 = require("../../store/slices/chatSlice");
+const chat_context_1 = require("../../context/chat-context");
+/**
+ * Manages the typing indicator for a conversation.
+ *
+ * Sender side protocol (§6.5 of design):
+ * 1. On first keystroke after idle: emit `typing:start` immediately.
+ * 2. Re-emit `typing:start` every 2 s as a keep-alive while typing continues.
+ * 3. On send / blur / input clear: cancel keep-alive, emit `typing:stop`.
+ */
+function useTypingIndicator({ conversationId, }) {
+    const { socket } = (0, chat_context_1.useChatContext)();
+    // Array of other users currently typing (current user already excluded by ChatProvider)
+    const typingUsers = (0, hooks_1.useSublaySelector)((0, chatSlice_1.selectTypingUsers)(conversationId));
+    // Whether we (the current user) are currently emitting typing events
+    const isTypingRef = (0, react_1.useRef)(false);
+    // Keep-alive interval: re-emits typing:start every 2 s
+    const keepAliveRef = (0, react_1.useRef)(null);
+    const stopKeepAlive = (0, react_1.useCallback)(() => {
+        if (keepAliveRef.current !== null) {
+            clearInterval(keepAliveRef.current);
+            keepAliveRef.current = null;
+        }
+    }, []);
+    const startTyping = (0, react_1.useCallback)(() => {
+        if (!socket || !conversationId)
+            return;
+        if (!isTypingRef.current) {
+            // First keystroke after idle — emit immediately
+            isTypingRef.current = true;
+            socket.emit("typing:start", { conversationId });
+            // Start the 2-second keep-alive
+            keepAliveRef.current = setInterval(() => {
+                socket.emit("typing:start", { conversationId });
+            }, 2000);
+        }
+        // Subsequent keystrokes while already typing: keep-alive handles re-emitting
+    }, [socket, conversationId]);
+    const stopTyping = (0, react_1.useCallback)(() => {
+        if (!socket || !conversationId)
+            return;
+        if (!isTypingRef.current)
+            return;
+        // Cancel keep-alive BEFORE emitting stop to avoid a scheduled keep-alive
+        // firing after the stop and briefly re-adding the user to receivers' typing lists
+        stopKeepAlive();
+        isTypingRef.current = false;
+        socket.emit("typing:stop", { conversationId });
+    }, [socket, conversationId, stopKeepAlive]);
+    // Clean up on unmount or conversation change
+    (0, react_1.useEffect)(() => {
+        return () => {
+            if (isTypingRef.current && socket && conversationId) {
+                stopKeepAlive();
+                socket.emit("typing:stop", { conversationId });
+                isTypingRef.current = false;
+            }
+        };
+    }, [socket, conversationId, stopKeepAlive]);
+    return { typingUsers, startTyping, stopTyping };
+}
+exports.default = useTypingIndicator;
+//# sourceMappingURL=useTypingIndicator.js.map

package/dist/cjs/hooks/chat/useTypingIndicator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTypingIndicator.js","sourceRoot":"","sources":["../../../../src/hooks/chat/useTypingIndicator.tsx"],"names":[],"mappings":";;AAAA,iCAAuD;AACvD,6CAAsD;AACtD,4DAAiE;AACjE,6DAA4D;AAe5D;;;;;;;GAOG;AACH,SAAS,kBAAkB,CAAC,EAC1B,cAAc,GACU;IACxB,MAAM,EAAE,MAAM,EAAE,GAAG,IAAA,6BAAc,GAAE,CAAC;IAEpC,wFAAwF;IACxF,MAAM,WAAW,GAAG,IAAA,yBAAiB,EAAC,IAAA,6BAAiB,EAAC,cAAc,CAAC,CAAC,CAAC;IAEzE,qEAAqE;IACrE,MAAM,WAAW,GAAG,IAAA,cAAM,EAAC,KAAK,CAAC,CAAC;IAClC,uDAAuD;IACvD,MAAM,YAAY,GAAG,IAAA,cAAM,EAAwC,IAAI,CAAC,CAAC;IAEzE,MAAM,aAAa,GAAG,IAAA,mBAAW,EAAC,GAAG,EAAE;QACrC,IAAI,YAAY,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;YAClC,aAAa,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;YACpC,YAAY,CAAC,OAAO,GAAG,IAAI,CAAC;QAC9B,CAAC;IACH,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,WAAW,GAAG,IAAA,mBAAW,EAAC,GAAG,EAAE;QACnC,IAAI,CAAC,MAAM,IAAI,CAAC,cAAc;YAAE,OAAO;QAEvC,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;YACzB,gDAAgD;YAChD,WAAW,CAAC,OAAO,GAAG,IAAI,CAAC;YAC3B,MAAM,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,cAAc,EAAE,CAAC,CAAC;YAEhD,gCAAgC;YAChC,YAAY,CAAC,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE;gBACtC,MAAM,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,cAAc,EAAE,CAAC,CAAC;YAClD,CAAC,EAAE,IAAI,CAAC,CAAC;QACX,CAAC;QACD,6EAA6E;IAC/E,CAAC,EAAE,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC;IAE7B,MAAM,UAAU,GAAG,IAAA,mBAAW,EAAC,GAAG,EAAE;QAClC,IAAI,CAAC,MAAM,IAAI,CAAC,cAAc;YAAE,OAAO;QACvC,IAAI,CAAC,WAAW,CAAC,OAAO;YAAE,OAAO;QAEjC,yEAAyE;QACzE,kFAAkF;QAClF,aAAa,EAAE,CAAC;QAChB,WAAW,CAAC,OAAO,GAAG,KAAK,CAAC;QAC5B,MAAM,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,cAAc,EAAE,CAAC,CAAC;IACjD,CAAC,EAAE,CAAC,MAAM,EAAE,cAAc,EAAE,aAAa,CAAC,CAAC,CAAC;IAE5C,6CAA6C;IAC7C,IAAA,iBAAS,EAAC,GAAG,EAAE;QACb,OAAO,GAAG,EAAE;YACV,IAAI,WAAW,CAAC,OAAO,IAAI,MAAM,IAAI,cAAc,EAAE,CAAC;gBACpD,aAAa,EAAE,CAAC;gBAChB,MAAM,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,cAAc,EAAE,CAAC,CAAC;gBAC/C,WAAW,CAAC,OAAO,GAAG,KAAK,CAAC;YAC9B,CAAC;QACH,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,MAAM,EAAE,cAAc,EAAE,aAAa,CAAC,CAAC,CAAC;IAE5C,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC;AAClD,CAAC;AAED,kBAAe,kBAAkB,CAAC"}

package/dist/cjs/hooks/chat/useUnreadConversationCount.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Returns the number of conversations that have at least one unread message.
+ * Initialized from the server on ChatProvider mount — accurate before the
+ * conversation list is ever loaded. Kept in sync via socket events.
+ *
+ * Note: when a new message arrives from a conversation not yet loaded into
+ * the conversation list (e.g. paginated out), only `useTotalUnreadCount` is
+ * bumped — this count is not adjusted for that edge case and re-syncs on
+ * the next ChatProvider mount.
+ */
+declare function useUnreadConversationCount(): number;
+export default useUnreadConversationCount;

package/dist/cjs/hooks/chat/useUnreadConversationCount.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const hooks_1 = require("../../store/hooks");
+const chatSlice_1 = require("../../store/slices/chatSlice");
+/**
+ * Returns the number of conversations that have at least one unread message.
+ * Initialized from the server on ChatProvider mount — accurate before the
+ * conversation list is ever loaded. Kept in sync via socket events.
+ *
+ * Note: when a new message arrives from a conversation not yet loaded into
+ * the conversation list (e.g. paginated out), only `useTotalUnreadCount` is
+ * bumped — this count is not adjusted for that edge case and re-syncs on
+ * the next ChatProvider mount.
+ */
+function useUnreadConversationCount() {
+    return (0, hooks_1.useSublaySelector)(chatSlice_1.selectUnreadConversationCount) ?? 0;
+}
+exports.default = useUnreadConversationCount;
+//# sourceMappingURL=useUnreadConversationCount.js.map

package/dist/cjs/hooks/chat/useUnreadConversationCount.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useUnreadConversationCount.js","sourceRoot":"","sources":["../../../../src/hooks/chat/useUnreadConversationCount.tsx"],"names":[],"mappings":";;AAAA,6CAAsD;AACtD,4DAA6E;AAE7E;;;;;;;;;GASG;AACH,SAAS,0BAA0B;IACjC,OAAO,IAAA,yBAAiB,EAAC,yCAA6B,CAAC,IAAI,CAAC,CAAC;AAC/D,CAAC;AAED,kBAAe,0BAA0B,CAAC"}

package/dist/cjs/hooks/collections/index.d.ts

@@ -0,0 +1,3 @@
+export { useCollectionsActions } from "./useCollectionsActions";
+export { default as useCollections, type UseCollectionsProps, type UseCollectionsValues, type CreateCollectionProps, type UpdateCollectionProps, type DeleteCollectionProps, type AddToCollectionProps, type RemoveFromCollectionProps, } from "./useCollections";
+export { default as useCollectionEntitiesWrapper, type UseCollectionEntitiesWrapperProps, type UseCollectionEntitiesWrapperValues, } from "./useCollectionEntitiesWrapper";

package/dist/cjs/hooks/collections/index.js

@@ -0,0 +1,14 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useCollectionEntitiesWrapper = exports.useCollections = exports.useCollectionsActions = void 0;
+// Export Redux-powered collections hooks
+var useCollectionsActions_1 = require("./useCollectionsActions");
+Object.defineProperty(exports, "useCollectionsActions", { enumerable: true, get: function () { return useCollectionsActions_1.useCollectionsActions; } });
+var useCollections_1 = require("./useCollections");
+Object.defineProperty(exports, "useCollections", { enumerable: true, get: function () { return __importDefault(useCollections_1).default; } });
+var useCollectionEntitiesWrapper_1 = require("./useCollectionEntitiesWrapper");
+Object.defineProperty(exports, "useCollectionEntitiesWrapper", { enumerable: true, get: function () { return __importDefault(useCollectionEntitiesWrapper_1).default; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/hooks/collections/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/hooks/collections/index.ts"],"names":[],"mappings":";;;;;;AAAA,yCAAyC;AACzC,iEAAgE;AAAvD,8HAAA,qBAAqB,OAAA;AAC9B,mDAS0B;AARxB,iIAAA,OAAO,OAAkB;AAS3B,+EAIwC;AAHtC,6JAAA,OAAO,OAAgC"}

package/dist/cjs/hooks/collections/useCollectionEntitiesWrapper.d.ts

@@ -0,0 +1,21 @@
+import { Entity, EntityIncludeParam } from "../../interfaces/models/Entity";
+export interface UseCollectionEntitiesWrapperProps {
+    collectionId?: string | null;
+    limit?: number;
+    include?: EntityIncludeParam;
+    defaultSortBy?: "new" | "top" | "hot" | "added";
+    defaultSortDir?: "asc" | "desc";
+}
+export interface UseCollectionEntitiesWrapperValues {
+    entities: Entity[];
+    loading: boolean;
+    hasMore: boolean;
+    sortBy: "new" | "top" | "hot" | "added";
+    sortDir: "asc" | "desc";
+    setSortBy: (newSortBy: "new" | "top" | "hot" | "added") => void;
+    setSortDir: (newSortDir: "asc" | "desc") => void;
+    loadMore: () => void;
+    refetch: () => void;
+}
+declare function useCollectionEntitiesWrapper(props: UseCollectionEntitiesWrapperProps): UseCollectionEntitiesWrapperValues;
+export default useCollectionEntitiesWrapper;

package/dist/cjs/hooks/collections/useCollectionEntitiesWrapper.js

@@ -0,0 +1,140 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const react_1 = require("react");
+const collectionsApi_1 = require("../../store/api/collectionsApi");
+const handleError_1 = require("../../utils/handleError");
+const useProject_1 = __importDefault(require("../projects/useProject"));
+const useCollections_1 = __importDefault(require("./useCollections"));
+const hooks_1 = require("../../store/hooks");
+const collectionsSlice_1 = require("../../store/slices/collectionsSlice");
+function useCollectionEntitiesWrapper(props) {
+    const { collectionId: passedCollectionId, limit = 20, defaultSortBy = "added", defaultSortDir = "desc", include, } = props;
+    const dispatch = (0, hooks_1.useSublayDispatch)();
+    const { projectId } = (0, useProject_1.default)();
+    const { currentCollection } = (0, useCollections_1.default)();
+    const [fetchCollectionEntitiesQuery] = (0, collectionsApi_1.useLazyFetchCollectionEntitiesQuery)();
+    const effectiveCollectionId = passedCollectionId ?? currentCollection?.id;
+    // Read entities from shared Redux state — written here and by useCollectionsActions for optimistic updates
+    const entities = (0, hooks_1.useSublaySelector)((0, collectionsSlice_1.selectCollectionEntities)(effectiveCollectionId));
+    const includeString = (0, react_1.useMemo)(() => (Array.isArray(include) ? include.join(",") : include), [include]);
+    const loading = (0, react_1.useRef)(false);
+    const [loadingState, setLoadingState] = (0, react_1.useState)(false);
+    const hasMore = (0, react_1.useRef)(true);
+    const [hasMoreState, setHasMoreState] = (0, react_1.useState)(true);
+    const [sortBy, setSortBy] = (0, react_1.useState)(defaultSortBy);
+    const [sortDir, setSortDir] = (0, react_1.useState)(defaultSortDir);
+    const [page, setPage] = (0, react_1.useState)(1);
+    const resetEntities = (0, react_1.useCallback)(async () => {
+        if (!projectId || !effectiveCollectionId) {
+            return;
+        }
+        try {
+            loading.current = true;
+            setLoadingState(true);
+            hasMore.current = true;
+            setHasMoreState(true);
+            setPage(1);
+            const response = await fetchCollectionEntitiesQuery({
+                projectId,
+                collectionId: effectiveCollectionId,
+                page: 1,
+                limit,
+                sortBy,
+                sortDir,
+                include,
+            }).unwrap();
+            if (response) {
+                const { data: newEntities, pagination } = response;
+                dispatch((0, collectionsSlice_1.setCollectionEntities)({ collectionId: effectiveCollectionId, entities: newEntities }));
+                hasMore.current = pagination.hasMore;
+                setHasMoreState(pagination.hasMore);
+            }
+        }
+        catch (err) {
+            (0, handleError_1.handleError)(err, "Failed to fetch collection entities:");
+        }
+        finally {
+            loading.current = false;
+            setLoadingState(false);
+        }
+    }, [
+        dispatch,
+        fetchCollectionEntitiesQuery,
+        projectId,
+        effectiveCollectionId,
+        limit,
+        sortBy,
+        sortDir,
+        includeString,
+    ]);
+    const loadMore = (0, react_1.useCallback)(() => {
+        if (loading.current || !hasMore.current)
+            return;
+        setPage((prevPage) => prevPage + 1);
+    }, []);
+    (0, react_1.useEffect)(() => {
+        resetEntities();
+    }, [resetEntities]);
+    (0, react_1.useEffect)(() => {
+        const loadMoreEntities = async () => {
+            if (!projectId || !effectiveCollectionId) {
+                return;
+            }
+            loading.current = true;
+            setLoadingState(true);
+            try {
+                const response = await fetchCollectionEntitiesQuery({
+                    projectId,
+                    collectionId: effectiveCollectionId,
+                    page,
+                    limit,
+                    sortBy,
+                    sortDir,
+                    include,
+                }).unwrap();
+                if (response) {
+                    const { data: newEntities, pagination } = response;
+                    dispatch((0, collectionsSlice_1.appendCollectionEntities)({ collectionId: effectiveCollectionId, entities: newEntities }));
+                    hasMore.current = pagination.hasMore;
+                    setHasMoreState(pagination.hasMore);
+                }
+            }
+            catch (err) {
+                (0, handleError_1.handleError)(err, "Loading more collection entities failed:");
+            }
+            finally {
+                loading.current = false;
+                setLoadingState(false);
+            }
+        };
+        if (page > 1 && hasMore.current && !loading.current) {
+            loadMoreEntities();
+        }
+    }, [
+        page,
+        dispatch,
+        fetchCollectionEntitiesQuery,
+        projectId,
+        effectiveCollectionId,
+        limit,
+        sortBy,
+        sortDir,
+        includeString,
+    ]);
+    return {
+        entities,
+        loading: loadingState,
+        hasMore: hasMoreState,
+        sortBy,
+        sortDir,
+        setSortBy,
+        setSortDir,
+        loadMore,
+        refetch: resetEntities,
+    };
+}
+exports.default = useCollectionEntitiesWrapper;
+//# sourceMappingURL=useCollectionEntitiesWrapper.js.map

package/dist/cjs/hooks/collections/useCollectionEntitiesWrapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCollectionEntitiesWrapper.js","sourceRoot":"","sources":["../../../../src/hooks/collections/useCollectionEntitiesWrapper.tsx"],"names":[],"mappings":";;;;;AAAA,iCAA0E;AAE1E,mEAAqF;AACrF,yDAAsD;AACtD,wEAAgD;AAChD,sEAA8C;AAC9C,6CAAyE;AACzE,0EAI6C;AAsB7C,SAAS,4BAA4B,CACnC,KAAwC;IAExC,MAAM,EACJ,YAAY,EAAE,kBAAkB,EAChC,KAAK,GAAG,EAAE,EACV,aAAa,GAAG,OAAO,EACvB,cAAc,GAAG,MAAM,EACvB,OAAO,GACR,GAAG,KAAK,CAAC;IAEV,MAAM,QAAQ,GAAG,IAAA,yBAAiB,GAAE,CAAC;IACrC,MAAM,EAAE,SAAS,EAAE,GAAG,IAAA,oBAAU,GAAE,CAAC;IACnC,MAAM,EAAE,iBAAiB,EAAE,GAAG,IAAA,wBAAc,GAAE,CAAC;IAC/C,MAAM,CAAC,4BAA4B,CAAC,GAAG,IAAA,oDAAmC,GAAE,CAAC;IAE7E,MAAM,qBAAqB,GAAG,kBAAkB,IAAI,iBAAiB,EAAE,EAAE,CAAC;IAE1E,2GAA2G;IAC3G,MAAM,QAAQ,GAAG,IAAA,yBAAiB,EAAC,IAAA,2CAAwB,EAAC,qBAAqB,CAAC,CAAC,CAAC;IAEpF,MAAM,aAAa,GAAG,IAAA,eAAO,EAC3B,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAC5D,CAAC,OAAO,CAAC,CACV,CAAC;IAEF,MAAM,OAAO,GAAG,IAAA,cAAM,EAAC,KAAK,CAAC,CAAC;IAC9B,MAAM,CAAC,YAAY,EAAE,eAAe,CAAC,GAAG,IAAA,gBAAQ,EAAC,KAAK,CAAC,CAAC;IAExD,MAAM,OAAO,GAAG,IAAA,cAAM,EAAC,IAAI,CAAC,CAAC;IAC7B,MAAM,CAAC,YAAY,EAAE,eAAe,CAAC,GAAG,IAAA,gBAAQ,EAAC,IAAI,CAAC,CAAC;IAEvD,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,IAAA,gBAAQ,EAAkC,aAAa,CAAC,CAAC;IACrF,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,IAAA,gBAAQ,EAAiB,cAAc,CAAC,CAAC;IACvE,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,IAAA,gBAAQ,EAAC,CAAC,CAAC,CAAC;IAEpC,MAAM,aAAa,GAAG,IAAA,mBAAW,EAAC,KAAK,IAAI,EAAE;QAC3C,IAAI,CAAC,SAAS,IAAI,CAAC,qBAAqB,EAAE,CAAC;YACzC,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACH,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;YACvB,eAAe,CAAC,IAAI,CAAC,CAAC;YAEtB,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;YACvB,eAAe,CAAC,IAAI,CAAC,CAAC;YAEtB,OAAO,CAAC,CAAC,CAAC,CAAC;YAEX,MAAM,QAAQ,GAAG,MAAM,4BAA4B,CAAC;gBAClD,SAAS;gBACT,YAAY,EAAE,qBAAqB;gBACnC,IAAI,EAAE,CAAC;gBACP,KAAK;gBACL,MAAM;gBACN,OAAO;gBACP,OAAO;aACR,CAAC,CAAC,MAAM,EAAE,CAAC;YAEZ,IAAI,QAAQ,EAAE,CAAC;gBACb,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,GAAG,QAAQ,CAAC;gBACnD,QAAQ,CAAC,IAAA,wCAAqB,EAAC,EAAE,YAAY,EAAE,qBAAqB,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC;gBAChG,OAAO,CAAC,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC;gBACrC,eAAe,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;YACtC,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAA,yBAAW,EAAC,GAAG,EAAE,sCAAsC,CAAC,CAAC;QAC3D,CAAC;gBAAS,CAAC;YACT,OAAO,CAAC,OAAO,GAAG,KAAK,CAAC;YACxB,eAAe,CAAC,KAAK,CAAC,CAAC;QACzB,CAAC;IACH,CAAC,EAAE;QACD,QAAQ;QACR,4BAA4B;QAC5B,SAAS;QACT,qBAAqB;QACrB,KAAK;QACL,MAAM;QACN,OAAO;QACP,aAAa;KACd,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,IAAA,mBAAW,EAAC,GAAG,EAAE;QAChC,IAAI,OAAO,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO;YAAE,OAAO;QAChD,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC;IACtC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,IAAA,iBAAS,EAAC,GAAG,EAAE;QACb,aAAa,EAAE,CAAC;IAClB,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC;IAEpB,IAAA,iBAAS,EAAC,GAAG,EAAE;QACb,MAAM,gBAAgB,GAAG,KAAK,IAAI,EAAE;YAClC,IAAI,CAAC,SAAS,IAAI,CAAC,qBAAqB,EAAE,CAAC;gBACzC,OAAO;YACT,CAAC;YAED,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;YACvB,eAAe,CAAC,IAAI,CAAC,CAAC;YAEtB,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,MAAM,4BAA4B,CAAC;oBAClD,SAAS;oBACT,YAAY,EAAE,qBAAqB;oBACnC,IAAI;oBACJ,KAAK;oBACL,MAAM;oBACN,OAAO;oBACP,OAAO;iBACR,CAAC,CAAC,MAAM,EAAE,CAAC;gBAEZ,IAAI,QAAQ,EAAE,CAAC;oBACb,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,GAAG,QAAQ,CAAC;oBACnD,QAAQ,CAAC,IAAA,2CAAwB,EAAC,EAAE,YAAY,EAAE,qBAAqB,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC;oBACnG,OAAO,CAAC,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC;oBACrC,eAAe,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;gBACtC,CAAC;YACH,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAA,yBAAW,EAAC,GAAG,EAAE,0CAA0C,CAAC,CAAC;YAC/D,CAAC;oBAAS,CAAC;gBACT,OAAO,CAAC,OAAO,GAAG,KAAK,CAAC;gBACxB,eAAe,CAAC,KAAK,CAAC,CAAC;YACzB,CAAC;QACH,CAAC,CAAC;QAEF,IAAI,IAAI,GAAG,CAAC,IAAI,OAAO,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;YACpD,gBAAgB,EAAE,CAAC;QACrB,CAAC;IACH,CAAC,EAAE;QACD,IAAI;QACJ,QAAQ;QACR,4BAA4B;QAC5B,SAAS;QACT,qBAAqB;QACrB,KAAK;QACL,MAAM;QACN,OAAO;QACP,aAAa;KACd,CAAC,CAAC;IAEH,OAAO;QACL,QAAQ;QACR,OAAO,EAAE,YAAY;QACrB,OAAO,EAAE,YAAY;QACrB,MAAM;QACN,OAAO;QACP,SAAS;QACT,UAAU;QACV,QAAQ;QACR,OAAO,EAAE,aAAa;KACvB,CAAC;AACJ,CAAC;AAED,kBAAe,4BAA4B,CAAC"}

package/dist/cjs/hooks/collections/useCollections.d.ts

@@ -0,0 +1,52 @@
+import type { Entity } from "../../interfaces/models/Entity";
+import type { Collection } from "../../interfaces/models/Collection";
+export interface UseCollectionsProps {
+}
+export interface CreateCollectionProps {
+    collectionName: string;
+}
+export interface UpdateCollectionProps {
+    collectionId: string;
+    update: Partial<{
+        name: string;
+    }>;
+}
+export interface DeleteCollectionProps {
+    collection: Collection;
+}
+export interface AddToCollectionProps {
+    entity: Entity;
+}
+export interface RemoveFromCollectionProps {
+    entityId: string;
+}
+export interface UseCollectionsValues {
+    currentCollection: Collection | null;
+    subCollections: Collection[];
+    loading: boolean;
+    openCollection: (collection: Collection) => void;
+    goBack: () => void;
+    goToRoot: () => void;
+    isEntitySaved: (props: {
+        entityId: string;
+        collectionId?: string;
+    }) => Promise<{
+        saved: boolean;
+        inSpecificCollection?: boolean;
+        collections: Array<{
+            id: string;
+            name: string;
+        }>;
+    }>;
+    createCollection: (props: CreateCollectionProps) => Promise<void>;
+    updateCollection: (props: UpdateCollectionProps) => Promise<void>;
+    deleteCollection: (props: DeleteCollectionProps) => Promise<void>;
+    addToCollection: (props: AddToCollectionProps) => Promise<void>;
+    removeFromCollection: (props: RemoveFromCollectionProps) => Promise<void>;
+}
+/**
+ * Redux-powered hook that provides the exact same interface as useCollectionsData()
+ * This is a drop-in replacement for the Context-based hook
+ */
+declare function useCollections(_?: UseCollectionsProps): UseCollectionsValues;
+export default useCollections;