@sudobility/entity_service 1.0.7 → 1.0.8

package/dist/helpers/EntityHelper.cjs

@@ -1,253 +0,0 @@
-"use strict";
-/**
- * @fileoverview Entity Helper Class
- * @description CRUD operations for entities (personal and organization workspaces)
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.EntityHelper = void 0;
-const drizzle_orm_1 = require("drizzle-orm");
-const types_1 = require("../types");
-const utils_1 = require("../utils");
-/**
- * Helper class for entity CRUD operations.
- */
-class EntityHelper {
-    constructor(config) {
-        this.config = config;
-    }
-    /**
-     * Create a personal entity for a user.
-     * Called automatically when a user first logs in.
-     * @param firebaseUid - The Firebase UID (used as user_id)
-     * @param email - Optional email for display name
-     */
-    async createPersonalEntity(firebaseUid, email) {
-        const slug = (0, utils_1.generateEntitySlug)();
-        const displayName = email?.split('@')[0] ?? 'Personal';
-        const [entity] = await this.config.db
-            .insert(this.config.entitiesTable)
-            .values({
-            entity_slug: slug,
-            entity_type: types_1.EntityType.PERSONAL,
-            display_name: displayName,
-        })
-            .returning();
-        // Add user as admin (personal entities use admin role, not owner)
-        await this.config.db.insert(this.config.membersTable).values({
-            entity_id: entity.id,
-            user_id: firebaseUid,
-            role: types_1.EntityRole.ADMIN,
-            is_active: true,
-        });
-        return this.mapRecordToEntity(entity);
-    }
-    /**
-     * Get or create a personal entity for a user.
-     * Ensures exactly one personal entity exists per user.
-     * @param firebaseUid - The Firebase UID (used as user_id)
-     * @param email - Optional email for display name
-     */
-    async getOrCreatePersonalEntity(firebaseUid, email) {
-        // Check for existing personal entity where user is admin
-        const existing = await this.config.db
-            .select({ entity: this.config.entitiesTable })
-            .from(this.config.membersTable)
-            .innerJoin(this.config.entitiesTable, (0, drizzle_orm_1.eq)(this.config.membersTable.entity_id, this.config.entitiesTable.id))
-            .where((0, drizzle_orm_1.and)((0, drizzle_orm_1.eq)(this.config.membersTable.user_id, firebaseUid), (0, drizzle_orm_1.eq)(this.config.membersTable.role, types_1.EntityRole.ADMIN), (0, drizzle_orm_1.eq)(this.config.membersTable.is_active, true), (0, drizzle_orm_1.eq)(this.config.entitiesTable.entity_type, types_1.EntityType.PERSONAL)))
-            .limit(1);
-        if (existing.length > 0) {
-            return this.mapRecordToEntity(existing[0].entity);
-        }
-        return this.createPersonalEntity(firebaseUid, email);
-    }
-    /**
-     * Create an organization entity.
-     * @param firebaseUid - The Firebase UID (used as user_id)
-     * @param request - Entity creation request
-     */
-    async createOrganizationEntity(firebaseUid, request) {
-        // Determine slug
-        let slug;
-        if (request.entitySlug) {
-            slug = (0, utils_1.normalizeSlug)(request.entitySlug);
-            if (!(0, utils_1.validateSlug)(slug)) {
-                throw new Error('Invalid entity slug format');
-            }
-            // Check availability
-            if (!(await this.isSlugAvailable(slug))) {
-                throw new Error('Entity slug is already taken');
-            }
-        }
-        else {
-            slug = await this.generateUniqueSlug();
-        }
-        const [entity] = await this.config.db
-            .insert(this.config.entitiesTable)
-            .values({
-            entity_slug: slug,
-            entity_type: types_1.EntityType.ORGANIZATION,
-            display_name: request.displayName,
-            description: request.description ?? null,
-        })
-            .returning();
-        // Add creator as owner
-        await this.config.db.insert(this.config.membersTable).values({
-            entity_id: entity.id,
-            user_id: firebaseUid,
-            role: types_1.EntityRole.OWNER,
-            is_active: true,
-        });
-        return this.mapRecordToEntity(entity);
-    }
-    /**
-     * Get entity by ID.
-     */
-    async getEntity(entityId) {
-        const results = await this.config.db
-            .select()
-            .from(this.config.entitiesTable)
-            .where((0, drizzle_orm_1.eq)(this.config.entitiesTable.id, entityId))
-            .limit(1);
-        if (results.length === 0) {
-            return null;
-        }
-        return this.mapRecordToEntity(results[0]);
-    }
-    /**
-     * Get entity by slug.
-     */
-    async getEntityBySlug(slug) {
-        const results = await this.config.db
-            .select()
-            .from(this.config.entitiesTable)
-            .where((0, drizzle_orm_1.eq)(this.config.entitiesTable.entity_slug, slug))
-            .limit(1);
-        if (results.length === 0) {
-            return null;
-        }
-        return this.mapRecordToEntity(results[0]);
-    }
-    /**
-     * Get all entities a user is a member of.
-     * If the user has no entities, a personal entity is automatically created.
-     * @param firebaseUid - The Firebase UID (used as user_id)
-     * @param email - Optional email for display name if creating personal entity
-     */
-    async getUserEntities(firebaseUid, email) {
-        const results = await this.config.db
-            .select({
-            entity: this.config.entitiesTable,
-            role: this.config.membersTable.role,
-        })
-            .from(this.config.membersTable)
-            .innerJoin(this.config.entitiesTable, (0, drizzle_orm_1.eq)(this.config.membersTable.entity_id, this.config.entitiesTable.id))
-            .where((0, drizzle_orm_1.and)((0, drizzle_orm_1.eq)(this.config.membersTable.user_id, firebaseUid), (0, drizzle_orm_1.eq)(this.config.membersTable.is_active, true)));
-        // If user has no entities, create a personal entity for them
-        if (results.length === 0) {
-            const personalEntity = await this.createPersonalEntity(firebaseUid, email);
-            return [
-                {
-                    ...personalEntity,
-                    userRole: types_1.EntityRole.OWNER,
-                },
-            ];
-        }
-        return results.map(({ entity, role }) => ({
-            ...this.mapRecordToEntity(entity),
-            userRole: role,
-        }));
-    }
-    /**
-     * Update entity details.
-     */
-    async updateEntity(entityId, request) {
-        const updates = {
-            updated_at: new Date(),
-        };
-        if (request.displayName !== undefined) {
-            updates.display_name = request.displayName;
-        }
-        if (request.description !== undefined) {
-            updates.description = request.description;
-        }
-        if (request.avatarUrl !== undefined) {
-            updates.avatar_url = request.avatarUrl;
-        }
-        if (request.entitySlug !== undefined) {
-            const slug = (0, utils_1.normalizeSlug)(request.entitySlug);
-            if (!(0, utils_1.validateSlug)(slug)) {
-                throw new Error('Invalid entity slug format');
-            }
-            // Check if changing slug
-            const existing = await this.getEntity(entityId);
-            if (existing && existing.entitySlug !== slug) {
-                if (!(await this.isSlugAvailable(slug))) {
-                    throw new Error('Entity slug is already taken');
-                }
-                updates.entity_slug = slug;
-            }
-        }
-        const [updated] = await this.config.db
-            .update(this.config.entitiesTable)
-            .set(updates)
-            .where((0, drizzle_orm_1.eq)(this.config.entitiesTable.id, entityId))
-            .returning();
-        return this.mapRecordToEntity(updated);
-    }
-    /**
-     * Delete an entity.
-     * Only organizations can be deleted; personal entities cannot.
-     */
-    async deleteEntity(entityId) {
-        const entity = await this.getEntity(entityId);
-        if (!entity) {
-            throw new Error('Entity not found');
-        }
-        if (entity.entityType === types_1.EntityType.PERSONAL) {
-            throw new Error('Personal entities cannot be deleted');
-        }
-        await this.config.db
-            .delete(this.config.entitiesTable)
-            .where((0, drizzle_orm_1.eq)(this.config.entitiesTable.id, entityId));
-    }
-    /**
-     * Check if a slug is available.
-     */
-    async isSlugAvailable(slug) {
-        const results = await this.config.db
-            .select({ id: this.config.entitiesTable.id })
-            .from(this.config.entitiesTable)
-            .where((0, drizzle_orm_1.eq)(this.config.entitiesTable.entity_slug, slug))
-            .limit(1);
-        return results.length === 0;
-    }
-    /**
-     * Generate a unique slug.
-     */
-    async generateUniqueSlug() {
-        for (let attempts = 0; attempts < 10; attempts++) {
-            const slug = (0, utils_1.generateEntitySlug)();
-            if (await this.isSlugAvailable(slug)) {
-                return slug;
-            }
-        }
-        throw new Error('Failed to generate unique slug');
-    }
-    /**
-     * Map database record to Entity type.
-     */
-    mapRecordToEntity(record) {
-        return {
-            id: record.id,
-            entitySlug: record.entity_slug,
-            entityType: record.entity_type,
-            displayName: record.display_name,
-            description: record.description,
-            avatarUrl: record.avatar_url,
-            createdAt: record.created_at?.toISOString() ?? new Date().toISOString(),
-            updatedAt: record.updated_at?.toISOString() ?? new Date().toISOString(),
-        };
-    }
-}
-exports.EntityHelper = EntityHelper;
-//# sourceMappingURL=EntityHelper.js.map

package/dist/helpers/EntityMemberHelper.cjs

@@ -1,254 +0,0 @@
-"use strict";
-/**
- * @fileoverview Entity Member Helper Class
- * @description Operations for managing entity members and their roles
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.EntityMemberHelper = void 0;
-const drizzle_orm_1 = require("drizzle-orm");
-const types_1 = require("../types");
-/**
- * Helper class for entity member operations.
- */
-class EntityMemberHelper {
-    constructor(config) {
-        this.config = config;
-    }
-    /**
-     * Get all members of an entity.
-     * By default, only returns active members.
-     */
-    async getMembers(entityId, options) {
-        // Build conditions - default to active members only
-        const conditions = [(0, drizzle_orm_1.eq)(this.config.membersTable.entity_id, entityId)];
-        if (options?.role) {
-            conditions.push((0, drizzle_orm_1.eq)(this.config.membersTable.role, options.role));
-        }
-        // Filter by is_active (default to true if not specified)
-        const isActive = options?.isActive ?? true;
-        conditions.push((0, drizzle_orm_1.eq)(this.config.membersTable.is_active, isActive));
-        let query = this.config.db
-            .select({
-            member: this.config.membersTable,
-            user: {
-                id: this.config.usersTable.firebase_uid,
-                email: this.config.usersTable.email,
-                displayName: this.config.usersTable.display_name,
-            },
-        })
-            .from(this.config.membersTable)
-            .leftJoin(this.config.usersTable, (0, drizzle_orm_1.eq)(this.config.membersTable.user_id, this.config.usersTable.firebase_uid))
-            .where((0, drizzle_orm_1.and)(...conditions))
-            .$dynamic();
-        if (options?.limit) {
-            query = query.limit(options.limit);
-        }
-        if (options?.offset) {
-            query = query.offset(options.offset);
-        }
-        const results = await query;
-        return results.map(({ member, user }) => this.mapRecordToMember(member, user));
-    }
-    /**
-     * Get a specific member by user ID.
-     * Only returns active members by default.
-     */
-    async getMember(entityId, userId, includeInactive = false) {
-        const conditions = [
-            (0, drizzle_orm_1.eq)(this.config.membersTable.entity_id, entityId),
-            (0, drizzle_orm_1.eq)(this.config.membersTable.user_id, userId),
-        ];
-        if (!includeInactive) {
-            conditions.push((0, drizzle_orm_1.eq)(this.config.membersTable.is_active, true));
-        }
-        const results = await this.config.db
-            .select({
-            member: this.config.membersTable,
-            user: {
-                id: this.config.usersTable.firebase_uid,
-                email: this.config.usersTable.email,
-                displayName: this.config.usersTable.display_name,
-            },
-        })
-            .from(this.config.membersTable)
-            .leftJoin(this.config.usersTable, (0, drizzle_orm_1.eq)(this.config.membersTable.user_id, this.config.usersTable.firebase_uid))
-            .where((0, drizzle_orm_1.and)(...conditions))
-            .limit(1);
-        if (results.length === 0) {
-            return null;
-        }
-        return this.mapRecordToMember(results[0].member, results[0].user);
-    }
-    /**
-     * Get user's role in an entity.
-     * Only returns role for active members.
-     */
-    async getUserRole(entityId, userId) {
-        const results = await this.config.db
-            .select({ role: this.config.membersTable.role })
-            .from(this.config.membersTable)
-            .where((0, drizzle_orm_1.and)((0, drizzle_orm_1.eq)(this.config.membersTable.entity_id, entityId), (0, drizzle_orm_1.eq)(this.config.membersTable.user_id, userId), (0, drizzle_orm_1.eq)(this.config.membersTable.is_active, true)))
-            .limit(1);
-        if (results.length === 0) {
-            return null;
-        }
-        return results[0].role;
-    }
-    /**
-     * Add a member to an entity.
-     * @param entityId - The entity ID
-     * @param firebaseUid - The Firebase UID (used as user_id)
-     * @param role - The member's role
-     */
-    async addMember(entityId, firebaseUid, role) {
-        // Check if there's an existing inactive membership to reactivate
-        const existing = await this.getMember(entityId, firebaseUid, true);
-        let member;
-        if (existing && !existing.isActive) {
-            // Reactivate existing membership
-            const [updated] = await this.config.db
-                .update(this.config.membersTable)
-                .set({
-                role,
-                is_active: true,
-                updated_at: new Date(),
-            })
-                .where((0, drizzle_orm_1.and)((0, drizzle_orm_1.eq)(this.config.membersTable.entity_id, entityId), (0, drizzle_orm_1.eq)(this.config.membersTable.user_id, firebaseUid)))
-                .returning();
-            member = updated;
-        }
-        else {
-            // Create new membership
-            const [inserted] = await this.config.db
-                .insert(this.config.membersTable)
-                .values({
-                entity_id: entityId,
-                user_id: firebaseUid,
-                role,
-                is_active: true,
-            })
-                .returning();
-            member = inserted;
-        }
-        // Fetch user info for response
-        const users = await this.config.db
-            .select({
-            id: this.config.usersTable.firebase_uid,
-            email: this.config.usersTable.email,
-            displayName: this.config.usersTable.display_name,
-        })
-            .from(this.config.usersTable)
-            .where((0, drizzle_orm_1.eq)(this.config.usersTable.firebase_uid, firebaseUid))
-            .limit(1);
-        return this.mapRecordToMember(member, users[0] ?? null);
-    }
-    /**
-     * Update a member's role.
-     * Cannot change the owner's role. Cannot set anyone to owner (ownership transfer is separate).
-     */
-    async updateMemberRole(entityId, userId, role) {
-        // Cannot assign owner role via this method
-        if (role === types_1.EntityRole.OWNER) {
-            throw new Error('Cannot assign owner role. Use ownership transfer instead.');
-        }
-        // Check constraints for personal entities
-        const entity = await this.config.db
-            .select()
-            .from(this.config.entitiesTable)
-            .where((0, drizzle_orm_1.eq)(this.config.entitiesTable.id, entityId))
-            .limit(1);
-        if (entity.length > 0 && entity[0].entity_type === types_1.EntityType.PERSONAL) {
-            throw new Error('Cannot change roles in personal entities');
-        }
-        // Check if user is the owner - cannot change owner's role
-        const currentMember = await this.getMember(entityId, userId);
-        if (currentMember?.role === types_1.EntityRole.OWNER) {
-            throw new Error('Cannot change the owner\'s role');
-        }
-        const [updated] = await this.config.db
-            .update(this.config.membersTable)
-            .set({
-            role,
-            updated_at: new Date(),
-        })
-            .where((0, drizzle_orm_1.and)((0, drizzle_orm_1.eq)(this.config.membersTable.entity_id, entityId), (0, drizzle_orm_1.eq)(this.config.membersTable.user_id, userId), (0, drizzle_orm_1.eq)(this.config.membersTable.is_active, true)))
-            .returning();
-        if (!updated) {
-            throw new Error('Member not found or inactive');
-        }
-        // Fetch user info for response
-        const users = await this.config.db
-            .select({
-            id: this.config.usersTable.firebase_uid,
-            email: this.config.usersTable.email,
-            displayName: this.config.usersTable.display_name,
-        })
-            .from(this.config.usersTable)
-            .where((0, drizzle_orm_1.eq)(this.config.usersTable.firebase_uid, userId))
-            .limit(1);
-        return this.mapRecordToMember(updated, users[0] ?? null);
-    }
-    /**
-     * Remove a member from an entity (soft delete).
-     * Sets is_active = false instead of deleting the record.
-     */
-    async removeMember(entityId, userId) {
-        // Check constraints for personal entities
-        const entity = await this.config.db
-            .select()
-            .from(this.config.entitiesTable)
-            .where((0, drizzle_orm_1.eq)(this.config.entitiesTable.id, entityId))
-            .limit(1);
-        if (entity.length > 0 && entity[0].entity_type === types_1.EntityType.PERSONAL) {
-            throw new Error('Cannot remove members from personal entities');
-        }
-        // Check if user is the owner - cannot remove owner
-        const member = await this.getMember(entityId, userId);
-        if (!member) {
-            throw new Error('Member not found');
-        }
-        if (member.role === types_1.EntityRole.OWNER) {
-            throw new Error('Cannot remove the entity owner');
-        }
-        // Soft delete - set is_active = false
-        await this.config.db
-            .update(this.config.membersTable)
-            .set({
-            is_active: false,
-            updated_at: new Date(),
-        })
-            .where((0, drizzle_orm_1.and)((0, drizzle_orm_1.eq)(this.config.membersTable.entity_id, entityId), (0, drizzle_orm_1.eq)(this.config.membersTable.user_id, userId)));
-    }
-    /**
-     * Check if a user is a member of an entity.
-     */
-    async isMember(entityId, userId) {
-        const role = await this.getUserRole(entityId, userId);
-        return role !== null;
-    }
-    /**
-     * Map database record to EntityMember type.
-     */
-    mapRecordToMember(record, user) {
-        const member = {
-            id: record.id,
-            entityId: record.entity_id,
-            userId: record.user_id,
-            role: record.role,
-            isActive: record.is_active ?? true,
-            joinedAt: record.joined_at?.toISOString() ?? new Date().toISOString(),
-            createdAt: record.created_at?.toISOString() ?? new Date().toISOString(),
-            updatedAt: record.updated_at?.toISOString() ?? new Date().toISOString(),
-        };
-        if (user) {
-            member.user = {
-                id: user.id,
-                email: user.email,
-                displayName: user.displayName,
-            };
-        }
-        return member;
-    }
-}
-exports.EntityMemberHelper = EntityMemberHelper;
-//# sourceMappingURL=EntityMemberHelper.js.map