@xbg.solutions/create-backend 1.0.0

package/lib/commands/sync.js

@@ -0,0 +1,161 @@
+"use strict";
+/**
+ * Sync Command
+ * Updates an existing project with latest boilerplate changes
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.syncProject = syncProject;
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs-extra"));
+const chalk_1 = __importDefault(require("chalk"));
+const child_process_1 = require("child_process");
+const utils_registry_1 = require("../utils-registry");
+async function syncProject(options) {
+    const projectDir = path.resolve(options.directory);
+    const functionsDir = path.join(projectDir, 'functions');
+    console.log(chalk_1.default.bold.blue('\n── XBG Backend Sync ────────────────────────────\n'));
+    // Verify this is an XBG project
+    if (!await fs.pathExists(path.join(functionsDir, 'package.json'))) {
+        console.error(chalk_1.default.red('Not an XBG backend project. Run from the project root.'));
+        process.exit(1);
+    }
+    const result = {
+        packagesUpdated: [],
+        packagesAdded: [],
+        filesUpdated: [],
+        newUtilitiesAvailable: [],
+    };
+    // Check for package updates
+    console.log(chalk_1.default.cyan('Checking for package updates...\n'));
+    const pkgJson = await fs.readJson(path.join(functionsDir, 'package.json'));
+    const deps = pkgJson.dependencies || {};
+    // Check installed @xbg packages
+    const installedXbgPackages = Object.keys(deps).filter((d) => d.startsWith('@xbg/'));
+    for (const pkg of installedXbgPackages) {
+        const currentVersion = deps[pkg];
+        try {
+            const latestVersion = (0, child_process_1.execSync)(`npm view ${pkg} version 2>/dev/null`, {
+                encoding: 'utf8',
+                timeout: 10000,
+            }).trim();
+            if (latestVersion && currentVersion !== `^${latestVersion}`) {
+                result.packagesUpdated.push(`${pkg}: ${currentVersion} -> ^${latestVersion}`);
+                console.log(chalk_1.default.yellow(`  Update available: ${pkg} ${currentVersion} -> ^${latestVersion}`));
+            }
+            else {
+                console.log(chalk_1.default.green(`  Up to date: ${pkg} ${currentVersion}`));
+            }
+        }
+        catch (_a) {
+            console.log(chalk_1.default.dim(`  Skipped: ${pkg} (not published yet)`));
+        }
+    }
+    // Check for new utilities available
+    const allPackageNames = utils_registry_1.UTILITY_REGISTRY.map((u) => u.package);
+    const newUtils = allPackageNames.filter((pkg) => !installedXbgPackages.includes(pkg));
+    if (newUtils.length > 0) {
+        result.newUtilitiesAvailable = newUtils;
+        console.log(chalk_1.default.cyan(`\n${newUtils.length} additional utilities available:`));
+        for (const pkg of newUtils) {
+            const util = utils_registry_1.UTILITY_REGISTRY.find((u) => u.package === pkg);
+            if (util) {
+                console.log(chalk_1.default.dim(`  ${util.name}: ${util.description} (${pkg})`));
+            }
+        }
+        console.log(chalk_1.default.dim(`\n  Run ${chalk_1.default.bold('npx @xbg/create-backend add-util')} to add utilities.`));
+    }
+    // Sync scaffold files (tsconfig, scripts)
+    console.log(chalk_1.default.cyan('\nChecking scaffold files...\n'));
+    const templateDir = path.resolve(__dirname, '../../src/project-template');
+    // Check scripts
+    const scriptsDir = path.join(templateDir, '__scripts__');
+    if (await fs.pathExists(scriptsDir)) {
+        const scripts = await fs.readdir(scriptsDir);
+        for (const script of scripts) {
+            const templateScript = path.join(scriptsDir, script);
+            const projectScript = path.join(projectDir, '__scripts__', script);
+            if (!await fs.pathExists(projectScript)) {
+                if (!options.checkOnly) {
+                    await fs.copy(templateScript, projectScript);
+                    result.filesUpdated.push(`__scripts__/${script}`);
+                    console.log(chalk_1.default.green(`  Added: __scripts__/${script}`));
+                }
+                else {
+                    console.log(chalk_1.default.yellow(`  Missing: __scripts__/${script}`));
+                }
+            }
+            else {
+                const templateContent = await fs.readFile(templateScript, 'utf8');
+                const projectContent = await fs.readFile(projectScript, 'utf8');
+                if (templateContent !== projectContent) {
+                    if (!options.checkOnly) {
+                        await fs.copy(templateScript, projectScript);
+                        result.filesUpdated.push(`__scripts__/${script}`);
+                        console.log(chalk_1.default.yellow(`  Updated: __scripts__/${script}`));
+                    }
+                    else {
+                        console.log(chalk_1.default.yellow(`  Outdated: __scripts__/${script}`));
+                    }
+                }
+                else {
+                    console.log(chalk_1.default.green(`  Current: __scripts__/${script}`));
+                }
+            }
+        }
+    }
+    // Apply updates
+    if (!options.checkOnly && result.packagesUpdated.length > 0) {
+        console.log(chalk_1.default.cyan('\nUpdating packages...\n'));
+        try {
+            (0, child_process_1.execSync)('npm update', { cwd: functionsDir, stdio: 'inherit' });
+            console.log(chalk_1.default.green('Packages updated.'));
+        }
+        catch (_b) {
+            console.error(chalk_1.default.red('Failed to update packages. Run npm update manually.'));
+        }
+    }
+    // Summary
+    console.log(chalk_1.default.bold.green(`\n── Sync Complete ───────────────────────────────\n`));
+    console.log(`  Packages checked:  ${installedXbgPackages.length}`);
+    console.log(`  Updates available: ${result.packagesUpdated.length}`);
+    console.log(`  Files updated:     ${result.filesUpdated.length}`);
+    console.log(`  New utils:         ${result.newUtilitiesAvailable.length}`);
+    console.log('');
+}
+//# sourceMappingURL=sync.js.map

package/lib/commands/sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.js","sourceRoot":"","sources":["../../src/commands/sync.ts"],"names":[],"mappings":"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"}

package/lib/utils-registry.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Registry of available @xbg/utils-* packages
+ * Used by the CLI to offer utility selection during project init/sync
+ */
+export interface UtilityDefinition {
+    name: string;
+    package: string;
+    description: string;
+    category: 'core' | 'data' | 'communication' | 'integration' | 'security' | 'infrastructure';
+    alwaysIncluded?: boolean;
+    envVars?: string[];
+}
+export declare const UTILITY_REGISTRY: UtilityDefinition[];
+/**
+ * Get utilities that are always included
+ */
+export declare function getRequiredUtilities(): UtilityDefinition[];
+/**
+ * Get utilities available for selection
+ */
+export declare function getOptionalUtilities(): UtilityDefinition[];
+/**
+ * Get utilities grouped by category
+ */
+export declare function getUtilitiesByCategory(): Record<string, UtilityDefinition[]>;

package/lib/utils-registry.js

@@ -0,0 +1,187 @@
+"use strict";
+/**
+ * Registry of available @xbg/utils-* packages
+ * Used by the CLI to offer utility selection during project init/sync
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UTILITY_REGISTRY = void 0;
+exports.getRequiredUtilities = getRequiredUtilities;
+exports.getOptionalUtilities = getOptionalUtilities;
+exports.getUtilitiesByCategory = getUtilitiesByCategory;
+exports.UTILITY_REGISTRY = [
+    // Core utilities (always included with @xbg/backend-core)
+    {
+        name: 'Logger',
+        package: '@xbg/utils-logger',
+        description: 'Structured logging with PII sanitization',
+        category: 'core',
+        alwaysIncluded: true,
+    },
+    {
+        name: 'Events',
+        package: '@xbg/utils-events',
+        description: 'Event bus for domain events',
+        category: 'core',
+        alwaysIncluded: true,
+    },
+    {
+        name: 'Errors',
+        package: '@xbg/utils-errors',
+        description: 'Custom error classes',
+        category: 'core',
+        alwaysIncluded: true,
+    },
+    // Data utilities
+    {
+        name: 'Firestore Connector',
+        package: '@xbg/utils-firestore-connector',
+        description: 'Multi-database Firestore access and Firebase Admin SDK init',
+        category: 'data',
+        alwaysIncluded: true,
+    },
+    {
+        name: 'Cache Connector',
+        package: '@xbg/utils-cache-connector',
+        description: 'Multi-provider caching (memory, Firestore, Redis)',
+        category: 'data',
+        envVars: ['CACHE_ENABLED', 'CACHE_DEFAULT_PROVIDER', 'CACHE_DEFAULT_TTL'],
+    },
+    {
+        name: 'Firebase Event Bridge',
+        package: '@xbg/utils-firebase-event-bridge',
+        description: 'Firebase triggers to domain event normalization',
+        category: 'data',
+    },
+    // Communication utilities
+    {
+        name: 'Email Connector',
+        package: '@xbg/utils-email-connector',
+        description: 'Email sending with Mailjet and Ortto providers',
+        category: 'communication',
+        envVars: ['EMAIL_ENABLED', 'EMAIL_PROVIDER', 'MAILJET_API_KEY', 'MAILJET_SECRET_KEY'],
+    },
+    {
+        name: 'SMS Connector',
+        package: '@xbg/utils-sms-connector',
+        description: 'SMS sending with Twilio and MessageBird providers',
+        category: 'communication',
+        envVars: ['SMS_ENABLED', 'SMS_PROVIDER', 'TWILIO_ACCOUNT_SID', 'TWILIO_AUTH_TOKEN'],
+    },
+    {
+        name: 'Push Notifications',
+        package: '@xbg/utils-push-notifications-connector',
+        description: 'Push notifications via Firebase Cloud Messaging',
+        category: 'communication',
+    },
+    {
+        name: 'Realtime Connector',
+        package: '@xbg/utils-realtime-connector',
+        description: 'SSE and WebSocket providers',
+        category: 'communication',
+    },
+    // Integration utilities
+    {
+        name: 'CRM Connector',
+        package: '@xbg/utils-crm-connector',
+        description: 'CRM integration with HubSpot and Salesforce',
+        category: 'integration',
+        envVars: ['CRM_ENABLED', 'CRM_PROVIDER', 'HUBSPOT_API_KEY'],
+    },
+    {
+        name: 'LLM Connector',
+        package: '@xbg/utils-llm-connector',
+        description: 'LLM integration with OpenAI, Claude, and Gemini',
+        category: 'integration',
+    },
+    {
+        name: 'ERP Connector',
+        package: '@xbg/utils-erp-connector',
+        description: 'ERP integration with Workday',
+        category: 'integration',
+    },
+    {
+        name: 'Journey Connector',
+        package: '@xbg/utils-journey-connector',
+        description: 'Customer journey integration with Ortto',
+        category: 'integration',
+    },
+    {
+        name: 'Survey Connector',
+        package: '@xbg/utils-survey-connector',
+        description: 'Survey integration',
+        category: 'integration',
+    },
+    {
+        name: 'Work Mgmt Connector',
+        package: '@xbg/utils-work-mgmt-connector',
+        description: 'Work management with Notion and Asana',
+        category: 'integration',
+    },
+    {
+        name: 'Document Connector',
+        package: '@xbg/utils-document-connector',
+        description: 'Document processing',
+        category: 'integration',
+    },
+    // Security utilities
+    {
+        name: 'Token Handler',
+        package: '@xbg/utils-token-handler',
+        description: 'JWT generation, verification, and blacklist management',
+        category: 'security',
+        envVars: ['JWT_ISSUER', 'JWT_AUDIENCE', 'JWT_EXPIRES_IN', 'TOKEN_BLACKLIST_ENABLED'],
+    },
+    {
+        name: 'Hashing',
+        package: '@xbg/utils-hashing',
+        description: 'PII encryption with AES-256-GCM',
+        category: 'security',
+        envVars: ['PII_ENCRYPTION_KEY'],
+    },
+    {
+        name: 'Validation',
+        package: '@xbg/utils-validation',
+        description: 'Input validation with Joi and express-validator',
+        category: 'security',
+    },
+    // Infrastructure utilities
+    {
+        name: 'Timezone',
+        package: '@xbg/utils-timezone',
+        description: 'Timezone conversion helper',
+        category: 'infrastructure',
+    },
+    {
+        name: 'Address Validation',
+        package: '@xbg/utils-address-validation',
+        description: 'Google Maps address validation',
+        category: 'infrastructure',
+        envVars: ['GOOGLE_MAPS_API_KEY'],
+    },
+];
+/**
+ * Get utilities that are always included
+ */
+function getRequiredUtilities() {
+    return exports.UTILITY_REGISTRY.filter((u) => u.alwaysIncluded);
+}
+/**
+ * Get utilities available for selection
+ */
+function getOptionalUtilities() {
+    return exports.UTILITY_REGISTRY.filter((u) => !u.alwaysIncluded);
+}
+/**
+ * Get utilities grouped by category
+ */
+function getUtilitiesByCategory() {
+    const grouped = {};
+    for (const util of exports.UTILITY_REGISTRY) {
+        if (!grouped[util.category]) {
+            grouped[util.category] = [];
+        }
+        grouped[util.category].push(util);
+    }
+    return grouped;
+}
+//# sourceMappingURL=utils-registry.js.map

package/lib/utils-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils-registry.js","sourceRoot":"","sources":["../src/utils-registry.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@xbg.solutions/create-backend",
+  "version": "1.0.0",
+  "description": "CLI tool to scaffold and sync XBG backend projects",
+  "main": "lib/cli.js",
+  "bin": {
+    "create-xbg-backend": "bin/create-backend.js"
+  },
+  "files": [
+    "lib",
+    "bin",
+    "src/project-template"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "build:watch": "tsc --watch",
+    "clean": "rm -rf lib",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "chalk": "^4.1.2",
+    "commander": "^11.1.0",
+    "fs-extra": "^11.2.0",
+    "inquirer": "^8.2.6"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.4",
+    "@types/inquirer": "^9.0.7",
+    "@types/node": "^20.11.0",
+    "typescript": "^5.3.3"
+  },
+  "engines": {
+    "node": "22"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}