@indexnetwork/protocol 0.1.0

package/dist/graphs/index_membership.graph.js

@@ -0,0 +1,204 @@
+import { StateGraph, START, END } from "@langchain/langgraph";
+import { protocolLogger } from "../support/protocol.logger.js";
+import { timed } from "../support/performance.js";
+import { IndexMembershipGraphState } from "../states/index_membership.state.js";
+const logger = protocolLogger("IndexMembershipGraphFactory");
+/**
+ * Factory class to build and compile the Index Membership Graph.
+ *
+ * Handles CRUD operations for the index_members table:
+ * - create: Add a member to an index (validates join policy and ownership)
+ * - read: List members of an index (validates caller is member)
+ * - delete: Remove a member from an index (future, validates ownership)
+ */
+export class IndexMembershipGraphFactory {
+    constructor(database) {
+        this.database = database;
+    }
+    createGraph() {
+        // --- NODE DEFINITIONS ---
+        /**
+         * Add Member Node: Add a user as a member of an index.
+         * Handles two cases:
+         * 1. Self-join (targetUserId === userId): Only allowed for public indexes (joinPolicy 'anyone')
+         * 2. Invite others (targetUserId !== userId): Requires caller to be member; owner-only for invite_only
+         */
+        const addMemberNode = async (state) => {
+            return timed("IndexMembershipGraph.addMember", async () => {
+                logger.verbose("Add member to index", {
+                    userId: state.userId,
+                    indexId: state.indexId,
+                    targetUserId: state.targetUserId,
+                });
+                if (!state.targetUserId) {
+                    return { mutationResult: { success: false, error: "targetUserId is required." } };
+                }
+                try {
+                    const indexRecord = await this.database.getIndexWithPermissions(state.indexId);
+                    if (!indexRecord) {
+                        return { mutationResult: { success: false, error: "Index not found." } };
+                    }
+                    const joinPolicy = indexRecord.permissions.joinPolicy;
+                    const isSelfJoin = state.targetUserId === state.userId;
+                    if (isSelfJoin) {
+                        // Self-join: only allowed for public indexes
+                        if (joinPolicy !== 'anyone') {
+                            return {
+                                mutationResult: {
+                                    success: false,
+                                    error: "This index is invite-only. You cannot join without an invitation from an existing member.",
+                                },
+                            };
+                        }
+                        const result = await this.database.addMemberToIndex(state.indexId, state.targetUserId, 'member');
+                        if (result.alreadyMember) {
+                            return { mutationResult: { success: true, message: "You are already a member of this index." } };
+                        }
+                        return { mutationResult: { success: true, message: `You have joined "${indexRecord.title}".` } };
+                    }
+                    // Inviting others: must be a member first
+                    const isMember = await this.database.isIndexMember(state.indexId, state.userId);
+                    if (!isMember) {
+                        return { mutationResult: { success: false, error: "You must be a member of that index to add others." } };
+                    }
+                    if (joinPolicy === 'invite_only') {
+                        const isOwner = await this.database.isIndexOwner(state.indexId, state.userId);
+                        if (!isOwner) {
+                            return { mutationResult: { success: false, error: "Only the index owner can add members when the index is invite-only." } };
+                        }
+                    }
+                    const result = await this.database.addMemberToIndex(state.indexId, state.targetUserId, 'member');
+                    if (result.alreadyMember) {
+                        return { mutationResult: { success: true, message: "That user is already a member of this index." } };
+                    }
+                    return { mutationResult: { success: true, message: "Member added to the index." } };
+                }
+                catch (err) {
+                    logger.error("Add member failed", { error: err });
+                    return {
+                        mutationResult: {
+                            success: false,
+                            error: err instanceof Error ? err.message : "Failed to add member.",
+                        },
+                    };
+                }
+            });
+        };
+        /**
+         * List Members Node: List all members of an index.
+         * Validates caller is a member.
+         */
+        const listMembersNode = async (state) => {
+            return timed("IndexMembershipGraph.listMembers", async () => {
+                logger.verbose("List index members", {
+                    userId: state.userId,
+                    indexId: state.indexId,
+                });
+                try {
+                    const isMember = await this.database.isIndexMember(state.indexId, state.userId);
+                    if (!isMember) {
+                        return {
+                            readResult: {
+                                indexId: state.indexId,
+                                count: 0,
+                                members: [],
+                            },
+                            error: "Index not found or you are not a member.",
+                        };
+                    }
+                    const members = await this.database.getIndexMembersForMember(state.indexId, state.userId);
+                    return {
+                        readResult: {
+                            indexId: state.indexId,
+                            count: members.length,
+                            members: members.map((m) => ({
+                                userId: m.userId,
+                                name: m.name,
+                                avatar: m.avatar,
+                                permissions: m.permissions,
+                                intentCount: m.intentCount,
+                                joinedAt: m.joinedAt,
+                            })),
+                        },
+                    };
+                }
+                catch (err) {
+                    logger.error("List members failed", { error: err });
+                    if (err instanceof Error && err.message === "Access denied: Not a member of this index") {
+                        return { error: "You must be a member of that index." };
+                    }
+                    return { error: "Failed to fetch index members." };
+                }
+            });
+        };
+        /**
+         * Remove Member Node: Remove a member from an index (owner only).
+         */
+        const removeMemberNode = async (state) => {
+            return timed("IndexMembershipGraph.removeMember", async () => {
+                logger.verbose("Remove member from index", {
+                    userId: state.userId,
+                    indexId: state.indexId,
+                    targetUserId: state.targetUserId,
+                });
+                if (!state.targetUserId) {
+                    return { mutationResult: { success: false, error: "targetUserId is required." } };
+                }
+                // Cannot remove yourself via this flow
+                if (state.targetUserId === state.userId) {
+                    return { mutationResult: { success: false, error: "You cannot remove yourself. Use 'leave index' instead." } };
+                }
+                try {
+                    const isOwner = await this.database.isIndexOwner(state.indexId, state.userId);
+                    if (!isOwner) {
+                        return { mutationResult: { success: false, error: "Only the index owner can remove members." } };
+                    }
+                    const result = await this.database.removeMemberFromIndex(state.indexId, state.targetUserId);
+                    if (result.wasOwner) {
+                        return { mutationResult: { success: false, error: "Cannot remove the index owner." } };
+                    }
+                    if (result.notMember) {
+                        return { mutationResult: { success: false, error: "User is not a member of this index." } };
+                    }
+                    if (!result.success) {
+                        return { mutationResult: { success: false, error: "Failed to remove member." } };
+                    }
+                    return {
+                        mutationResult: {
+                            success: true,
+                            message: "Member removed from the index.",
+                        },
+                    };
+                }
+                catch (err) {
+                    logger.error("Remove member failed", { error: err });
+                    return { mutationResult: { success: false, error: "Failed to remove member." } };
+                }
+            });
+        };
+        // --- CONDITIONAL ROUTING ---
+        const routeByMode = (state) => {
+            switch (state.operationMode) {
+                case 'create': return 'add_member';
+                case 'read': return 'list_members';
+                case 'delete': return 'remove_member';
+                default: return 'list_members';
+            }
+        };
+        // --- GRAPH ASSEMBLY ---
+        const workflow = new StateGraph(IndexMembershipGraphState)
+            .addNode("add_member", addMemberNode)
+            .addNode("list_members", listMembersNode)
+            .addNode("remove_member", removeMemberNode)
+            .addConditionalEdges(START, routeByMode, {
+            add_member: "add_member",
+            list_members: "list_members",
+            remove_member: "remove_member",
+        })
+            .addEdge("add_member", END)
+            .addEdge("list_members", END)
+            .addEdge("remove_member", END);
+        return workflow.compile();
+    }
+}
+//# sourceMappingURL=index_membership.graph.js.map

package/dist/graphs/index_membership.graph.js.map

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