@atomixstudio/mcp 0.1.1 → 1.0.1

package/src/tenant-store.ts

@@ -1,436 +0,0 @@
-/**
- * Tenant Store
- * 
- * Manages per-tenant token configurations with support for:
- * - Local file storage (default)
- * - Cloud API storage (future)
- * - In-memory caching
- * 
- * Each tenant gets isolated storage for:
- * - Component defaults
- * - Token overrides
- * - Locked token configurations
- */
-
-import fs from "fs";
-import path from "path";
-import { fileURLToPath } from "url";
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-
-// ============================================
-// TYPES
-// ============================================
-
-export interface TenantConfig {
-  tenantId: string;
-  createdAt: string;
-  updatedAt: string;
-  componentDefaults: Record<string, unknown>;
-  lockedTokens: string[];
-  tokenOverrides: Record<string, string>;
-}
-
-export interface TenantStoreOptions {
-  /** Base directory for tenant data (default: ./data/tenants) */
-  dataDir?: string;
-  /** Cloud API URL for remote storage (optional) */
-  cloudApiUrl?: string;
-  /** Enable in-memory caching */
-  enableCache?: boolean;
-  /** Cache TTL in milliseconds */
-  cacheTtlMs?: number;
-}
-
-interface CacheEntry {
-  data: TenantConfig;
-  timestamp: number;
-}
-
-// ============================================
-// TENANT STORE
-// ============================================
-
-export class TenantStore {
-  private dataDir: string;
-  private cloudApiUrl: string | null;
-  private cache: Map<string, CacheEntry>;
-  private enableCache: boolean;
-  private cacheTtlMs: number;
-
-  constructor(options: TenantStoreOptions = {}) {
-    this.dataDir = options.dataDir || path.join(__dirname, "../data/tenants");
-    this.cloudApiUrl = options.cloudApiUrl || null;
-    this.cache = new Map();
-    this.enableCache = options.enableCache ?? true;
-    this.cacheTtlMs = options.cacheTtlMs ?? 60000; // 1 minute default
-
-    // Ensure data directory exists
-    this.ensureDataDir();
-  }
-
-  private ensureDataDir(): void {
-    if (!fs.existsSync(this.dataDir)) {
-      fs.mkdirSync(this.dataDir, { recursive: true });
-    }
-  }
-
-  private getTenantFilePath(tenantId: string): string {
-    // Sanitize tenant ID for filesystem safety
-    const safeId = tenantId.replace(/[^a-zA-Z0-9-_]/g, "_");
-    return path.join(this.dataDir, `${safeId}.json`);
-  }
-
-  private isCacheValid(entry: CacheEntry): boolean {
-    return Date.now() - entry.timestamp < this.cacheTtlMs;
-  }
-
-  // ============================================
-  // PUBLIC API
-  // ============================================
-
-  /**
-   * Get tenant configuration
-   */
-  async getTenant(tenantId: string): Promise<TenantConfig | null> {
-    // Check cache first
-    if (this.enableCache) {
-      const cached = this.cache.get(tenantId);
-      if (cached && this.isCacheValid(cached)) {
-        return cached.data;
-      }
-    }
-
-    // Try cloud API first if configured
-    if (this.cloudApiUrl) {
-      try {
-        const cloudData = await this.fetchFromCloud(tenantId);
-        if (cloudData) {
-          this.updateCache(tenantId, cloudData);
-          return cloudData;
-        }
-      } catch (error) {
-        console.warn(`Cloud fetch failed for tenant ${tenantId}, falling back to local`);
-      }
-    }
-
-    // Fall back to local storage
-    const localData = this.loadFromFile(tenantId);
-    if (localData) {
-      this.updateCache(tenantId, localData);
-    }
-    return localData;
-  }
-
-  /**
-   * Save tenant configuration
-   */
-  async saveTenant(tenantId: string, config: Partial<TenantConfig>): Promise<TenantConfig> {
-    const existing = await this.getTenant(tenantId);
-    const now = new Date().toISOString();
-
-    const updated: TenantConfig = {
-      tenantId,
-      createdAt: existing?.createdAt || now,
-      updatedAt: now,
-      componentDefaults: config.componentDefaults || existing?.componentDefaults || {},
-      lockedTokens: config.lockedTokens || existing?.lockedTokens || [],
-      tokenOverrides: config.tokenOverrides || existing?.tokenOverrides || {},
-    };
-
-    // Save to cloud if configured
-    if (this.cloudApiUrl) {
-      try {
-        await this.saveToCloud(tenantId, updated);
-      } catch (error) {
-        console.warn(`Cloud save failed for tenant ${tenantId}, saving locally`);
-      }
-    }
-
-    // Always save locally as backup
-    this.saveToFile(tenantId, updated);
-    this.updateCache(tenantId, updated);
-
-    return updated;
-  }
-
-  /**
-   * Update component defaults for a tenant
-   */
-  async updateComponentDefaults(
-    tenantId: string,
-    componentKey: string,
-    defaults: unknown
-  ): Promise<TenantConfig> {
-    const existing = await this.getTenant(tenantId);
-    const componentDefaults = existing?.componentDefaults || {};
-
-    return this.saveTenant(tenantId, {
-      ...existing,
-      componentDefaults: {
-        ...componentDefaults,
-        [componentKey]: defaults,
-      },
-    });
-  }
-
-  /**
-   * Check if a token is locked for a tenant
-   */
-  async isTokenLocked(tenantId: string, tokenPath: string): Promise<boolean> {
-    const tenant = await this.getTenant(tenantId);
-    if (!tenant) return false;
-
-    return tenant.lockedTokens.some(locked => {
-      // Support wildcards: "button.*.bgColor" matches "button.primary.bgColor"
-      if (locked.includes("*")) {
-        const regex = new RegExp("^" + locked.replace(/\*/g, "[^.]+") + "$");
-        return regex.test(tokenPath);
-      }
-      return locked === tokenPath;
-    });
-  }
-
-  /**
-   * Lock tokens for a tenant
-   */
-  async lockTokens(tenantId: string, tokenPaths: string[]): Promise<TenantConfig> {
-    const existing = await this.getTenant(tenantId);
-    const currentLocked = existing?.lockedTokens || [];
-    const newLocked = [...new Set([...currentLocked, ...tokenPaths])];
-
-    return this.saveTenant(tenantId, {
-      ...existing,
-      lockedTokens: newLocked,
-    });
-  }
-
-  /**
-   * Unlock tokens for a tenant
-   */
-  async unlockTokens(tenantId: string, tokenPaths: string[]): Promise<TenantConfig> {
-    const existing = await this.getTenant(tenantId);
-    const currentLocked = existing?.lockedTokens || [];
-    const newLocked = currentLocked.filter(t => !tokenPaths.includes(t));
-
-    return this.saveTenant(tenantId, {
-      ...existing,
-      lockedTokens: newLocked,
-    });
-  }
-
-  /**
-   * List all tenants
-   */
-  listTenants(): string[] {
-    if (!fs.existsSync(this.dataDir)) {
-      return [];
-    }
-
-    return fs.readdirSync(this.dataDir)
-      .filter(f => f.endsWith(".json"))
-      .map(f => f.replace(".json", ""));
-  }
-
-  /**
-   * Delete a tenant
-   */
-  async deleteTenant(tenantId: string): Promise<boolean> {
-    const filePath = this.getTenantFilePath(tenantId);
-    
-    // Remove from cache
-    this.cache.delete(tenantId);
-
-    // Delete from cloud if configured
-    if (this.cloudApiUrl) {
-      try {
-        await this.deleteFromCloud(tenantId);
-      } catch (error) {
-        console.warn(`Cloud delete failed for tenant ${tenantId}`);
-      }
-    }
-
-    // Delete local file
-    if (fs.existsSync(filePath)) {
-      fs.unlinkSync(filePath);
-      return true;
-    }
-
-    return false;
-  }
-
-  /**
-   * Clear cache
-   */
-  clearCache(): void {
-    this.cache.clear();
-  }
-
-  // ============================================
-  // PRIVATE: File Storage
-  // ============================================
-
-  private loadFromFile(tenantId: string): TenantConfig | null {
-    const filePath = this.getTenantFilePath(tenantId);
-    
-    if (!fs.existsSync(filePath)) {
-      return null;
-    }
-
-    try {
-      const content = fs.readFileSync(filePath, "utf-8");
-      return JSON.parse(content) as TenantConfig;
-    } catch (error) {
-      console.error(`Failed to load tenant ${tenantId}:`, error);
-      return null;
-    }
-  }
-
-  private saveToFile(tenantId: string, config: TenantConfig): void {
-    const filePath = this.getTenantFilePath(tenantId);
-    
-    try {
-      fs.writeFileSync(filePath, JSON.stringify(config, null, 2), "utf-8");
-    } catch (error) {
-      console.error(`Failed to save tenant ${tenantId}:`, error);
-      throw error;
-    }
-  }
-
-  // ============================================
-  // PRIVATE: Cloud Storage (Future)
-  // ============================================
-
-  private async fetchFromCloud(tenantId: string): Promise<TenantConfig | null> {
-    if (!this.cloudApiUrl) return null;
-
-    const response = await fetch(`${this.cloudApiUrl}/tenants/${tenantId}`);
-    
-    if (!response.ok) {
-      if (response.status === 404) return null;
-      throw new Error(`Cloud API error: ${response.status}`);
-    }
-
-    return response.json() as Promise<TenantConfig>;
-  }
-
-  private async saveToCloud(tenantId: string, config: TenantConfig): Promise<void> {
-    if (!this.cloudApiUrl) return;
-
-    const response = await fetch(`${this.cloudApiUrl}/tenants/${tenantId}`, {
-      method: "PUT",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify(config),
-    });
-
-    if (!response.ok) {
-      throw new Error(`Cloud API error: ${response.status}`);
-    }
-  }
-
-  private async deleteFromCloud(tenantId: string): Promise<void> {
-    if (!this.cloudApiUrl) return;
-
-    const response = await fetch(`${this.cloudApiUrl}/tenants/${tenantId}`, {
-      method: "DELETE",
-    });
-
-    if (!response.ok && response.status !== 404) {
-      throw new Error(`Cloud API error: ${response.status}`);
-    }
-  }
-
-  // ============================================
-  // PRIVATE: Cache
-  // ============================================
-
-  private updateCache(tenantId: string, data: TenantConfig): void {
-    if (this.enableCache) {
-      this.cache.set(tenantId, {
-        data,
-        timestamp: Date.now(),
-      });
-    }
-  }
-}
-
-// ============================================
-// SINGLETON INSTANCE
-// ============================================
-
-let defaultStore: TenantStore | null = null;
-
-export function getTenantStore(options?: TenantStoreOptions): TenantStore {
-  if (!defaultStore) {
-    defaultStore = new TenantStore({
-      cloudApiUrl: process.env.ATOMIX_CLOUD_API || undefined,
-      ...options,
-    });
-  }
-  return defaultStore;
-}
-
-// ============================================
-// VALIDATION HELPERS
-// ============================================
-
-export interface TokenChangeValidation {
-  valid: boolean;
-  blockedChanges: Array<{
-    path: string;
-    reason: string;
-  }>;
-}
-
-/**
- * Validate token changes against locked tokens
- */
-export async function validateTokenChanges(
-  tenantId: string,
-  changes: Record<string, unknown>,
-  store?: TenantStore
-): Promise<TokenChangeValidation> {
-  const tenantStore = store || getTenantStore();
-  const blockedChanges: TokenChangeValidation["blockedChanges"] = [];
-
-  // Flatten changes to paths
-  const changePaths = flattenToPaths(changes);
-
-  for (const changePath of changePaths) {
-    const isLocked = await tenantStore.isTokenLocked(tenantId, changePath);
-    if (isLocked) {
-      blockedChanges.push({
-        path: changePath,
-        reason: `Token "${changePath}" is locked for tenant "${tenantId}"`,
-      });
-    }
-  }
-
-  return {
-    valid: blockedChanges.length === 0,
-    blockedChanges,
-  };
-}
-
-/**
- * Flatten an object to dot-notation paths
- */
-function flattenToPaths(obj: unknown, prefix = ""): string[] {
-  const paths: string[] = [];
-
-  if (obj && typeof obj === "object" && !Array.isArray(obj)) {
-    for (const [key, value] of Object.entries(obj)) {
-      const newPrefix = prefix ? `${prefix}.${key}` : key;
-      
-      if (value && typeof value === "object" && !Array.isArray(value)) {
-        paths.push(...flattenToPaths(value, newPrefix));
-      } else {
-        paths.push(newPrefix);
-      }
-    }
-  }
-
-  return paths;
-}
-

package/src/tokens.ts

@@ -1,208 +0,0 @@
-/**
- * Token data for MCP server
- * 
- * Loads primitives dynamically from the local @atomix/tokens package.
- * This module provides the single source of truth for all design tokens.
- */
-
-import { createRequire } from "node:module";
-import { fileURLToPath } from "node:url";
-import { dirname, join } from "node:path";
-
-// Get the directory of this file
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-
-// Load primitives from the sibling atomix package
-// Path: packages/atomix-mcp/dist -> packages/atomix/dist
-const atomixPath = join(__dirname, "../../atomix/dist/index.mjs");
-
-// Dynamic import with fallback to inline primitives
-let loadedPrimitives: Record<string, unknown> | null = null;
-
-async function loadPrimitives(): Promise<Record<string, unknown>> {
-  if (loadedPrimitives) return loadedPrimitives;
-  
-  try {
-    const module = await import(atomixPath);
-    loadedPrimitives = module.primitives as Record<string, unknown>;
-    return loadedPrimitives;
-  } catch (error) {
-    console.error(`Failed to load @atomix/tokens from ${atomixPath}:`, error);
-    console.error("Falling back to inline primitives...");
-    loadedPrimitives = FALLBACK_PRIMITIVES;
-    return FALLBACK_PRIMITIVES;
-  }
-}
-
-// Export a synchronous reference (populated on first use)
-// For the MCP server, we'll use loadPrimitives() to ensure it's loaded
-export { loadPrimitives };
-
-// Synchronous export (may be empty until loadPrimitives is called)
-export let primitives: Record<string, unknown> = {};
-
-// Initialize primitives immediately
-loadPrimitives().then((p) => {
-  primitives = p;
-});
-
-export const TOKEN_CATEGORIES = [
-  "colors",
-  "typography", 
-  "spacing",
-  "sizing",
-  "shadows",
-  "radius",
-  "motion",
-  "zIndex",
-  "borders",
-] as const;
-
-export type TokenCategory = typeof TOKEN_CATEGORIES[number];
-
-// Fallback primitives (minimal set for testing when @atomix/tokens isn't available)
-const FALLBACK_PRIMITIVES: Record<string, unknown> = {
-  colors: {
-    static: {
-      brand: {
-        primary: "#007061",
-        primaryLight: "#00A389",
-        primaryDark: "#005A4D",
-        primaryForeground: "#FFFFFF",
-      },
-      white: "#FFFFFF",
-      black: "#000000",
-    },
-    modes: {
-      light: {
-        bgPage: "#FFFFFF",
-        bgSurface: "#FFFFFF",
-        bgMuted: "#F5F5F5",
-        textPrimary: "#171717",
-        textSecondary: "#525252",
-        textMuted: "#A3A3A3",
-        // Icon colors (derived from brand/text)
-        iconBrand: "#007061",   // = brand.primary
-        iconStrong: "#171717",  // = textPrimary
-        iconSubtle: "#525252",  // = textSecondary
-        iconDisabled: "#A3A3A3", // = textMuted
-        borderPrimary: "#E5E5E5",
-      },
-      dark: {
-        bgPage: "#0A0A0A",
-        bgSurface: "#1A1A1A",
-        bgMuted: "#262626",
-        textPrimary: "#FAFAFA",
-        textSecondary: "#A3A3A3",
-        textMuted: "#737373",
-        // Icon colors (derived from brand/text)
-        iconBrand: "#007061",   // = brand.primary
-        iconStrong: "#FAFAFA",  // = textPrimary
-        iconSubtle: "#A3A3A3",  // = textSecondary
-        iconDisabled: "#737373", // = textMuted
-        borderPrimary: "#404040",
-      },
-    },
-    scales: {
-      green: {
-        50: "#E6F5F2",
-        500: "#007061",
-        900: "#002E28",
-      },
-    },
-  },
-  typography: {
-    fontFamily: {
-      sans: "Inter, system-ui, sans-serif",
-      mono: "JetBrains Mono, monospace",
-    },
-    fontSize: {
-      xs: "0.75rem",
-      sm: "0.875rem",
-      md: "1rem",
-      lg: "1.125rem",
-      xl: "1.25rem",
-    },
-    fontWeight: {
-      regular: 400,
-      medium: 500,
-      semibold: 600,
-      bold: 700,
-    },
-    lineHeight: {
-      tight: 1.25,
-      normal: 1.5,
-      relaxed: 1.625,
-    },
-  },
-  spacing: {
-    scale: {
-      xs: "0.25rem",
-      sm: "0.5rem",
-      md: "1rem",
-      lg: "1.5rem",
-      xl: "2rem",
-    },
-    inset: {
-      xs: "0.25rem",
-      sm: "0.5rem",
-      md: "1rem",
-      lg: "1.5rem",
-    },
-  },
-  sizing: {
-    button: {
-      sm: { height: "32px" },
-      md: { height: "40px" },
-      lg: { height: "48px" },
-    },
-  },
-  shadows: {
-    elevation: {
-      none: "none",
-      sm: "0 1px 2px rgba(0, 0, 0, 0.05)",
-      md: "0 4px 6px rgba(0, 0, 0, 0.1)",
-      lg: "0 10px 15px rgba(0, 0, 0, 0.1)",
-    },
-    focus: {
-      ring: "0 0 0 2px var(--atomix-brand)",
-    },
-  },
-  radius: {
-    scale: {
-      none: "0",
-      sm: "0.25rem",
-      md: "0.5rem",
-      lg: "0.75rem",
-      xl: "1rem",
-      full: "9999px",
-    },
-  },
-  motion: {
-    duration: {
-      instant: "0ms",
-      fast: "150ms",
-      normal: "200ms",
-      slow: "300ms",
-    },
-    easing: {
-      ease: "cubic-bezier(0.4, 0, 0.2, 1)",
-      easeIn: "cubic-bezier(0.4, 0, 1, 1)",
-      easeOut: "cubic-bezier(0, 0, 0.2, 1)",
-    },
-  },
-  zIndex: {
-    dropdown: 1000,
-    modal: 1100,
-    tooltip: 1200,
-  },
-  borders: {
-    width: {
-      none: "0",
-      thin: "1px",
-      medium: "2px",
-    },
-  },
-};
-