@contrail/flexplm 1.5.0-alpha.aaef470 → 1.5.0

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]
+
+## [1.5.0] - 2026-05-12
 ### 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.
 - Added optional identity-service lookup in `DataConverter.setObjectReferenceValue` for resolving inbound `object_reference` values. Enabled per referenced entity type via `config.search.<entityType>.useIdentityServiceForInboundData`. When enabled the reference is resolved via the identity service using a uniqueness pool key; otherwise behavior falls through to the existing `getAllObjectReferences` query path.

package/lib/util/data-converter.d.ts

@@ -32,7 +32,7 @@ export declare class DataConverter {
     private buildObjectReferenceContext;
     private lookupObjectReferenceViaIdentityService;
     private lookupObjectReferenceViaQuery;
-    private assertSingleObjectReference;
+    private pickSingleResult;
     getAllObjectReferences(entityType: string, rootTypeCriteria: any, postProcessCriteria?: any): Promise<any[]>;
     checkKeysAndValues(criteria: any, arrayOfObjects: any, entityTypePath: any): any[];
     filterOutArchivedAndTrashedEntities(entities: any[]): any[];

package/lib/util/data-converter.js

@@ -417,25 +417,27 @@ class DataConverter {
             entityName: 'identity',
             criteria: { poolKey, propertyName, propertyValue }
         }) ?? [];
-        return this.assertSingleObjectReference(identityResults, ctx.combinedCriteria, (r) => r.entityReference.split(':')[1]);
+        const match = this.pickSingleResult(identityResults, ctx.combinedCriteria);
+        return match ? match.entityReference.split(':')[1] : "";
     }
     async lookupObjectReferenceViaQuery(ctx) {
         let arrObjectReferences = await this.getAllObjectReferences(ctx.entityType, ctx.rootTypeCriteria);
         if (ctx.entityType !== ctx.entityTypePath) {
             arrObjectReferences = this.checkKeysAndValues(ctx.typeCriteria, arrObjectReferences, ctx.entityTypePath);
         }
-        return this.assertSingleObjectReference(arrObjectReferences, ctx.combinedCriteria, (r) => r.id);
+        const match = this.pickSingleResult(arrObjectReferences, ctx.combinedCriteria);
+        return match ? match.id : "";
     }
-    assertSingleObjectReference(results, combinedCriteria, getId) {
+    pickSingleResult(results, combinedCriteria) {
         if (!results.length) {
             console.warn(`The passed in object reference criteria ${JSON.stringify(combinedCriteria)} didn't match any entities.`);
-            return "";
+            return undefined;
         }
         if (results.length > 1) {
             console.warn(`The passed in object reference criteria has duplicate records found ${JSON.stringify(combinedCriteria)}.`);
-            return "";
+            return undefined;
         }
-        return getId(results[0]);
+        return results[0];
     }
     async getAllObjectReferences(entityType, rootTypeCriteria, postProcessCriteria = null) {
         const entities = new sdk_1.Entities();

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

@@ -826,7 +826,7 @@ describe('setObjectReferenceValue - identity service', () => {
             checkSpy.mockRestore();
         }
     });
-    it('assertSingleObjectReference single result - returns id via callback', async () => {
+    it('pickSingleResult single result - identity branch parses id from entityReference', async () => {
         const config = baseConfig();
         config.search = { item: { useIdentityServiceForInboundData: true } };
         const dc = new data_converter_1.DataConverter(config, new transform_data_1.MapFileUtil(new sdk_1.Entities()));

package/package.json

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

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

@@ -947,7 +947,7 @@ describe('setObjectReferenceValue - identity service', () => {
     }
   });
 
-  it('assertSingleObjectReference single result - returns id via callback', async () => {
+  it('pickSingleResult single result - identity branch parses id from entityReference', async () => {
     const config = baseConfig();
     config.search = { item: { useIdentityServiceForInboundData: true } };
     const dc = new DataConverter(config, new MapFileUtil(new Entities()));

package/src/util/data-converter.ts

@@ -520,7 +520,8 @@ export class DataConverter {
       criteria: { poolKey, propertyName, propertyValue }
     }) ?? [];
 
-    return this.assertSingleObjectReference(identityResults, ctx.combinedCriteria, (r) => r.entityReference.split(':')[1]);
+    const match = this.pickSingleResult(identityResults, ctx.combinedCriteria);
+    return match ? match.entityReference.split(':')[1] : "";
   }
 
   private async lookupObjectReferenceViaQuery(ctx: ObjectReferenceContext): Promise<string> {
@@ -528,19 +529,20 @@ export class DataConverter {
     if (ctx.entityType !== ctx.entityTypePath) {
       arrObjectReferences = this.checkKeysAndValues(ctx.typeCriteria, arrObjectReferences, ctx.entityTypePath);
     }
-    return this.assertSingleObjectReference(arrObjectReferences, ctx.combinedCriteria, (r) => r.id);
+    const match = this.pickSingleResult(arrObjectReferences, ctx.combinedCriteria);
+    return match ? match.id : "";
   }
 
-  private assertSingleObjectReference(results: any[], combinedCriteria: any, getId: (r: any) => string): string {
+  private pickSingleResult(results: any[], combinedCriteria: any): any | undefined {
     if (!results.length) {
       console.warn(`The passed in object reference criteria ${JSON.stringify(combinedCriteria)} didn't match any entities.`);
-      return "";
+      return undefined;
     }
     if (results.length > 1) {
       console.warn(`The passed in object reference criteria has duplicate records found ${JSON.stringify(combinedCriteria)}.`);
-      return "";
+      return undefined;
     }
-    return getId(results[0]);
+    return results[0];
   }
 
   /**