dartmind 17.0.0

package/dist/whitelabel/types.d.ts

@@ -0,0 +1,906 @@
+/**
+ * FlutterAI V16 - White-Label Types
+ *
+ * Type definitions for multi-tenant white-label platform.
+ *
+ * @module whitelabel/types
+ * @version 16.0.0
+ */
+/**
+ * Tenant identifier
+ */
+export type TenantId = string;
+/**
+ * Tenant status
+ */
+export type TenantStatus = 'active' | 'suspended' | 'trial' | 'expired' | 'pending';
+/**
+ * Tenant tier/plan
+ */
+export type TenantTier = 'free' | 'starter' | 'professional' | 'enterprise' | 'custom';
+/**
+ * Tenant resolution strategy
+ */
+export type TenantResolutionStrategy = 'domain' | 'subdomain' | 'header' | 'path' | 'token';
+/**
+ * Tenant configuration
+ */
+export interface TenantConfig {
+    /** Unique tenant identifier */
+    id: TenantId;
+    /** Tenant display name */
+    name: string;
+    /** Tenant slug (URL-friendly) */
+    slug: string;
+    /** Tenant status */
+    status: TenantStatus;
+    /** Tenant tier */
+    tier: TenantTier;
+    /** Primary domain */
+    domain?: string;
+    /** Custom domains */
+    customDomains: CustomDomain[];
+    /** Branding configuration */
+    branding: BrandingConfig;
+    /** Feature flags */
+    features: TenantFeatures;
+    /** Rate limits */
+    rateLimits: TenantRateLimits;
+    /** Quota limits */
+    quotas: TenantQuotas;
+    /** Tenant metadata */
+    metadata: Record<string, unknown>;
+    /** Contact email */
+    contactEmail: string;
+    /** Technical contact */
+    technicalContact?: string;
+    /** Billing email */
+    billingEmail?: string;
+    /** Created timestamp */
+    createdAt: Date;
+    /** Updated timestamp */
+    updatedAt: Date;
+    /** Trial end date */
+    trialEndsAt?: Date;
+    /** Subscription end date */
+    subscriptionEndsAt?: Date;
+}
+/**
+ * Tenant features
+ */
+export interface TenantFeatures {
+    /** Enable MCP servers */
+    mcpServers: boolean;
+    /** Enable computer vision */
+    computerVision: boolean;
+    /** Enable plugins */
+    plugins: boolean;
+    /** Enable Figma integration */
+    figmaIntegration: boolean;
+    /** Enable pattern library */
+    patternLibrary: boolean;
+    /** Enable analytics */
+    analytics: boolean;
+    /** Enable team collaboration */
+    teamCollaboration: boolean;
+    /** Enable custom branding */
+    customBranding: boolean;
+    /** Enable custom domains */
+    customDomains: boolean;
+    /** Enable API access */
+    apiAccess: boolean;
+    /** Enable SSO */
+    sso: boolean;
+    /** Enable audit logs */
+    auditLogs: boolean;
+    /** Enable priority support */
+    prioritySupport: boolean;
+    /** Custom feature flags */
+    custom: Record<string, boolean>;
+}
+/**
+ * Tenant rate limits
+ */
+export interface TenantRateLimits {
+    /** Requests per minute */
+    requestsPerMinute: number;
+    /** Requests per hour */
+    requestsPerHour: number;
+    /** Requests per day */
+    requestsPerDay: number;
+    /** Concurrent requests */
+    concurrentRequests: number;
+    /** Max request size (bytes) */
+    maxRequestSize: number;
+    /** Max response size (bytes) */
+    maxResponseSize: number;
+    /** AI requests per minute */
+    aiRequestsPerMinute: number;
+    /** AI requests per day */
+    aiRequestsPerDay: number;
+}
+/**
+ * Tenant quotas
+ */
+export interface TenantQuotas {
+    /** Max users */
+    maxUsers: number;
+    /** Max projects */
+    maxProjects: number;
+    /** Max storage (bytes) */
+    maxStorage: number;
+    /** Max API keys */
+    maxApiKeys: number;
+    /** Max webhooks */
+    maxWebhooks: number;
+    /** Max custom domains */
+    maxCustomDomains: number;
+    /** Max team members */
+    maxTeamMembers: number;
+    /** Monthly AI tokens */
+    monthlyAiTokens: number;
+    /** Monthly generations */
+    monthlyGenerations: number;
+}
+/**
+ * Complete branding configuration
+ */
+export interface BrandingConfig {
+    /** Company/product name */
+    name: string;
+    /** Tagline */
+    tagline?: string;
+    /** Logo configuration */
+    logo: LogoConfig;
+    /** Favicon configuration */
+    favicon?: FaviconConfig;
+    /** Color palette */
+    colors: ColorPalette;
+    /** Typography configuration */
+    typography: TypographyConfig;
+    /** Component styling */
+    components: ComponentStyles;
+    /** Custom CSS */
+    customCss?: string;
+    /** Email templates */
+    emailTemplates?: EmailTemplateConfig;
+    /** Social links */
+    socialLinks?: SocialLinks;
+    /** Legal links */
+    legalLinks?: LegalLinks;
+}
+/**
+ * Logo configuration
+ */
+export interface LogoConfig {
+    /** Light mode logo URL */
+    light: string;
+    /** Dark mode logo URL */
+    dark?: string;
+    /** Icon/favicon URL */
+    icon?: string;
+    /** Logo alt text */
+    alt: string;
+    /** Logo width */
+    width?: number;
+    /** Logo height */
+    height?: number;
+}
+/**
+ * Favicon configuration
+ */
+export interface FaviconConfig {
+    /** Favicon URL (ICO or PNG) */
+    url: string;
+    /** Apple touch icon */
+    appleTouchIcon?: string;
+    /** Android icon 192x192 */
+    android192?: string;
+    /** Android icon 512x512 */
+    android512?: string;
+}
+/**
+ * Color palette
+ */
+export interface ColorPalette {
+    /** Primary color */
+    primary: ColorScale;
+    /** Secondary color */
+    secondary: ColorScale;
+    /** Accent color */
+    accent: ColorScale;
+    /** Neutral color */
+    neutral: ColorScale;
+    /** Success color */
+    success: ColorScale;
+    /** Warning color */
+    warning: ColorScale;
+    /** Error color */
+    error: ColorScale;
+    /** Info color */
+    info: ColorScale;
+    /** Background colors */
+    background: BackgroundColors;
+    /** Text colors */
+    text: TextColors;
+    /** Border colors */
+    border: BorderColors;
+}
+/**
+ * Color scale (50-950)
+ */
+export interface ColorScale {
+    50: string;
+    100: string;
+    200: string;
+    300: string;
+    400: string;
+    500: string;
+    600: string;
+    700: string;
+    800: string;
+    900: string;
+    950: string;
+}
+/**
+ * Background colors
+ */
+export interface BackgroundColors {
+    /** Default background */
+    default: string;
+    /** Paper/card background */
+    paper: string;
+    /** Subtle background */
+    subtle: string;
+    /** Dark mode default */
+    darkDefault: string;
+    /** Dark mode paper */
+    darkPaper: string;
+    /** Dark mode subtle */
+    darkSubtle: string;
+}
+/**
+ * Text colors
+ */
+export interface TextColors {
+    /** Primary text */
+    primary: string;
+    /** Secondary text */
+    secondary: string;
+    /** Disabled text */
+    disabled: string;
+    /** Inverse text */
+    inverse: string;
+    /** Link text */
+    link: string;
+    /** Dark mode primary */
+    darkPrimary: string;
+    /** Dark mode secondary */
+    darkSecondary: string;
+}
+/**
+ * Border colors
+ */
+export interface BorderColors {
+    /** Default border */
+    default: string;
+    /** Light border */
+    light: string;
+    /** Dark border */
+    dark: string;
+    /** Focus border */
+    focus: string;
+    /** Error border */
+    error: string;
+}
+/**
+ * Typography configuration
+ */
+export interface TypographyConfig {
+    /** Font families */
+    fontFamily: FontFamilyConfig;
+    /** Font sizes */
+    fontSize: FontSizeConfig;
+    /** Font weights */
+    fontWeight: FontWeightConfig;
+    /** Line heights */
+    lineHeight: LineHeightConfig;
+    /** Letter spacing */
+    letterSpacing: LetterSpacingConfig;
+}
+/**
+ * Font family configuration
+ */
+export interface FontFamilyConfig {
+    /** Sans-serif font */
+    sans: string;
+    /** Serif font */
+    serif: string;
+    /** Monospace font */
+    mono: string;
+    /** Display/heading font */
+    display?: string;
+}
+/**
+ * Font size configuration
+ */
+export interface FontSizeConfig {
+    xs: string;
+    sm: string;
+    base: string;
+    lg: string;
+    xl: string;
+    '2xl': string;
+    '3xl': string;
+    '4xl': string;
+    '5xl': string;
+    '6xl': string;
+}
+/**
+ * Font weight configuration
+ */
+export interface FontWeightConfig {
+    thin: number;
+    light: number;
+    normal: number;
+    medium: number;
+    semibold: number;
+    bold: number;
+    extrabold: number;
+}
+/**
+ * Line height configuration
+ */
+export interface LineHeightConfig {
+    none: number;
+    tight: number;
+    snug: number;
+    normal: number;
+    relaxed: number;
+    loose: number;
+}
+/**
+ * Letter spacing configuration
+ */
+export interface LetterSpacingConfig {
+    tighter: string;
+    tight: string;
+    normal: string;
+    wide: string;
+    wider: string;
+    widest: string;
+}
+/**
+ * Component styles
+ */
+export interface ComponentStyles {
+    /** Border radius */
+    borderRadius: BorderRadiusConfig;
+    /** Shadows */
+    shadows: ShadowConfig;
+    /** Transitions */
+    transitions: TransitionConfig;
+    /** Button styles */
+    button?: ButtonStyles;
+    /** Input styles */
+    input?: InputStyles;
+    /** Card styles */
+    card?: CardStyles;
+}
+/**
+ * Border radius configuration
+ */
+export interface BorderRadiusConfig {
+    none: string;
+    sm: string;
+    default: string;
+    md: string;
+    lg: string;
+    xl: string;
+    '2xl': string;
+    full: string;
+}
+/**
+ * Shadow configuration
+ */
+export interface ShadowConfig {
+    sm: string;
+    default: string;
+    md: string;
+    lg: string;
+    xl: string;
+    '2xl': string;
+    inner: string;
+    none: string;
+}
+/**
+ * Transition configuration
+ */
+export interface TransitionConfig {
+    fast: string;
+    normal: string;
+    slow: string;
+    easing: string;
+}
+/**
+ * Button styles
+ */
+export interface ButtonStyles {
+    /** Default padding */
+    padding: string;
+    /** Border radius */
+    borderRadius: string;
+    /** Font weight */
+    fontWeight: number;
+    /** Text transform */
+    textTransform?: 'none' | 'uppercase' | 'lowercase' | 'capitalize';
+}
+/**
+ * Input styles
+ */
+export interface InputStyles {
+    /** Border radius */
+    borderRadius: string;
+    /** Border width */
+    borderWidth: string;
+    /** Padding */
+    padding: string;
+    /** Focus ring */
+    focusRing: string;
+}
+/**
+ * Card styles
+ */
+export interface CardStyles {
+    /** Border radius */
+    borderRadius: string;
+    /** Shadow */
+    shadow: string;
+    /** Padding */
+    padding: string;
+    /** Border */
+    border?: string;
+}
+/**
+ * Email template configuration
+ */
+export interface EmailTemplateConfig {
+    /** Header HTML */
+    header?: string;
+    /** Footer HTML */
+    footer?: string;
+    /** Primary button style */
+    buttonStyle?: string;
+    /** Accent color override */
+    accentColor?: string;
+}
+/**
+ * Social links
+ */
+export interface SocialLinks {
+    twitter?: string;
+    github?: string;
+    linkedin?: string;
+    discord?: string;
+    youtube?: string;
+    facebook?: string;
+    instagram?: string;
+}
+/**
+ * Legal links
+ */
+export interface LegalLinks {
+    privacyPolicy?: string;
+    termsOfService?: string;
+    cookiePolicy?: string;
+    acceptableUse?: string;
+}
+/**
+ * Custom domain configuration
+ */
+export interface CustomDomain {
+    /** Domain name */
+    domain: string;
+    /** Domain status */
+    status: DomainStatus;
+    /** SSL certificate status */
+    sslStatus: SSLStatus;
+    /** DNS verification */
+    dnsVerification: DNSVerification;
+    /** Primary domain */
+    isPrimary: boolean;
+    /** Created timestamp */
+    createdAt: Date;
+    /** Verified timestamp */
+    verifiedAt?: Date;
+    /** SSL provisioned timestamp */
+    sslProvisionedAt?: Date;
+}
+/**
+ * Domain status
+ */
+export type DomainStatus = 'pending' | 'verifying' | 'verified' | 'failed' | 'active';
+/**
+ * SSL status
+ */
+export type SSLStatus = 'pending' | 'provisioning' | 'active' | 'failed' | 'expired';
+/**
+ * DNS verification
+ */
+export interface DNSVerification {
+    /** Verification type */
+    type: 'CNAME' | 'TXT' | 'A';
+    /** Record name */
+    name: string;
+    /** Expected value */
+    value: string;
+    /** Verified */
+    verified: boolean;
+    /** Last check timestamp */
+    lastChecked?: Date;
+}
+/**
+ * Generated theme output
+ */
+export interface GeneratedTheme {
+    /** CSS variables */
+    css: string;
+    /** SCSS variables */
+    scss: string;
+    /** Tailwind config */
+    tailwind: TailwindConfig;
+    /** Flutter ThemeData */
+    flutter: FlutterThemeData;
+    /** JSON theme */
+    json: Record<string, unknown>;
+}
+/**
+ * Tailwind config structure
+ */
+export interface TailwindConfig {
+    theme: {
+        extend: {
+            colors: Record<string, Record<string, string>>;
+            fontFamily: Record<string, string[]>;
+            fontSize: Record<string, string>;
+            borderRadius: Record<string, string>;
+            boxShadow: Record<string, string>;
+        };
+    };
+}
+/**
+ * Flutter theme data representation
+ */
+export interface FlutterThemeData {
+    /** Color scheme */
+    colorScheme: FlutterColorScheme;
+    /** Text theme */
+    textTheme: FlutterTextTheme;
+    /** Button theme */
+    buttonTheme: FlutterButtonTheme;
+    /** Input decoration theme */
+    inputDecorationTheme: FlutterInputTheme;
+    /** Card theme */
+    cardTheme: FlutterCardTheme;
+    /** App bar theme */
+    appBarTheme: FlutterAppBarTheme;
+}
+/**
+ * Flutter color scheme
+ */
+export interface FlutterColorScheme {
+    primary: string;
+    onPrimary: string;
+    primaryContainer: string;
+    onPrimaryContainer: string;
+    secondary: string;
+    onSecondary: string;
+    secondaryContainer: string;
+    onSecondaryContainer: string;
+    tertiary: string;
+    onTertiary: string;
+    tertiaryContainer: string;
+    onTertiaryContainer: string;
+    error: string;
+    onError: string;
+    errorContainer: string;
+    onErrorContainer: string;
+    surface: string;
+    onSurface: string;
+    surfaceContainerHighest: string;
+    onSurfaceVariant: string;
+    outline: string;
+    outlineVariant: string;
+    shadow: string;
+    scrim: string;
+    inverseSurface: string;
+    onInverseSurface: string;
+    inversePrimary: string;
+}
+/**
+ * Flutter text theme
+ */
+export interface FlutterTextTheme {
+    displayLarge: FlutterTextStyle;
+    displayMedium: FlutterTextStyle;
+    displaySmall: FlutterTextStyle;
+    headlineLarge: FlutterTextStyle;
+    headlineMedium: FlutterTextStyle;
+    headlineSmall: FlutterTextStyle;
+    titleLarge: FlutterTextStyle;
+    titleMedium: FlutterTextStyle;
+    titleSmall: FlutterTextStyle;
+    bodyLarge: FlutterTextStyle;
+    bodyMedium: FlutterTextStyle;
+    bodySmall: FlutterTextStyle;
+    labelLarge: FlutterTextStyle;
+    labelMedium: FlutterTextStyle;
+    labelSmall: FlutterTextStyle;
+}
+/**
+ * Flutter text style
+ */
+export interface FlutterTextStyle {
+    fontFamily: string;
+    fontSize: number;
+    fontWeight: string;
+    letterSpacing: number;
+    height: number;
+}
+/**
+ * Flutter button theme
+ */
+export interface FlutterButtonTheme {
+    shape: string;
+    padding: string;
+    textStyle: Partial<FlutterTextStyle>;
+}
+/**
+ * Flutter input theme
+ */
+export interface FlutterInputTheme {
+    border: string;
+    focusedBorder: string;
+    errorBorder: string;
+    contentPadding: string;
+}
+/**
+ * Flutter card theme
+ */
+export interface FlutterCardTheme {
+    elevation: number;
+    shape: string;
+    margin: string;
+}
+/**
+ * Flutter app bar theme
+ */
+export interface FlutterAppBarTheme {
+    backgroundColor: string;
+    foregroundColor: string;
+    elevation: number;
+    centerTitle: boolean;
+}
+/**
+ * Tenant context for request isolation
+ */
+export interface TenantContext {
+    /** Tenant ID */
+    tenantId: TenantId;
+    /** Tenant configuration */
+    config: TenantConfig;
+    /** Request ID */
+    requestId: string;
+    /** User ID (if authenticated) */
+    userId?: string;
+    /** User roles */
+    roles: string[];
+    /** Request timestamp */
+    timestamp: Date;
+    /** Request metadata */
+    metadata: Record<string, unknown>;
+}
+/**
+ * Isolation options
+ */
+export interface IsolationOptions {
+    /** Enable database isolation */
+    databaseIsolation: boolean;
+    /** Enable storage isolation */
+    storageIsolation: boolean;
+    /** Enable cache isolation */
+    cacheIsolation: boolean;
+    /** Enable log isolation */
+    logIsolation: boolean;
+    /** Tenant ID header name */
+    tenantHeader: string;
+    /** Enable strict mode */
+    strictMode: boolean;
+}
+/**
+ * Admin API response
+ */
+export interface AdminApiResponse<T> {
+    success: boolean;
+    data?: T;
+    error?: AdminApiError;
+    meta?: AdminApiMeta;
+}
+/**
+ * Admin API error
+ */
+export interface AdminApiError {
+    code: string;
+    message: string;
+    details?: Record<string, unknown>;
+}
+/**
+ * Admin API metadata
+ */
+export interface AdminApiMeta {
+    requestId: string;
+    timestamp: Date;
+    duration: number;
+}
+/**
+ * Tenant creation request
+ */
+export interface CreateTenantRequest {
+    name: string;
+    slug: string;
+    contactEmail: string;
+    tier?: TenantTier;
+    branding?: Partial<BrandingConfig>;
+    features?: Partial<TenantFeatures>;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Tenant update request
+ */
+export interface UpdateTenantRequest {
+    name?: string;
+    status?: TenantStatus;
+    tier?: TenantTier;
+    branding?: Partial<BrandingConfig>;
+    features?: Partial<TenantFeatures>;
+    rateLimits?: Partial<TenantRateLimits>;
+    quotas?: Partial<TenantQuotas>;
+    metadata?: Record<string, unknown>;
+    contactEmail?: string;
+    technicalContact?: string;
+    billingEmail?: string;
+}
+/**
+ * Domain addition request
+ */
+export interface AddDomainRequest {
+    domain: string;
+    isPrimary?: boolean;
+}
+/**
+ * Tenant list options
+ */
+export interface TenantListOptions {
+    status?: TenantStatus;
+    tier?: TenantTier;
+    search?: string;
+    page?: number;
+    limit?: number;
+    sortBy?: 'name' | 'createdAt' | 'updatedAt';
+    sortOrder?: 'asc' | 'desc';
+}
+/**
+ * Tenant list response
+ */
+export interface TenantListResponse {
+    tenants: TenantConfig[];
+    total: number;
+    page: number;
+    limit: number;
+    hasMore: boolean;
+}
+/**
+ * Tenant usage stats
+ */
+export interface TenantUsageStats {
+    tenantId: TenantId;
+    period: 'day' | 'week' | 'month';
+    requests: number;
+    aiRequests: number;
+    tokensUsed: number;
+    storageUsed: number;
+    usersActive: number;
+    projectsCreated: number;
+    generationsCreated: number;
+}
+/**
+ * Tenant analytics
+ */
+export interface TenantAnalytics {
+    tenantId: TenantId;
+    period: {
+        start: Date;
+        end: Date;
+    };
+    metrics: {
+        totalRequests: number;
+        uniqueUsers: number;
+        avgResponseTime: number;
+        errorRate: number;
+        peakConcurrency: number;
+    };
+    usage: {
+        aiTokens: number;
+        storageBytes: number;
+        bandwidthBytes: number;
+    };
+    topEndpoints: Array<{
+        endpoint: string;
+        count: number;
+        avgDuration: number;
+    }>;
+}
+/**
+ * Tenant events
+ */
+export type TenantEvent = {
+    type: 'tenant:created';
+    tenant: TenantConfig;
+} | {
+    type: 'tenant:updated';
+    tenant: TenantConfig;
+    changes: Partial<TenantConfig>;
+} | {
+    type: 'tenant:deleted';
+    tenantId: TenantId;
+} | {
+    type: 'tenant:suspended';
+    tenantId: TenantId;
+    reason: string;
+} | {
+    type: 'tenant:activated';
+    tenantId: TenantId;
+} | {
+    type: 'domain:added';
+    tenantId: TenantId;
+    domain: CustomDomain;
+} | {
+    type: 'domain:verified';
+    tenantId: TenantId;
+    domain: string;
+} | {
+    type: 'domain:removed';
+    tenantId: TenantId;
+    domain: string;
+} | {
+    type: 'branding:updated';
+    tenantId: TenantId;
+    branding: BrandingConfig;
+} | {
+    type: 'quota:exceeded';
+    tenantId: TenantId;
+    quota: keyof TenantQuotas;
+    current: number;
+    limit: number;
+};
+/**
+ * Event handler type
+ */
+export type TenantEventHandler = (event: TenantEvent) => void | Promise<void>;
+/**
+ * Create default tenant features
+ */
+export declare function createDefaultFeatures(tier: TenantTier): TenantFeatures;
+/**
+ * Create default rate limits
+ */
+export declare function createDefaultRateLimits(tier: TenantTier): TenantRateLimits;
+/**
+ * Create default quotas
+ */
+export declare function createDefaultQuotas(tier: TenantTier): TenantQuotas;
+/**
+ * Create default branding
+ */
+export declare function createDefaultBranding(name: string): BrandingConfig;
+//# sourceMappingURL=types.d.ts.map