@atomixstudio/mcp 0.1.1 → 1.0.1

package/src/user-tokens.ts

@@ -1,268 +0,0 @@
-/**
- * User Tokens Fetcher
- * -------------------
- * Fetches user-specific design system tokens from Atomix API.
- * 
- * Used when MCP server is run with --ds-id flag to serve a user's
- * custom design system instead of Atomix's internal tokens.
- */
-
-// ============================================
-// TYPES
-// ============================================
-
-export interface UserDesignSystem {
-  id: string;
-  name: string;
-  tokens: Record<string, unknown>;
-  governance?: {
-    rules: string[];
-    categories?: Record<string, string[]>;
-  };
-}
-
-export interface FetchUserDSOptions {
-  /** User's design system ID */
-  dsId: string;
-  /** API key for authentication */
-  apiKey?: string;
-  /** Base URL for the Atomix API (default: https://atomix.design) */
-  baseUrl?: string;
-}
-
-export interface UserDSMeta {
-  id: string;
-  name: string;
-  publishedAt?: number;
-  updatedAt?: number;
-  version?: number;
-}
-
-export interface UserDSResponse {
-  success: boolean;
-  tokens?: Record<string, unknown>;
-  governance?: UserDesignSystem['governance'];
-  meta?: UserDSMeta;
-  error?: string;
-}
-
-// ============================================
-// API ENDPOINTS
-// ============================================
-
-const DEFAULT_BASE_URL = 'https://atomixstudio.eu';
-
-/**
- * Fetch user's design system tokens from Atomix API
- * 
- * @param options - Fetch options including dsId and apiKey
- * @returns User's tokens and governance rules
- * 
- * @example
- * ```ts
- * const { tokens, governance } = await fetchUserDesignSystem({
- *   dsId: 'abc123',
- *   apiKey: 'user-api-key'
- * });
- * ```
- */
-export async function fetchUserDesignSystem(
-  options: FetchUserDSOptions
-): Promise<UserDSResponse> {
-  const { dsId, apiKey, baseUrl = DEFAULT_BASE_URL } = options;
-
-  try {
-    const headers: Record<string, string> = {
-      'Content-Type': 'application/json',
-    };
-
-    if (apiKey) {
-      headers['Authorization'] = `Bearer ${apiKey}`;
-    }
-
-    // Fetch tokens
-    const tokensResponse = await fetch(`${baseUrl}/api/ds/${dsId}/tokens`, {
-      method: 'GET',
-      headers,
-    });
-
-    if (!tokensResponse.ok) {
-      const error = await tokensResponse.text();
-      return {
-        success: false,
-        error: `Failed to fetch tokens: ${tokensResponse.status} ${error}`,
-      };
-    }
-
-    const tokensData = await tokensResponse.json() as { 
-      tokens?: Record<string, unknown>;
-      meta?: UserDSMeta;
-    } | Record<string, unknown>;
-
-    // Extract metadata
-    const meta: UserDSMeta | undefined = 'meta' in tokensData && tokensData.meta
-      ? tokensData.meta as UserDSMeta
-      : undefined;
-
-    // Fetch governance rules
-    let governance: UserDesignSystem['governance'] | undefined;
-    
-    try {
-      const rulesResponse = await fetch(`${baseUrl}/api/ds/${dsId}/rules`, {
-        method: 'GET',
-        headers,
-      });
-
-      if (rulesResponse.ok) {
-        const rulesData = await rulesResponse.json() as UserDesignSystem['governance'];
-        governance = rulesData;
-      }
-    } catch {
-      // Governance is optional, continue without it
-      console.error('[atomix-mcp] Could not fetch governance rules, continuing without them');
-    }
-
-    // Extract tokens - handle both { tokens: {...} } and direct {...} formats
-    const tokens = 'tokens' in tokensData && tokensData.tokens 
-      ? tokensData.tokens as Record<string, unknown>
-      : tokensData as Record<string, unknown>;
-
-    return {
-      success: true,
-      tokens,
-      governance,
-      meta,
-    };
-  } catch (error) {
-    return {
-      success: false,
-      error: `Network error: ${error instanceof Error ? error.message : String(error)}`,
-    };
-  }
-}
-
-/**
- * Validate API key format
- */
-export function isValidApiKey(key: unknown): key is string {
-  if (typeof key !== 'string') return false;
-  // API keys should be at least 20 characters (UUID-ish)
-  return key.length >= 20;
-}
-
-/**
- * Validate design system ID format
- */
-export function isValidDsId(id: unknown): id is string {
-  if (typeof id !== 'string') return false;
-  // DS IDs should be non-empty strings
-  return id.length > 0;
-}
-
-// ============================================
-// CLI ARGUMENT PARSING
-// ============================================
-
-export interface CLIArgs {
-  /** User's design system ID */
-  dsId?: string;
-  /** API key for authentication */
-  apiKey?: string;
-  /** Tenant ID (legacy, mapped to dsId) */
-  tenant?: string;
-  /** Base URL for the Atomix API */
-  baseUrl?: string;
-}
-
-/**
- * Parse command line arguments for user DS mode
- * 
- * Supported args:
- * - --ds-id <id>: User's design system ID
- * - --api-key <key>: API key for authentication
- * - --tenant <id>: Legacy tenant ID (mapped to dsId)
- * - --base-url <url>: Custom API base URL
- * 
- * @param argv - Command line arguments (default: process.argv)
- * @returns Parsed CLI arguments
- */
-export function parseCLIArgs(argv: string[] = process.argv): CLIArgs {
-  const args: CLIArgs = {};
-  
-  for (let i = 0; i < argv.length; i++) {
-    const arg = argv[i];
-    const next = argv[i + 1];
-
-    switch (arg) {
-      case '--ds-id':
-        if (next && !next.startsWith('--')) {
-          args.dsId = next;
-          i++;
-        }
-        break;
-
-      case '--api-key':
-        if (next && !next.startsWith('--')) {
-          args.apiKey = next;
-          i++;
-        }
-        break;
-
-      case '--tenant':
-        // Legacy support: map tenant to dsId
-        if (next && !next.startsWith('--')) {
-          args.tenant = next;
-          args.dsId = args.dsId || next;
-          i++;
-        }
-        break;
-
-      case '--base-url':
-        if (next && !next.startsWith('--')) {
-          args.baseUrl = next;
-          i++;
-        }
-        break;
-    }
-  }
-
-  return args;
-}
-
-/**
- * Check if CLI args indicate user DS mode
- */
-export function isUserDSMode(args: CLIArgs): boolean {
-  return Boolean(args.dsId);
-}
-
-// ============================================
-// TOKEN TRANSFORMATION
-// ============================================
-
-/**
- * Transform user DS tokens to match the structure expected by MCP server.
- * 
- * User DS tokens come in the StoredDesignSystem format from InstantDB.
- * This transforms them to the flat primitives structure used by MCP tools.
- * 
- * @param userTokens - User's tokens from InstantDB
- * @returns Tokens in MCP-compatible format
- */
-export function transformUserTokens(
-  userTokens: Record<string, unknown>
-): Record<string, unknown> {
-  // If tokens are already in the right format, return as-is
-  if (userTokens.colors && userTokens.typography && userTokens.spacing) {
-    return userTokens;
-  }
-
-  // If tokens have a 'tokens' wrapper, unwrap it
-  if (typeof userTokens.tokens === 'object' && userTokens.tokens !== null) {
-    return userTokens.tokens as Record<string, unknown>;
-  }
-
-  // Return as-is and let the MCP tools handle the structure
-  return userTokens;
-}
-