@codingfactory/socialkit-vue 0.7.8 → 0.7.11

package/dist/services/circles.js

@@ -319,6 +319,29 @@ function buildActorContext(circle) {
         managementSections,
     };
 }
+function resolveBootstrapActorRole(actorCapabilities, fallbackRole) {
+    if (actorCapabilities === null) {
+        return fallbackRole;
+    }
+    const displayRole = readString(actorCapabilities.display_role);
+    if (isCircleRole(displayRole)) {
+        return displayRole;
+    }
+    const moderationLevel = readString(actorCapabilities.moderation_level);
+    if (isCircleRole(moderationLevel)) {
+        return moderationLevel;
+    }
+    return fallbackRole;
+}
+function circleUserRole(circle) {
+    if (circle === null || circle === undefined) {
+        return null;
+    }
+    return isCircleRole(circle.user_role) ? circle.user_role : null;
+}
+function hasValue(value) {
+    return value !== undefined && value !== null;
+}
 function normalizeCollectionResponse(payload, normalizeItem) {
     const data = readRecord(payload, 'data') ?? (isRecord(payload) ? payload : null);
     const dataItems = readArray(payload, 'data');
@@ -353,6 +376,11 @@ function normalizeInlineCollection(items, normalizeItem) {
         meta: createEmptyPagination().meta,
     };
 }
+function normalizeBootstrapRoleCollection(value) {
+    return Array.isArray(value)
+        ? normalizeInlineCollection(value, normalizeRoleDefinition)
+        : normalizeCollectionResponse(value ?? {}, normalizeRoleDefinition);
+}
 function normalizeCircle(value) {
     if (!isRecord(value)) {
         return null;
@@ -1008,6 +1036,56 @@ class CirclesService {
         const matchedCircle = items.find((item) => isCircleWithSlug(item) && item.slug.toLowerCase() === normalizedSlug);
         return matchedCircle ? normalizeCircle(matchedCircle) : null;
     }
+    normalizeModerationReportSubmissionInput(subjectOrInput, category, notes) {
+        if (typeof subjectOrInput !== 'string') {
+            return subjectOrInput;
+        }
+        const input = {
+            category: category ?? '',
+            subject_user_id: subjectOrInput,
+            subject_type: 'user',
+            subject_id: subjectOrInput,
+        };
+        if (typeof notes === 'string') {
+            input.notes = notes;
+        }
+        return input;
+    }
+    buildModerationReportPayload(input) {
+        const category = this.sanitizeInput(input.category);
+        if (category.length === 0) {
+            throw new Error('Moderation report category is required.');
+        }
+        const subjectUserId = typeof input.subject_user_id === 'string' && input.subject_user_id.trim().length > 0
+            ? this.sanitizeInput(input.subject_user_id)
+            : null;
+        const subjectType = input.subject_type ?? (subjectUserId !== null ? 'user' : undefined);
+        const derivedSubjectId = typeof input.subject_id === 'string' && input.subject_id.trim().length > 0
+            ? this.sanitizeInput(input.subject_id)
+            : subjectType === 'user'
+                ? subjectUserId
+                : null;
+        if (subjectType !== undefined && derivedSubjectId === null) {
+            throw new Error('Moderation report subject_id is required when subject_type is provided.');
+        }
+        if (subjectType === undefined && subjectUserId === null) {
+            throw new Error('Moderation report subject details are required.');
+        }
+        const payload = {
+            category,
+        };
+        if (subjectUserId !== null) {
+            payload.subject_user_id = subjectUserId;
+        }
+        if (subjectType !== undefined && derivedSubjectId !== null) {
+            payload.subject_type = subjectType;
+            payload.subject_id = derivedSubjectId;
+        }
+        if (typeof input.notes === 'string' && input.notes.trim().length > 0) {
+            payload.notes = this.sanitizeInput(input.notes);
+        }
+        return payload;
+    }
     async list(cursor, filters) {
         try {
             const params = {
@@ -1490,15 +1568,9 @@ class CirclesService {
             return await this.handleError(error);
         }
     }
-    async reportMember(circleId, subjectUserId, category, notes) {
+    async submitModerationReport(circleId, input) {
         try {
-            const payload = {
-                subject_user_id: subjectUserId,
-                category: this.sanitizeInput(category),
-            };
-            if (typeof notes === 'string' && notes.trim().length > 0) {
-                payload.notes = this.sanitizeInput(notes);
-            }
+            const payload = this.buildModerationReportPayload(input);
             const response = await this.client.post(`${this.baseURL}/${circleId}/moderation/reports`, payload);
             const data = readRecord(response.data, 'data') ?? {};
             const reportId = readString(data.report_id);
@@ -1519,6 +1591,9 @@ class CirclesService {
             return await this.handleError(error);
         }
     }
+    async reportMember(circleId, subjectOrInput, category, notes) {
+        return await this.submitModerationReport(circleId, this.normalizeModerationReportSubmissionInput(subjectOrInput, category, notes));
+    }
     async listModerationReports(circleId, cursor, status) {
         try {
             const params = {};
@@ -1686,6 +1761,10 @@ class CirclesService {
     async getManagementBootstrap(circleId) {
         const identifier = this.sanitizeInput(circleId);
         let resolvedCircle = null;
+        let bootstrapPermissionCatalog = createEmptyPagination().data;
+        let bootstrapManagementSections = [];
+        let bootstrapCounts = createEmptyManagementCounts();
+        let hasBootstrapCounts = false;
         const bootstrapIdentifier = this.isUuid(identifier)
             ? identifier
             : await (async () => {
@@ -1696,12 +1775,24 @@ class CirclesService {
             const response = await this.client.get(`${this.baseURL}/${bootstrapIdentifier}/management/bootstrap`);
             const data = readRecord(response.data, 'data');
             const bootstrapCircle = data?.circle;
-            const bootstrapManagementSections = normalizeManagementSections(data?.management_sections);
+            const bootstrapActorCapabilities = readRecord(data, 'actor_capabilities');
+            bootstrapManagementSections = normalizeManagementSections(data?.management_sections);
+            bootstrapPermissionCatalog = Array.isArray(data?.permission_catalog)
+                ? data.permission_catalog
+                    .map((entry) => normalizePermissionCatalogEntry(entry))
+                    .filter((entry) => entry !== null)
+                : [];
+            hasBootstrapCounts = hasValue(data?.counts);
+            bootstrapCounts = normalizeManagementCounts(data?.counts);
             const directCircle = normalizeCircle(bootstrapCircle ?? data);
+            const directCircleRole = circleUserRole(directCircle);
+            const fallbackRole = directCircleRole ?? circleUserRole(resolvedCircle);
+            const bootstrapActorRole = resolveBootstrapActorRole(bootstrapActorCapabilities, fallbackRole);
             const mergedCircleSource = directCircle === null
                 ? {
                     ...(resolvedCircle ?? await this.get(bootstrapIdentifier)),
                     ...(bootstrapCircle ?? {}),
+                    ...(bootstrapActorRole !== null ? { user_role: bootstrapActorRole } : {}),
                     actor_capabilities: data?.actor_capabilities,
                     management_sections: bootstrapManagementSections.length > 0
                         ? bootstrapManagementSections
@@ -1709,6 +1800,7 @@ class CirclesService {
                 }
                 : {
                     ...directCircle,
+                    ...(bootstrapActorRole !== null ? { user_role: bootstrapActorRole } : {}),
                     actor_capabilities: data?.actor_capabilities ?? directCircle.actor_capabilities,
                     management_sections: bootstrapManagementSections.length > 0
                         ? bootstrapManagementSections
@@ -1716,36 +1808,98 @@ class CirclesService {
                 };
             const circle = normalizeCircle(mergedCircleSource);
             if (circle !== null) {
-                const bootstrapHasCollections = data?.members !== undefined && data?.members !== null;
-                if (bootstrapHasCollections) {
-                    const actor = circle.actor ?? buildActorContext(circle);
+                const actor = circle.actor ?? buildActorContext(circle);
+                if (!actor.capabilities.canViewManagement) {
                     return {
                         circle,
                         actor,
                         management_sections: bootstrapManagementSections.length > 0
                             ? bootstrapManagementSections
                             : actor.managementSections,
-                        members: normalizeCollectionResponse(data?.members ?? {}, normalizeCircleMember),
-                        requests: normalizeCollectionResponse(data?.requests ?? {}, normalizeJoinRequest),
-                        roles: Array.isArray(data?.roles)
-                            ? normalizeInlineCollection(data.roles, normalizeRoleDefinition)
-                            : normalizeCollectionResponse(data?.roles ?? {}, normalizeRoleDefinition),
-                        counts: normalizeManagementCounts(data?.counts),
-                        permission_catalog: Array.isArray(data?.permission_catalog)
-                            ? data.permission_catalog
-                                .map((entry) => normalizePermissionCatalogEntry(entry))
-                                .filter((entry) => entry !== null)
-                            : [],
-                        reports: normalizeCollectionResponse(data?.reports ?? {}, normalizeModerationReport),
-                        bans: normalizeCollectionResponse(data?.bans ?? {}, normalizeBanRecord),
-                        mutes: normalizeCollectionResponse(data?.mutes ?? {}, normalizeMuteRecord),
-                        audit: normalizeCollectionResponse(data?.audit ?? {}, normalizeAuditLogEntry),
-                        automod: normalizeCollectionResponse(data?.automod ?? {}, normalizeAutomodRule),
+                        members: createEmptyPagination(),
+                        requests: createEmptyPagination(),
+                        roles: createEmptyPagination(),
+                        counts: createEmptyManagementCounts(),
+                        permission_catalog: [],
+                        reports: createEmptyPagination(),
+                        bans: createEmptyPagination(),
+                        mutes: createEmptyPagination(),
+                        audit: createEmptyPagination(),
+                        automod: createEmptyPagination(),
                     };
                 }
-                // Bootstrap returned circle + counts but no collection data arrays.
-                // Save the circle so the individual-fetch fallback path below can use it.
-                resolvedCircle = circle;
+                const caps = actor.capabilities;
+                const emptyJoinRequests = createEmptyPagination();
+                const emptyRoles = createEmptyPagination();
+                const emptyReports = createEmptyPagination();
+                const emptyBans = createEmptyPagination();
+                const emptyMutes = createEmptyPagination();
+                const emptyAudit = createEmptyPagination();
+                const emptyAutomod = createEmptyPagination();
+                const members = hasValue(data?.members)
+                    ? normalizeCollectionResponse(data?.members ?? {}, normalizeCircleMember)
+                    : await this.getMembers(circle.id);
+                const requests = hasValue(data?.requests)
+                    ? normalizeCollectionResponse(data?.requests ?? {}, normalizeJoinRequest)
+                    : caps.canReviewRequests
+                        ? await this.listJoinRequests(circle.id, null, 'pending')
+                        : emptyJoinRequests;
+                const roles = hasValue(data?.roles)
+                    ? normalizeBootstrapRoleCollection(data?.roles)
+                    : caps.canManageRoles
+                        ? await this.listRoles(circle.id)
+                        : emptyRoles;
+                const reports = hasValue(data?.reports)
+                    ? normalizeCollectionResponse(data?.reports ?? {}, normalizeModerationReport)
+                    : caps.canManageReports
+                        ? await this.listModerationReports(circle.id, null, 'pending')
+                        : emptyReports;
+                const bans = hasValue(data?.bans)
+                    ? normalizeCollectionResponse(data?.bans ?? {}, normalizeBanRecord)
+                    : caps.canManageBans
+                        ? await this.listBans(circle.id)
+                        : emptyBans;
+                const mutes = hasValue(data?.mutes)
+                    ? normalizeCollectionResponse(data?.mutes ?? {}, normalizeMuteRecord)
+                    : caps.canManageMutes
+                        ? await this.listMutes(circle.id)
+                        : emptyMutes;
+                const audit = hasValue(data?.audit)
+                    ? normalizeCollectionResponse(data?.audit ?? {}, normalizeAuditLogEntry)
+                    : caps.canViewAuditLog
+                        ? await this.getModerationAuditLog(circle.id)
+                        : emptyAudit;
+                const automod = hasValue(data?.automod)
+                    ? normalizeCollectionResponse(data?.automod ?? {}, normalizeAutomodRule)
+                    : caps.canManageAutomod
+                        ? await this.listAutomodRules(circle.id)
+                        : emptyAutomod;
+                return {
+                    circle,
+                    actor,
+                    management_sections: bootstrapManagementSections.length > 0
+                        ? bootstrapManagementSections
+                        : actor.managementSections,
+                    members,
+                    requests,
+                    roles,
+                    counts: hasBootstrapCounts
+                        ? bootstrapCounts
+                        : {
+                            members: circle.member_count ?? members.data.length,
+                            requests_pending: requests.data.length,
+                            reports_pending: reports.data.length,
+                            roles: roles.data.length,
+                            bans_active: bans.data.length,
+                            mutes_active: mutes.data.length,
+                        },
+                    permission_catalog: bootstrapPermissionCatalog,
+                    reports,
+                    bans,
+                    mutes,
+                    audit,
+                    automod,
+                };
             }
         }
         catch (error) {
@@ -1764,7 +1918,7 @@ class CirclesService {
                 requests: createEmptyPagination(),
                 roles: createEmptyPagination(),
                 counts: createEmptyManagementCounts(),
-                permission_catalog: [],
+                permission_catalog: bootstrapPermissionCatalog,
                 reports: createEmptyPagination(),
                 bans: createEmptyPagination(),
                 mutes: createEmptyPagination(),
@@ -1819,7 +1973,7 @@ class CirclesService {
                 bans_active: bans.data.length,
                 mutes_active: mutes.data.length,
             },
-            permission_catalog: [],
+            permission_catalog: bootstrapPermissionCatalog,
             reports,
             bans,
             mutes,