chore: import upstream snapshot with attribution

apps/sim/lib/workspaces/organization/utils.ts

@@ -0,0 +1,93 @@
+/**
+ * Utility functions for organization-related operations
+ * These are pure functions that compute values from organization data
+ */
+
+import { isOrgAdminRole } from '@sim/platform-authz/predicates'
+import { normalizeEmail } from '@sim/utils/string'
+import { quickValidateEmail } from '@/lib/messaging/email/validation'
+import type { Organization } from '@/lib/workspaces/organization/types'
+
+/**
+ * Get the role of a user in an organization
+ */
+export function getUserRole(
+  organization: Organization | null | undefined,
+  userEmail?: string
+): string {
+  if (!userEmail || !organization?.members) {
+    return 'member'
+  }
+  const currentMember = organization.members.find((m) => m.user?.email === userEmail)
+  return currentMember?.role ?? 'member'
+}
+
+/**
+ * Check if a user is an admin or owner in an organization
+ */
+export function isAdminOrOwner(
+  organization: Organization | null | undefined,
+  userEmail?: string
+): boolean {
+  const role = getUserRole(organization, userEmail)
+  return isOrgAdminRole(role)
+}
+
+/**
+ * Calculate seat usage for an organization
+ */
+export function calculateSeatUsage(organization: Organization | null | undefined): {
+  used: number
+  members: number
+  pending: number
+} {
+  if (!organization) {
+    return { used: 0, members: 0, pending: 0 }
+  }
+
+  const membersCount = organization.members?.length || 0
+  const pendingInvitationsCount =
+    organization.invitations?.filter(
+      (inv) => inv.status === 'pending' && inv.membershipIntent !== 'external'
+    ).length || 0
+
+  return {
+    used: membersCount + pendingInvitationsCount,
+    members: membersCount,
+    pending: pendingInvitationsCount,
+  }
+}
+
+/**
+ * Get used seats from an organization
+ * Alias for calculateSeatUsage
+ */
+export function getUsedSeats(organization: Organization | null | undefined) {
+  return calculateSeatUsage(organization)
+}
+
+/**
+ * Generate a URL-friendly slug from a name
+ */
+export function generateSlug(name: string): string {
+  return name
+    .toLowerCase()
+    .replace(/[^a-z0-9]/g, '-') // Replace non-alphanumeric with hyphens
+    .replace(/-+/g, '-') // Replace consecutive hyphens with single hyphen
+    .replace(/^-|-$/g, '') // Remove leading and trailing hyphens
+}
+
+/**
+ * Validate organization slug format
+ */
+export function validateSlug(slug: string): boolean {
+  const slugRegex = /^[a-z0-9-_]+$/
+  return slugRegex.test(slug)
+}
+
+/**
+ * Validate email format
+ */
+export function validateEmail(email: string): boolean {
+  return quickValidateEmail(normalizeEmail(email)).isValid
+}