ayezee-astro-cms 1.3.0 → 1.4.0

package/dist/integration.d.ts

@@ -50,6 +50,21 @@ export interface AyezeeCmsOptions {
      * @default true
      */
     enableAnalytics?: boolean;
+    /**
+     * Report site version to CMS dashboard for tracking
+     * @default true
+     */
+    reportVersion?: boolean;
+    /**
+     * Site URL for version reporting (auto-detected if not provided)
+     * @default process.env.SITE_URL or process.env.URL
+     */
+    siteUrl?: string;
+    /**
+     * Environment name for version reporting
+     * @default process.env.NODE_ENV or 'production'
+     */
+    environment?: string;
 }
 /**
  * AyeZee CMS Astro Integration

package/dist/integration.js

@@ -15,6 +15,8 @@
  */
 import fs from 'fs';
 import path from 'path';
+// Package version - automatically updated during build
+const PACKAGE_VERSION = '1.4.0';
 /**
  * Load environment variables from .env file
  */
@@ -48,6 +50,57 @@ function slugify(text) {
         .replace(/[\s_-]+/g, '-')
         .replace(/^-+|-+$/g, '');
 }
+/**
+ * Get Astro version from package.json
+ */
+function getAstroVersion() {
+    try {
+        const pkgPath = path.join(process.cwd(), 'node_modules', 'astro', 'package.json');
+        if (fs.existsSync(pkgPath)) {
+            const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+            return pkg.version;
+        }
+    }
+    catch {
+        // Ignore errors
+    }
+    return undefined;
+}
+/**
+ * Report site version to CMS dashboard
+ */
+async function reportSiteVersion(baseUrl, apiKey, siteUrl, environment, astroVersion, logger) {
+    try {
+        const response = await fetch(`${baseUrl}/sites`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                ...(apiKey && { 'Authorization': `Bearer ${apiKey}` }),
+            },
+            body: JSON.stringify({
+                siteUrl,
+                environment,
+                packageVersion: PACKAGE_VERSION,
+                astroVersion,
+                metadata: {
+                    nodeVersion: process.version,
+                    platform: process.platform,
+                    buildTime: new Date().toISOString(),
+                },
+            }),
+        });
+        if (response.ok) {
+            logger.info(`📡 Reported site version to dashboard`);
+        }
+        else {
+            logger.warn(`⚠️  Failed to report site version: ${response.status}`);
+        }
+    }
+    catch (error) {
+        // Don't fail the build if version reporting fails
+        logger.warn(`⚠️  Could not report site version (non-critical)`);
+    }
+}
 /**
  * AyeZee CMS Astro Integration
  */
@@ -57,7 +110,7 @@ export function ayezeeCms(options = {}) {
         name: 'ayezee-cms',
         hooks: {
             'astro:config:setup': async ({ config, logger, injectScript }) => {
-                logger.info('🚀 AyeZee CMS: Fetching data...');
+                logger.info(`🚀 AyeZee CMS v${PACKAGE_VERSION}: Fetching data...`);
                 // Load environment variables from .env
                 loadEnvFile();
                 // Get configuration
@@ -68,21 +121,44 @@ export function ayezeeCms(options = {}) {
                 const cacheFileName = options.cacheFileName || 'cms-cache.json';
                 const skipOnError = options.skipOnError || false;
                 const enableAnalytics = options.enableAnalytics !== false;
-                // Validate config
+                const reportVersion = options.reportVersion !== false;
+                const siteUrl = options.siteUrl || process.env.SITE_URL || process.env.URL || process.env.VERCEL_URL;
+                const environment = options.environment || process.env.NODE_ENV || 'production';
+                // Validate config with helpful error messages
                 if (!cmsDomain || !projectSlug) {
-                    const errorMsg = 'Missing environment variables:';
-                    if (!cmsDomain)
-                        logger.error(`   - PUBLIC_CMS_DOMAIN`);
-                    if (!projectSlug)
-                        logger.error(`   - PUBLIC_PROJECT_SLUG`);
+                    logger.error('');
+                    logger.error('❌ AyeZee CMS Configuration Error');
+                    logger.error('═══════════════════════════════════════════════════════════');
+                    logger.error('');
+                    logger.error('Missing required environment variables:');
+                    if (!cmsDomain) {
+                        logger.error('   ✗ PUBLIC_CMS_DOMAIN - The URL of your CMS dashboard');
+                        logger.error('     Example: PUBLIC_CMS_DOMAIN=https://cms.yourdomain.com');
+                    }
+                    if (!projectSlug) {
+                        logger.error('   ✗ PUBLIC_PROJECT_SLUG - Your project identifier');
+                        logger.error('     Example: PUBLIC_PROJECT_SLUG=my-project');
+                    }
+                    logger.error('');
+                    logger.error('Add these to your .env file:');
+                    logger.error('');
+                    logger.error('   PUBLIC_CMS_DOMAIN=https://your-cms-domain.com');
+                    logger.error('   PUBLIC_PROJECT_SLUG=your-project-slug');
+                    logger.error('   PUBLIC_AYEZEE_API_KEY=AZ_your_api_key (optional)');
+                    logger.error('');
+                    logger.error('═══════════════════════════════════════════════════════════');
+                    logger.error('');
                     if (skipOnError) {
                         logger.warn('⚠️  Skipping CMS data fetch due to missing config');
+                        logger.warn('   Build will continue with cached data (if available)');
                         return;
                     }
-                    throw new Error(`AyeZee CMS integration requires PUBLIC_CMS_DOMAIN and PUBLIC_PROJECT_SLUG`);
+                    throw new Error(`AyeZee CMS integration requires PUBLIC_CMS_DOMAIN and PUBLIC_PROJECT_SLUG. ` +
+                        `See the error messages above for details.`);
                 }
                 logger.info(`   Domain: ${cmsDomain}`);
                 logger.info(`   Project: ${projectSlug}`);
+                logger.info(`   Environment: ${environment}`);
                 try {
                     // Build API URL
                     let domain = cmsDomain;
@@ -183,13 +259,49 @@ export function ayezeeCms(options = {}) {
               `);
                         logger.info('✅ Umami analytics script injected');
                     }
+                    // Report site version to dashboard (non-blocking)
+                    if (reportVersion && siteUrl) {
+                        const astroVersion = getAstroVersion();
+                        reportSiteVersion(baseUrl, apiKey, siteUrl, environment, astroVersion, logger);
+                    }
+                    logger.info('');
+                    logger.info('🎉 AyeZee CMS data fetched successfully!');
+                    logger.info('');
                 }
                 catch (error) {
                     const errorMessage = error instanceof Error ? error.message : 'Unknown error';
-                    logger.error('❌ Failed to fetch CMS data:');
-                    logger.error(`   ${errorMessage}`);
+                    logger.error('');
+                    logger.error('❌ Failed to fetch CMS data');
+                    logger.error('═══════════════════════════════════════════════════════════');
+                    logger.error('');
+                    logger.error(`Error: ${errorMessage}`);
+                    logger.error('');
+                    // Provide helpful troubleshooting tips
+                    if (errorMessage.includes('ECONNREFUSED') || errorMessage.includes('fetch failed')) {
+                        logger.error('Troubleshooting tips:');
+                        logger.error('   1. Is the CMS dashboard running?');
+                        logger.error(`   2. Can you access ${cmsDomain} in your browser?`);
+                        logger.error('   3. Check your network connection');
+                        logger.error('   4. If using localhost, ensure the dashboard is started');
+                    }
+                    else if (errorMessage.includes('401') || errorMessage.includes('403')) {
+                        logger.error('Troubleshooting tips:');
+                        logger.error('   1. Check that PUBLIC_AYEZEE_API_KEY is correct');
+                        logger.error('   2. Verify the API key has read permissions');
+                        logger.error('   3. Ensure the project slug matches your dashboard project');
+                    }
+                    else if (errorMessage.includes('404')) {
+                        logger.error('Troubleshooting tips:');
+                        logger.error('   1. Verify PUBLIC_PROJECT_SLUG is correct');
+                        logger.error('   2. Check that the project exists in the dashboard');
+                        logger.error(`   3. Project slug should match: ${projectSlug}`);
+                    }
+                    logger.error('');
+                    logger.error('═══════════════════════════════════════════════════════════');
+                    logger.error('');
                     if (skipOnError) {
-                        logger.warn('⚠️  Continuing build without CMS data');
+                        logger.warn('⚠️  Continuing build with cached data (skipOnError: true)');
+                        logger.warn('   The site will use previously cached CMS data if available.');
                         return;
                     }
                     throw error;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ayezee-astro-cms",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "AyeZee CMS integration for Astro with automatic data fetching, form handling, validation, and analytics",
   "type": "module",
   "main": "./dist/index.js",