@schandlergarcia/sf-web-components 1.9.88 → 2.1.0

package/scripts/apply-brand.mjs

@@ -0,0 +1,178 @@
+#!/usr/bin/env node
+
+/**
+ * apply-brand.mjs — Apply a brand theme to the project.
+ *
+ * Usage:
+ *   node scripts/apply-brand.mjs engine     # Apply Engine brand
+ *   node scripts/apply-brand.mjs --list     # List available brands
+ *   node scripts/apply-brand.mjs --reset    # Remove brand, restore neutral theme
+ *
+ * When run from a consuming project (via npm run brand:engine), the script
+ * detects the package location automatically.
+ */
+
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+const arg = process.argv[2];
+
+if (!arg) {
+  console.error('Usage: node scripts/apply-brand.mjs <brand-name|--list|--reset>');
+  process.exit(1);
+}
+
+const cwd = process.cwd();
+const PACKAGE_NAME = '@schandlergarcia/sf-web-components';
+
+function findPackageRoot() {
+  const fromNodeModules = path.join(cwd, 'node_modules', PACKAGE_NAME);
+  if (fs.existsSync(fromNodeModules)) return fromNodeModules;
+
+  const fromScript = path.resolve(__dirname, '..');
+  if (fs.existsSync(path.join(fromScript, 'brands'))) return fromScript;
+
+  return null;
+}
+
+const packageRoot = findPackageRoot();
+if (!packageRoot) {
+  console.error('Could not find package root. Run from the project directory.');
+  process.exit(1);
+}
+
+const brandsDir = path.join(packageRoot, 'brands');
+
+if (arg === '--list') {
+  if (!fs.existsSync(brandsDir)) {
+    console.log('No brands available.');
+    process.exit(0);
+  }
+  const brands = fs.readdirSync(brandsDir).filter(d =>
+    fs.statSync(path.join(brandsDir, d)).isDirectory()
+  );
+  console.log(`Available brands: ${brands.join(', ') || '(none)'}`);
+  process.exit(0);
+}
+
+if (arg === '--reset') {
+  const neutralCSS = path.join(packageRoot, 'src/styles/global.css');
+  const targetCSS = path.join(cwd, 'src/styles/global.css');
+  if (fs.existsSync(neutralCSS)) {
+    fs.copyFileSync(neutralCSS, targetCSS);
+    console.log('  ✓ Restored neutral theme (global.css)');
+  }
+  const brandMarker = path.join(cwd, '.brand');
+  if (fs.existsSync(brandMarker)) fs.unlinkSync(brandMarker);
+  console.log('\n✅ Brand reset to neutral.\n');
+  process.exit(0);
+}
+
+const brandName = arg;
+const brandDir = path.join(brandsDir, brandName);
+
+if (!fs.existsSync(brandDir)) {
+  console.error(`Brand "${brandName}" not found in ${brandsDir}`);
+  const available = fs.existsSync(brandsDir)
+    ? fs.readdirSync(brandsDir).filter(d => fs.statSync(path.join(brandsDir, d)).isDirectory())
+    : [];
+  if (available.length) console.error(`Available: ${available.join(', ')}`);
+  process.exit(1);
+}
+
+console.log(`\n🎨 Applying "${brandName}" brand...\n`);
+
+let installed = 0;
+
+// 1. global.css → src/styles/global.css (always overwrite)
+const brandCSS = path.join(brandDir, 'global.css');
+const targetCSS = path.join(cwd, 'src/styles/global.css');
+if (fs.existsSync(brandCSS)) {
+  fs.mkdirSync(path.dirname(targetCSS), { recursive: true });
+  fs.copyFileSync(brandCSS, targetCSS);
+  console.log('  ✓ Brand theme applied (global.css)');
+  installed++;
+}
+
+// 2. Sample data files → src/data/
+const dataFiles = [
+  { src: 'engine-sample-data.js', dst: 'src/data/engine-sample-data.js' },
+  { src: 'engine-live-data.js', dst: 'src/data/engine-live-data.js' },
+];
+for (const { src, dst } of dataFiles) {
+  const srcPath = path.join(brandDir, src);
+  const dstPath = path.join(cwd, dst);
+  if (fs.existsSync(srcPath)) {
+    fs.mkdirSync(path.dirname(dstPath), { recursive: true });
+    fs.copyFileSync(srcPath, dstPath);
+    console.log(`  ✓ Installed ${dst}`);
+    installed++;
+  }
+}
+
+// 3. Hooks → src/hooks/
+const hooks = [
+  { src: 'useEngineLiveData.ts', dst: 'src/hooks/useEngineLiveData.ts' },
+  { src: 'useEvaAgent.ts', dst: 'src/hooks/useEvaAgent.ts' },
+];
+for (const { src, dst } of hooks) {
+  const srcPath = path.join(brandDir, src);
+  const dstPath = path.join(cwd, dst);
+  if (fs.existsSync(srcPath)) {
+    fs.mkdirSync(path.dirname(dstPath), { recursive: true });
+    fs.copyFileSync(srcPath, dstPath);
+    console.log(`  ✓ Installed ${dst}`);
+    installed++;
+  }
+}
+
+// 4. Config files → src/config/
+const configs = [
+  { src: 'agentApiConfig.ts', dst: 'src/config/agentApi.ts' },
+];
+for (const { src, dst } of configs) {
+  const srcPath = path.join(brandDir, src);
+  const dstPath = path.join(cwd, dst);
+  if (fs.existsSync(srcPath)) {
+    fs.mkdirSync(path.dirname(dstPath), { recursive: true });
+    fs.copyFileSync(srcPath, dstPath);
+    console.log(`  ✓ Installed ${dst}`);
+    installed++;
+  }
+}
+
+// 5. PRD → project root
+const prd = path.join(brandDir, 'engine-command-center-prd.md');
+if (fs.existsSync(prd)) {
+  fs.copyFileSync(prd, path.join(cwd, 'engine-command-center-prd.md'));
+  console.log('  ✓ Installed engine-command-center-prd.md');
+  installed++;
+}
+
+// 6. Schema → project root
+const schema = path.join(brandDir, 'schema.graphql');
+if (fs.existsSync(schema)) {
+  fs.copyFileSync(schema, path.join(cwd, 'schema.graphql'));
+  console.log('  ✓ Installed schema.graphql');
+  installed++;
+}
+
+// 7. Logo → src/assets/images/
+const logo = path.join(brandDir, 'engine_logo.png');
+if (fs.existsSync(logo)) {
+  const logoTarget = path.join(cwd, 'src/assets/images/engine_logo.png');
+  fs.mkdirSync(path.dirname(logoTarget), { recursive: true });
+  fs.copyFileSync(logo, logoTarget);
+  console.log('  ✓ Installed engine_logo.png');
+  installed++;
+}
+
+// 8. Write .brand marker so reset script knows which brand is active
+fs.writeFileSync(path.join(cwd, '.brand'), brandName + '\n', 'utf-8');
+
+console.log(`\n✅ "${brandName}" brand applied (${installed} files installed).`);
+console.log('   Run "npm run brand:reset" to revert to neutral theme.\n');

package/scripts/postinstall.mjs

@@ -227,174 +227,29 @@ if (fs.existsSync(templatesDir)) {
   }
 }
 
-// Copy sample data files
-const dataSourceDir = path.join(packageRoot, 'data');
-const targetDataDir = path.join(cwd, 'src/data');
-
-console.log('\n📊 Installing sample data files...\n');
-
-let dataFilesInstalled = 0;
-
-if (fs.existsSync(dataSourceDir)) {
-  // Create target data directory if it doesn't exist
-  if (!fs.existsSync(targetDataDir)) {
-    fs.mkdirSync(targetDataDir, { recursive: true });
-  }
-
-  // Copy engine-sample-data.js
-  const engineDataSource = path.join(dataSourceDir, 'engine-sample-data.js');
-  const engineDataTarget = path.join(targetDataDir, 'engine-sample-data.js');
-
-  if (fs.existsSync(engineDataSource)) {
-    try {
-      fs.copyFileSync(engineDataSource, engineDataTarget);
-      console.log('  ✓ Installed engine-sample-data.js');
-      dataFilesInstalled++;
-    } catch (error) {
-      console.error(`  ✗ Failed to install engine-sample-data.js: ${error.message}`);
-    }
-  }
-
-  // Copy schema.graphql
-  const schemaSource = path.join(dataSourceDir, 'schema.graphql');
-  const schemaTarget = path.join(cwd, 'schema.graphql');
-
-  if (fs.existsSync(schemaSource)) {
-    try {
-      fs.copyFileSync(schemaSource, schemaTarget);
-      console.log('  ✓ Installed schema.graphql (pre-built from sample data)');
-      dataFilesInstalled++;
-    } catch (error) {
-      console.error(`  ✗ Failed to install schema.graphql: ${error.message}`);
-    }
-  }
-
-  // Copy engine-command-center-prd.md
-  const prdSource = path.join(dataSourceDir, 'engine-command-center-prd.md');
-  const prdTarget = path.join(cwd, 'engine-command-center-prd.md');
-
-  if (fs.existsSync(prdSource)) {
-    try {
-      fs.copyFileSync(prdSource, prdTarget);
-      console.log('  ✓ Installed engine-command-center-prd.md');
-      dataFilesInstalled++;
-    } catch (error) {
-      console.error(`  ✗ Failed to install engine-command-center-prd.md: ${error.message}`);
-    }
-  }
-
-  // Copy engine-live-data.js
-  const engineLiveDataSource = path.join(dataSourceDir, 'engine-live-data.js');
-  const engineLiveDataTarget = path.join(targetDataDir, 'engine-live-data.js');
-
-  if (fs.existsSync(engineLiveDataSource)) {
-    try {
-      fs.copyFileSync(engineLiveDataSource, engineLiveDataTarget);
-      console.log('  ✓ Installed engine-live-data.js');
-      dataFilesInstalled++;
-    } catch (error) {
-      console.error(`  ✗ Failed to install engine-live-data.js: ${error.message}`);
-    }
-  }
-
-  // Copy useEngineLiveData.ts
-  const targetHooksDir = path.join(cwd, 'src/hooks');
-  const useEngineLiveDataSource = path.join(dataSourceDir, 'useEngineLiveData.ts');
-  const useEngineLiveDataTarget = path.join(targetHooksDir, 'useEngineLiveData.ts');
-
-  if (fs.existsSync(useEngineLiveDataSource)) {
-    try {
-      if (!fs.existsSync(targetHooksDir)) {
-        fs.mkdirSync(targetHooksDir, { recursive: true });
-      }
-      fs.copyFileSync(useEngineLiveDataSource, useEngineLiveDataTarget);
-      console.log('  ✓ Installed useEngineLiveData.ts');
-      dataFilesInstalled++;
-    } catch (error) {
-      console.error(`  ✗ Failed to install useEngineLiveData.ts: ${error.message}`);
-    }
-  }
-
-  // Copy useEvaAgent.ts (Agentforce Agent API hook)
-  const useEvaAgentSource = path.join(dataSourceDir, 'useEvaAgent.ts');
-  const useEvaAgentTarget = path.join(targetHooksDir, 'useEvaAgent.ts');
-
-  if (fs.existsSync(useEvaAgentSource)) {
-    try {
-      if (!fs.existsSync(targetHooksDir)) {
-        fs.mkdirSync(targetHooksDir, { recursive: true });
-      }
-      fs.copyFileSync(useEvaAgentSource, useEvaAgentTarget);
-      console.log('  ✓ Installed useEvaAgent.ts');
-      dataFilesInstalled++;
-    } catch (error) {
-      console.error(`  ✗ Failed to install useEvaAgent.ts: ${error.message}`);
-    }
-  }
-
-  // Copy agentApiConfig.ts → src/config/agentApi.ts
-  const agentApiConfigSource = path.join(dataSourceDir, 'agentApiConfig.ts');
-  const targetConfigDir = path.join(cwd, 'src/config');
-  const agentApiConfigTarget = path.join(targetConfigDir, 'agentApi.ts');
-
-  if (fs.existsSync(agentApiConfigSource)) {
-    try {
-      if (!fs.existsSync(targetConfigDir)) {
-        fs.mkdirSync(targetConfigDir, { recursive: true });
-      }
-      fs.copyFileSync(agentApiConfigSource, agentApiConfigTarget);
-      console.log('  ✓ Installed src/config/agentApi.ts');
-      dataFilesInstalled++;
-    } catch (error) {
-      console.error(`  ✗ Failed to install agentApiConfig.ts: ${error.message}`);
-    }
-  }
-
-  // Copy engine_logo.png
-  const assetsSourceDir = path.join(packageRoot, 'assets/images');
-  const targetAssetsDir = path.join(cwd, 'src/assets/images');
-  const engineLogoSource = path.join(assetsSourceDir, 'engine_logo.png');
-  const engineLogoTarget = path.join(targetAssetsDir, 'engine_logo.png');
-
-  if (fs.existsSync(engineLogoSource)) {
-    try {
-      if (!fs.existsSync(targetAssetsDir)) {
-        fs.mkdirSync(targetAssetsDir, { recursive: true });
-      }
-      fs.copyFileSync(engineLogoSource, engineLogoTarget);
-      console.log('  ✓ Installed engine_logo.png');
-      dataFilesInstalled++;
-    } catch (error) {
-      console.error(`  ✗ Failed to install engine_logo.png: ${error.message}`);
-    }
-  }
-}
-
-// Copy GraphQL schema generator script
+// Copy GraphQL introspection script (generic — works with any Salesforce org)
 const scriptsSourceDir = path.join(packageRoot, 'scripts');
 const targetScriptsDir = path.join(cwd, 'scripts');
 
-console.log('\n📝 Installing GraphQL scripts...\n');
+console.log('\n📝 Installing utility scripts...\n');
 
 let scriptsInstalled = 0;
 
 if (fs.existsSync(scriptsSourceDir)) {
-  // Create target scripts directory if it doesn't exist
   if (!fs.existsSync(targetScriptsDir)) {
     fs.mkdirSync(targetScriptsDir, { recursive: true });
   }
 
-  // Copy generate-schema-from-sample.mjs
-  const generatorSource = path.join(scriptsSourceDir, 'generate-schema-from-sample.mjs');
-  const generatorTarget = path.join(targetScriptsDir, 'generate-schema-from-sample.mjs');
+  const getSchemaSource = path.join(scriptsSourceDir, 'get-graphql-schema.mjs');
+  const getSchemaTarget = path.join(targetScriptsDir, 'get-graphql-schema.mjs');
 
-  if (fs.existsSync(generatorSource)) {
+  if (fs.existsSync(getSchemaSource)) {
     try {
-      fs.copyFileSync(generatorSource, generatorTarget);
-      console.log('  ✓ Installed generate-schema-from-sample.mjs');
+      fs.copyFileSync(getSchemaSource, getSchemaTarget);
+      console.log('  ✓ Installed get-graphql-schema.mjs');
       scriptsInstalled++;
     } catch (error) {
-      console.error(`  ✗ Failed to install generate-schema-from-sample.mjs: ${error.message}`);
+      console.error(`  ✗ Failed to install get-graphql-schema.mjs: ${error.message}`);
     }
   }
 }
@@ -429,46 +284,7 @@ if (fs.existsSync(viteConfigTemplatePath) && !fs.existsSync(viteConfigPath)) {
     console.error(`  ✗ Failed to install vite.config.ts: ${error.message}`);
   }
 } else if (fs.existsSync(viteConfigPath)) {
-  // Ensure Agent API proxy rules exist even in pre-existing vite.config.ts
-  try {
-    const existing = fs.readFileSync(viteConfigPath, 'utf-8');
-    if (!existing.includes('/sf-oauth') || !existing.includes("api.salesforce.com")) {
-      const proxyBlock = `
-    // Proxy Agentforce Agent API calls through the dev server to avoid CORS.
-    // /sf-oauth/* → Salesforce org (for OAuth client-credentials token)
-    // /sf-agent/* → Agent API base (for session + message calls)
-    server: {
-      proxy: {
-        '/sf-oauth': {
-          target: 'https://tdx26-keynote-org-1com.my.salesforce.com',
-          changeOrigin: true,
-          rewrite: (p: string) => p.replace(/^\\/sf-oauth/, ''),
-        },
-        '/sf-agent': {
-          target: 'https://api.salesforce.com',
-          changeOrigin: true,
-          rewrite: (p: string) => p.replace(/^\\/sf-agent/, ''),
-        },
-      },
-    },
-`;
-      // Insert before the build: { section if it exists
-      if (existing.includes('build: {') && !existing.includes('server: {')) {
-        const updated = existing.replace(
-          /(\s*)(\/\/.*Build|build:\s*\{)/,
-          proxyBlock + '\n$1$2'
-        );
-        if (updated !== existing) {
-          fs.writeFileSync(viteConfigPath, updated, 'utf-8');
-          console.log('  ✓ Added Agent API proxy rules to existing vite.config.ts');
-        }
-      }
-    } else {
-      console.log('  ℹ vite.config.ts already has proxy rules');
-    }
-  } catch {
-    // Non-critical — proxy can be added manually
-  }
+  console.log('  ℹ vite.config.ts already exists (not overwriting)');
 }
 
 // Copy dataStrategy.ts template
@@ -519,10 +335,18 @@ if (fs.existsSync(packageJsonPath)) {
       scriptsAdded.push('validate:dashboard');
     }
 
-    // Add the graphql:schema:sample script if it doesn't exist
-    if (!packageJson.scripts['graphql:schema:sample']) {
-      packageJson.scripts['graphql:schema:sample'] = 'node scripts/generate-schema-from-sample.mjs';
-      scriptsAdded.push('graphql:schema:sample');
+    // Add brand scripts
+    if (!packageJson.scripts['brand:engine']) {
+      packageJson.scripts['brand:engine'] = 'node node_modules/@schandlergarcia/sf-web-components/scripts/apply-brand.mjs engine';
+      scriptsAdded.push('brand:engine');
+    }
+    if (!packageJson.scripts['brand:reset']) {
+      packageJson.scripts['brand:reset'] = 'node node_modules/@schandlergarcia/sf-web-components/scripts/apply-brand.mjs --reset';
+      scriptsAdded.push('brand:reset');
+    }
+    if (!packageJson.scripts['brand:list']) {
+      packageJson.scripts['brand:list'] = 'node node_modules/@schandlergarcia/sf-web-components/scripts/apply-brand.mjs --list';
+      scriptsAdded.push('brand:list');
     }
 
     if (scriptsAdded.length > 0) {
@@ -627,13 +451,12 @@ if (fs.existsSync(oldPagesDir)) {
 
 console.log('\n📊 Summary:');
 console.log(`  - Copied ${componentsCopied} UI components`);
-console.log(`  - Updated ${filesUpdated} files`);
+console.log(`  - Updated ${filesUpdated} import references`);
 console.log(`  - Installed ${templatesInstalled} page templates`);
-console.log(`  - Installed ${dataFilesInstalled} sample data files (including schema.graphql)`);
-console.log(`  - Installed ${scriptsInstalled} GraphQL scripts`);
+console.log(`  - Installed ${scriptsInstalled} utility scripts`);
 console.log(`  - Installed CommandCenter.tsx for dashboard management`);
 console.log(`  - Added "npm run reset:command-center" script`);
-console.log(`  - Installed AI assistant rules for command center building`);
+console.log(`  - Installed AI assistant rules (.a4drules)`);
 if (migratedFiles > 0) {
   console.log(`  - Migrated ${migratedFiles} dashboard files to correct location`);
 }