sfdx-easy-sources 0.9.1 → 0.9.3

package/README.md

@@ -28,8 +28,8 @@ With this plugin you can:
 | Metadata Label| Metadata api | Available commands    | Programmatic API |
 | :---:    | :---:  | :---: | :---: |
 | All Meta | allmeta   | split, upsert, merge, minify, retrieve   | ❌ |
-| Profiles | profiles | split, upsert, merge, minify, updatekey, delete, clean, clearempty, arealigned | ✅ **Complete** |
-| Permission Sets | permissionsets | split, upsert, merge, minify, updatekey, delete, clean, clearempty, arealigned | ✅ **Complete** |
+| Profiles | profiles | split, upsert, merge, minify, updatekey, delete, customupsert, clean, clearempty, arealigned | ✅ **Complete** |
+| Permission Sets | permissionsets | split, upsert, merge, minify, updatekey, delete, customupsert, clean, clearempty, arealigned | ✅ **Complete** |
 | Record Types | recordtypes | split, upsert, merge, updatekey, delete, clean, arealigned | ✅ **Complete** |
 | Labels | labels | split, upsert, merge, updatekey, arealigned | ✅ **Complete** |
 | Global Value Sets | globalvaluesets | split, upsert, merge, updatekey, arealigned | ✅ **Complete** |
@@ -68,8 +68,18 @@ async function automateMetadata() {
   await profiles.upsert({ input: 'Admin' });
   await profiles.merge({ input: 'Admin' });
   
+  // Custom upsert with JSON content
+  await profiles.customUpsert({
+    type: 'classAccesses',
+    content: { apexClass: 'MyClass', enabled: true }
+  });
+  
   // Same pattern for all metadata types
   await permissionsets.split();
+  await permissionsets.customUpsert({
+    type: 'objectPermissions',
+    content: { object: 'Account', allowRead: true, allowEdit: true }
+  });
   await labels.upsert();
   await objectTranslations.minify();
 }
@@ -99,6 +109,7 @@ Based on the source type, this plugin provides the following commands:
 - **Split**: Splits the resources into various CSV files, and creates an XML file containing all the tags that weren't split
 - **Merge**: Merges back all the resources previously split from CSV files into XML format
 - **Upsert**: Similar to split, but adds new entries to existing CSV files instead of recreating them
+- **CustomUpsert**: Inserts or updates specific entries in CSV files using JSON content, with automatic key calculation and smart field handling
 - **Updatekey**: Updates the `_tagid` column when developers make changes directly in CSV files
 - **Delete**: Bulk deletes a single permission from all resources of the same type (only applies to Profiles, PermissionSets and Record Types)
 - **Minify**: Removes entries that don't add value to the file (available for profiles, permissionsets, objecttranslations, and translations)
@@ -209,6 +220,37 @@ Another scenario could be during a cherry pick or a merge conflict. Suppose a de
 Suppose the developer deletes a field on the org, he needs to delete all the references for that field for all Profiles, PermissionSets and RecordTypes.
 This command is intended to delete references, and it has flags to specify the name of the field. Run with --help flag to get a better description of the possible flags for each metadata type.
 
+### CustomUpsert
+**Note: only applies to Profiles and PermissionSets**
+
+The customupsert command allows you to insert or update specific entries in CSV files using JSON content, providing a powerful way to programmatically manage permissions without manually editing CSV files.
+
+**Key Features:**
+- **JSON Input**: Pass structured data directly via the `--content` flag (single object or array)
+- **Smart Field Handling**: 
+  - Non-existent keys in the JSON are automatically ignored
+  - Omitted existing keys result in empty values in the CSV
+- **Automatic Key Calculation**: The `_tagid` is automatically calculated based on the metadata type configuration
+- **Bulk Operations**: Process multiple entries at once by passing an array
+- **Target Specific Items**: Use `--input` to target specific profiles/permission sets, or omit to process all
+
+**Examples:**
+```sh-session
+# Insert/update a single class access permission
+$ sf easysources profiles customupsert -t classAccesses -j '{"apexClass":"MyClass","enabled":true}'
+
+# Insert/update multiple entries at once
+$ sf easysources profiles customupsert -t classAccesses -j '[{"apexClass":"Class1","enabled":true},{"apexClass":"Class2","enabled":false}]'
+
+# Update field permissions for a specific profile
+$ sf easysources profiles customupsert -i Admin -t fieldPermissions -j '{"field":"Account.CustomField__c","editable":true,"readable":true}'
+
+# Update object permissions for all permission sets
+$ sf easysources permissionsets customupsert -t objectPermissions -j '{"object":"CustomObject__c","allowRead":true,"allowEdit":true}'
+```
+
+This command is particularly useful for automation scripts, CI/CD pipelines, or when you need to apply the same permission changes across multiple profiles or permission sets programmatically.
+
 ### Minify
 
 This command is very useful if you don't want to have in your csv files all the lines that don't add value to the file. The minify command is available for **profiles**, **permissionsets**, **objecttranslations**, and **translations**.

package/lib/api/permissionsets.d.ts

@@ -24,10 +24,12 @@ export interface PermissionSetOptions extends PathOptions {
     'include-types'?: string;
     /** Log directory path (clean only) */
     'log-dir'?: string;
-    /** Specific permission type to target (upsert, delete only) */
+    /** Specific permission type to target (upsert, delete, customUpsert only) */
     type?: string;
     /** Specific tag ID to target (upsert, delete only) */
     tagid?: string;
+    /** JSON content to insert/update (customUpsert only) - can be object or JSON string */
+    content?: string | object | object[];
 }
 /**
  * Permission Sets namespace containing all programmatic API functions for Salesforce Permission Set metadata operations.
@@ -44,20 +46,27 @@ export interface PermissionSetOptions extends PathOptions {
  * - updateKey(): Updates permission set keys in CSV files
  * - minify(): Removes entries with only false permissions
  * - delete(): Deletes specific entries from CSV files
+ * - customUpsert(): Inserts or updates entries via JSON content
  * - clean(): Removes references to non-existent metadata
  *
  * @example
  * ```javascript
- * const { permissionsets } = require('sfdx-easy-sources');
+ * const { permissionSets } = require('sfdx-easy-sources');
  *
  * // Using default settings from easysources-settings.json
- * await permissionsets.split({ input: 'MyPermSet' });
+ * await permissionSets.split({ input: 'MyPermSet' });
  *
  * // Override specific paths
- * await permissionsets.upsert({
+ * await permissionSets.upsert({
  *   'sf-xml': './custom-metadata-path',
  *   'es-csv': './custom-csv-path'
  * });
+ *
+ * // Custom upsert with JSON content
+ * await permissionSets.customUpsert({
+ *   type: 'objectPermissions',
+ *   content: { object: 'Account', allowRead: true, allowEdit: true }
+ * });
  * ```
  */
 export declare const permissionSets: {
@@ -109,6 +118,12 @@ export declare const permissionSets: {
      * @returns Promise resolving to operation result
      */
     delete: (options: PermissionSetOptions) => Promise<AnyJson>;
+    /**
+     * Inserts or updates specific entries in permission set CSV files using JSON content.
+     * @param options Configuration options for the custom upsert operation
+     * @returns Promise resolving to operation result
+     */
+    customUpsert: (options: PermissionSetOptions) => Promise<AnyJson>;
     /**
      * Cleans permission set CSV files by removing references to non-existent metadata.
      * @param options Optional configuration, automatically resolved from settings if not provided

package/lib/api/permissionsets.js

@@ -11,6 +11,7 @@ const clearempty_1 = require("../commands/easysources/permissionsets/clearempty"
 const minify_1 = require("../commands/easysources/permissionsets/minify");
 const delete_1 = require("../commands/easysources/permissionsets/delete");
 const clean_1 = require("../commands/easysources/permissionsets/clean");
+const customupsert_1 = require("../commands/easysources/permissionsets/customupsert");
 /**
  * Permission Sets namespace containing all programmatic API functions for Salesforce Permission Set metadata operations.
  *
@@ -26,20 +27,27 @@ const clean_1 = require("../commands/easysources/permissionsets/clean");
  * - updateKey(): Updates permission set keys in CSV files
  * - minify(): Removes entries with only false permissions
  * - delete(): Deletes specific entries from CSV files
+ * - customUpsert(): Inserts or updates entries via JSON content
  * - clean(): Removes references to non-existent metadata
  *
  * @example
  * ```javascript
- * const { permissionsets } = require('sfdx-easy-sources');
+ * const { permissionSets } = require('sfdx-easy-sources');
  *
  * // Using default settings from easysources-settings.json
- * await permissionsets.split({ input: 'MyPermSet' });
+ * await permissionSets.split({ input: 'MyPermSet' });
  *
  * // Override specific paths
- * await permissionsets.upsert({
+ * await permissionSets.upsert({
  *   'sf-xml': './custom-metadata-path',
  *   'es-csv': './custom-csv-path'
  * });
+ *
+ * // Custom upsert with JSON content
+ * await permissionSets.customUpsert({
+ *   type: 'objectPermissions',
+ *   content: { object: 'Account', allowRead: true, allowEdit: true }
+ * });
  * ```
  */
 exports.permissionSets = {
@@ -107,6 +115,14 @@ exports.permissionSets = {
     delete: async (options) => {
         return await (0, delete_1.permissionsetDelete)(options);
     },
+    /**
+     * Inserts or updates specific entries in permission set CSV files using JSON content.
+     * @param options Configuration options for the custom upsert operation
+     * @returns Promise resolving to operation result
+     */
+    customUpsert: async (options) => {
+        return await (0, customupsert_1.permissionsetCustomUpsert)(options);
+    },
     /**
      * Cleans permission set CSV files by removing references to non-existent metadata.
      * @param options Optional configuration, automatically resolved from settings if not provided

package/lib/api/permissionsets.js.map

@@ -1 +1 @@
-{"version":3,"file":"permissionsets.js","sourceRoot":"","sources":["../../src/api/permissionsets.ts"],"names":[],"mappings":";;;AAGA,uEAAuE;AACvE,wEAAkF;AAClF,0EAAoF;AACpF,wEAAkF;AAClF,gFAA0F;AAC1F,kFAA4F;AAC5F,kFAA4F;AAC5F,0EAAoF;AACpF,0EAAoF;AACpF,wEAAkF;AAmClF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACU,QAAA,cAAc,GAAG;IAC5B;;;;OAIG;IACH,KAAK,EAAE,KAAK,EAAE,UAAgC,EAAE,EAAoB,EAAE;QACpE,OAAO,MAAM,IAAA,0BAAkB,EAAC,OAAO,CAAC,CAAC;IAC3C,CAAC;IAED;;;;OAIG;IACH,MAAM,EAAE,KAAK,EAAE,UAAgC,EAAE,EAAoB,EAAE;QACrE,OAAO,MAAM,IAAA,4BAAmB,EAAC,OAAO,CAAC,CAAC;IAC5C,CAAC;IAED;;;;OAIG;IACH,KAAK,EAAE,KAAK,EAAE,UAAgC,EAAE,EAAoB,EAAE;QACpE,OAAO,MAAM,IAAA,0BAAkB,EAAC,OAAO,CAAC,CAAC;IAC3C,CAAC;IAED;;;;OAIG;IACH,UAAU,EAAE,KAAK,EAAE,UAAgC,EAAE,EAAoB,EAAE;QACzE,OAAO,MAAM,IAAA,oCAAuB,EAAC,OAAO,CAAC,CAAC;IAChD,CAAC;IAED;;;;OAIG;IACH,UAAU,EAAE,KAAK,EAAE,UAAgC,EAAE,EAAoB,EAAE;QACzE,OAAO,MAAM,IAAA,oCAAuB,EAAC,OAAO,CAAC,CAAC;IAChD,CAAC;IAED;;;;OAIG;IACH,SAAS,EAAE,KAAK,EAAE,OAA6B,EAAoB,EAAE;QACnE,OAAO,MAAM,IAAA,kCAAsB,EAAC,OAAO,CAAC,CAAC;IAC/C,CAAC;IAED;;;;OAIG;IACH,MAAM,EAAE,KAAK,EAAE,UAAgC,EAAE,EAAoB,EAAE;QACrE,OAAO,MAAM,IAAA,4BAAmB,EAAC,OAAO,CAAC,CAAC;IAC5C,CAAC;IAED;;;;OAIG;IACH,MAAM,EAAE,KAAK,EAAE,OAA6B,EAAoB,EAAE;QAChE,OAAO,MAAM,IAAA,4BAAmB,EAAC,OAAO,CAAC,CAAC;IAC5C,CAAC;IAED;;;;OAIG;IACH,KAAK,EAAE,KAAK,EAAE,UAAgC,EAAE,EAAoB,EAAE;QACpE,OAAO,MAAM,IAAA,0BAAkB,EAAC,OAAO,CAAC,CAAC;IAC3C,CAAC;CACF,CAAC"}
+{"version":3,"file":"permissionsets.js","sourceRoot":"","sources":["../../src/api/permissionsets.ts"],"names":[],"mappings":";;;AAGA,uEAAuE;AACvE,wEAAkF;AAClF,0EAAoF;AACpF,wEAAkF;AAClF,gFAA0F;AAC1F,kFAA4F;AAC5F,kFAA4F;AAC5F,0EAAoF;AACpF,0EAAoF;AACpF,wEAAkF;AAClF,sFAAgG;AAqChG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACU,QAAA,cAAc,GAAG;IAC5B;;;;OAIG;IACH,KAAK,EAAE,KAAK,EAAE,UAAgC,EAAE,EAAoB,EAAE;QACpE,OAAO,MAAM,IAAA,0BAAkB,EAAC,OAAO,CAAC,CAAC;IAC3C,CAAC;IAED;;;;OAIG;IACH,MAAM,EAAE,KAAK,EAAE,UAAgC,EAAE,EAAoB,EAAE;QACrE,OAAO,MAAM,IAAA,4BAAmB,EAAC,OAAO,CAAC,CAAC;IAC5C,CAAC;IAED;;;;OAIG;IACH,KAAK,EAAE,KAAK,EAAE,UAAgC,EAAE,EAAoB,EAAE;QACpE,OAAO,MAAM,IAAA,0BAAkB,EAAC,OAAO,CAAC,CAAC;IAC3C,CAAC;IAED;;;;OAIG;IACH,UAAU,EAAE,KAAK,EAAE,UAAgC,EAAE,EAAoB,EAAE;QACzE,OAAO,MAAM,IAAA,oCAAuB,EAAC,OAAO,CAAC,CAAC;IAChD,CAAC;IAED;;;;OAIG;IACH,UAAU,EAAE,KAAK,EAAE,UAAgC,EAAE,EAAoB,EAAE;QACzE,OAAO,MAAM,IAAA,oCAAuB,EAAC,OAAO,CAAC,CAAC;IAChD,CAAC;IAED;;;;OAIG;IACH,SAAS,EAAE,KAAK,EAAE,OAA6B,EAAoB,EAAE;QACnE,OAAO,MAAM,IAAA,kCAAsB,EAAC,OAAO,CAAC,CAAC;IAC/C,CAAC;IAED;;;;OAIG;IACH,MAAM,EAAE,KAAK,EAAE,UAAgC,EAAE,EAAoB,EAAE;QACrE,OAAO,MAAM,IAAA,4BAAmB,EAAC,OAAO,CAAC,CAAC;IAC5C,CAAC;IAED;;;;OAIG;IACH,MAAM,EAAE,KAAK,EAAE,OAA6B,EAAoB,EAAE;QAChE,OAAO,MAAM,IAAA,4BAAmB,EAAC,OAAO,CAAC,CAAC;IAC5C,CAAC;IAED;;;;OAIG;IACH,YAAY,EAAE,KAAK,EAAE,OAA6B,EAAoB,EAAE;QACtE,OAAO,MAAM,IAAA,wCAAyB,EAAC,OAAO,CAAC,CAAC;IAClD,CAAC;IAED;;;;OAIG;IACH,KAAK,EAAE,KAAK,EAAE,UAAgC,EAAE,EAAoB,EAAE;QACpE,OAAO,MAAM,IAAA,0BAAkB,EAAC,OAAO,CAAC,CAAC;IAC3C,CAAC;CACF,CAAC"}

package/lib/api/profiles.d.ts

@@ -26,10 +26,12 @@ export interface ProfileOptions extends PathOptions {
     'include-types'?: string;
     /** Log directory path (clean only) */
     'log-dir'?: string;
-    /** Specific permission type to target (upsert, delete only) */
+    /** Specific permission type to target (upsert, delete, customUpsert only) */
     type?: string;
     /** Specific tag ID to target (upsert, delete only) */
     tagid?: string;
+    /** JSON content to insert/update (customUpsert only) - can be object or JSON string */
+    content?: string | object | object[];
 }
 /**
  * Profiles namespace containing all programmatic API functions for Salesforce Profile metadata operations.
@@ -46,6 +48,7 @@ export interface ProfileOptions extends PathOptions {
  * - updateKey(): Updates profile keys in CSV files
  * - minify(): Removes entries with only false permissions
  * - delete(): Deletes specific entries from CSV files
+ * - customUpsert(): Inserts or updates entries via JSON content
  * - clean(): Removes references to non-existent metadata
  *
  * @example
@@ -60,6 +63,12 @@ export interface ProfileOptions extends PathOptions {
  *   'sf-xml': './custom-metadata-path',
  *   'es-csv': './custom-csv-path'
  * });
+ *
+ * // Custom upsert with JSON content
+ * await profiles.customUpsert({
+ *   type: 'classAccesses',
+ *   content: { apexClass: 'MyClass', enabled: true }
+ * });
  * ```
  */
 export declare const profiles: {
@@ -111,6 +120,12 @@ export declare const profiles: {
      * @returns Promise resolving to operation result
      */
     delete: (options: ProfileOptions) => Promise<AnyJson>;
+    /**
+     * Inserts or updates specific entries in profile CSV files using JSON content.
+     * @param options Configuration options for the custom upsert operation
+     * @returns Promise resolving to operation result
+     */
+    customUpsert: (options: ProfileOptions) => Promise<AnyJson>;
     /**
      * Cleans profile CSV files by removing references to non-existent metadata.
      * @param options Optional configuration, automatically resolved from settings if not provided

package/lib/api/profiles.js

@@ -11,6 +11,7 @@ const clearempty_1 = require("../commands/easysources/profiles/clearempty");
 const minify_1 = require("../commands/easysources/profiles/minify");
 const delete_1 = require("../commands/easysources/profiles/delete");
 const clean_1 = require("../commands/easysources/profiles/clean");
+const customupsert_1 = require("../commands/easysources/profiles/customupsert");
 /**
  * Profiles namespace containing all programmatic API functions for Salesforce Profile metadata operations.
  *
@@ -26,6 +27,7 @@ const clean_1 = require("../commands/easysources/profiles/clean");
  * - updateKey(): Updates profile keys in CSV files
  * - minify(): Removes entries with only false permissions
  * - delete(): Deletes specific entries from CSV files
+ * - customUpsert(): Inserts or updates entries via JSON content
  * - clean(): Removes references to non-existent metadata
  *
  * @example
@@ -40,6 +42,12 @@ const clean_1 = require("../commands/easysources/profiles/clean");
  *   'sf-xml': './custom-metadata-path',
  *   'es-csv': './custom-csv-path'
  * });
+ *
+ * // Custom upsert with JSON content
+ * await profiles.customUpsert({
+ *   type: 'classAccesses',
+ *   content: { apexClass: 'MyClass', enabled: true }
+ * });
  * ```
  */
 exports.profiles = {
@@ -107,6 +115,14 @@ exports.profiles = {
     delete: async (options) => {
         return await (0, delete_1.profileDelete)(options);
     },
+    /**
+     * Inserts or updates specific entries in profile CSV files using JSON content.
+     * @param options Configuration options for the custom upsert operation
+     * @returns Promise resolving to operation result
+     */
+    customUpsert: async (options) => {
+        return await (0, customupsert_1.profileCustomUpsert)(options);
+    },
     /**
      * Cleans profile CSV files by removing references to non-existent metadata.
      * @param options Optional configuration, automatically resolved from settings if not provided

package/lib/api/profiles.js.map

@@ -1 +1 @@
-{"version":3,"file":"profiles.js","sourceRoot":"","sources":["../../src/api/profiles.ts"],"names":[],"mappings":";;;AAGA,gEAAgE;AAChE,kEAAsE;AACtE,oEAAwE;AACxE,kEAAsE;AACtE,0EAA8E;AAC9E,4EAAgF;AAChF,4EAAgF;AAChF,oEAAwE;AACxE,oEAAwE;AACxE,kEAAsE;AAqCtE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACU,QAAA,QAAQ,GAAG;IACtB;;;;OAIG;IACH,KAAK,EAAE,KAAK,EAAE,UAA0B,EAAE,EAAoB,EAAE;QAC9D,OAAO,MAAM,IAAA,oBAAY,EAAC,OAAO,CAAC,CAAC;IACrC,CAAC;IAED;;;;OAIG;IACH,MAAM,EAAE,KAAK,EAAE,UAA0B,EAAE,EAAoB,EAAE;QAC/D,OAAO,MAAM,IAAA,sBAAa,EAAC,OAAO,CAAC,CAAC;IACtC,CAAC;IAED;;;;OAIG;IACH,KAAK,EAAE,KAAK,EAAE,UAA0B,EAAE,EAAoB,EAAE;QAC9D,OAAO,MAAM,IAAA,oBAAY,EAAC,OAAO,CAAC,CAAC;IACrC,CAAC;IAED;;;;OAIG;IACH,UAAU,EAAE,KAAK,EAAE,UAA0B,EAAE,EAAoB,EAAE;QACnE,OAAO,MAAM,IAAA,8BAAiB,EAAC,OAAO,CAAC,CAAC;IAC1C,CAAC;IAED;;;;OAIG;IACH,UAAU,EAAE,KAAK,EAAE,UAA0B,EAAE,EAAoB,EAAE;QACnE,OAAO,MAAM,IAAA,8BAAiB,EAAC,OAAO,CAAC,CAAC;IAC1C,CAAC;IAED;;;;OAIG;IACH,SAAS,EAAE,KAAK,EAAE,OAAuB,EAAoB,EAAE;QAC7D,OAAO,MAAM,IAAA,4BAAgB,EAAC,OAAO,CAAC,CAAC;IACzC,CAAC;IAED;;;;OAIG;IACH,MAAM,EAAE,KAAK,EAAE,UAA0B,EAAE,EAAoB,EAAE;QAC/D,OAAO,MAAM,IAAA,sBAAa,EAAC,OAAO,CAAC,CAAC;IACtC,CAAC;IAED;;;;OAIG;IACH,MAAM,EAAE,KAAK,EAAE,OAAuB,EAAoB,EAAE;QAC1D,OAAO,MAAM,IAAA,sBAAa,EAAC,OAAO,CAAC,CAAC;IACtC,CAAC;IAED;;;;OAIG;IACH,KAAK,EAAE,KAAK,EAAE,UAA0B,EAAE,EAAoB,EAAE;QAC9D,OAAO,MAAM,IAAA,oBAAY,EAAC,OAAO,CAAC,CAAC;IACrC,CAAC;CACF,CAAC"}
+{"version":3,"file":"profiles.js","sourceRoot":"","sources":["../../src/api/profiles.ts"],"names":[],"mappings":";;;AAGA,gEAAgE;AAChE,kEAAsE;AACtE,oEAAwE;AACxE,kEAAsE;AACtE,0EAA8E;AAC9E,4EAAgF;AAChF,4EAAgF;AAChF,oEAAwE;AACxE,oEAAwE;AACxE,kEAAsE;AACtE,gFAAoF;AAuCpF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACU,QAAA,QAAQ,GAAG;IACtB;;;;OAIG;IACH,KAAK,EAAE,KAAK,EAAE,UAA0B,EAAE,EAAoB,EAAE;QAC9D,OAAO,MAAM,IAAA,oBAAY,EAAC,OAAO,CAAC,CAAC;IACrC,CAAC;IAED;;;;OAIG;IACH,MAAM,EAAE,KAAK,EAAE,UAA0B,EAAE,EAAoB,EAAE;QAC/D,OAAO,MAAM,IAAA,sBAAa,EAAC,OAAO,CAAC,CAAC;IACtC,CAAC;IAED;;;;OAIG;IACH,KAAK,EAAE,KAAK,EAAE,UAA0B,EAAE,EAAoB,EAAE;QAC9D,OAAO,MAAM,IAAA,oBAAY,EAAC,OAAO,CAAC,CAAC;IACrC,CAAC;IAED;;;;OAIG;IACH,UAAU,EAAE,KAAK,EAAE,UAA0B,EAAE,EAAoB,EAAE;QACnE,OAAO,MAAM,IAAA,8BAAiB,EAAC,OAAO,CAAC,CAAC;IAC1C,CAAC;IAED;;;;OAIG;IACH,UAAU,EAAE,KAAK,EAAE,UAA0B,EAAE,EAAoB,EAAE;QACnE,OAAO,MAAM,IAAA,8BAAiB,EAAC,OAAO,CAAC,CAAC;IAC1C,CAAC;IAED;;;;OAIG;IACH,SAAS,EAAE,KAAK,EAAE,OAAuB,EAAoB,EAAE;QAC7D,OAAO,MAAM,IAAA,4BAAgB,EAAC,OAAO,CAAC,CAAC;IACzC,CAAC;IAED;;;;OAIG;IACH,MAAM,EAAE,KAAK,EAAE,UAA0B,EAAE,EAAoB,EAAE;QAC/D,OAAO,MAAM,IAAA,sBAAa,EAAC,OAAO,CAAC,CAAC;IACtC,CAAC;IAED;;;;OAIG;IACH,MAAM,EAAE,KAAK,EAAE,OAAuB,EAAoB,EAAE;QAC1D,OAAO,MAAM,IAAA,sBAAa,EAAC,OAAO,CAAC,CAAC;IACtC,CAAC;IAED;;;;OAIG;IACH,YAAY,EAAE,KAAK,EAAE,OAAuB,EAAoB,EAAE;QAChE,OAAO,MAAM,IAAA,kCAAmB,EAAC,OAAO,CAAC,CAAC;IAC5C,CAAC;IAED;;;;OAIG;IACH,KAAK,EAAE,KAAK,EAAE,UAA0B,EAAE,EAAoB,EAAE;QAC9D,OAAO,MAAM,IAAA,oBAAY,EAAC,OAAO,CAAC,CAAC;IACrC,CAAC;CACF,CAAC"}

package/lib/commands/easysources/objecttranslations/arealigned.d.ts

@@ -1,16 +1,16 @@
 import { flags, SfdxCommand } from '@salesforce/command';
 import { AnyJson } from '@salesforce/ts-types';
 interface ItemResult {
-    result: 'OK' | 'KO' | 'WARN';
+    result: 'OK' | 'KO';
     error?: string;
 }
 interface ValidationSummary {
-    result: 'OK';
+    result: 'OK' | 'KO';
+    error?: string;
     summary: {
         totalItems: number;
         alignedItems: number;
         misalignedItems: number;
-        warningItems: number;
     };
     items: {
         [itemName: string]: ItemResult;

package/lib/commands/easysources/objecttranslations/arealigned.js

@@ -20,6 +20,7 @@ const localSettings_1 = require("../../../utils/localSettings");
 const os_1 = require("os");
 const merge_1 = require("./merge");
 const utils_objtransl_1 = require("../../../utils/utils_objtransl");
+const alignmentChecker_1 = require("../../../utils/commands/alignmentChecker");
 const settings = (0, localSettings_1.loadSettings)();
 // Initialize Messages with the current plugin directory
 core_1.Messages.importMessagesDirectory(__dirname);
@@ -73,19 +74,21 @@ async function objectTranslationAreAligned(options = {}) {
     if (!fs.existsSync(baseXmlDir)) {
         console.log(`Missing XML directory: ${baseXmlDir}`);
         return {
-            result: 'OK',
-            summary: { totalItems: 0, alignedItems: 0, misalignedItems: 0, warningItems: 0 },
-            items: {}
-        };
-    }
-    if (!fs.existsSync(baseCsvDir)) {
-        console.log(`Missing CSV directory: ${baseCsvDir}`);
-        return {
-            result: 'OK',
-            summary: { totalItems: 0, alignedItems: 0, misalignedItems: 0, warningItems: 0 },
+            result: 'KO',
+            error: `Missing XML directory: ${baseXmlDir}`,
+            summary: { totalItems: 0, alignedItems: 0, misalignedItems: 0 },
             items: {}
         };
     }
+    // if (!fs.existsSync(baseCsvDir)) {
+    //     console.log(`Missing CSV directory: ${baseCsvDir}`);
+    //     return { 
+    //         result: 'KO',
+    //         error: `Missing CSV directory: ${baseCsvDir}`,
+    //         summary: { totalItems: 0, alignedItems: 0, misalignedItems: 0 }, 
+    //         items: {} 
+    //     };
+    // }
     var objectList = [];
     if (inputObjects) {
         objectList = inputObjects.split(',');
@@ -98,14 +101,53 @@ async function objectTranslationAreAligned(options = {}) {
     }
     const items = {};
     let alignedCount = 0;
-    let warningCount = 0;
     for (const objectName of objectList) {
+        const xmlFilePath = (0, path_1.join)(baseXmlDir, objectName, objectName + constants_objecttranslations_1.OBJTRANSL_EXTENSION);
+        const xmlDir = (0, path_1.join)(baseXmlDir, objectName);
+        const objectCsvDir = (0, path_1.join)(baseCsvDir, objectName, 'csv');
+        // Check if XML file exists
+        if (!fs.existsSync(xmlFilePath)) {
+            items[objectName] = {
+                result: 'KO',
+                error: `XML file not found: ${xmlFilePath}`
+            };
+            console.log(`❌ Object translation '${objectName}' has misalignment:`);
+            console.log(`   - XML file not found: ${xmlFilePath}`);
+            continue;
+        }
+        // Read original XML to check content
+        const originalXml = (await (0, filesUtils_1.readXmlFromFile)(xmlFilePath)) ?? {};
+        const originalItem = originalXml[constants_objecttranslations_1.OBJTRANSL_ROOT_TAG] ?? {};
+        // Check if CSV directory exists
+        if (!fs.existsSync(objectCsvDir)) {
+            // Check if original XML has any content in OBJTRANSL_ITEMS sections (excluding fieldTranslations)
+            const itemsWithoutFieldTranslations = Object.keys(constants_objecttranslations_1.OBJTRANSL_ITEMS)
+                .filter(key => key !== constants_objecttranslations_1.OBJTRANSL_CFIELDTRANSL_ROOT)
+                .reduce((obj, key) => ({ ...obj, [key]: constants_objecttranslations_1.OBJTRANSL_ITEMS[key] }), {});
+            const hasContent = (0, alignmentChecker_1.hasFileItemsContent)(originalItem, itemsWithoutFieldTranslations);
+            // Also check if there are any .fieldTranslation-meta.xml files
+            const fieldTranslationFiles = (0, utils_objtransl_1.getFieldTranslationFiles)(xmlDir);
+            const hasFieldTranslations = fieldTranslationFiles.length > 0;
+            const message = `CSV directory not found: ${objectCsvDir}`;
+            // CSV should exist if there's content OR if there are fieldTranslation files
+            if (hasContent || hasFieldTranslations) {
+                items[objectName] = { result: 'KO', error: message };
+                console.log(`❌ Object translation '${objectName}' has misalignment:`);
+                console.log(`   - ${message}`);
+            }
+            else {
+                items[objectName] = { result: 'OK' };
+                alignedCount++;
+                console.log(`✅ Object translation '${objectName}' is aligned`);
+            }
+            continue;
+        }
         let validationResult;
         if (mode === 'string') {
-            validationResult = await compareStringsForObject(objectName, baseXmlDir, baseCsvDir, options);
+            validationResult = await compareStringsForObject(objectName, xmlFilePath, xmlDir, objectCsvDir, options);
         }
         else {
-            validationResult = await validateSingleObjectTranslation(objectName, baseXmlDir, baseCsvDir, options);
+            validationResult = await validateSingleObjectTranslation(objectName, objectCsvDir, originalItem, options);
         }
         // Convert ValidationResult to ItemResult format
         if (validationResult.isAligned) {
@@ -113,15 +155,6 @@ async function objectTranslationAreAligned(options = {}) {
             alignedCount++;
             console.log(`✅ Object translation '${objectName}' is aligned`);
         }
-        else if (validationResult.isWarning) {
-            items[objectName] = {
-                result: 'WARN',
-                error: validationResult.differences.join('; ')
-            };
-            warningCount++;
-            console.log(`⚠️  Object translation '${objectName}' has warnings:`);
-            validationResult.differences.forEach(diff => console.log(`   - ${diff}`));
-        }
         else {
             items[objectName] = {
                 result: 'KO',
@@ -136,56 +169,26 @@ async function objectTranslationAreAligned(options = {}) {
         summary: {
             totalItems: objectList.length,
             alignedItems: alignedCount,
-            misalignedItems: objectList.length - alignedCount - warningCount,
-            warningItems: warningCount
+            misalignedItems: objectList.length - alignedCount
         },
         items: items
     };
-    console.log(`\n📊 Validation Summary: ${result.summary.totalItems} total, ${result.summary.alignedItems} aligned, ${result.summary.misalignedItems} misaligned, ${result.summary.warningItems} warnings`);
+    console.log(`\n📊 Validation Summary: ${result.summary.totalItems} total, ${result.summary.alignedItems} aligned, ${result.summary.misalignedItems} misaligned`);
     return result;
 }
 exports.objectTranslationAreAligned = objectTranslationAreAligned;
-async function validateSingleObjectTranslation(objectName, xmlDir, csvDir, options) {
+async function validateSingleObjectTranslation(objectName, objectCsvDir, originalItem, options) {
     const differences = [];
     try {
-        // Check main object translation XML
-        const xmlFilePath = (0, path_1.join)(xmlDir, objectName, objectName + constants_objecttranslations_1.OBJTRANSL_EXTENSION);
-        if (!fs.existsSync(xmlFilePath)) {
-            return {
-                itemName: objectName,
-                isAligned: false,
-                differences: [`XML file not found: ${xmlFilePath}`],
-                isWarning: true
-            };
-        }
-        const originalXml = await (0, filesUtils_1.readXmlFromFile)(xmlFilePath);
-        if (!originalXml || !originalXml[constants_objecttranslations_1.OBJTRANSL_ROOT_TAG]) {
-            return {
-                itemName: objectName,
-                isAligned: false,
-                differences: [`Invalid XML structure in: ${xmlFilePath}`]
-            };
-        }
-        // Check CSV directory
-        const objectCsvDir = (0, path_1.join)(csvDir, objectName, 'csv');
-        if (!fs.existsSync(objectCsvDir)) {
-            return {
-                itemName: objectName,
-                isAligned: false,
-                differences: [`CSV directory not found: ${objectCsvDir}`],
-                isWarning: true
-            };
-        }
         // Reconstruct XML from CSV using shared merge logic
         const reconstructedXml = await (0, merge_1.mergeObjectTranslationFromCsv)(objectName, objectCsvDir, options);
         // Compare main object translation structures
-        const originalData = originalXml[constants_objecttranslations_1.OBJTRANSL_ROOT_TAG] || {};
         const reconstructedData = reconstructedXml[constants_objecttranslations_1.OBJTRANSL_ROOT_TAG] || {};
         // Deep compare the relevant sections (excluding fieldTranslations)
         for (const sectionName in constants_objecttranslations_1.OBJTRANSL_ITEMS) {
             if (sectionName === constants_objecttranslations_1.OBJTRANSL_CFIELDTRANSL_ROOT)
                 continue; // Skip fieldTranslations
-            const originalSection = originalData[sectionName] || [];
+            const originalSection = originalItem[sectionName] || [];
             const reconstructedSection = reconstructedData[sectionName] || [];
             // Convert to arrays if they're objects
             const originalArray = Array.isArray(originalSection) ? originalSection : (originalSection ? [originalSection] : []);
@@ -207,7 +210,7 @@ async function validateSingleObjectTranslation(objectName, xmlDir, csvDir, optio
             }
         }
         // Validate fieldTranslations separately
-        const fieldTranslationsDifferences = await validateFieldTranslationsForObject(objectName, xmlDir, objectCsvDir);
+        const fieldTranslationsDifferences = await validateFieldTranslationsForObject(objectName, objectCsvDir);
         differences.push(...fieldTranslationsDifferences);
         return {
             itemName: objectName,
@@ -223,42 +226,17 @@ async function validateSingleObjectTranslation(objectName, xmlDir, csvDir, optio
         };
     }
 }
-async function validateFieldTranslationsForObject(objectName, xmlDir, csvDir) {
+async function validateFieldTranslationsForObject(objectName, csvDir) {
     const differences = [];
     try {
-        // Get all existing fieldTranslation XML files
-        const objectXmlDir = (0, path_1.join)(xmlDir, objectName);
-        const fieldTranslationFiles = (0, utils_objtransl_1.getFieldTranslationFiles)(objectXmlDir);
         // Use shared logic to get field translations from CSV
         const fieldXmlArray = await (0, merge_1.getFieldTranslationsFromCsv)(objectName, csvDir);
-        // Compare counts
-        if (fieldTranslationFiles.length !== fieldXmlArray.length) {
-            differences.push(`fieldTranslations: File count mismatch (XML: ${fieldTranslationFiles.length}, CSV: ${fieldXmlArray.length})`);
-        }
-        // Validate each field translation
-        for (const fieldEntry of fieldXmlArray) {
-            const expectedFileName = fieldEntry.name + constants_objecttranslations_1.OBJTRANSL_FIELDTRANSL_EXTENSION;
-            const expectedFilePath = (0, path_1.join)(objectXmlDir, expectedFileName);
-            if (!fs.existsSync(expectedFilePath)) {
-                differences.push(`fieldTranslations: Missing XML file for ${fieldEntry.name}`);
-                continue;
-            }
-            // Compare content
-            const originalXml = await (0, filesUtils_1.readXmlFromFile)(expectedFilePath);
-            const reconstructedXml = { [constants_objecttranslations_1.OBJTRANSL_CFIELDTRANSL_ROOT_TAG]: fieldEntry };
-            const originalStr = JSON.stringify(originalXml);
-            const reconstructedStr = JSON.stringify(reconstructedXml);
-            if (originalStr !== reconstructedStr) {
-                differences.push(`fieldTranslations: Content mismatch for ${fieldEntry.name}`);
-            }
-        }
-        // Check for XML files not represented in CSV
-        for (const xmlFile of fieldTranslationFiles) {
-            const fieldName = xmlFile.replace(constants_objecttranslations_1.OBJTRANSL_FIELDTRANSL_EXTENSION, '');
-            const foundInCsv = fieldXmlArray.some(entry => entry.name === fieldName);
-            if (!foundInCsv) {
-                differences.push(`fieldTranslations: XML file ${xmlFile} not represented in CSV`);
-            }
+        // In logic mode, we just verify that we can reconstruct from CSV
+        // The actual comparison with XML files is done in the main validation
+        // This is mainly to catch CSV parsing errors
+        if (fieldXmlArray.length === 0) {
+            // No field translations in CSV - this is OK
+            return differences;
         }
     }
     catch (error) {
@@ -266,28 +244,8 @@ async function validateFieldTranslationsForObject(objectName, xmlDir, csvDir) {
     }
     return differences;
 }
-async function compareStringsForObject(objectName, xmlDir, csvDir, options) {
+async function compareStringsForObject(objectName, xmlFilePath, xmlDir, objectCsvDir, options) {
     try {
-        // Check main object translation XML
-        const xmlFilePath = (0, path_1.join)(xmlDir, objectName, objectName + constants_objecttranslations_1.OBJTRANSL_EXTENSION);
-        if (!fs.existsSync(xmlFilePath)) {
-            return {
-                itemName: objectName,
-                isAligned: false,
-                differences: [`XML file not found: ${xmlFilePath}`],
-                isWarning: true
-            };
-        }
-        // Check CSV directory
-        const objectCsvDir = (0, path_1.join)(csvDir, objectName, 'csv');
-        if (!fs.existsSync(objectCsvDir)) {
-            return {
-                itemName: objectName,
-                isAligned: false,
-                differences: [`CSV directory not found: ${objectCsvDir}`],
-                isWarning: true
-            };
-        }
         const originalXmlString = await (0, filesUtils_1.readStringNormalizedFromFile)(xmlFilePath);
         // Reconstruct XML from CSV using shared merge logic
         const mergedXml = await (0, merge_1.mergeObjectTranslationFromCsv)(objectName, objectCsvDir, options);
@@ -329,13 +287,13 @@ async function compareStringsForObject(objectName, xmlDir, csvDir, options) {
 async function compareFieldTranslationsStringsForObject(objectName, xmlDir, csvDir, options) {
     const differences = [];
     try {
-        const objectXmlDir = (0, path_1.join)(xmlDir, objectName);
-        const fieldTranslationFiles = (0, utils_objtransl_1.getFieldTranslationFiles)(objectXmlDir);
+        // xmlDir is already the full path to the object directory (e.g., assets/default/objectTranslations/Account-es_CL)
+        const fieldTranslationFiles = (0, utils_objtransl_1.getFieldTranslationFiles)(xmlDir);
         // Use shared logic to get field translations from CSV
         const fieldXmlArray = await (0, merge_1.getFieldTranslationsFromCsv)(objectName, csvDir);
         // For each expected field translation file, reconstruct and compare
         for (const fieldEntry of fieldXmlArray) {
-            const expectedFilePath = (0, path_1.join)(objectXmlDir, fieldEntry.name + constants_objecttranslations_1.OBJTRANSL_FIELDTRANSL_EXTENSION);
+            const expectedFilePath = (0, path_1.join)(xmlDir, fieldEntry.name + constants_objecttranslations_1.OBJTRANSL_FIELDTRANSL_EXTENSION);
             if (fs.existsSync(expectedFilePath)) {
                 const originalString = await (0, filesUtils_1.readStringNormalizedFromFile)(expectedFilePath);
                 // Create temp file for reconstructed content