@mintlify/common 1.0.1161 → 1.0.1163

package/dist/navigation/checkNavAccess.js

@@ -1,12 +1,8 @@
+import { checkGroupAccess } from './groupAccess.js';
 export function checkNavAccess(page, userGroups, isPreview = false, checkHidden = true) {
     if (checkHidden && page.hidden)
         return false;
     if (isPreview)
         return true;
-    const pageGroups = Array.isArray(page.groups) && page.groups.every((pageGroup) => typeof pageGroup === 'string')
-        ? page.groups
-        : undefined;
-    if (!pageGroups)
-        return true;
-    return pageGroups.some((pageGroup) => userGroups.has(pageGroup));
+    return checkGroupAccess(page.groups, userGroups);
 }

package/dist/navigation/groupAccess.d.ts

@@ -0,0 +1,9 @@
+import type { PageGroups } from '@mintlify/models';
+export declare const WILDCARD_GROUP = "*";
+export type NormalizedGroups = {
+    includes: string[] | undefined;
+    excludes: string[];
+};
+export declare const isPageGroups: (value: unknown) => value is PageGroups;
+export declare function normalizeGroups(groups: PageGroups | undefined): NormalizedGroups | undefined;
+export declare function checkGroupAccess(groups: PageGroups | undefined, readerGroups: ReadonlySet<string>): boolean;

package/dist/navigation/groupAccess.js

@@ -0,0 +1,46 @@
+export const WILDCARD_GROUP = '*';
+const isStringArray = (value) => Array.isArray(value) && value.every((item) => typeof item === 'string');
+const isGroupRule = (value) => typeof value === 'object' &&
+    value !== null &&
+    !Array.isArray(value) &&
+    (!('includes' in value) || value.includes === undefined || isStringArray(value.includes)) &&
+    (!('excludes' in value) || value.excludes === undefined || isStringArray(value.excludes));
+export const isPageGroups = (value) => isStringArray(value) || (Array.isArray(value) && value.every(isGroupRule));
+const DENY_ALL = { includes: [], excludes: [] };
+export function normalizeGroups(groups) {
+    var _a;
+    if (groups == null)
+        return undefined;
+    if (!isPageGroups(groups))
+        return DENY_ALL;
+    if (isStringArray(groups))
+        return { includes: groups, excludes: [] };
+    const includes = new Set();
+    const excludes = new Set();
+    let hasIncludes = false;
+    for (const rule of groups) {
+        if (rule.includes) {
+            hasIncludes = true;
+            for (const group of rule.includes)
+                includes.add(group);
+        }
+        for (const group of (_a = rule.excludes) !== null && _a !== void 0 ? _a : []) {
+            if (group !== WILDCARD_GROUP)
+                excludes.add(group);
+        }
+    }
+    return {
+        includes: hasIncludes ? [...includes] : undefined,
+        excludes: [...excludes],
+    };
+}
+export function checkGroupAccess(groups, readerGroups) {
+    const normalized = normalizeGroups(groups);
+    if (!normalized)
+        return true;
+    if (normalized.excludes.some((group) => readerGroups.has(group)))
+        return false;
+    if (!normalized.includes)
+        return true;
+    return normalized.includes.some((group) => readerGroups.has(group));
+}

package/dist/navigation/index.d.ts

@@ -7,6 +7,7 @@ export * from './getAllPathsInDocsNav.js';
 export * from './decoratedNavTree.js';
 export * from './getAllPathsInDecoratedNav.js';
 export * from './checkNavAccess.js';
+export * from './groupAccess.js';
 export * from './filterDivisions.js';
 export * from './updateFirstHrefInDivision.js';
 export * from './scopeNavToPath.js';

package/dist/navigation/index.js

@@ -7,6 +7,7 @@ export * from './getAllPathsInDocsNav.js';
 export * from './decoratedNavTree.js';
 export * from './getAllPathsInDecoratedNav.js';
 export * from './checkNavAccess.js';
+export * from './groupAccess.js';
 export * from './filterDivisions.js';
 export * from './updateFirstHrefInDivision.js';
 export * from './scopeNavToPath.js';