@salesforce/ui-bundle-features 1.117.2

package/dist/types.d.ts

@@ -0,0 +1,174 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import type { Logger } from "./logger.js";
+/**
+ * Schema structure from features.json files
+ */
+export interface FileCopySchema {
+    /** Other features that must be installed first */
+    readonly featureDependencies?: readonly string[];
+    /** npm packages to add to dependencies */
+    readonly packageDependencies?: Readonly<Record<string, string>>;
+    /** npm packages to add to devDependencies */
+    readonly packageDevDependencies?: Readonly<Record<string, string>>;
+    /** File/directory copy operations */
+    readonly copy?: readonly CopyOperation[];
+}
+/**
+ * A single copy operation
+ */
+export interface CopyOperation {
+    /** Source path relative to package's dist/ directory */
+    readonly from: string;
+    /** Destination path (may contain <uiBundle> placeholder) */
+    readonly to: string;
+    /** Optional description of what this copies */
+    readonly description?: string;
+    /** For __example__ files: the target file where patterns should be integrated */
+    readonly integrationTarget?: string;
+}
+/**
+ * Conflict handling mode
+ */
+export type ConflictMode = "prompt" | "error" | "skip" | "overwrite";
+/**
+ * User's choice for handling a specific conflict
+ */
+export type ConflictResolution = "skip" | "overwrite" | "cancel";
+/**
+ * Map of file paths to conflict resolutions
+ */
+export type ConflictResolutionMap = Record<string, ConflictResolution>;
+/**
+ * Shared context for installation operations
+ */
+export interface InstallationContext {
+    /** SFDX source directory (e.g., force-app/main/default) */
+    sfdxSource: string;
+    /** Specific UI bundle directory (e.g., force-app/main/default/uiBundles/my-ui-bundle) */
+    uiBundleDir: string;
+    /** UI bundle name extracted from uiBundleDir (e.g., "my-ui-bundle") */
+    uiBundleName: string;
+    /** Enable verbose logging */
+    verbose: boolean;
+    /** Dry run mode - show what would be done without changes */
+    dryRun: boolean;
+    /** Conflict handling mode */
+    conflictMode: ConflictMode;
+    /** Conflict resolution map (from file or interactive prompts) */
+    conflictResolutions: ConflictResolutionMap;
+    /** Track installed features to prevent duplicates */
+    installedFeatures: Set<string>;
+    /** Track all copied example files with their integration targets */
+    copiedExampleFiles: {
+        file: string;
+        integrationTarget?: string;
+    }[];
+    /** Logger instance (verbose-aware) */
+    logger: Logger;
+}
+/**
+ * Feature registry entry
+ */
+export interface FeatureDefinition {
+    /** Display name for the feature */
+    readonly name: string;
+    /** npm package name */
+    readonly package: string;
+    /** Optional description */
+    readonly description?: string;
+}
+/**
+ * Feature registry mapping feature names to packages
+ */
+export type FeatureRegistry = Record<string, string>;
+/**
+ * Feature definition as exported from individual feature.ts files.
+ * Each feature directory exports a default FeatureDefinitionFile.
+ */
+export interface FeatureDefinitionFile {
+    /** Registry key for this feature (e.g., "authentication", "global-search") */
+    readonly key: string;
+    /** Display name */
+    readonly name: string;
+    /** npm package name */
+    readonly package: string;
+    /** Short description (1-2 sentences) */
+    readonly shortDescription: string;
+    /** Long description (detailed explanation) */
+    readonly longDescription: string;
+    /** Search keywords */
+    readonly keywords: readonly string[];
+    /** Feature dependencies */
+    readonly featureDependencies?: readonly string[];
+    /** Package dependencies */
+    readonly packageDependencies?: Readonly<Record<string, string>>;
+    /** Package dev dependencies */
+    readonly packageDevDependencies?: Readonly<Record<string, string>>;
+    /** Copy operations (includes __example__ files with integrationTarget) */
+    readonly copy?: readonly CopyOperation[];
+    /** List of feature capabilities */
+    readonly features?: readonly string[];
+    /** List of included components */
+    readonly components?: readonly string[];
+}
+/**
+ * Detailed feature metadata
+ */
+export interface FeatureMetadata {
+    /** Display name */
+    readonly name: string;
+    /** npm package name */
+    readonly package: string;
+    /** Short description (1-2 sentences) */
+    readonly shortDescription: string;
+    /** Long description (detailed explanation) */
+    readonly longDescription: string;
+    /** Search keywords */
+    readonly keywords: readonly string[];
+    /** Feature dependencies */
+    readonly featureDependencies?: readonly string[];
+    /** Package dependencies */
+    readonly packageDependencies?: Readonly<Record<string, string>>;
+    /** Package dev dependencies */
+    readonly packageDevDependencies?: Readonly<Record<string, string>>;
+    /** Copy operations (includes __example__ files with integrationTarget) */
+    readonly copy?: readonly CopyOperation[];
+    /** List of feature capabilities */
+    readonly features?: readonly string[];
+    /** List of included components */
+    readonly components?: readonly string[];
+}
+/**
+ * Features metadata collection
+ */
+export interface FeaturesMetadata {
+    features: Record<string, FeatureMetadata>;
+}
+/**
+ * Search result with scoring information
+ */
+export interface SearchResult {
+    /** The feature that matched the search */
+    readonly feature: FeatureMetadata;
+    /** Relevance score (higher = more relevant) */
+    readonly score: number;
+    /** Fields that matched the search terms (for debugging) */
+    readonly matchedFields: readonly string[];
+}
+/**
+ * CLI options
+ */
+export interface CliOptions {
+    sfdxSource?: string;
+    uiBundleDir?: string;
+    verbose?: boolean;
+    dryRun?: boolean;
+    yes?: boolean;
+    onConflict?: ConflictMode;
+    conflictResolution?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,7 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/utils.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+/**
+ * Check if a path exists
+ */
+export declare function pathExists(path: string): boolean;
+/**
+ * Resolve an absolute path from a potentially relative path
+ */
+export declare function resolvePath(path: string, base?: string): string;
+/**
+ * Extract UI bundle name from UI bundle directory path
+ */
+export declare function extractUIBundleName(uiBundleDir: string): string;
+/**
+ * Check if a path points to SFDX metadata (Apex classes, objects, etc.)
+ */
+export declare function isSfdxMetadataPath(path: string): boolean;
+/**
+ * Check if a path contains the UI bundle placeholder
+ */
+export declare function hasUIBundlePlaceholder(path: string): boolean;
+/**
+ * Normalize path separators to forward slashes
+ */
+export declare function normalizePath(path: string): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEhD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAK/D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAcxD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD"}

package/dist/utils.js

@@ -0,0 +1,58 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import { existsSync } from "fs";
+import { basename, resolve } from "path";
+/**
+ * Check if a path exists
+ */
+export function pathExists(path) {
+    return existsSync(path);
+}
+/**
+ * Resolve an absolute path from a potentially relative path
+ */
+export function resolvePath(path, base) {
+    if (base) {
+        return resolve(base, path);
+    }
+    return resolve(path);
+}
+/**
+ * Extract UI bundle name from UI bundle directory path
+ */
+export function extractUIBundleName(uiBundleDir) {
+    return basename(uiBundleDir);
+}
+/**
+ * Check if a path points to SFDX metadata (Apex classes, objects, etc.)
+ */
+export function isSfdxMetadataPath(path) {
+    const sfdxPatterns = [
+        "force-app/main/default/classes",
+        "force-app/main/default/objects",
+        "force-app/main/default/triggers",
+        "force-app/main/default/lwc",
+        "force-app/main/default/aura",
+        "force-app/main/default/staticresources",
+        "force-app/main/default/layouts",
+        "force-app/main/default/permissionsets",
+        "force-app/main/default/profiles",
+    ];
+    return sfdxPatterns.some((pattern) => path.startsWith(pattern));
+}
+/**
+ * Check if a path contains the UI bundle placeholder
+ */
+export function hasUIBundlePlaceholder(path) {
+    return path.includes("<uiBundle>");
+}
+/**
+ * Normalize path separators to forward slashes
+ */
+export function normalizePath(path) {
+    return path.replace(/\\/g, "/");
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAChC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAEzC;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY;IACtC,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,IAAa;IACtD,IAAI,IAAI,EAAE,CAAC;QACV,OAAO,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC5B,CAAC;IACD,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC;AACtB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,WAAmB;IACtD,OAAO,QAAQ,CAAC,WAAW,CAAC,CAAC;AAC9B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC9C,MAAM,YAAY,GAAG;QACpB,gCAAgC;QAChC,gCAAgC;QAChC,iCAAiC;QACjC,4BAA4B;QAC5B,6BAA6B;QAC7B,wCAAwC;QACxC,gCAAgC;QAChC,uCAAuC;QACvC,iCAAiC;KACjC,CAAC;IAEF,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;AACjE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAY;IAClD,OAAO,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACzC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AACjC,CAAC"}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@salesforce/ui-bundle-features",
+  "version": "1.117.2",
+  "description": "CLI tool for searching and installing UI features into Salesforce UI Bundles",
+  "license": "SEE LICENSE IN LICENSE.txt",
+  "type": "module",
+  "main": "./dist/cli.js",
+  "bin": {
+    "ui-bundle-features": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc --build && tsx scripts/aggregate-features.ts",
+    "clean": "rm -rf dist tsconfig.tsbuildinfo",
+    "dev": "tsx src/cli.ts",
+    "prepublishOnly": "npm run build",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:unit": "vitest run unit",
+    "test:e2e": "vitest run e2e",
+    "test:coverage": "vitest run --coverage"
+  },
+  "keywords": [
+    "salesforce",
+    "ui",
+    "features",
+    "cli",
+    "installer"
+  ],
+  "dependencies": {
+    "commander": "^13.0.0",
+    "inquirer": "^12.0.0",
+    "ora": "^9.3.0",
+    "zod": "^3.24.1"
+  },
+  "devDependencies": {
+    "@types/inquirer": "^9.0.9",
+    "@types/node": "^22.0.0",
+    "@vitest/coverage-v8": "^4.0.17",
+    "tsx": "^4.19.2",
+    "typescript": "~5.9.3",
+    "vitest": "^4.0.17"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}