@anymux/connect 0.1.0

package/src/utils/scope-labels.ts

@@ -0,0 +1,91 @@
+/**
+ * Maps raw OAuth scope strings to human-readable descriptions.
+ * Falls back to a cleaned-up version of the scope string for unknown scopes.
+ */
+
+const SCOPE_LABELS: Record<string, string> = {
+  // GitHub
+  'repo': 'Repository access',
+  'read:user': 'Read user profile',
+  'user:email': 'Read email address',
+  'gist': 'Gist access',
+  'read:org': 'Read organizations',
+
+  // Google
+  'https://www.googleapis.com/auth/drive': 'Google Drive',
+  'https://www.googleapis.com/auth/drive.readonly': 'Google Drive (read-only)',
+  'https://www.googleapis.com/auth/calendar.readonly': 'Calendar (read-only)',
+  'https://www.googleapis.com/auth/calendar': 'Calendar',
+  'https://www.googleapis.com/auth/contacts.readonly': 'Contacts (read-only)',
+  'https://www.googleapis.com/auth/contacts': 'Contacts',
+
+  // Microsoft
+  'Files.ReadWrite.All': 'File read/write',
+  'Files.Read.All': 'File read',
+  'Contacts.Read': 'Contacts (read-only)',
+  'Calendars.Read': 'Calendar (read-only)',
+  'User.Read': 'User profile',
+
+  // GitLab
+  'read_api': 'API read access',
+  'read_repository': 'Repository read access',
+  'api': 'Full API access',
+  'read_user': 'Read user profile',
+
+  // Bitbucket
+  'repository': 'Repository access',
+  'pullrequest': 'Pull request access',
+  'account': 'Account access',
+
+  // Dropbox
+  'files.metadata.read': 'Read file metadata',
+  'files.content.read': 'Read file content',
+  'files.content.write': 'Write file content',
+
+  // S3
+  's3:GetObject': 'Read objects',
+  's3:PutObject': 'Write objects',
+  's3:ListBucket': 'List buckets',
+
+  // Box
+  'root_readwrite': 'Read & write all files',
+
+  // Gitea
+  'read:repository': 'Repository read access',
+  'write:repository': 'Repository write access',
+};
+
+/**
+ * Returns a human-readable label for a scope string.
+ * Unknown scopes get cleaned up: URL paths are extracted, dots/underscores become spaces.
+ */
+export function getScopeLabel(scope: string): string {
+  if (SCOPE_LABELS[scope]) {
+    return SCOPE_LABELS[scope];
+  }
+
+  // Google-style URL scopes: extract the last path segment
+  if (scope.startsWith('https://')) {
+    const last = scope.split('/').pop() ?? scope;
+    return formatScopeSegment(last);
+  }
+
+  return formatScopeSegment(scope);
+}
+
+/** Turn a scope segment like "files.content.read" into "Files content read" */
+function formatScopeSegment(segment: string): string {
+  return segment
+    .replace(/[._:]/g, ' ')
+    .replace(/\b\w/g, c => c.toUpperCase())
+    .trim();
+}
+
+/**
+ * Deduplicate and label a list of scope strings.
+ * Returns unique human-readable labels sorted alphabetically.
+ */
+export function getScopeLabels(scopes: string[]): string[] {
+  const unique = [...new Set(scopes)];
+  return unique.map(getScopeLabel).sort();
+}