@sfdc-webapps/cli 1.0.2

package/dist/utils/validation.js

@@ -0,0 +1,109 @@
+import { existsSync, statSync } from 'fs';
+import { getMonorepoRoot } from './paths.js';
+import { join, isAbsolute, basename } from 'path';
+export class ValidationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ValidationError';
+    }
+}
+/**
+ * Get the web application directory path from a base app path
+ * Structure: <basePath>/digitalExperiences/webApplications/<appName>
+ */
+export function getWebApplicationPath(basePath) {
+    const appName = basename(basePath);
+    return join(basePath, 'digitalExperiences', 'webApplications', appName);
+}
+/**
+ * Validate that a feature path exists and resolve it to an absolute path
+ */
+export function validateAndResolveFeaturePath(featurePath) {
+    let resolvedPath;
+    // If it's an absolute path, use it as-is
+    if (isAbsolute(featurePath)) {
+        resolvedPath = featurePath;
+    }
+    else {
+        // If it's relative, resolve from monorepo root
+        resolvedPath = join(getMonorepoRoot(), featurePath);
+    }
+    if (!existsSync(resolvedPath)) {
+        throw new ValidationError(`Feature path '${featurePath}' does not exist`);
+    }
+    if (!statSync(resolvedPath).isDirectory()) {
+        throw new ValidationError(`Feature path '${featurePath}' is not a directory`);
+    }
+    // Check if it has a feature.ts file
+    const featureFilePath = join(resolvedPath, 'feature.ts');
+    if (!existsSync(featureFilePath)) {
+        throw new ValidationError(`Feature path '${featurePath}' does not contain a feature.ts file`);
+    }
+    return resolvedPath;
+}
+/**
+ * Validate and resolve an app path (can be relative or absolute)
+ * Validates that the web application directory exists with proper structure
+ * Returns the absolute path to the base app directory
+ */
+export function validateAndResolveAppPath(appPath) {
+    let resolvedBasePath;
+    // If it's an absolute path, use it as-is
+    if (isAbsolute(appPath)) {
+        resolvedBasePath = appPath;
+    }
+    else {
+        // If it's relative, resolve from monorepo root
+        resolvedBasePath = join(getMonorepoRoot(), appPath);
+    }
+    if (!existsSync(resolvedBasePath)) {
+        throw new ValidationError(`App path '${appPath}' does not exist`);
+    }
+    if (!statSync(resolvedBasePath).isDirectory()) {
+        throw new ValidationError(`App path '${appPath}' is not a directory`);
+    }
+    // Get the web application directory path
+    const webAppPath = getWebApplicationPath(resolvedBasePath);
+    if (!existsSync(webAppPath)) {
+        throw new ValidationError(`Web application directory does not exist at '${webAppPath}'. Expected structure: digitalExperiences/webApplications/<app-name>`);
+    }
+    if (!statSync(webAppPath).isDirectory()) {
+        throw new ValidationError(`Web application path '${webAppPath}' is not a directory`);
+    }
+    // Check if it has a package.json
+    const packageJsonPath = join(webAppPath, 'package.json');
+    if (!existsSync(packageJsonPath)) {
+        throw new ValidationError(`Web application '${webAppPath}' does not contain a package.json file`);
+    }
+    return resolvedBasePath;
+}
+const APP_FEATURE_NAME_REGEX = /^[a-z0-9]+(-[a-z0-9]+)*$/;
+/**
+ * Validate that a app or feature name is valid
+ * - Must be in kebab-case (lowercase with hyphens)
+ * - Only alphanumeric characters and hyphens allowed
+ * - Cannot start or end with hyphens
+ * - No consecutive hyphens
+ * - Cannot be reserved names: "base", "cli"
+ * - Max 50 characters
+ */
+export function validateAppOrFeatureName(name) {
+    // Check empty
+    if (!name || name.trim().length === 0) {
+        throw new ValidationError('App or feature name cannot be empty');
+    }
+    // Check format
+    if (!APP_FEATURE_NAME_REGEX.test(name)) {
+        throw new ValidationError(`App or feature name '${name}' is invalid. Must be kebab-case (lowercase letters, numbers, and hyphens only).\nExamples: "nav-menu", "user-auth", "dashboard-v2"`);
+    }
+    // Check reserved names
+    const reserved = ['app', 'feature'];
+    if (reserved.includes(name)) {
+        throw new ValidationError(`App or feature name '${name}' is reserved. Please choose a different name.`);
+    }
+    // Check length
+    if (name.length > 50) {
+        throw new ValidationError(`App or feature name '${name}' is too long. Maximum 50 characters.`);
+    }
+}
+//# sourceMappingURL=validation.js.map

package/dist/utils/validation.js.map

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

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@sfdc-webapps/cli",
+  "version": "1.0.2",
+  "description": "CLI tool for applying feature patches to base apps",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "apply-patches": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "test": "vitest run",
+    "test:ui": "vitest run --ui",
+    "test:e2e": "vitest run e2e",
+    "test:unit": "vitest run unit",
+    "test:coverage": "vitest run --coverage"
+  },
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^12.0.0",
+    "fs-extra": "^11.2.0",
+    "ts-morph": "^27.0.2",
+    "turbowatch": "^2.29.4"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.4",
+    "@types/node": "^24.10.1",
+    "@types/react-dom": "^19.2.3",
+    "@vitest/coverage-v8": "2.1.9",
+    "@vitest/ui": "^2.1.8",
+    "react-dom": "^19.2.1",
+    "tsx": "^4.19.2",
+    "typescript": "~5.9.3",
+    "vitest": "^2.1.8"
+  }
+}