@spacemade/ui 0.0.1

package/src/helpers/permissions/index.ts

@@ -0,0 +1,292 @@
+import type {
+  PermissionAction as BasePermissionAction,
+  PermissionRole,
+  UserPermissionRow,
+} from '@store/model/user-permission.model'
+import type { OrgGroupPermissionPayload } from '@store/model/org-group-permission.model'
+import type { OrgMembership, Org } from '@store/model'
+
+export type PermissionAction = BasePermissionAction
+export type AppRole = 'anonymous' | 'viewer' | 'editor' | 'admin' | 'owner'
+export type OrgRole = 'none' | 'viewer' | 'member' | 'admin' | 'owner'
+
+export type AppKey =
+  | 'projects'
+  | 'storage'
+  | 'users'
+  | 'providers'
+
+export type AppPermissionDef = {
+  key: AppKey
+  label: string
+  actions: BasePermissionAction[]
+  special?: { key: string; label: string }[]
+}
+
+
+export const APP_PERMISSION_DEFS: AppPermissionDef[] = [
+  {
+    key: 'projects',
+    label: 'Projects',
+    actions: ['read', 'create', 'update', 'delete'],
+    special: [
+      { key: 'permissions.read', label: 'View permissions' },
+      { key: 'permissions.invite', label: 'Invite users' },
+      { key: 'permissions.update', label: 'Update permissions' },
+      { key: 'permissions.delete', label: 'Remove users' },
+    ],
+  },
+  {
+    key: 'storage',
+    label: 'Storage',
+    actions: ['read', 'create', 'update', 'delete'],
+  },
+  {
+    key: 'users',
+    label: 'Users',
+    actions: ['read', 'create', 'update', 'delete'],
+    special: [
+      { key: 'permissions.read', label: 'View permissions' },
+      { key: 'permissions.update', label: 'Update permissions' },
+    ],
+  },
+  {
+    key: 'providers',
+    label: 'Providers',
+    actions: ['read', 'create', 'update', 'delete'],
+  },
+]
+
+export const ROLE_PRESETS: Record<
+  PermissionRole,
+  Record<BasePermissionAction, boolean>
+> = {
+  admin: { read: true, create: true, update: true, delete: true },
+  editor: { read: true, create: true, update: true, delete: false },
+  viewer: { read: true, create: false, update: false, delete: false },
+  none: { read: false, create: false, update: false, delete: false },
+  custom: { read: false, create: false, update: false, delete: false },
+}
+
+export type AppPermissionState = {
+  role: PermissionRole
+  actions: Record<BasePermissionAction, boolean>
+  special: Record<string, boolean>
+}
+
+export type PermissionTree = {
+  apps: Record<string, AppPermissionState>
+}
+
+export type PermissionRowLike = {
+  appKey: string
+  action: string
+  allowed: boolean
+}
+
+export const buildEmptyPermissions = (): PermissionTree => {
+  const apps: Record<string, AppPermissionState> = {}
+  for (const app of APP_PERMISSION_DEFS) {
+    apps[app.key] = {
+      role: 'none',
+      actions: { ...ROLE_PRESETS.none },
+      special: app.special?.reduce((acc, s) => {
+        acc[s.key] = false
+        return acc
+      }, {} as Record<string, boolean>) || {},
+    }
+  }
+  return { apps }
+}
+
+export const rowsToPermissionTree = (
+  rows?: PermissionRowLike[] | null
+): PermissionTree => {
+  const base = buildEmptyPermissions()
+  if (!rows || rows.length === 0) return base
+
+  for (const row of rows) {
+    const appKey = row.appKey as AppKey
+    if (!base.apps[appKey]) continue
+
+    const isSpecial = row.action.includes('.')
+    if (isSpecial) {
+      base.apps[appKey].special[row.action] = row.allowed
+    } else {
+      base.apps[appKey].actions[row.action as PermissionAction] = row.allowed
+    }
+  }
+
+  for (const app of Object.values(base.apps)) {
+    app.role = roleFromActions(app.actions)
+  }
+
+  return base
+}
+
+export const permissionTreeToRows = (
+  userId: string,
+  tree: PermissionTree
+): UserPermissionRow[] => {
+  const rows: UserPermissionRow[] = []
+
+  for (const [appKey, app] of Object.entries(tree.apps)) {
+    for (const [action, allowed] of Object.entries(app.actions)) {
+      rows.push({
+        id: '',
+        userId,
+        orgId: '',
+        appKey,
+        action,
+        allowed,
+        role: app.role,
+        createdAt: '',
+        updatedAt: '',
+      })
+    }
+    for (const [action, allowed] of Object.entries(app.special || {})) {
+      rows.push({
+        id: '',
+        userId,
+        orgId: '',
+        appKey,
+        action,
+        allowed,
+        role: app.role,
+        createdAt: '',
+        updatedAt: '',
+      })
+    }
+  }
+
+  return rows
+}
+
+export const permissionTreeToGroupPermissionPayload = (
+  tree: PermissionTree
+): OrgGroupPermissionPayload[] => {
+  const rows: OrgGroupPermissionPayload[] = []
+
+  for (const [appKey, app] of Object.entries(tree.apps)) {
+    for (const [action, allowed] of Object.entries(app.actions)) {
+      rows.push({
+        appKey,
+        action,
+        allowed,
+        role: app.role,
+      })
+    }
+    for (const [action, allowed] of Object.entries(app.special || {})) {
+      rows.push({
+        appKey,
+        action,
+        allowed,
+        role: app.role,
+      })
+    }
+  }
+
+  return rows
+}
+
+
+export const canAccessApp = (
+  rows: UserPermissionRow[] | null | undefined,
+  appKey: AppKey,
+  action: BasePermissionAction = 'read'
+) => {
+  if (!rows) return false
+  return rows.some(
+    (row) =>
+      row.appKey === appKey &&
+      row.action === action &&
+      row.allowed === true
+  )
+}
+
+export const isPersonalOrg = (org?: Partial<Org> | null, username?: string | null) => {
+  if (!org) return false
+  const slug = String((org as any)?.slug || '').trim().toLowerCase()
+  const name = String((org as any)?.name || '').trim()
+  const normalizedUsername = String(username || '').trim().toLowerCase()
+  return (
+    org.orgType === 'personal' ||
+    (!!slug && slug.endsWith('-personal')) ||
+    (!!name && /\(personal\b/i.test(name)) ||
+    (!!slug && !!normalizedUsername && slug === normalizedUsername)
+  )
+}
+
+export const isBusinessOrg = (org?: Partial<Org> | null) =>
+  org?.orgType === 'business'
+
+export const isOrgOwner = (userId?: string | null, org?: Partial<Org> | null) => {
+  const ownerId = String(org?.ownerId || '').trim()
+  const currentUserId = String(userId || '').trim()
+  return !!ownerId && !!currentUserId && ownerId === currentUserId
+}
+
+export const isOrgAdminMembership = (membership?: Partial<OrgMembership> | null) =>
+  String(membership?.role || '').trim().toLowerCase() === 'admin'
+
+export const hasAppPermissionConfig = (
+  rows: UserPermissionRow[] | null | undefined,
+  appKey: AppKey
+) => {
+  if (!rows) return false
+  return rows.some((row) => row.appKey === appKey)
+}
+
+export const isSurfaceAdmin = (
+  rows: UserPermissionRow[] | null | undefined,
+  appKey: AppKey
+) =>
+  canAccessApp(rows, appKey, 'update') &&
+  rows?.some(
+    (row) =>
+      row.appKey === appKey &&
+      row.action === 'permissions.update' &&
+      row.allowed === true
+  ) === true
+
+export const canAccessAppWithOrgContext = ({
+  rows,
+  appKey,
+  action = 'read',
+  org,
+  membership,
+  userId,
+  username,
+}: {
+  rows: UserPermissionRow[] | null | undefined
+  appKey: AppKey
+  action?: BasePermissionAction
+  org?: Partial<Org> | null
+  membership?: Partial<OrgMembership> | null
+  userId?: string | null
+  username?: string | null
+}) => {
+  if (isOrgOwner(userId, org) || isOrgAdminMembership(membership)) return true
+  if (isPersonalOrg(org, username)) return true
+
+  const hasRowsForApp = hasAppPermissionConfig(rows, appKey)
+
+  // Business orgs stay collaborative by default until an app surface is explicitly configured.
+  if (isBusinessOrg(org) && !hasRowsForApp) return true
+
+  // For non-business orgs or legacy orgs without app-specific rows, preserve permissive behavior.
+  if (!rows || rows.length === 0) return true
+  if (!hasRowsForApp) return true
+
+  return canAccessApp(rows, appKey, action)
+}
+
+export const roleFromActions = (actions: Record<BasePermissionAction, boolean>) => {
+  const match = Object.entries(ROLE_PRESETS).find(([role, preset]) => {
+    if (role === 'custom') return false
+    return (Object.keys(preset) as BasePermissionAction[]).every(
+      (k) => preset[k] === actions[k]
+    )
+  })
+  return (match?.[0] as PermissionRole | undefined) || 'custom'
+}

package/src/helpers/providers/providerFeatures.ts

@@ -0,0 +1,29 @@
+export type ProviderFeatureSlug =
+  | 'vector-store'
+  | 'project'
+
+export const PROVIDER_FEATURES: {
+  slug: ProviderFeatureSlug
+  label: string
+  queryParam:
+    | 'hasStorage'
+    | 'hasProject'
+
+}[] = [
+  { slug: 'vector-store', label: 'Storage', queryParam: 'hasStorage' },
+  { slug: 'project', label: 'Projects', queryParam: 'hasProject' },
+]
+
+export const isProviderFeatureSlug = (
+  slug?: string | null
+): slug is ProviderFeatureSlug =>
+  PROVIDER_FEATURES.some((feature) => feature.slug === slug)
+
+export const getProviderFeatureLabel = (slug?: string | null) =>
+  PROVIDER_FEATURES.find((feature) => feature.slug === slug)?.label || 'Features'
+
+export const getProviderFeatureQueryParams = (slug?: string | null) => {
+  const feature = PROVIDER_FEATURES.find((item) => item.slug === slug)
+  if (!feature) return {}
+  return { [feature.queryParam]: true }
+}

package/src/helpers/sharer/index.ts

@@ -0,0 +1,44 @@
+import { toast } from 'react-toastify'
+
+const facebookBaseSharerURL = 'https://www.facebook.com/sharer/sharer.php'
+const twitterBaseSharerURL = 'https://twitter.com/intent/tweet'
+const linkedinBaseSharerURL = 'https://www.linkedin.com/shareArticle'
+
+export const twitterSharerLink = (url: string, message: string) => {
+	return `${twitterBaseSharerURL}?url=${url}&text=${message}&via=OsirusAI`
+}
+
+export const facebookSharerLink = (url: string, articleTitle: string) => {
+	return `${facebookBaseSharerURL}?u=${url}&title=${articleTitle}`
+}
+
+export const linkedinSharerLink = (url: string, articleTitle: string) => {
+	return `${linkedinBaseSharerURL}?mini=true&url=${url}&title=${articleTitle}&source=OsirusAI`
+}
+
+export const mailSharerLink = (url: string, subject: string) => {
+	return `mailto:?subject=${subject}&body=${url}`
+}
+
+export const copyToClipboard = async (
+	value: string,
+	message: string = 'Link Copied!'
+) => {
+	if (navigator.clipboard) {
+		await navigator.clipboard.writeText(value)
+	} else {
+		const textArea = document.createElement('textarea')
+		textArea.value = value
+		document.body.appendChild(textArea)
+		textArea.focus()
+		textArea.select()
+		try {
+			document.execCommand('copy')
+		} catch (err) {
+			console.error('Unable to copy to clipboard', err)
+		}
+		document.body.removeChild(textArea)
+	}
+
+	toast.success(message)
+}

package/src/helpers/sitemap/sitemap-utils.ts

@@ -0,0 +1,50 @@
+import RSS from 'rss'
+
+type SiteMapURL = {
+	url: string
+	updatedAt?: string
+	images?: string[]
+	priority: string // 1.0, 0.9, 0.8, 0.7, 0.6, 0.5, 0.4, 0.3, 0.2, 0.1
+}
+
+export function generateSiteMap(sitemapURLs: SiteMapURL[]) {
+	return `<?xml version="1.0" encoding="UTF-8"?>
+<urlset xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:image="http://www.google.com/schemas/sitemap-image/1.1" xsi:schemaLocation="http://www.sitemaps.org/schemas/sitemap/0.9 http://www.sitemaps.org/schemas/sitemap/0.9/sitemap.xsd http://www.google.com/schemas/sitemap-image/1.1 http://www.google.com/schemas/sitemap-image/1.1/sitemap-image.xsd" xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">		>
+${sitemapURLs
+	.map((sitemap) => {
+		return `
+<url>
+	<loc>${process.env.NEXT_PUBLIC_SITE_URL}${sitemap.url}</loc>
+	${sitemap.updatedAt ? `<lastmod>${sitemap.updatedAt}</lastmod>` : ''}
+	<priority>${sitemap.priority}</priority>
+	${generateImages(sitemap.images?.filter((image) => !!image) || [])}
+</url>`
+	})
+	.join('')}
+</urlset>
+`
+}
+
+const generateImages = (images: string[]) => {
+	return `${images
+		.map((imageUrl) => {
+			return `
+	<image:image>
+		<image:loc>${imageUrl}</image:loc>
+	</image:image>`
+		})
+		.join('')}`
+}
+
+export function generateRssFeed() {
+	return new RSS({
+		title: 'Osirus AI | RSS Feed',
+		description: 'The leading website for news on CMS, DXP, and more.',
+		site_url: process.env.NEXT_PUBLIC_SITE_URL || '',
+		feed_url: `${process.env.NEXT_PUBLIC_SITE_URL}/feed`,
+		image_url: `${process.env.NEXT_PUBLIC_SITE_URL}/images/logo/Osirus-Logo-Horizontal.svg`,
+		pubDate: new Date(),
+		copyright: `All rights reserved ${new Date().getFullYear()}, Osirus AI`,
+		language: 'en-US',
+	})
+}

package/src/helpers/slugUtils/index.ts

@@ -0,0 +1,39 @@
+/**
+ * Creates a URL-friendly slug from a project name
+ * @param name - The project name to convert to a slug
+ * @returns A URL-safe project slug
+ */
+export const createProjectSlug = (name: string): string => {
+  if (!name || typeof name !== 'string') {
+    return 'project'
+  }
+  
+  return name
+    .toLowerCase()
+    .trim()
+    .replace(/\s+/g, '-')           // Replace spaces with hyphens
+    .replace(/[^a-z0-9-]/g, '')     // Remove special characters
+    .replace(/-+/g, '-')            // Replace multiple hyphens with single
+    .replace(/^-|-$/g, '')          // Remove leading/trailing hyphens
+    .substring(0, 50) || 'project'  // Limit length and provide fallback
+}
+
+/**
+ * Creates a URL-friendly slug from an agent name
+ * @param name - The agent name to convert to a slug
+ * @returns A URL-safe agent slug
+ */
+export const createAgentSlug = (name: string): string => {
+  if (!name || typeof name !== 'string') {
+    return 'agent'
+  }
+
+  return name
+    .toLowerCase()
+    .trim()
+    .replace(/\s+/g, '-')           // Replace spaces with hyphens
+    .replace(/[^a-z0-9-]/g, '')     // Remove special characters
+    .replace(/-+/g, '-')            // Replace multiple hyphens with single
+    .replace(/^-|-$/g, '')          // Remove leading/trailing hyphens
+    .substring(0, 50) || 'agent'    // Limit length and provide fallback
+}

package/src/helpers/sonicVoices.ts

@@ -0,0 +1,22 @@
+export const SONIC_VOICES = [
+  { voiceId: 'tiffany', label: 'Tiffany - English (US)' },
+  { voiceId: 'matthew', label: 'Matthew - English (US)' },
+  { voiceId: 'amy', label: 'Amy - English (GB)' },
+  { voiceId: 'olivia', label: 'Olivia - English (AU)' },
+  { voiceId: 'kiara', label: 'Kiara - English (IN)' },
+  { voiceId: 'arjun', label: 'Arjun - English (IN)' },
+  { voiceId: 'ambre', label: 'Ambre - French (FR)' },
+  { voiceId: 'florian', label: 'Florian - French (FR)' },
+  { voiceId: 'beatrice', label: 'Beatrice - German (DE)' },
+  { voiceId: 'tina', label: 'Tina - German (DE)' },
+  { voiceId: 'lorenzo', label: 'Lorenzo - Italian (IT)' },
+  { voiceId: 'lennart', label: 'Lennart - Dutch (NL)' },
+  { voiceId: 'lupe', label: 'Lupe - Spanish (US)' },
+  { voiceId: 'carlos', label: 'Carlos - Spanish (ES)' },
+  { voiceId: 'carolina', label: 'Carolina - Spanish (LATAM)' },
+  { voiceId: 'leo', label: 'Leo - Portuguese (BR)' },
+] as const;
+
+export const SONIC_VOICE_ID_SET = new Set(
+  SONIC_VOICES.map((voice) => voice.voiceId)
+);

package/src/helpers/string/index.ts

@@ -0,0 +1,93 @@
+import { User } from '@store/model';
+import { GET_FILE_EXTENSION_REGEX } from '@helpers/constants';
+
+export const truncateString = (
+	string: string | null | undefined,
+	maxLength: number
+): string | null | undefined => {
+	return string && string?.length > maxLength
+		? string.slice(0, maxLength - 3) + '...'
+		: string;
+};
+
+export const generateUUID = () =>
+	'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (c) => {
+		const r = (Math.random() * 16) | 0,
+			v = c == 'x' ? r : (r & 0x3) | 0x8;
+		return v.toString(16);
+	});
+
+export const randomString = () => Math.floor(Date.now() * Math.random());
+
+export const transformToURLFormat = (string: string) => {
+	const specialCharsRegex = /[^\w\s-]/g;
+	const trimmedString = string.trim().toLowerCase();
+	const stringWithoutSpecialChars = trimmedString.replace(specialCharsRegex, '');
+	const urlFriendlyString = stringWithoutSpecialChars.replace(/\s+/g, '-');
+	return urlFriendlyString;
+};
+
+export const currencyPipe = (number: number | undefined) => {
+	if (!number && number !== 0) return;
+
+	const formatter = new Intl.NumberFormat('en-US', {
+		style: 'currency',
+		currency: 'USD',
+		minimumFractionDigits: 2,
+	});
+
+	return formatter.format(number);
+};
+
+export const getFileExtension = (value: string) =>
+	value.match(GET_FILE_EXTENSION_REGEX)?.[0];
+
+export const createUniqueTokenByObject = (obj: { [key: string]: any }) =>
+	Object.entries(obj)
+		.map(([key, val]) => `${key}:${val}`)
+		.join('-');
+
+export const getUserNameFromUser = (user?: User | null) => {
+	if (!user) return ''; // or 'Osirus AI' / 'Unknown' if you prefer
+
+	const first = user.firstName?.trim();
+	const last = user.lastName?.trim();
+	const full = [first, last].filter(Boolean).join(' ').trim();
+
+	return full || user.name || '';
+};
+
+export const generatePageDescription = (htmlString: string) => {
+	if (!htmlString) return '';
+
+	const textContent = htmlString
+		.replace(/<script[\s\S]*?>[\s\S]*?<\/script>/gi, ' ')
+		.replace(/<style[\s\S]*?>[\s\S]*?<\/style>/gi, ' ')
+		.replace(/<[^>]+>/g, ' ')
+		.replace(/\s+/g, ' ')
+		.trim();
+
+	if (!textContent) return '';
+	return `${textContent.substring(0, 350)}...`;
+};
+
+export const removeProtocolPortAndPathFromUrl = (string: string) => {
+	const match = string.match(/^(https?:\/\/)?([^:/]+)(:[0-9]+)?(\/.*)?/);
+	return match && match[2] ? match[2] : string;
+};
+
+export const formatNumericValue = (value: string) => {
+	let formattedValue = value.replace(/[^\d.]/g, '');
+
+	if (formattedValue.includes('.')) {
+		const [integerPart, decimalPart] = formattedValue.split('.');
+		formattedValue =
+			integerPart.replace(/\B(?=(\d{3})+(?!\d))/g, ',') +
+			'.' +
+			decimalPart.slice(0, 14);
+	} else {
+		formattedValue = formattedValue.replace(/\B(?=(\d{3})+(?!\d))/g, ',');
+	}
+
+	return formattedValue;
+};

package/src/helpers/theme/colors.ts

@@ -0,0 +1,27 @@
+export const colors = {
+	transparent: '#0000',
+	'primary': '#006FE5',
+	'secondary': '#050330',
+	'success': '#5dad2f',
+	'warning': '#fbe020',
+	'danger': '#f6494d',
+	'background': '#f4f4f6',
+	'light': '#c1c1c1',
+	'medium-blue': '#4877a5',
+	'dark-blue': '#234a75',
+	'alice-blue': '#eff5fb',
+	'light-blue': '#cefaff',
+	'lighter-gray': '#eeeeee',
+	'light-gray': '#e2e2e4',
+	'medium-gray': '#97989e',
+	'dark-gray': '#333333',
+	'dark': '#30313d',
+	'dark-medium': '#1a1a21',
+	'dark-900': '#111117',
+	'purple': '#ae2eca',
+	'purple-dark': '#8300c8',
+	'white': '#ffffff',
+	'black': '#000000',
+}
+
+export type ThemeColorsKeys = keyof typeof colors

package/src/helpers/types/api.ts

@@ -0,0 +1,22 @@
+export type ApiPagingResponse<T> = {
+	results: T[]
+	next: string | null
+	previous: string | null
+	count: number
+}
+
+export enum ApiEntityNames {
+	owner = 'owner',
+	creator = 'creator',
+	modifier = 'modifier',
+	post_category = 'post_category',
+	address = 'address',
+	category = 'category',
+	tags = 'tags',
+	allowedDomains = 'allowedDomains',
+	sites = 'sites',
+	product = 'product',
+	agentSetting = 'agentSetting',
+	provider = 'provider',
+	provider_model = 'provider_model',
+}

package/src/helpers/types/customer-io.ts

@@ -0,0 +1,47 @@
+type CustomerIOUser = {
+	id: string
+	email: string
+	created_at: number
+	name: string
+	first_name: string
+	last_name: string
+	profile_image_url: string
+}
+
+type CustomerIOMessageEvent = {
+	type: `in-app:${
+		| 'message-opened'
+		| 'message-dismissed'
+		| 'message-action'
+		| 'message-error'}`
+	detail: {
+		messageId: string
+		deliveryId?: string // not present in test messages
+	}
+}
+
+export type CustomerIO = {
+	// Identifies a person and updates their attributes. Future calls reference this person.
+	identify: (user: CustomerIOUser) => void
+
+	// Sends a `page` event, representing a “pageview”. It's automatic by default
+	page: (pageName: string, parameters: Object) => void
+
+	// Sends a custom event, representing a person’s activity on your website.
+	track: (eventName: string, parameters: Object) => void
+
+	// Stop identifying a person. You might send this call when someone logs out or refuses tracking consent.
+	reset: () => void
+
+	//Listen for an in-app message event.
+	on: (
+		eventType: CustomerIOMessageEvent['type'],
+		callback: (event: CustomerIOMessageEvent) => void
+	) => void
+
+	// Stop listening for an in-app message event.
+	off: (
+		eventType: CustomerIOMessageEvent['type'],
+		callback: (event: CustomerIOMessageEvent) => void
+	) => void
+}

package/src/helpers/types/data-layer.ts

@@ -0,0 +1,25 @@
+/**
+ * Check this URL for reference to these properties
+ * https://developers.google.com/analytics/devguides/collection/ga4/reference/events?client_type=gtag#select_promotion
+ */
+
+export enum DataLayerEvents {
+	// Platform
+	login = 'login',
+	sign_up = 'sign_up',
+}
+
+export type DataLayerObject = {
+	push: (args: DataLayerArgs) => void
+}
+
+type DataLayerArgs = {
+	event?: DataLayerEvents
+	method?: string | null
+
+	// Currency of the items associated with the event, in 3-letter ISO 4217 format.
+	currency?: 'USD'
+
+	// The monetary value of the event. This is important for conversions. eg: 7.77
+	value?: number
+}