@burdenoff/microfe-workspaces 2026.1014.1 → 2026.1016.1

package/dist/types/index.d.ts

@@ -0,0 +1,336 @@
+import { MicrofrontendRootProps } from '@burdenoff/fe-libs/shared/types';
+export interface NavItem {
+    id: string;
+    label: string;
+    path: string;
+    icon?: React.ReactNode;
+    badge?: number | string;
+    order?: number;
+    group?: string;
+    children?: NavItem[];
+}
+export interface FooterItem {
+    id: string;
+    label: string;
+    type?: 'status' | 'action' | 'info';
+    order?: number;
+    section?: 'left' | 'center' | 'right';
+    onClick?: () => void;
+}
+export interface WorkspacesRootProps extends MicrofrontendRootProps {
+    /** Organization ID for workspace creation context */
+    organizationId?: string;
+    registerNavItems?: (items: NavItem | NavItem[]) => () => void;
+    registerFooterItems?: (items: FooterItem | FooterItem[]) => () => void;
+    onWorkspaceCreate?: (workspace: Workspace) => void;
+    onProjectCreate?: (project: Project) => void;
+}
+export type WorkspaceType = 'workspace' | 'user';
+export type WorkspaceStatus = 'ACTIVE' | 'SUSPENDED' | 'ARCHIVED' | 'DELETED';
+export type ProjectStatus = 'ACTIVE' | 'INACTIVE' | 'ARCHIVED';
+export interface ProjectTag {
+    id: string;
+    tagId: string;
+    key: string;
+    label: string;
+    value?: string | null;
+    vocabularyId?: string | null;
+    vocabularyKey?: string | null;
+    parentTagId?: string | null;
+    hierarchyPath?: string | null;
+    color?: string | null;
+    icon?: string | null;
+    description?: string | null;
+    metadata?: Record<string, unknown> | null;
+}
+export interface ProjectAssignmentTag {
+    id: string;
+    key: string;
+    label: string;
+    value?: string | null;
+    vocabularyId?: string | null;
+    parentId?: string | null;
+    hierarchyPath?: string | null;
+    color?: string | null;
+    icon?: string | null;
+    description?: string | null;
+    vocabulary?: {
+        key?: string | null;
+    } | null;
+}
+export interface ProjectTagAssignment {
+    id: string;
+    tagId: string;
+    entityType: string;
+    entityId: string;
+    source: string;
+    assignedBy?: string | null;
+    assignedAt?: string | null;
+    validFrom?: string | null;
+    validTo?: string | null;
+    metadata?: Record<string, unknown> | null;
+    tag?: ProjectAssignmentTag | null;
+}
+export interface Workspace {
+    id: string;
+    name: string;
+    type: WorkspaceType;
+    status: WorkspaceStatus;
+    memberCount?: number;
+    projectCount?: number;
+    domain?: string;
+    contactEmail?: string;
+    website?: string;
+    address?: string;
+    tenantId: string;
+    orgId?: string;
+    createdBy?: string;
+    ownerId: string;
+    createdAt: string;
+    updatedAt: string;
+    deletedAt?: string;
+    context?: {
+        type?: string;
+        metadata?: Record<string, unknown>;
+    };
+}
+export interface Project {
+    id: string;
+    name: string;
+    key: string;
+    workspaceId: string;
+    creatorId: string;
+    memberCount?: number;
+    status: ProjectStatus;
+    config?: Record<string, unknown>;
+    tags: ProjectTag[];
+    tagAssignments?: ProjectTagAssignment[];
+    archived: boolean;
+    createdAt: string;
+    updatedAt: string;
+    deletedAt?: string;
+}
+export interface ProjectMember {
+    id: string;
+    projectId: string;
+    userId: string;
+    createdAt: string;
+    updatedAt: string;
+    deletedAt?: string;
+}
+export interface WorkspaceMember {
+    id: string;
+    workspaceId: string;
+    userId: string;
+    createdAt: string;
+    updatedAt: string;
+    deletedAt?: string;
+    context?: {
+        type?: string;
+        metadata?: Record<string, unknown>;
+    };
+}
+export interface WorkspaceInvitation {
+    id: string;
+    workspaceId?: string;
+    workspaceName?: string;
+    projectId?: string;
+    projectIds?: string[];
+    email: string;
+    status: InvitationStatus;
+    roleIds: string[];
+    roleNames?: string[];
+    expiresAt?: string;
+    invitedById: string;
+    invitedUserId?: string;
+    createdAt: string;
+    updatedAt: string;
+    deletedAt?: string;
+    context?: {
+        type?: string;
+        metadata?: Record<string, unknown>;
+    };
+}
+export type InvitationStatus = 'PENDING' | 'ACCEPTED' | 'REJECTED' | 'EXPIRED' | 'CANCELLED';
+export type ViewMode = 'grid' | 'list';
+export type SortBy = 'name' | 'createdAt' | 'updatedAt';
+export type SortDirection = 'asc' | 'desc';
+export interface WorkspaceFilters {
+    type?: WorkspaceType;
+    status?: WorkspaceStatus;
+    search?: string;
+    tenantId?: string;
+    ownerId?: string;
+}
+export interface ProjectFilters {
+    status?: ProjectStatus;
+    archived?: boolean;
+    search?: string;
+    workspaceId?: string;
+    tagIds?: string[];
+    tagKeys?: string[];
+    tagHierarchyPaths?: string[];
+    matchAllTags?: boolean;
+    includeDescendants?: boolean;
+}
+export interface MemberFilters {
+    workspaceId?: string;
+    search?: string;
+}
+export interface ContextInput {
+    type?: string;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Input for creating a workspace via global-tenant-svc
+ * This creates the workspace in the global layer, which then syncs to wspace layer
+ */
+export interface CreateWorkspaceInput {
+    /** Tenant ID where the workspace will be created (required) */
+    tenantId: string;
+    /** Organization ID within the tenant (required) */
+    organizationId: string;
+    /** Display name of the workspace */
+    name: string;
+    /** URL-friendly slug (unique within tenant) */
+    slug: string;
+    /** Workspace type: TEAM or PERSONAL */
+    type?: 'TEAM' | 'PERSONAL';
+    /** Optional metadata */
+    metadata?: Record<string, unknown>;
+}
+/** Tenant entity from global-tenant-svc */
+export interface Tenant {
+    id: string;
+    name: string;
+    slug: string;
+    status: string;
+    type?: string;
+}
+/** List of tenants response */
+export interface TenantList {
+    items: Tenant[];
+    total: number;
+    hasMore: boolean;
+}
+/** Organization entity from global-tenant-svc */
+export interface Organization {
+    id: string;
+    name: string;
+    slug: string;
+    tenantId: string;
+}
+/** List of organizations response */
+export interface OrganizationList {
+    items: Organization[];
+    total: number;
+    hasMore: boolean;
+}
+export interface UpdateWorkspaceInput {
+    name?: string;
+    status?: WorkspaceStatus;
+    domain?: string;
+    contactEmail?: string;
+    website?: string;
+    address?: string;
+    ownerId?: string;
+    context?: ContextInput;
+}
+export interface CreateProjectInput {
+    name: string;
+    key?: string;
+    config?: Record<string, unknown>;
+    tags?: ProjectTag[];
+}
+export interface UpdateProjectInput {
+    name?: string;
+    key?: string;
+    status?: ProjectStatus;
+    config?: Record<string, unknown>;
+    archived?: boolean;
+    tags?: ProjectTag[];
+}
+export interface ReplaceProjectTagsInput {
+    entityId: string;
+    tagIds: string[];
+}
+export interface AddWorkspaceMemberInput {
+    userId: string;
+    context?: ContextInput;
+}
+export interface AddProjectMemberInput {
+    projectId: string;
+    userId: string;
+}
+export interface RemoveProjectMemberInput {
+    projectId: string;
+    userId: string;
+}
+export interface CreateInvitationInput {
+    email: string;
+    roleIds?: string[];
+    workspaceId?: string;
+    projectId?: string;
+    projectIds?: string[];
+    invitedUserId?: string;
+    expiresAt?: string;
+    context?: ContextInput;
+}
+export interface UpdateInvitationInput {
+    status?: InvitationStatus;
+    roleIds?: string[];
+    expiresAt?: string;
+    context?: ContextInput;
+}
+export interface PaginationInput {
+    limit?: number;
+    offset?: number;
+    cursor?: string;
+}
+export interface WorkspaceList {
+    items: Workspace[];
+    total: number;
+    hasMore: boolean;
+}
+export interface ProjectList {
+    items: Project[];
+    total: number;
+    hasMore: boolean;
+}
+export interface MemberList {
+    items: WorkspaceMember[];
+    total: number;
+    hasMore: boolean;
+}
+export interface ProjectMemberList {
+    items: ProjectMember[];
+    total: number;
+    hasMore: boolean;
+}
+export interface InvitationList {
+    items: WorkspaceInvitation[];
+    total: number;
+    hasMore: boolean;
+}
+export type WorkspaceRole = 'owner' | 'admin' | 'member' | 'guest';
+export interface WorkspaceSettings {
+    visibility: 'private' | 'public' | 'unlisted';
+    features: WorkspaceFeature[];
+    integrations: WorkspaceIntegration[];
+}
+export type WorkspaceFeature = 'projects' | 'files' | 'calendar' | 'tags' | 'conversations' | 'workflow';
+export interface WorkspaceIntegration {
+    id: string;
+    type: string;
+    enabled: boolean;
+    config: Record<string, unknown>;
+}
+export interface Activity {
+    id: string;
+    workspaceId: string;
+    userId: string;
+    type: ActivityType;
+    metadata: Record<string, unknown>;
+    createdAt: string;
+}
+export type ActivityType = 'workspace.created' | 'workspace.updated' | 'member.added' | 'member.removed' | 'project.created' | 'file.uploaded';

package/dist/utils/formatters.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Utility functions for formatting dates and strings in the workspace module
+ */
+export declare function formatDate(date: string | Date, options?: Intl.DateTimeFormatOptions): string;
+/**
+ * Format a date to a relative time string (e.g., "2 days ago")
+ * @param date - Date string or Date object
+ * @returns Relative time string
+ */
+export declare function formatRelativeTime(date: string | Date): string;
+/**
+ * Format a date and time to a readable string
+ * @param date - Date string or Date object
+ * @returns Formatted date and time string
+ */
+export declare function formatDateTime(date: string | Date): string;
+/**
+ * Truncate a string to a maximum length and add ellipsis
+ * @param str - String to truncate
+ * @param maxLength - Maximum length before truncation
+ * @returns Truncated string
+ */
+export declare function truncate(str: string, maxLength: number): string;
+/**
+ * Convert a string to title case
+ * @param str - String to convert
+ * @returns Title cased string
+ */
+export declare function toTitleCase(str: string): string;
+/**
+ * Format a workspace status to a human-readable string
+ * @param status - Workspace status
+ * @returns Formatted status string
+ */
+export declare function formatWorkspaceStatus(status: string): string;
+/**
+ * Format a project status to a human-readable string
+ * @param status - Project status
+ * @returns Formatted status string
+ */
+export declare function formatProjectStatus(status: string): string;
+/**
+ * Generate initials from a name
+ * @param name - Full name
+ * @returns Initials (up to 2 characters)
+ */
+export declare function getInitials(name: string): string;
+/**
+ * Format a file size in bytes to a human-readable string
+ * @param bytes - Size in bytes
+ * @returns Formatted size string (e.g., "1.5 MB")
+ */
+export declare function formatFileSize(bytes: number): string;

package/dist/utils/formatters.js

@@ -58,7 +58,7 @@ function d(e) {
 		"GB",
 		"TB"
 	], r = Math.floor(Math.log(e) / Math.log(t));
-	return `${parseFloat((e / t ** +r).toFixed(2))} ${n[r]}`;
+	return `${parseFloat((e / t ** r).toFixed(2))} ${n[r]}`;
 }
 //#endregion
 export { r as formatDate, a as formatDateTime, d as formatFileSize, l as formatProjectStatus, i as formatRelativeTime, c as formatWorkspaceStatus, u as getInitials, s as toTitleCase, o as truncate };

package/dist/utils/i18n.d.ts

@@ -0,0 +1,11 @@
+import { I18nContextValue } from '@burdenoff/fe-libs/shared/providers/shell';
+type TranslationParams = Record<string, string | number>;
+/**
+ * Translate `key` and fall back to `fallback` when the i18n provider
+ * returns the key itself (the convention shell's `useI18n().t(...)` uses
+ * to indicate a missing translation). Optional `params` are forwarded to
+ * the translator and also used for `{name}` style interpolation in the
+ * fallback string.
+ */
+export declare function tWithFallback(t: I18nContextValue['t'], key: string, fallback: string, params?: TranslationParams): string;
+export {};

package/dist/utils/index.d.ts

@@ -0,0 +1,2 @@
+export * from './formatters';
+export * from './tokenHelpers';

package/dist/utils/invitationDisplay.d.ts

@@ -0,0 +1,6 @@
+import { WorkspaceInvitation } from '../types';
+type InvitationLike = Pick<WorkspaceInvitation, 'workspaceName' | 'workspaceId' | 'roleNames' | 'roleIds' | 'projectId' | 'projectIds' | 'context'>;
+export declare function getWorkspaceDisplayName(invitation: InvitationLike): string;
+export declare function getRoleDisplayNames(invitation: InvitationLike): string[];
+export declare function getProjectDisplayNames(invitation: InvitationLike): string[];
+export {};

package/dist/utils/nativeBridge.d.ts

@@ -0,0 +1,2 @@
+export { getPlatform, isNative, isIOS, isAndroid, isWeb, nativeImpact, nativeNotify, nativeToast, nativeConfirm, nativeCopyText, nativeShare, nativeOpenUrl, useNativePlatform, useSafeArea, useNativeKeyboard, useAppState, useDeviceInfo, useHaptics, useStatusBar, } from '@burdenoff/fe-libs/shared/native';
+export type { BurdenoffNativePlatform, BurdenoffNativeBridge, SafeAreaInsets, DeviceInfo, HapticImpactStyle, HapticNotificationType, ToastDuration, ConfirmOptions, ShareOptions, AppState, StatusBarTheme, } from '@burdenoff/fe-libs/shared/native';

package/dist/utils/projectTags.d.ts

@@ -0,0 +1,6 @@
+import { TagItem } from '@burdenoff/fe-libs/tag';
+import { Project, ProjectTag } from '../types';
+export declare function normalizeProjectTags(value: unknown): ProjectTag[];
+export declare function normalizeProjectTagAssignments(value: unknown): ProjectTag[];
+export declare function getProjectDisplayTags(project: Pick<Project, 'tags' | 'tagAssignments'> | null | undefined): ProjectTag[];
+export declare function toProjectTag(tag: TagItem): ProjectTag;

package/dist/utils/slug.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Slug utility functions
+ *
+ * Shared utilities for generating URL-friendly slugs
+ */
+/**
+ * Generate a URL-friendly slug from a name
+ *
+ * @param name - The name to convert to a slug
+ * @returns A lowercase, hyphenated string suitable for URLs
+ */
+export declare function generateSlug(name: string): string;

package/dist/utils/telemetryError.d.ts

@@ -0,0 +1 @@
+export declare function safeTelemetryError(err: unknown): string;

package/dist/utils/tokenHelpers.d.ts

@@ -0,0 +1,112 @@
+import { WorkspaceStatus, ProjectStatus, WorkspaceRole } from '../types';
+/**
+ * Get semantic token classes for workspace status badges
+ *
+ * Uses semantic tokens that automatically adapt to theme (light/dark)
+ * and brand (workspaces, fluidgrids, etc.)
+ *
+ * @param status - The workspace status
+ * @returns Tailwind class string with semantic token classes
+ *
+ * @example
+ * ```tsx
+ * <Badge className={getWorkspaceStatusClasses('ACTIVE')}>
+ *   ACTIVE
+ * </Badge>
+ * ```
+ */
+export declare function getWorkspaceStatusClasses(status: WorkspaceStatus): string;
+/**
+ * Get semantic token classes for project status badges
+ *
+ * @param status - The project status
+ * @returns Tailwind class string with semantic token classes
+ *
+ * @example
+ * ```tsx
+ * <Badge className={getProjectStatusClasses('ACTIVE')}>
+ *   ACTIVE
+ * </Badge>
+ * ```
+ */
+export declare function getProjectStatusClasses(status: ProjectStatus): string;
+/**
+ * Get semantic token classes for member role badges
+ *
+ * @param role - The workspace member role
+ * @returns Tailwind class string with semantic token classes
+ *
+ * @example
+ * ```tsx
+ * <Badge className={getMemberRoleClasses('owner')}>
+ *   Owner
+ * </Badge>
+ * ```
+ */
+export declare function getMemberRoleClasses(role: WorkspaceRole): string;
+/**
+ * Get semantic icon color class for workspace status
+ *
+ * Used for status indicator icons that need to match the status color
+ *
+ * @param status - The workspace status
+ * @returns Tailwind class string for text color
+ *
+ * @example
+ * ```tsx
+ * <CheckCircle className={getWorkspaceStatusIconClass('ACTIVE')} size={16} />
+ * ```
+ */
+export declare function getWorkspaceStatusIconClass(status: WorkspaceStatus): string;
+/**
+ * Get semantic icon color class for project status
+ *
+ * @param status - The project status
+ * @returns Tailwind class string for text color
+ *
+ * @example
+ * ```tsx
+ * <Circle className={getProjectStatusIconClass(project.status)} size={12} />
+ * ```
+ */
+export declare function getProjectStatusIconClass(status: ProjectStatus): string;
+/**
+ * Get semantic background class for workspace status (for larger areas)
+ *
+ * @param status - The workspace status
+ * @returns Tailwind class string for background color
+ *
+ * @example
+ * ```tsx
+ * <div className={getWorkspaceStatusBgClass('SUSPENDED')}>
+ *   Workspace is suspended
+ * </div>
+ * ```
+ */
+export declare function getWorkspaceStatusBgClass(status: WorkspaceStatus): string;
+/**
+ * Get human-readable label for workspace status
+ *
+ * @param status - The workspace status
+ * @returns Formatted status label
+ *
+ * @example
+ * ```tsx
+ * getWorkspaceStatusLabel('ACTIVE') // "Active"
+ * ```
+ */
+export declare function getWorkspaceStatusLabel(status: WorkspaceStatus): string;
+/**
+ * Get human-readable label for project status
+ *
+ * @param status - The project status
+ * @returns Formatted status label
+ */
+export declare function getProjectStatusLabel(status: ProjectStatus): string;
+/**
+ * Get human-readable label for member role
+ *
+ * @param role - The workspace member role
+ * @returns Formatted role label
+ */
+export declare function getMemberRoleLabel(role: WorkspaceRole): string;

package/dist/utils/workspaceBulkInviteCsv.d.ts

@@ -0,0 +1,9 @@
+export interface WorkspaceBulkInviteRow {
+    rowNumber: number;
+    email: string;
+    errors: string[];
+}
+export declare function parseWorkspaceBulkInviteCsv(text: string): WorkspaceBulkInviteRow[];
+export declare const WORKSPACE_BULK_INVITE_TEMPLATE_FILENAME = "workspace-invite-template.csv";
+export declare const WORKSPACE_BULK_INVITE_TEMPLATE_CONTENT: string;
+export declare function downloadWorkspaceBulkInviteTemplate(): void;