@hamzasaleemorg/convex-comments 1.0.0

package/dist/component/threads.js

@@ -0,0 +1,276 @@
+import { v } from "convex/values";
+import { mutation, query } from "./_generated/server.js";
+// ============================================================================
+// Thread Validators
+// ============================================================================
+const positionValidator = v.object({
+    x: v.number(),
+    y: v.number(),
+    anchor: v.optional(v.string()),
+});
+const threadValidator = v.object({
+    _id: v.id("threads"),
+    _creationTime: v.number(),
+    zoneId: v.id("zones"),
+    resolved: v.boolean(),
+    resolvedBy: v.optional(v.string()),
+    resolvedAt: v.optional(v.number()),
+    createdAt: v.number(),
+    lastActivityAt: v.number(),
+    position: v.optional(positionValidator),
+    metadata: v.optional(v.any()),
+});
+const messagePreviewValidator = v.object({
+    _id: v.id("messages"),
+    body: v.string(),
+    authorId: v.string(),
+    createdAt: v.number(),
+});
+const threadWithPreviewValidator = v.object({
+    thread: threadValidator,
+    firstMessage: v.union(v.null(), messagePreviewValidator),
+    messageCount: v.number(),
+});
+// ============================================================================
+// Thread Functions
+// ============================================================================
+/**
+ * Create a new thread in a zone.
+ */
+export const addThread = mutation({
+    args: {
+        zoneId: v.id("zones"),
+        position: v.optional(positionValidator),
+        metadata: v.optional(v.any()),
+    },
+    returns: v.id("threads"),
+    handler: async (ctx, args) => {
+        // Verify zone exists
+        const zone = await ctx.db.get(args.zoneId);
+        if (!zone) {
+            throw new Error(`Zone ${args.zoneId} not found`);
+        }
+        const now = Date.now();
+        const threadId = await ctx.db.insert("threads", {
+            zoneId: args.zoneId,
+            resolved: false,
+            createdAt: now,
+            lastActivityAt: now,
+            position: args.position,
+            metadata: args.metadata,
+        });
+        return threadId;
+    },
+});
+/**
+ * Get a thread by ID.
+ */
+export const getThread = query({
+    args: {
+        threadId: v.id("threads"),
+    },
+    returns: v.union(v.null(), threadValidator),
+    handler: async (ctx, args) => {
+        return await ctx.db.get(args.threadId);
+    },
+});
+/**
+ * Get all threads in a zone with optional pagination and filtering.
+ */
+export const getThreads = query({
+    args: {
+        zoneId: v.id("zones"),
+        limit: v.optional(v.number()),
+        includeResolved: v.optional(v.boolean()),
+        cursor: v.optional(v.string()),
+    },
+    returns: v.object({
+        threads: v.array(threadWithPreviewValidator),
+        nextCursor: v.optional(v.string()),
+        hasMore: v.boolean(),
+    }),
+    handler: async (ctx, args) => {
+        const limit = args.limit ?? 50;
+        const includeResolved = args.includeResolved ?? true;
+        // Build query
+        let query = ctx.db
+            .query("threads")
+            .withIndex("zoneId_lastActivity", (q) => q.eq("zoneId", args.zoneId))
+            .order("desc");
+        // Apply cursor if provided
+        if (args.cursor) {
+            // Cursor is the lastActivityAt timestamp
+            const cursorTime = parseInt(args.cursor, 10);
+            query = ctx.db
+                .query("threads")
+                .withIndex("zoneId_lastActivity", (q) => q.eq("zoneId", args.zoneId).lt("lastActivityAt", cursorTime))
+                .order("desc");
+        }
+        // Fetch one extra to check if there are more
+        const threads = await query.take(limit + 1);
+        // Filter by resolved status if needed
+        const filteredThreads = includeResolved
+            ? threads
+            : threads.filter((t) => !t.resolved);
+        const hasMore = filteredThreads.length > limit;
+        const resultThreads = filteredThreads.slice(0, limit);
+        // Get first message preview and count for each thread
+        const threadsWithPreviews = await Promise.all(resultThreads.map(async (thread) => {
+            const messages = await ctx.db
+                .query("messages")
+                .withIndex("threadId_createdAt", (q) => q.eq("threadId", thread._id))
+                .order("asc")
+                .take(1);
+            const firstMessage = messages[0] ?? null;
+            // Get message count
+            const allMessages = await ctx.db
+                .query("messages")
+                .withIndex("threadId", (q) => q.eq("threadId", thread._id))
+                .collect();
+            const messageCount = allMessages.filter((m) => !m.isDeleted).length;
+            return {
+                thread,
+                firstMessage: firstMessage
+                    ? {
+                        _id: firstMessage._id,
+                        body: firstMessage.body,
+                        authorId: firstMessage.authorId,
+                        createdAt: firstMessage.createdAt,
+                    }
+                    : null,
+                messageCount,
+            };
+        }));
+        // Generate next cursor
+        const lastThread = resultThreads[resultThreads.length - 1];
+        const nextCursor = hasMore && lastThread
+            ? lastThread.lastActivityAt.toString()
+            : undefined;
+        return {
+            threads: threadsWithPreviews,
+            nextCursor,
+            hasMore,
+        };
+    },
+});
+/**
+ * Resolve a thread.
+ */
+export const resolveThread = mutation({
+    args: {
+        threadId: v.id("threads"),
+        userId: v.string(),
+    },
+    returns: v.null(),
+    handler: async (ctx, args) => {
+        const thread = await ctx.db.get(args.threadId);
+        if (!thread) {
+            throw new Error(`Thread ${args.threadId} not found`);
+        }
+        await ctx.db.patch(args.threadId, {
+            resolved: true,
+            resolvedBy: args.userId,
+            resolvedAt: Date.now(),
+        });
+        return null;
+    },
+});
+/**
+ * Unresolve a thread.
+ */
+export const unresolveThread = mutation({
+    args: {
+        threadId: v.id("threads"),
+    },
+    returns: v.null(),
+    handler: async (ctx, args) => {
+        const thread = await ctx.db.get(args.threadId);
+        if (!thread) {
+            throw new Error(`Thread ${args.threadId} not found`);
+        }
+        await ctx.db.patch(args.threadId, {
+            resolved: false,
+            resolvedBy: undefined,
+            resolvedAt: undefined,
+        });
+        return null;
+    },
+});
+/**
+ * Update thread position (for positioned comments).
+ */
+export const updateThreadPosition = mutation({
+    args: {
+        threadId: v.id("threads"),
+        position: v.optional(positionValidator),
+    },
+    returns: v.null(),
+    handler: async (ctx, args) => {
+        await ctx.db.patch(args.threadId, {
+            position: args.position,
+        });
+        return null;
+    },
+});
+/**
+ * Delete a thread and all its messages.
+ */
+export const deleteThread = mutation({
+    args: {
+        threadId: v.id("threads"),
+    },
+    returns: v.object({
+        deletedMessages: v.number(),
+        deletedReactions: v.number(),
+    }),
+    handler: async (ctx, args) => {
+        let deletedMessages = 0;
+        let deletedReactions = 0;
+        // Get all messages in this thread
+        const messages = await ctx.db
+            .query("messages")
+            .withIndex("threadId", (q) => q.eq("threadId", args.threadId))
+            .collect();
+        for (const message of messages) {
+            // Delete reactions on this message
+            const reactions = await ctx.db
+                .query("reactions")
+                .withIndex("messageId", (q) => q.eq("messageId", message._id))
+                .collect();
+            for (const reaction of reactions) {
+                await ctx.db.delete(reaction._id);
+                deletedReactions++;
+            }
+            // Delete the message
+            await ctx.db.delete(message._id);
+            deletedMessages++;
+        }
+        // Delete typing indicators
+        const typingIndicators = await ctx.db
+            .query("typingIndicators")
+            .withIndex("threadId", (q) => q.eq("threadId", args.threadId))
+            .collect();
+        for (const indicator of typingIndicators) {
+            await ctx.db.delete(indicator._id);
+        }
+        // Delete the thread
+        await ctx.db.delete(args.threadId);
+        return { deletedMessages, deletedReactions };
+    },
+});
+/**
+ * Internal function to update thread's lastActivityAt.
+ */
+export const updateThreadActivity = mutation({
+    args: {
+        threadId: v.id("threads"),
+    },
+    returns: v.null(),
+    handler: async (ctx, args) => {
+        await ctx.db.patch(args.threadId, {
+            lastActivityAt: Date.now(),
+        });
+        return null;
+    },
+});
+//# sourceMappingURL=threads.js.map

package/dist/component/threads.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"threads.js","sourceRoot":"","sources":["../../src/component/threads.ts"],"names":[],"mappings":"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"}

package/dist/component/typing.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Set typing indicator for a user in a thread.
+ * Automatically schedules expiry cleanup.
+ */
+export declare const setIsTyping: import("convex/server").RegisteredMutation<"public", {
+    threadId: import("convex/values").GenericId<"threads">;
+    userId: string;
+    isTyping: boolean;
+}, Promise<null>>;
+/**
+ * Get all users currently typing in a thread.
+ */
+export declare const getTypingUsers: import("convex/server").RegisteredQuery<"public", {
+    excludeUserId?: string | undefined;
+    threadId: import("convex/values").GenericId<"threads">;
+}, Promise<{
+    userId: string;
+    updatedAt: number;
+}[]>>;
+/**
+ * Internal function to cleanup expired typing indicators.
+ */
+export declare const cleanupExpiredIndicators: import("convex/server").RegisteredMutation<"internal", {}, Promise<number>>;
+/**
+ * Clear all typing indicators for a user across all threads.
+ * Useful when a user disconnects.
+ */
+export declare const clearUserTyping: import("convex/server").RegisteredMutation<"public", {
+    userId: string;
+}, Promise<number>>;
+//# sourceMappingURL=typing.d.ts.map

package/dist/component/typing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typing.d.ts","sourceRoot":"","sources":["../../src/component/typing.ts"],"names":[],"mappings":"AAwBA;;;GAGG;AACH,eAAO,MAAM,WAAW;;;;iBAyDtB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;KA0BzB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,wBAAwB,6EAoBnC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,eAAe;;mBAoB1B,CAAC"}

package/dist/component/typing.js

@@ -0,0 +1,147 @@
+import { v } from "convex/values";
+import { mutation, query, internalMutation } from "./_generated/server.js";
+import { internal } from "./_generated/api.js";
+// ============================================================================
+// Typing Indicator Configuration
+// ============================================================================
+/** How long (in ms) before a typing indicator expires */
+const TYPING_EXPIRY_MS = 5000; // 5 seconds
+// ============================================================================
+// Typing Indicator Validators
+// ============================================================================
+const typingUserValidator = v.object({
+    userId: v.string(),
+    updatedAt: v.number(),
+});
+// ============================================================================
+// Typing Indicator Functions
+// ============================================================================
+/**
+ * Set typing indicator for a user in a thread.
+ * Automatically schedules expiry cleanup.
+ */
+export const setIsTyping = mutation({
+    args: {
+        threadId: v.id("threads"),
+        userId: v.string(),
+        isTyping: v.boolean(),
+    },
+    returns: v.null(),
+    handler: async (ctx, args) => {
+        // Verify thread exists
+        const thread = await ctx.db.get(args.threadId);
+        if (!thread) {
+            throw new Error(`Thread ${args.threadId} not found`);
+        }
+        const now = Date.now();
+        const expiresAt = now + TYPING_EXPIRY_MS;
+        // Find existing indicator
+        const existing = await ctx.db
+            .query("typingIndicators")
+            .withIndex("threadId_userId", (q) => q.eq("threadId", args.threadId).eq("userId", args.userId))
+            .first();
+        if (args.isTyping) {
+            if (existing) {
+                // Update existing indicator
+                await ctx.db.patch(existing._id, {
+                    updatedAt: now,
+                    expiresAt,
+                });
+            }
+            else {
+                // Create new indicator
+                await ctx.db.insert("typingIndicators", {
+                    threadId: args.threadId,
+                    userId: args.userId,
+                    updatedAt: now,
+                    expiresAt,
+                });
+            }
+            // Schedule cleanup
+            await ctx.scheduler.runAfter(TYPING_EXPIRY_MS + 1000, // Add a small buffer
+            internal.typing.cleanupExpiredIndicators, {});
+        }
+        else {
+            // Remove indicator if exists
+            if (existing) {
+                await ctx.db.delete(existing._id);
+            }
+        }
+        return null;
+    },
+});
+/**
+ * Get all users currently typing in a thread.
+ */
+export const getTypingUsers = query({
+    args: {
+        threadId: v.id("threads"),
+        excludeUserId: v.optional(v.string()),
+    },
+    returns: v.array(typingUserValidator),
+    handler: async (ctx, args) => {
+        const now = Date.now();
+        const indicators = await ctx.db
+            .query("typingIndicators")
+            .withIndex("threadId", (q) => q.eq("threadId", args.threadId))
+            .collect();
+        // Filter to only non-expired indicators and optionally exclude current user
+        return indicators
+            .filter((i) => {
+            if (i.expiresAt < now)
+                return false;
+            if (args.excludeUserId && i.userId === args.excludeUserId)
+                return false;
+            return true;
+        })
+            .map((i) => ({
+            userId: i.userId,
+            updatedAt: i.updatedAt,
+        }));
+    },
+});
+/**
+ * Internal function to cleanup expired typing indicators.
+ */
+export const cleanupExpiredIndicators = internalMutation({
+    args: {},
+    returns: v.number(),
+    handler: async (ctx) => {
+        const now = Date.now();
+        let deleted = 0;
+        // Get all expired indicators
+        const expired = await ctx.db
+            .query("typingIndicators")
+            .withIndex("expiresAt", (q) => q.lt("expiresAt", now))
+            .collect();
+        for (const indicator of expired) {
+            await ctx.db.delete(indicator._id);
+            deleted++;
+        }
+        return deleted;
+    },
+});
+/**
+ * Clear all typing indicators for a user across all threads.
+ * Useful when a user disconnects.
+ */
+export const clearUserTyping = mutation({
+    args: {
+        userId: v.string(),
+    },
+    returns: v.number(),
+    handler: async (ctx, args) => {
+        // We need to scan all indicators since we don't have a userId index
+        // In production, you might want to add an index on userId
+        const allIndicators = await ctx.db.query("typingIndicators").collect();
+        let deleted = 0;
+        for (const indicator of allIndicators) {
+            if (indicator.userId === args.userId) {
+                await ctx.db.delete(indicator._id);
+                deleted++;
+            }
+        }
+        return deleted;
+    },
+});
+//# sourceMappingURL=typing.js.map

package/dist/component/typing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typing.js","sourceRoot":"","sources":["../../src/component/typing.ts"],"names":[],"mappings":"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"}

package/dist/component/zones.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Get or create a zone for an entity.
+ * This is the main entry point - lazily creates a zone if it doesn't exist.
+ */
+export declare const getOrCreateZone: import("convex/server").RegisteredMutation<"public", {
+    metadata?: any;
+    entityId: string;
+}, Promise<import("convex/values").GenericId<"zones">>>;
+/**
+ * List all zones with optional pagination.
+ */
+export declare const listZones: import("convex/server").RegisteredQuery<"public", {
+    limit?: number | undefined;
+}, Promise<{
+    _id: import("convex/values").GenericId<"zones">;
+    _creationTime: number;
+    metadata?: any;
+    entityId: string;
+    createdAt: number;
+}[]>>;
+/**
+ * Get a zone by entity ID (without creating).
+ */
+export declare const getZone: import("convex/server").RegisteredQuery<"public", {
+    entityId: string;
+}, Promise<{
+    _id: import("convex/values").GenericId<"zones">;
+    _creationTime: number;
+    metadata?: any;
+    entityId: string;
+    createdAt: number;
+} | null>>;
+/**
+ * Get a zone by its ID.
+ */
+export declare const getZoneById: import("convex/server").RegisteredQuery<"public", {
+    zoneId: import("convex/values").GenericId<"zones">;
+}, Promise<{
+    _id: import("convex/values").GenericId<"zones">;
+    _creationTime: number;
+    metadata?: any;
+    entityId: string;
+    createdAt: number;
+} | null>>;
+/**
+ * Update zone metadata.
+ */
+export declare const updateZoneMetadata: import("convex/server").RegisteredMutation<"public", {
+    metadata: any;
+    zoneId: import("convex/values").GenericId<"zones">;
+}, Promise<null>>;
+/**
+ * Delete a zone and all its threads/messages.
+ * Use with caution - this is a destructive operation.
+ */
+export declare const deleteZone: import("convex/server").RegisteredMutation<"public", {
+    zoneId: import("convex/values").GenericId<"zones">;
+}, Promise<{
+    deletedThreads: number;
+    deletedMessages: number;
+    deletedReactions: number;
+}>>;
+//# sourceMappingURL=zones.d.ts.map

package/dist/component/zones.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zones.d.ts","sourceRoot":"","sources":["../../src/component/zones.ts"],"names":[],"mappings":"AAmBA;;;GAGG;AACH,eAAO,MAAM,eAAe;;;uDA0B1B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,SAAS;;;;;;;;KASpB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,OAAO;;;;;;;;UAWlB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,WAAW;;;;;;;;UAQtB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;iBAY7B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,UAAU;;;;;;GAgErB,CAAC"}