@contrail/flexplm 1.4.0-alpha.6954f61 → 1.5.0-alpha.6d9ffc4

package/CHANGELOG.md

@@ -6,6 +6,8 @@ Format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 Versioning follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ## [Unreleased]
+### Added
+- Added support for Inbound `LCSMaterial` to sync to the entity class `item` with type path `item:material` and `itemNumber` as identifier.  This is controlled by an `LCSMaterial.processAsItem` (default `false`) config default.
 
 ## [1.4.0] - 2026-05-06
 ### Added

package/lib/transform/identifier-conversion.js

@@ -201,7 +201,7 @@ class IdentifierConversion {
     }
     static async getItemCriteriaFromObject(transformMapFile, mapFileUtil, dc, object) {
         const criteria = await IdentifierConversion.getEntityCriteriaFromObject(transformMapFile, mapFileUtil, dc, object);
-        const roles = (object.flexPLMObjectClass === 'LCSProduct') ? 'family' : 'color';
+        const roles = (['LCSProduct', 'LCSMaterial'].includes(object.flexPLMObjectClass)) ? 'family' : 'color';
         criteria['roles'] = roles;
         return criteria;
     }

package/lib/transform/identifier-conversion.spec.js

@@ -4,6 +4,7 @@ const transform_data_1 = require("@contrail/transform-data");
 const identifier_conversion_1 = require("./identifier-conversion");
 const data_converter_1 = require("../util/data-converter");
 const sdk_1 = require("@contrail/sdk");
+const type_defaults_1 = require("../util/type-defaults");
 const mapFile1Data = require('./identifier-conversion-spec-mockData');
 const mapFile1Mappings = mapFile1Data?.mapping;
 const mapFile2Mappings = mapFile1Data?.mapping2;
@@ -296,6 +297,36 @@ describe('getItemCriteriaFromObject', () => {
             }
         }
     });
+    it('should return the item family criteria from the object -LCSMaterial', async () => {
+        const object = {
+            "flexPLMObjectClass": "LCSMaterial",
+            "flexPLMTypePath": "Material\\form",
+            "itemNumber": "MAT-100"
+        };
+        const criteriaObject = {
+            flexPLMObjectClass: 'LCSMaterial',
+            itemNumber: 'MAT-100',
+            flexPLMTypePath: 'Material\\form',
+        };
+        const resultsObject = {
+            roles: 'family',
+            itemNumber: 'MAT-100'
+        };
+        let getEntityValuesSpyOn = undefined;
+        type_defaults_1.TypeDefaults.applyConfig({ LCSMaterial: { processAsItem: true } });
+        try {
+            getEntityValuesSpyOn = jest.spyOn(dc, 'getEntityValues');
+            const result = await identifier_conversion_1.IdentifierConversion.getItemCriteriaFromObject(transformMapFile1, mapFileUtil, dc, object);
+            expect(getEntityValuesSpyOn).toHaveBeenCalledWith('LCSMaterial', criteriaObject, []);
+            expect(result).toEqual(resultsObject);
+        }
+        finally {
+            if (getEntityValuesSpyOn) {
+                getEntityValuesSpyOn.mockRestore();
+            }
+            type_defaults_1.TypeDefaults.applyConfig({});
+        }
+    });
     it('should return the item option criteria from the object -uniqueIdentifierA, uniqueIdentifierB', async () => {
         const object = {
             "flexBoolean": false,

package/lib/util/config-defaults.d.ts

@@ -3,6 +3,24 @@ export declare class ConfigDefaults {
     static NEED_CONFIG_VALUES: string;
     static STATIC_CONFIG_CACHE: {};
     static setConfigDefaults(config: any): Promise<FCConfig>;
+    static getDefaultConfig(): {
+        urlContext: string;
+        sendMode: {
+            ASYNC_PUBLISH_SEASON: string;
+        };
+        itemPreDevelopmentLifecycleStages: string[];
+        identifierAtts: {
+            LCSProduct: string[];
+            LCSSeason: string[];
+            LCSSKU: string[];
+        };
+        LCSMaterial: {
+            processAsItem: boolean;
+        };
+        csrfEndpoint: string;
+        vibeEventEndpoint: string;
+        payloadDefaultAsArray: boolean;
+    };
     static getConfigFile(fileId: string): Promise<any>;
     static isPropertyTrue(value: any): boolean;
     static clearConfigCache(): void;

package/lib/util/config-defaults.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ConfigDefaults = void 0;
 const sdk_1 = require("@contrail/sdk");
 const util_1 = require("@contrail/util");
+const type_defaults_1 = require("./type-defaults");
 class ConfigDefaults {
     static async setConfigDefaults(config) {
         if (!config.apiHost || !config.userName || !config.password) {
@@ -14,7 +15,24 @@ class ConfigDefaults {
         else if (Object.keys(config).includes('itemPreDevelopmentLifecycleStages')) {
             delete config['itemPreDevelopmentLifecycleStages'];
         }
-        const defaultConfig = {
+        const configArr = [ConfigDefaults.getDefaultConfig()];
+        if (config.configFile) {
+            const fileConfig = await ConfigDefaults.getConfigFile(config.configFile);
+            configArr.push(fileConfig);
+        }
+        configArr.push(config);
+        const outputConfig = util_1.ObjectUtil.mergeDeep({}, ...configArr);
+        const uName = outputConfig.userName;
+        const pass = outputConfig.password;
+        outputConfig.userName = () => uName;
+        outputConfig.password = () => pass;
+        outputConfig['OOBvibeEventEndpoint'] = '/rfa/vibeiq/vibeEvents';
+        type_defaults_1.TypeDefaults.applyConfig(outputConfig);
+        console.log('outputConfig: ' + JSON.stringify(outputConfig));
+        return outputConfig;
+    }
+    static getDefaultConfig() {
+        return {
             urlContext: '/Windchill',
             sendMode: {
                 ASYNC_PUBLISH_SEASON: 'vibeiqfile'
@@ -25,24 +43,13 @@ class ConfigDefaults {
                 LCSSeason: ['flexPLMSeasonName'],
                 LCSSKU: ['itemNumber']
             },
+            LCSMaterial: {
+                processAsItem: false
+            },
             csrfEndpoint: '/servlet/rest/security/csrf',
             vibeEventEndpoint: '/rfa/vibeiq/vibeEvents',
             payloadDefaultAsArray: true
         };
-        const configArr = [defaultConfig];
-        if (config.configFile) {
-            const fileConfig = await ConfigDefaults.getConfigFile(config.configFile);
-            configArr.push(fileConfig);
-        }
-        configArr.push(config);
-        const outputConfig = util_1.ObjectUtil.mergeDeep({}, ...configArr);
-        const uName = outputConfig.userName;
-        const pass = outputConfig.password;
-        outputConfig.userName = () => uName;
-        outputConfig.password = () => pass;
-        outputConfig['OOBvibeEventEndpoint'] = '/rfa/vibeiq/vibeEvents';
-        console.log('outputConfig: ' + JSON.stringify(outputConfig));
-        return outputConfig;
     }
     static async getConfigFile(fileId) {
         try {

package/lib/util/config-defaults.spec.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const config_defaults_1 = require("./config-defaults");
+const type_defaults_1 = require("./type-defaults");
 let entityObject = {};
 jest.mock('@contrail/sdk', () => {
     return {
@@ -296,6 +297,52 @@ describe('all tests', () => {
             expect(config_defaults_1.ConfigDefaults.isPropertyTrue(1)).toBe(false);
         });
     });
+    describe('getDefaultConfig', () => {
+        it('returns LCSMaterial.processAsItem=false by default', () => {
+            const dc = config_defaults_1.ConfigDefaults.getDefaultConfig();
+            expect(dc.LCSMaterial).toBeDefined();
+            expect(dc.LCSMaterial.processAsItem).toBe(false);
+        });
+        it('returns a fresh object each call (no shared reference)', () => {
+            const a = config_defaults_1.ConfigDefaults.getDefaultConfig();
+            const b = config_defaults_1.ConfigDefaults.getDefaultConfig();
+            expect(a).not.toBe(b);
+            expect(a.LCSMaterial).not.toBe(b.LCSMaterial);
+            a.LCSMaterial.processAsItem = true;
+            expect(b.LCSMaterial.processAsItem).toBe(false);
+        });
+    });
+    describe('setConfigDefaults - LCSMaterial', () => {
+        const config = {
+            apiHost: 'http://test.com',
+            userName: 'vibeiq',
+            password: 'vibeiq'
+        };
+        it('LCSMaterial.processAsItem-get default', async () => {
+            const startConfig = Object.assign({}, config);
+            const fcConfig = await config_defaults_1.ConfigDefaults.setConfigDefaults(startConfig);
+            expect(fcConfig.LCSMaterial.processAsItem).toBe(false);
+        });
+        it('LCSMaterial.processAsItem-override', async () => {
+            const startConfig = Object.assign({}, config);
+            startConfig.LCSMaterial = { processAsItem: true };
+            const fcConfig = await config_defaults_1.ConfigDefaults.setConfigDefaults(startConfig);
+            expect(fcConfig.LCSMaterial.processAsItem).toBe(true);
+        });
+        it('applies LCSMaterial.processAsItem to TypeDefaults', async () => {
+            try {
+                const startConfig = Object.assign({}, config, { LCSMaterial: { processAsItem: true } });
+                await config_defaults_1.ConfigDefaults.setConfigDefaults(startConfig);
+                expect(type_defaults_1.TypeDefaults.processLCSMaterialAsItem).toBe(true);
+                const defaultStart = Object.assign({}, config);
+                await config_defaults_1.ConfigDefaults.setConfigDefaults(defaultStart);
+                expect(type_defaults_1.TypeDefaults.processLCSMaterialAsItem).toBe(false);
+            }
+            finally {
+                type_defaults_1.TypeDefaults.applyConfig({});
+            }
+        });
+    });
     describe('getConfigFile', () => {
         beforeEach(() => {
             config_defaults_1.ConfigDefaults.clearConfigCache();

package/lib/util/data-converter.js

@@ -235,7 +235,7 @@ class DataConverter {
         const type = await this.typeUtils.getByRootAndPath(tco);
         const typePath = type['typePath'];
         if (typePath && (typePath.startsWith('item') || typePath.startsWith('project-item'))) {
-            if (['LCSProduct', 'LCSProductSeasonLink'].includes(objectClass)) {
+            if (['LCSProduct', 'LCSProductSeasonLink', 'LCSMaterial'].includes(objectClass)) {
                 entityValues['roles'] = ['family'];
             }
             else {

package/lib/util/data-converter.spec.js

@@ -525,6 +525,47 @@ describe('getObjectReferenceValue - use mapping', () => {
         }
     });
 });
+describe('getEntityValues', () => {
+    const config = {
+        apiHost: 'host',
+        userName: () => 'user',
+        password: () => 'pass',
+        urlContext: 'xxx',
+        vibeEventEndpoint: '/rfa/vibeiq/vibeEvents',
+        csrfEndpoint: '/servlet/rest/security/csrf',
+        itemPreDevelopmentLifecycleStages: ['concept']
+    };
+    const mapFileUtil = new transform_data_1.MapFileUtil(new sdk_1.Entities());
+    const dc = new data_converter_1.DataConverter(config, mapFileUtil);
+    const runWithStubs = async (typePath, objectClass, data) => {
+        const tcoSpy = jest.spyOn(dc['typeUtils'], 'getEntityTypeClientOptionsUsingMapping')
+            .mockImplementation(async () => ({ root: 'item' }));
+        const typeSpy = jest.spyOn(dc['typeUtils'], 'getByRootAndPath')
+            .mockImplementation(async () => ({ typePath, typeProperties: [] }));
+        const filterSpy = jest.spyOn(dc['typeUtils'], 'filterTypeProperties')
+            .mockImplementation(() => []);
+        try {
+            return await dc.getEntityValues(objectClass, data);
+        }
+        finally {
+            tcoSpy.mockRestore();
+            typeSpy.mockRestore();
+            filterSpy.mockRestore();
+        }
+    };
+    it('LCSProduct -> roles family', async () => {
+        const result = await runWithStubs('item', 'LCSProduct', { itemNumber: 'X1' });
+        expect(result['roles']).toEqual(['family']);
+    });
+    it('LCSSKU -> roles color, option', async () => {
+        const result = await runWithStubs('item', 'LCSSKU', { itemNumber: 'X1' });
+        expect(result['roles']).toEqual(['color', 'option']);
+    });
+    it('LCSMaterial -> roles family', async () => {
+        const result = await runWithStubs('item:material', 'LCSMaterial', { itemNumber: 'MAT-100' });
+        expect(result['roles']).toEqual(['family']);
+    });
+});
 describe('setEnumerationKeys', () => {
     const config = {
         apiHost: 'host',

package/lib/util/type-defaults.d.ts

@@ -2,7 +2,9 @@ export declare class TypeDefaults {
     static NO_ENTITY_TYPE: string;
     static NO_OBJECT_CLASS: string;
     static NO_TYPE_PATH: string;
+    static processLCSMaterialAsItem: boolean;
     constructor();
+    static applyConfig(config: any): void;
     static getDefaultObjectClass(entity: any): string;
     static getDefaultObjectTypePath(entity: any): string;
     static getDefaultIdentifierProperties(entity: any): string[];

package/lib/util/type-defaults.js

@@ -4,6 +4,11 @@ exports.TypeDefaults = void 0;
 class TypeDefaults {
     constructor() {
     }
+    static applyConfig(config) {
+        const val = config?.LCSMaterial?.processAsItem;
+        TypeDefaults.processLCSMaterialAsItem =
+            val === true || (typeof val === 'string' && val.toLowerCase() === 'true');
+    }
     static getDefaultObjectClass(entity) {
         const entityType = this.getEntityType(entity);
         let objectClass = '';
@@ -130,7 +135,13 @@ class TypeDefaults {
     static getDefaultEntityClass(object) {
         let entityClass = '';
         let objectClass = TypeDefaults.getObjectClass(object);
-        if (['LCSProduct', 'LCSSKU'].includes(objectClass)) {
+        const itemClasses = TypeDefaults.processLCSMaterialAsItem
+            ? ['LCSProduct', 'LCSSKU', 'LCSMaterial']
+            : ['LCSProduct', 'LCSSKU'];
+        const customEntityClasses = TypeDefaults.processLCSMaterialAsItem
+            ? ['LCSRevisableEntity', 'LCSLifecycleManaged', 'LCSLast']
+            : ['LCSRevisableEntity', 'LCSLifecycleManaged', 'LCSLast', 'LCSMaterial'];
+        if (itemClasses.includes(objectClass)) {
             entityClass = 'item';
         }
         else if (['LCSProductSeasonLink', 'LCSSKUSeasonLink'].includes(objectClass)) {
@@ -142,7 +153,7 @@ class TypeDefaults {
         else if (['LCSSeason', 'SeasonGroup'].includes(objectClass)) {
             entityClass = 'assortment';
         }
-        else if (['LCSRevisableEntity', 'LCSLifecycleManaged', 'LCSLast', 'LCSMaterial'].includes(objectClass)) {
+        else if (customEntityClasses.includes(objectClass)) {
             entityClass = 'custom-entity';
         }
         if (entityClass === '')
@@ -157,6 +168,11 @@ class TypeDefaults {
             case 'LCSSKU':
                 typePath = 'item';
                 break;
+            case 'LCSMaterial':
+                if (TypeDefaults.processLCSMaterialAsItem) {
+                    typePath = 'item:material';
+                }
+                break;
             case 'LCSProductSeasonLink':
             case 'LCSSKUSeasonLink':
                 typePath = 'project-item';
@@ -181,6 +197,14 @@ class TypeDefaults {
             case 'LCSSKU':
                 identifierProps.push('itemNumber');
                 break;
+            case 'LCSMaterial':
+                if (TypeDefaults.processLCSMaterialAsItem) {
+                    identifierProps.push('itemNumber');
+                }
+                else {
+                    identifierProps.push('name');
+                }
+                break;
             case 'LCSSeason':
                 identifierProps.push('flexPLMSeasonName');
                 break;
@@ -191,7 +215,6 @@ class TypeDefaults {
             case 'LCSRevisableEntity':
             case 'LCSLifecycleManaged':
             case 'LCSLast':
-            case 'LCSMaterial':
                 identifierProps.push('name');
                 break;
         }
@@ -200,7 +223,10 @@ class TypeDefaults {
     static getDefaultInformationalPropertiesFromObject(object) {
         const objectClass = TypeDefaults.getObjectClass(object);
         let properties = [];
-        if ('LCSProduct' === objectClass) {
+        const itemClasses = TypeDefaults.processLCSMaterialAsItem
+            ? ['LCSProduct', 'LCSMaterial']
+            : ['LCSProduct'];
+        if (itemClasses.includes(objectClass)) {
             properties.push('name');
         }
         else if ('LCSSKU' === objectClass) {
@@ -219,3 +245,4 @@ exports.TypeDefaults = TypeDefaults;
 TypeDefaults.NO_ENTITY_TYPE = 'Not able to determine the entity type of the entity object';
 TypeDefaults.NO_OBJECT_CLASS = 'Please ensure that the flexPLMObjectClass property is provided.';
 TypeDefaults.NO_TYPE_PATH = 'Please ensure that the flexPLMTypePath property is provided.';
+TypeDefaults.processLCSMaterialAsItem = false;

package/lib/util/type-defaults.spec.js

@@ -369,6 +369,26 @@ describe('Type Defaults', () => {
             const entityClass = type_defaults_1.TypeDefaults.getDefaultEntityClass(object);
             expect(entityClass).toBe('custom-entity');
         });
+        it('item - LCSMaterial - processAsItem=true', () => {
+            const object = {
+                flexPLMObjectClass: 'LCSMaterial'
+            };
+            type_defaults_1.TypeDefaults.applyConfig({ LCSMaterial: { processAsItem: true } });
+            try {
+                const entityClass = type_defaults_1.TypeDefaults.getDefaultEntityClass(object);
+                expect(entityClass).toBe('item');
+            }
+            finally {
+                type_defaults_1.TypeDefaults.applyConfig({});
+            }
+        });
+        it('custom-entity - LCSMaterial - processAsItem=false (default)', () => {
+            const object = {
+                flexPLMObjectClass: 'LCSMaterial'
+            };
+            const entityClass = type_defaults_1.TypeDefaults.getDefaultEntityClass(object);
+            expect(entityClass).toBe('custom-entity');
+        });
     });
     describe('getDefaultEntityTypePath', () => {
         it('LCSProduct', () => {
@@ -420,6 +440,25 @@ describe('Type Defaults', () => {
             const typePath = type_defaults_1.TypeDefaults.getDefaultEntityTypePath(object);
             expect(typePath).toBe('assortment');
         });
+        it('LCSMaterial - processAsItem=true', () => {
+            const object = {
+                flexPLMObjectClass: 'LCSMaterial'
+            };
+            type_defaults_1.TypeDefaults.applyConfig({ LCSMaterial: { processAsItem: true } });
+            try {
+                const typePath = type_defaults_1.TypeDefaults.getDefaultEntityTypePath(object);
+                expect(typePath).toBe('item:material');
+            }
+            finally {
+                type_defaults_1.TypeDefaults.applyConfig({});
+            }
+        });
+        it('LCSMaterial - processAsItem=false (default) throws', () => {
+            const object = {
+                flexPLMObjectClass: 'LCSMaterial'
+            };
+            expect(() => type_defaults_1.TypeDefaults.getDefaultEntityTypePath(object)).toThrowError(type_defaults_1.TypeDefaults.NO_TYPE_PATH);
+        });
     });
     describe('getDefaultIdentifierPropertiesFromObject', () => {
         it('LCSProduct', () => {
@@ -478,6 +517,28 @@ describe('Type Defaults', () => {
             expect(defaultIdentifiers).toContain('name');
             expect(defaultIdentifiers).toHaveLength(1);
         });
+        it('LCSMaterial - processAsItem=true', () => {
+            const object = {
+                flexPLMObjectClass: 'LCSMaterial'
+            };
+            type_defaults_1.TypeDefaults.applyConfig({ LCSMaterial: { processAsItem: true } });
+            try {
+                const defaultIdentifiers = type_defaults_1.TypeDefaults.getDefaultIdentifierPropertiesFromObject(object);
+                expect(defaultIdentifiers).toContain('itemNumber');
+                expect(defaultIdentifiers).toHaveLength(1);
+            }
+            finally {
+                type_defaults_1.TypeDefaults.applyConfig({});
+            }
+        });
+        it('LCSMaterial - processAsItem=false (default)', () => {
+            const object = {
+                flexPLMObjectClass: 'LCSMaterial'
+            };
+            const defaultIdentifiers = type_defaults_1.TypeDefaults.getDefaultIdentifierPropertiesFromObject(object);
+            expect(defaultIdentifiers).toContain('name');
+            expect(defaultIdentifiers).toHaveLength(1);
+        });
     });
     describe('getDefaultInformationalPropertiesFromObject', () => {
         it('LCSProduct', () => {
@@ -512,5 +573,54 @@ describe('Type Defaults', () => {
             expect(defaultIdentifiers).toContain('name');
             expect(defaultIdentifiers).toHaveLength(1);
         });
+        it('LCSMaterial - processAsItem=true', () => {
+            const object = {
+                flexPLMObjectClass: 'LCSMaterial'
+            };
+            type_defaults_1.TypeDefaults.applyConfig({ LCSMaterial: { processAsItem: true } });
+            try {
+                const defaultIdentifiers = type_defaults_1.TypeDefaults.getDefaultInformationalPropertiesFromObject(object);
+                expect(defaultIdentifiers).toContain('name');
+                expect(defaultIdentifiers).toHaveLength(1);
+            }
+            finally {
+                type_defaults_1.TypeDefaults.applyConfig({});
+            }
+        });
+        it('LCSMaterial - processAsItem=false (default) yields no informational props', () => {
+            const object = {
+                flexPLMObjectClass: 'LCSMaterial'
+            };
+            const defaultIdentifiers = type_defaults_1.TypeDefaults.getDefaultInformationalPropertiesFromObject(object);
+            expect(defaultIdentifiers).toHaveLength(0);
+        });
+    });
+    describe('applyConfig', () => {
+        afterEach(() => {
+            type_defaults_1.TypeDefaults.applyConfig({});
+        });
+        it('sets processLCSMaterialAsItem=true when processAsItem=true', () => {
+            type_defaults_1.TypeDefaults.applyConfig({ LCSMaterial: { processAsItem: true } });
+            expect(type_defaults_1.TypeDefaults.processLCSMaterialAsItem).toBe(true);
+        });
+        it('sets processLCSMaterialAsItem=true when processAsItem=\"true\" (string)', () => {
+            type_defaults_1.TypeDefaults.applyConfig({ LCSMaterial: { processAsItem: 'true' } });
+            expect(type_defaults_1.TypeDefaults.processLCSMaterialAsItem).toBe(true);
+        });
+        it('sets processLCSMaterialAsItem=false when processAsItem=false', () => {
+            type_defaults_1.TypeDefaults.processLCSMaterialAsItem = true;
+            type_defaults_1.TypeDefaults.applyConfig({ LCSMaterial: { processAsItem: false } });
+            expect(type_defaults_1.TypeDefaults.processLCSMaterialAsItem).toBe(false);
+        });
+        it('sets processLCSMaterialAsItem=false when LCSMaterial missing', () => {
+            type_defaults_1.TypeDefaults.processLCSMaterialAsItem = true;
+            type_defaults_1.TypeDefaults.applyConfig({});
+            expect(type_defaults_1.TypeDefaults.processLCSMaterialAsItem).toBe(false);
+        });
+        it('sets processLCSMaterialAsItem=false when config is null/undefined', () => {
+            type_defaults_1.TypeDefaults.processLCSMaterialAsItem = true;
+            type_defaults_1.TypeDefaults.applyConfig(undefined);
+            expect(type_defaults_1.TypeDefaults.processLCSMaterialAsItem).toBe(false);
+        });
     });
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contrail/flexplm",
-  "version": "1.4.0-alpha.6954f61",
+  "version": "1.5.0-alpha.6d9ffc4",
   "description": "Library used for integration with flexplm.",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",

package/src/transform/identifier-conversion.spec.ts

@@ -3,6 +3,7 @@ import { IdentifierConversion } from "./identifier-conversion";
 import { DataConverter } from "../util/data-converter";
 import { FCConfig } from "../interfaces/interfaces";
 import { Entities } from "@contrail/sdk";
+import { TypeDefaults } from "../util/type-defaults";
 
 const mapFile1Data = require('./identifier-conversion-spec-mockData');
 const mapFile1Mappings = mapFile1Data?.mapping;
@@ -309,6 +310,37 @@ describe('getItemCriteriaFromObject', () => {
     }
   });
 
+  it('should return the item family criteria from the object -LCSMaterial', async () => {
+    const object = {
+      "flexPLMObjectClass": "LCSMaterial",
+      "flexPLMTypePath": "Material\\form",
+      "itemNumber": "MAT-100"
+    };
+    const criteriaObject = {
+      flexPLMObjectClass: 'LCSMaterial',
+      itemNumber: 'MAT-100',
+      flexPLMTypePath: 'Material\\form',
+    };
+    const resultsObject = {
+      roles: 'family',
+      itemNumber: 'MAT-100'
+    };
+    let getEntityValuesSpyOn = undefined
+    TypeDefaults.applyConfig({ LCSMaterial: { processAsItem: true } });
+    try {
+
+      getEntityValuesSpyOn = jest.spyOn(dc, 'getEntityValues');
+      const result = await IdentifierConversion.getItemCriteriaFromObject(transformMapFile1, mapFileUtil, dc, object);
+      expect(getEntityValuesSpyOn).toHaveBeenCalledWith('LCSMaterial', criteriaObject, []);
+      expect(result).toEqual(resultsObject);
+    } finally {
+      if (getEntityValuesSpyOn) {
+        getEntityValuesSpyOn.mockRestore();
+      }
+      TypeDefaults.applyConfig({});
+    }
+  });
+
   it('should return the item option criteria from the object -uniqueIdentifierA, uniqueIdentifierB', async () => {
     const object = {
       "flexBoolean": false,

package/src/transform/identifier-conversion.ts

@@ -274,7 +274,7 @@ export class IdentifierConversion {
 
   static async getItemCriteriaFromObject(transformMapFile: string, mapFileUtil: MapFileUtil, dc: DataConverter, object: any): Promise<any> {
     const criteria = await IdentifierConversion.getEntityCriteriaFromObject(transformMapFile, mapFileUtil, dc, object);
-    const roles = (object.flexPLMObjectClass === 'LCSProduct') ? 'family' : 'color';
+    const roles = (['LCSProduct', 'LCSMaterial'].includes(object.flexPLMObjectClass)) ? 'family' : 'color';
     criteria['roles'] = roles;
 
     return criteria;

package/src/util/config-defaults.spec.ts

@@ -1,5 +1,6 @@
 import { ConfigDefaults } from './config-defaults';
 import { FCConfig } from '../interfaces/interfaces';
+import { TypeDefaults } from './type-defaults';
 
 let entityObject = {};
 jest.mock('@contrail/sdk', () => {
@@ -356,6 +357,58 @@ describe('all tests', () => {
     });
   });
 
+  describe('getDefaultConfig', () => {
+    it('returns LCSMaterial.processAsItem=false by default', () => {
+      const dc: any = ConfigDefaults.getDefaultConfig();
+      expect(dc.LCSMaterial).toBeDefined();
+      expect(dc.LCSMaterial.processAsItem).toBe(false);
+    });
+
+    it('returns a fresh object each call (no shared reference)', () => {
+      const a: any = ConfigDefaults.getDefaultConfig();
+      const b: any = ConfigDefaults.getDefaultConfig();
+      expect(a).not.toBe(b);
+      expect(a.LCSMaterial).not.toBe(b.LCSMaterial);
+      a.LCSMaterial.processAsItem = true;
+      expect(b.LCSMaterial.processAsItem).toBe(false);
+    });
+  });
+
+  describe('setConfigDefaults - LCSMaterial', () => {
+    const config = {
+      apiHost: 'http://test.com',
+      userName: 'vibeiq',
+      password: 'vibeiq'
+    };
+
+    it('LCSMaterial.processAsItem-get default', async () => {
+      const startConfig = Object.assign({}, config);
+      const fcConfig: any = await ConfigDefaults.setConfigDefaults(startConfig);
+      expect(fcConfig.LCSMaterial.processAsItem).toBe(false);
+    });
+
+    it('LCSMaterial.processAsItem-override', async () => {
+      const startConfig: any = Object.assign({}, config);
+      startConfig.LCSMaterial = { processAsItem: true };
+      const fcConfig: any = await ConfigDefaults.setConfigDefaults(startConfig);
+      expect(fcConfig.LCSMaterial.processAsItem).toBe(true);
+    });
+
+    it('applies LCSMaterial.processAsItem to TypeDefaults', async () => {
+      try {
+        const startConfig: any = Object.assign({}, config, { LCSMaterial: { processAsItem: true } });
+        await ConfigDefaults.setConfigDefaults(startConfig);
+        expect(TypeDefaults.processLCSMaterialAsItem).toBe(true);
+
+        const defaultStart: any = Object.assign({}, config);
+        await ConfigDefaults.setConfigDefaults(defaultStart);
+        expect(TypeDefaults.processLCSMaterialAsItem).toBe(false);
+      } finally {
+        TypeDefaults.applyConfig({});
+      }
+    });
+  });
+
   describe('getConfigFile', () => {
     beforeEach(() => {
       ConfigDefaults.clearConfigCache();

package/src/util/config-defaults.ts

@@ -1,6 +1,7 @@
 import { Entities } from '@contrail/sdk';
 import { FCConfig } from '../interfaces/interfaces';
 import { ObjectUtil } from '@contrail/util';
+import { TypeDefaults } from './type-defaults';
 
 export class ConfigDefaults {
   static NEED_CONFIG_VALUES = 'To connect to FlexPLM all these APP values need to be set apiHost, userName, and password';
@@ -18,22 +19,7 @@ export class ConfigDefaults {
       delete config['itemPreDevelopmentLifecycleStages'];
     }
 
-    const defaultConfig = {
-      urlContext: '/Windchill',
-      sendMode: {
-        ASYNC_PUBLISH_SEASON: 'vibeiqfile'
-      },
-      itemPreDevelopmentLifecycleStages: ['concept'],
-      identifierAtts: {
-        LCSProduct: ['itemNumber'],
-        LCSSeason: ['flexPLMSeasonName'],
-        LCSSKU: ['itemNumber']
-      },
-      csrfEndpoint: '/servlet/rest/security/csrf',
-      vibeEventEndpoint: '/rfa/vibeiq/vibeEvents',
-      payloadDefaultAsArray: true
-    };
-    const configArr = [defaultConfig];
+    const configArr = [ConfigDefaults.getDefaultConfig()];
 
     if(config.configFile){
       const fileConfig = await ConfigDefaults.getConfigFile(config.configFile);
@@ -49,10 +35,33 @@ export class ConfigDefaults {
     //Don't allow overwriting this.
     outputConfig['OOBvibeEventEndpoint'] = '/rfa/vibeiq/vibeEvents';
 
+    TypeDefaults.applyConfig(outputConfig);
+
     console.log('outputConfig: ' + JSON.stringify(outputConfig));
     return outputConfig as FCConfig;
   }
 
+  static getDefaultConfig() {
+    return {
+      urlContext: '/Windchill',
+      sendMode: {
+        ASYNC_PUBLISH_SEASON: 'vibeiqfile'
+      },
+      itemPreDevelopmentLifecycleStages: ['concept'],
+      identifierAtts: {
+        LCSProduct: ['itemNumber'],
+        LCSSeason: ['flexPLMSeasonName'],
+        LCSSKU: ['itemNumber']
+      },
+      LCSMaterial: {
+        processAsItem: false
+      },
+      csrfEndpoint: '/servlet/rest/security/csrf',
+      vibeEventEndpoint: '/rfa/vibeiq/vibeEvents',
+      payloadDefaultAsArray: true
+    };
+  }
+
   static async getConfigFile(fileId: string) {
     try {
 

package/src/util/data-converter.spec.ts

@@ -594,6 +594,51 @@ describe('getObjectReferenceValue - use mapping', () => {
   });
 });
 
+describe('getEntityValues', () => {
+  const config: FCConfig = {
+    apiHost: 'host',
+    userName: () => 'user',
+    password: () => 'pass',
+    urlContext: 'xxx',
+    vibeEventEndpoint: '/rfa/vibeiq/vibeEvents',
+    csrfEndpoint: '/servlet/rest/security/csrf',
+    itemPreDevelopmentLifecycleStages: ['concept']
+  };
+  const mapFileUtil = new MapFileUtil(new Entities());
+  const dc = new DataConverter(config, mapFileUtil);
+
+  const runWithStubs = async (typePath: string, objectClass: string, data: any) => {
+    const tcoSpy = jest.spyOn(dc['typeUtils'], 'getEntityTypeClientOptionsUsingMapping')
+      .mockImplementation(async () => ({ root: 'item' }));
+    const typeSpy = jest.spyOn(dc['typeUtils'], 'getByRootAndPath')
+      .mockImplementation(async () => ({ typePath, typeProperties: [] }));
+    const filterSpy = jest.spyOn(dc['typeUtils'], 'filterTypeProperties')
+      .mockImplementation(() => []);
+    try {
+      return await dc.getEntityValues(objectClass, data);
+    } finally {
+      tcoSpy.mockRestore();
+      typeSpy.mockRestore();
+      filterSpy.mockRestore();
+    }
+  };
+
+  it('LCSProduct -> roles family', async () => {
+    const result = await runWithStubs('item', 'LCSProduct', { itemNumber: 'X1' });
+    expect(result['roles']).toEqual(['family']);
+  });
+
+  it('LCSSKU -> roles color, option', async () => {
+    const result = await runWithStubs('item', 'LCSSKU', { itemNumber: 'X1' });
+    expect(result['roles']).toEqual(['color', 'option']);
+  });
+
+  it('LCSMaterial -> roles family', async () => {
+    const result = await runWithStubs('item:material', 'LCSMaterial', { itemNumber: 'MAT-100' });
+    expect(result['roles']).toEqual(['family']);
+  });
+});
+
 describe('setEnumerationKeys', () =>{
   const config: FCConfig = {
     apiHost: 'host',

package/src/util/data-converter.ts

@@ -287,7 +287,7 @@ export class DataConverter {
     const type = await this.typeUtils.getByRootAndPath(tco);
     const typePath = type['typePath'];
     if(typePath && (typePath.startsWith('item') || typePath.startsWith('project-item'))){
-      if(['LCSProduct', 'LCSProductSeasonLink'].includes(objectClass)){
+      if(['LCSProduct', 'LCSProductSeasonLink', 'LCSMaterial'].includes(objectClass)){
         entityValues['roles'] = ['family'];
       }else{
         entityValues['roles'] = ['color', 'option'];

package/src/util/type-defaults.spec.ts

@@ -485,6 +485,30 @@ describe('Type Defaults', () =>{
       expect(entityClass).toBe('custom-entity');
     });
 
+    it('item - LCSMaterial - processAsItem=true', () =>{
+      const object = {
+        flexPLMObjectClass: 'LCSMaterial'
+      };
+
+      TypeDefaults.applyConfig({ LCSMaterial: { processAsItem: true } });
+      try {
+        const entityClass = TypeDefaults.getDefaultEntityClass(object);
+        expect(entityClass).toBe('item');
+      } finally {
+        TypeDefaults.applyConfig({});
+      }
+    });
+
+    it('custom-entity - LCSMaterial - processAsItem=false (default)', () =>{
+      const object = {
+        flexPLMObjectClass: 'LCSMaterial'
+      };
+
+      const entityClass = TypeDefaults.getDefaultEntityClass(object);
+
+      expect(entityClass).toBe('custom-entity');
+    });
+
   });//getDefaultEntityClass
 
   describe('getDefaultEntityTypePath', () =>{
@@ -549,6 +573,28 @@ describe('Type Defaults', () =>{
       const typePath = TypeDefaults.getDefaultEntityTypePath(object);
       expect(typePath).toBe('assortment');
     });
+
+    it('LCSMaterial - processAsItem=true', () =>{
+      const object = {
+        flexPLMObjectClass: 'LCSMaterial'
+      };
+
+      TypeDefaults.applyConfig({ LCSMaterial: { processAsItem: true } });
+      try {
+        const typePath = TypeDefaults.getDefaultEntityTypePath(object);
+        expect(typePath).toBe('item:material');
+      } finally {
+        TypeDefaults.applyConfig({});
+      }
+    });
+
+    it('LCSMaterial - processAsItem=false (default) throws', () =>{
+      const object = {
+        flexPLMObjectClass: 'LCSMaterial'
+      };
+
+      expect(() => TypeDefaults.getDefaultEntityTypePath(object)).toThrowError(TypeDefaults.NO_TYPE_PATH);
+    });
   });//getDefaultEntityTypePath
 
   describe('getDefaultIdentifierPropertiesFromObject', () =>{
@@ -622,6 +668,30 @@ describe('Type Defaults', () =>{
       expect(defaultIdentifiers).toHaveLength(1);
     });
 
+    it('LCSMaterial - processAsItem=true', () =>{
+      const object = {
+        flexPLMObjectClass: 'LCSMaterial'
+      };
+      TypeDefaults.applyConfig({ LCSMaterial: { processAsItem: true } });
+      try {
+        const defaultIdentifiers = TypeDefaults.getDefaultIdentifierPropertiesFromObject(object);
+        expect(defaultIdentifiers).toContain('itemNumber');
+        expect(defaultIdentifiers).toHaveLength(1);
+      } finally {
+        TypeDefaults.applyConfig({});
+      }
+    });
+
+    it('LCSMaterial - processAsItem=false (default)', () =>{
+      const object = {
+        flexPLMObjectClass: 'LCSMaterial'
+      };
+      const defaultIdentifiers = TypeDefaults.getDefaultIdentifierPropertiesFromObject(object);
+
+      expect(defaultIdentifiers).toContain('name');
+      expect(defaultIdentifiers).toHaveLength(1);
+    });
+
   });//getDefaultIdentifierPropertiesFromObject
 
   describe('getDefaultInformationalPropertiesFromObject', () =>{
@@ -665,5 +735,63 @@ describe('Type Defaults', () =>{
       expect(defaultIdentifiers).toHaveLength(1);
     });
 
+    it('LCSMaterial - processAsItem=true', () =>{
+      const object = {
+        flexPLMObjectClass: 'LCSMaterial'
+      };
+
+      TypeDefaults.applyConfig({ LCSMaterial: { processAsItem: true } });
+      try {
+        const defaultIdentifiers = TypeDefaults.getDefaultInformationalPropertiesFromObject(object);
+        expect(defaultIdentifiers).toContain('name');
+        expect(defaultIdentifiers).toHaveLength(1);
+      } finally {
+        TypeDefaults.applyConfig({});
+      }
+    });
+
+    it('LCSMaterial - processAsItem=false (default) yields no informational props', () =>{
+      const object = {
+        flexPLMObjectClass: 'LCSMaterial'
+      };
+
+      const defaultIdentifiers = TypeDefaults.getDefaultInformationalPropertiesFromObject(object);
+      expect(defaultIdentifiers).toHaveLength(0);
+    });
+
   });//getDefaultInformationalPropertiesFromObject
+
+  describe('applyConfig', () => {
+    afterEach(() => {
+      TypeDefaults.applyConfig({});
+    });
+
+    it('sets processLCSMaterialAsItem=true when processAsItem=true', () => {
+      TypeDefaults.applyConfig({ LCSMaterial: { processAsItem: true } });
+      expect(TypeDefaults.processLCSMaterialAsItem).toBe(true);
+    });
+
+    it('sets processLCSMaterialAsItem=true when processAsItem=\"true\" (string)', () => {
+      TypeDefaults.applyConfig({ LCSMaterial: { processAsItem: 'true' } });
+      expect(TypeDefaults.processLCSMaterialAsItem).toBe(true);
+    });
+
+    it('sets processLCSMaterialAsItem=false when processAsItem=false', () => {
+      TypeDefaults.processLCSMaterialAsItem = true;
+      TypeDefaults.applyConfig({ LCSMaterial: { processAsItem: false } });
+      expect(TypeDefaults.processLCSMaterialAsItem).toBe(false);
+    });
+
+    it('sets processLCSMaterialAsItem=false when LCSMaterial missing', () => {
+      TypeDefaults.processLCSMaterialAsItem = true;
+      TypeDefaults.applyConfig({});
+      expect(TypeDefaults.processLCSMaterialAsItem).toBe(false);
+    });
+
+    it('sets processLCSMaterialAsItem=false when config is null/undefined', () => {
+      TypeDefaults.processLCSMaterialAsItem = true;
+      TypeDefaults.applyConfig(undefined);
+      expect(TypeDefaults.processLCSMaterialAsItem).toBe(false);
+    });
+  });
 });

package/src/util/type-defaults.ts

@@ -2,8 +2,23 @@ export class TypeDefaults {
   static NO_ENTITY_TYPE = 'Not able to determine the entity type of the entity object';
   static NO_OBJECT_CLASS = 'Please ensure that the flexPLMObjectClass property is provided.';
   static NO_TYPE_PATH = 'Please ensure that the flexPLMTypePath property is provided.';
+  static processLCSMaterialAsItem = false;
   constructor() {
   }
+
+  /** Applies values from the resolved config to TypeDefaults static state.
+   *  Currently toggles whether LCSMaterial is treated as an item (new) or a
+   *  custom-entity (old) based on config.LCSMaterial.processAsItem.
+   *  Technically this could cause side effects if different parts of the code
+   *  expect different behavior, but in practice * @param config will be 
+   *  consistent across the app and this is simpler than passing this config
+   *  through multiple layers of function calls.
+   */
+  static applyConfig(config: any): void {
+    const val = config?.LCSMaterial?.processAsItem;
+    TypeDefaults.processLCSMaterialAsItem =
+      val === true || (typeof val === 'string' && val.toLowerCase() === 'true');
+  }
   /**Takes in full entity and returs the default FlexPLM
    * object class.
    *
@@ -87,7 +102,7 @@ export class TypeDefaults {
    */
 
   static getDefaultIdentifierProperties(entity): string[] {
-    const identifierProps = [];
+    const identifierProps: string[] = [];
     const entityType = this.getEntityType(entity);
 
     switch (entityType) {
@@ -168,7 +183,13 @@ export class TypeDefaults {
   static getDefaultEntityClass(object): string {
     let entityClass = '';
     let objectClass = TypeDefaults.getObjectClass(object);
-    if(['LCSProduct', 'LCSSKU'].includes(objectClass)){
+    const itemClasses = TypeDefaults.processLCSMaterialAsItem
+      ? ['LCSProduct', 'LCSSKU', 'LCSMaterial']
+      : ['LCSProduct', 'LCSSKU'];
+    const customEntityClasses = TypeDefaults.processLCSMaterialAsItem
+      ? ['LCSRevisableEntity', 'LCSLifecycleManaged', 'LCSLast']
+      : ['LCSRevisableEntity', 'LCSLifecycleManaged', 'LCSLast', 'LCSMaterial'];
+    if(itemClasses.includes(objectClass)){
       entityClass = 'item';
     }else if(['LCSProductSeasonLink', 'LCSSKUSeasonLink'].includes(objectClass)){
       entityClass = 'project-item'
@@ -176,7 +197,7 @@ export class TypeDefaults {
       entityClass = 'color';
     } else if(['LCSSeason', 'SeasonGroup'].includes(objectClass)) {
       entityClass = 'assortment';
-    } else if(['LCSRevisableEntity', 'LCSLifecycleManaged', 'LCSLast', 'LCSMaterial'].includes(objectClass)) {
+    } else if(customEntityClasses.includes(objectClass)) {
       entityClass = 'custom-entity';
     }
 
@@ -201,6 +222,11 @@ export class TypeDefaults {
         case 'LCSSKU':
           typePath = 'item';
           break;
+        case 'LCSMaterial':
+          if (TypeDefaults.processLCSMaterialAsItem) {
+            typePath = 'item:material';
+          }
+          break;
         case 'LCSProductSeasonLink':
         case 'LCSSKUSeasonLink':
           typePath = 'project-item';
@@ -229,7 +255,7 @@ export class TypeDefaults {
    */
 
   static getDefaultIdentifierPropertiesFromObject(object): string[] {
-    const identifierProps = [];
+    const identifierProps: string[] = [];
     const objectClass = TypeDefaults.getObjectClass(object);
 
     switch (objectClass) {
@@ -237,6 +263,13 @@ export class TypeDefaults {
       case 'LCSSKU':
           identifierProps.push('itemNumber');
         break;
+      case 'LCSMaterial':
+        if (TypeDefaults.processLCSMaterialAsItem) {
+          identifierProps.push('itemNumber');
+        } else {
+          identifierProps.push('name');
+        }
+        break;
       case 'LCSSeason':
         identifierProps.push('flexPLMSeasonName');
         break;
@@ -247,7 +280,6 @@ export class TypeDefaults {
       case 'LCSRevisableEntity':
       case 'LCSLifecycleManaged':
       case 'LCSLast':
-      case 'LCSMaterial':
         identifierProps.push('name');
         break;
     }
@@ -265,7 +297,10 @@ export class TypeDefaults {
     static getDefaultInformationalPropertiesFromObject(object): string[] {
       const objectClass = TypeDefaults.getObjectClass(object);
       let properties:string[] = [];
-      if ('LCSProduct' === objectClass) {
+      const itemClasses = TypeDefaults.processLCSMaterialAsItem
+        ? ['LCSProduct', 'LCSMaterial']
+        : ['LCSProduct'];
+      if (itemClasses.includes(objectClass)) {
         properties.push('name');
       } else if ('LCSSKU' === objectClass) {
         properties.push('optionName');