@contrail/flexplm 1.5.0-alpha.aaef470 → 1.5.1-alpha.14abddb

package/CHANGELOG.md

@@ -6,6 +6,12 @@ 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.1] - 2026-05-14
+### Added
+- Added sending an external event with the publish payload and trigger key of `VibeIQ|AssortmentPublishedToFlexPLM` to enable secondary events to run on the event / data which was generated.  Also includes the payload in the data which can be passed to the next action.
+
+## [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/publish/base-process-publish-assortment.d.ts

@@ -79,6 +79,7 @@ export declare class BaseProcessPublishAssortment {
     private sendToFlexPLM;
     private saveToLocalFile;
     private handleVibeIQFile;
+    sendPublishPayloadEvent(outboundEvent: any): Promise<void>;
     private getCurrentDateString;
     getItemFamilyChanges(pcd: PublishChangeData, changeDetail: any, assortmentItemFullChangeMap: Map<string, any>, assortmentItemDeleteMap: Map<string, any>): Map<string, ItemFamilyChanges>;
     getEventsForPublishChangeData(publishChangeData: PublishChangeData): Promise<SeasonalPayload[]>;

package/lib/publish/base-process-publish-assortment.js

@@ -569,14 +569,19 @@ class BaseProcessPublishAssortment {
         }
     }
     async sendToFlexPLM(events, eventType) {
-        const asyncEvent = {
+        const outboundPublishEvent = {
             taskId: this.config.taskId,
             eventType,
             objectClass: 'LCSSeason',
             events
         };
         const flexPLMConnect = new flexplm_connect_1.FlexPLMConnect(this.config);
-        return await flexPLMConnect.sendToFlexPLM(asyncEvent);
+        const [result] = await Promise.all([
+            flexPLMConnect.sendToFlexPLM(outboundPublishEvent),
+            this.sendPublishPayloadEvent(outboundPublishEvent)
+        ]);
+        result['outboundPublishEvent'] = outboundPublishEvent;
+        return result;
     }
     async saveToLocalFile(events, eventType) {
         let results = {};
@@ -588,15 +593,16 @@ class BaseProcessPublishAssortment {
             const eventDirName = 'events-output';
             const fileName = `${path.sep}${eventDirName}${path.sep}events-${dateString}.json`;
             fileHandle = await fsPromise.open('.' + fileName, 'a');
-            const asyncEvent = {
+            const outboundPublishEvent = {
                 taskId: this.config.taskId,
                 eventType,
                 objectClass: 'LCSSeason',
                 events
             };
-            await fileHandle.writeFile(JSON.stringify(asyncEvent));
+            await fileHandle.writeFile(JSON.stringify(outboundPublishEvent));
             results = {
                 message: 'Successfully Saved File',
+                outboundPublishEvent,
                 fileLocation: dirName + fileName
             };
         }
@@ -612,7 +618,7 @@ class BaseProcessPublishAssortment {
         const eventBuffer = Buffer.from(JSON.stringify(events), 'utf-8');
         const fileName = 'ASYNC_PUBLISH_SEASON-events.json';
         const uploadFile = await new sdk_1.Files().createAndUploadFileFromBuffer(eventBuffer, 'application/json', fileName, null, this.TTL);
-        const asyncEvent = {
+        const outboundPublishEvent = {
             taskId: this.config.taskId,
             eventType,
             objectClass: 'LCSSeason',
@@ -622,15 +628,39 @@ class BaseProcessPublishAssortment {
         };
         if (sendMode === 'vibeiqfile') {
             const flexPLMConnect = new flexplm_connect_1.FlexPLMConnect(this.config);
-            return await flexPLMConnect.sendToFlexPLM(asyncEvent);
+            const [result] = await Promise.all([
+                flexPLMConnect.sendToFlexPLM(outboundPublishEvent),
+                this.sendPublishPayloadEvent(outboundPublishEvent)
+            ]);
+            return { ...result, outboundPublishEvent };
         }
         else {
+            await this.sendPublishPayloadEvent(outboundPublishEvent);
             return {
                 message: 'Successfully Uploaded File.',
-                asyncEvent
+                outboundPublishEvent
             };
         }
     }
+    async sendPublishPayloadEvent(outboundEvent) {
+        console.info('sendPublishPayloadEvent()');
+        let initialEvent = {};
+        if (this.config?.event) {
+            initialEvent = (typeof this.config?.event === 'string')
+                ? JSON.parse(this.config?.event)
+                : this.config?.event;
+        }
+        const eventBody = {
+            originSystemType: 'VibeIQ',
+            objectClass: 'AssortmentPublishedToFlexPLM',
+            outboundEvent,
+            initialEvent
+        };
+        await new sdk_1.Entities().create({
+            entityName: 'external-event',
+            object: eventBody
+        });
+    }
     getCurrentDateString() {
         const d = new Date();
         return '' + d.getUTCFullYear()

package/lib/publish/base-process-publish-assortment.spec.js

@@ -9,6 +9,7 @@ const sdk_1 = require("@contrail/sdk");
 const type_conversion_utils_1 = require("../util/type-conversion-utils");
 const map_utils_1 = require("../util/map-utils");
 const item_family_changes_1 = require("../interfaces/item-family-changes");
+const flexplm_connect_1 = require("../util/flexplm-connect");
 let federatedId = '';
 jest.mock('../util/data-converter', () => {
     return {
@@ -30,6 +31,13 @@ jest.mock('../util/federation', () => {
 });
 let entityObject = {};
 let getOptionsObject = {};
+let createCallArg = undefined;
+let fileUploadCalls = [];
+let fileUploadResult = {
+    id: 'file-123',
+    downloadUrl: 'https://download.url',
+    adminDownloadUrl: 'https://admin.download.url'
+};
 jest.mock('@contrail/sdk', () => {
     return {
         Entities: class {
@@ -37,6 +45,18 @@ jest.mock('@contrail/sdk', () => {
                 getOptionsObject = _getOtionsObject;
                 return entityObject;
             }
+            create(arg) {
+                createCallArg = arg;
+                return Promise.resolve({});
+            }
+        },
+        Files: class {
+            createAndUploadFileFromBuffer(buffer, mimeType, fileName, _x, ttl) {
+                fileUploadCalls.push({ buffer, mimeType, fileName, ttl });
+                return Promise.resolve(fileUploadResult);
+            }
+        },
+        Request: class {
         }
     };
 });
@@ -1668,3 +1688,122 @@ describe('getEventsForItemFamilyChanges - conditional eventType', () => {
         expect(type_conversion_utils_1.TypeConversionUtils.isOutboundCreatableFromEntity).toHaveBeenNthCalledWith(2, undefined, mapFileUtil, colorProjectItem, { item: itemData, assortment });
     });
 });
+describe('sendToFlexPLM / handleVibeIQFile / sendPublishPayloadEvent', () => {
+    const config = {
+        taskId: 'task-abc',
+        event: '{"sourceEventId":"src-1"}'
+    };
+    const mapFileUtil = new transform_data_1.MapFileUtil(new sdk_1.Entities());
+    const dc = new data_converter_1.DataConverter(config, mapFileUtil);
+    const events = [{ objectClass: 'LCSProductSeasonLink' }];
+    const eventType = 'ASYNC_PUBLISH_SEASON';
+    beforeEach(() => {
+        createCallArg = undefined;
+        fileUploadCalls = [];
+        fileUploadResult = {
+            id: 'file-123',
+            downloadUrl: 'https://download.url',
+            adminDownloadUrl: 'https://admin.download.url'
+        };
+    });
+    afterEach(() => {
+        jest.restoreAllMocks();
+    });
+    it('sendToFlexPLM merges outboundPublishEvent into result and calls sendPublishPayloadEvent in parallel', async () => {
+        const bppa = new base_process_publish_assortment_1.BaseProcessPublishAssortment(config, dc, mapFileUtil);
+        const flexResponse = { status: 200, data: { ok: true } };
+        let flexResolved = false;
+        let eventResolved = false;
+        const spyFlex = jest.spyOn(flexplm_connect_1.FlexPLMConnect.prototype, 'sendToFlexPLM')
+            .mockImplementation(async () => {
+            await new Promise(r => setTimeout(r, 5));
+            flexResolved = true;
+            return flexResponse;
+        });
+        const spyEvent = jest.spyOn(bppa, 'sendPublishPayloadEvent')
+            .mockImplementation(async () => {
+            await new Promise(r => setTimeout(r, 5));
+            eventResolved = true;
+        });
+        const result = await bppa.sendToFlexPLM(events, eventType);
+        expect(spyFlex).toHaveBeenCalledTimes(1);
+        expect(spyEvent).toHaveBeenCalledTimes(1);
+        expect(flexResolved).toBe(true);
+        expect(eventResolved).toBe(true);
+        const passedOutboundPublishEvent = spyFlex.mock.calls[0][0];
+        expect(passedOutboundPublishEvent.taskId).toBe('task-abc');
+        expect(passedOutboundPublishEvent.eventType).toBe(eventType);
+        expect(passedOutboundPublishEvent.objectClass).toBe('LCSSeason');
+        expect(passedOutboundPublishEvent.events).toBe(events);
+        expect(spyEvent).toHaveBeenCalledWith(passedOutboundPublishEvent);
+        expect(result).toEqual({ ...flexResponse, outboundPublishEvent: passedOutboundPublishEvent });
+    });
+    it('handleVibeIQFile (vibeiqfile) merges outboundPublishEvent into FlexPLM result and calls sendPublishPayloadEvent', async () => {
+        const bppa = new base_process_publish_assortment_1.BaseProcessPublishAssortment(config, dc, mapFileUtil);
+        const flexResponse = { status: 200, data: { ok: true } };
+        const spyFlex = jest.spyOn(flexplm_connect_1.FlexPLMConnect.prototype, 'sendToFlexPLM')
+            .mockResolvedValue(flexResponse);
+        const spyEvent = jest.spyOn(bppa, 'sendPublishPayloadEvent')
+            .mockResolvedValue(undefined);
+        const result = await bppa.handleVibeIQFile(events, eventType, 'vibeiqfile');
+        expect(fileUploadCalls).toHaveLength(1);
+        expect(fileUploadCalls[0].fileName).toBe('ASYNC_PUBLISH_SEASON-events.json');
+        expect(fileUploadCalls[0].mimeType).toBe('application/json');
+        const passedOutboundPublishEvent = spyFlex.mock.calls[0][0];
+        expect(passedOutboundPublishEvent.taskId).toBe('task-abc');
+        expect(passedOutboundPublishEvent.eventType).toBe(eventType);
+        expect(passedOutboundPublishEvent.objectClass).toBe('LCSSeason');
+        expect(passedOutboundPublishEvent.eventsFileId).toBe('file-123');
+        expect(passedOutboundPublishEvent.eventsDownloadLink).toBe('https://download.url');
+        expect(passedOutboundPublishEvent.eventsAdminDownloadLink).toBe('https://admin.download.url');
+        expect(spyFlex).toHaveBeenCalledTimes(1);
+        expect(spyEvent).toHaveBeenCalledTimes(1);
+        expect(spyEvent).toHaveBeenCalledWith(passedOutboundPublishEvent);
+        expect(result).toEqual({ ...flexResponse, outboundPublishEvent: passedOutboundPublishEvent });
+    });
+    it('handleVibeIQFile (vibeiqfile-dontsendtoflexplm) skips FlexPLM but still calls sendPublishPayloadEvent', async () => {
+        const bppa = new base_process_publish_assortment_1.BaseProcessPublishAssortment(config, dc, mapFileUtil);
+        const spyFlex = jest.spyOn(flexplm_connect_1.FlexPLMConnect.prototype, 'sendToFlexPLM')
+            .mockResolvedValue({});
+        const spyEvent = jest.spyOn(bppa, 'sendPublishPayloadEvent')
+            .mockResolvedValue(undefined);
+        const result = await bppa.handleVibeIQFile(events, eventType, 'vibeiqfile-dontsendtoflexplm');
+        expect(spyFlex).not.toHaveBeenCalled();
+        expect(spyEvent).toHaveBeenCalledTimes(1);
+        const passedOutboundPublishEvent = spyEvent.mock.calls[0][0];
+        expect(passedOutboundPublishEvent.eventsFileId).toBe('file-123');
+        expect(result).toEqual({
+            message: 'Successfully Uploaded File.',
+            outboundPublishEvent: passedOutboundPublishEvent
+        });
+    });
+    it('sendPublishPayloadEvent creates an external-event with initialEvent parsed from config', async () => {
+        const bppa = new base_process_publish_assortment_1.BaseProcessPublishAssortment(config, dc, mapFileUtil);
+        const outboundEvent = { foo: 'bar' };
+        await bppa.sendPublishPayloadEvent(outboundEvent);
+        expect(createCallArg).toEqual({
+            entityName: 'external-event',
+            object: {
+                originSystemType: 'VibeIQ',
+                objectClass: 'AssortmentPublishedToFlexPLM',
+                outboundEvent,
+                initialEvent: { sourceEventId: 'src-1' }
+            }
+        });
+    });
+    it('sendPublishPayloadEvent defaults initialEvent to {} when config has no event', async () => {
+        const bareConfig = { taskId: 'task-x' };
+        const bppa = new base_process_publish_assortment_1.BaseProcessPublishAssortment(bareConfig, dc, mapFileUtil);
+        const outboundEvent = { hello: 'world' };
+        await bppa.sendPublishPayloadEvent(outboundEvent);
+        expect(createCallArg).toEqual({
+            entityName: 'external-event',
+            object: {
+                originSystemType: 'VibeIQ',
+                objectClass: 'AssortmentPublishedToFlexPLM',
+                outboundEvent,
+                initialEvent: {}
+            }
+        });
+    });
+});

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.1-alpha.14abddb",
   "description": "Library used for integration with flexplm.",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",

package/src/publish/base-process-publish-assortment.spec.ts

@@ -8,6 +8,7 @@ import { Entities } from '@contrail/sdk';
 import { TypeConversionUtils } from '../util/type-conversion-utils';
 import { MapUtil } from '../util/map-utils';
 import { ItemFamilyChanges } from '../interfaces/item-family-changes';
+import { FlexPLMConnect } from '../util/flexplm-connect';
 
 let federatedId = '';
 jest.mock('../util/data-converter', () => {
@@ -32,6 +33,13 @@ jest.mock('../util/federation', () => {
 });
 let entityObject = {};
 let getOptionsObject = {};
+let createCallArg: any = undefined;
+let fileUploadCalls: any[] = [];
+let fileUploadResult: any = {
+  id: 'file-123',
+  downloadUrl: 'https://download.url',
+  adminDownloadUrl: 'https://admin.download.url'
+};
 jest.mock('@contrail/sdk', () => {
   return {
     Entities: class{
@@ -39,7 +47,18 @@ jest.mock('@contrail/sdk', () => {
         getOptionsObject = _getOtionsObject;
         return entityObject;
       }
-    }
+      create(arg){
+        createCallArg = arg;
+        return Promise.resolve({});
+      }
+    },
+    Files: class{
+      createAndUploadFileFromBuffer(buffer, mimeType, fileName, _x, ttl){
+        fileUploadCalls.push({ buffer, mimeType, fileName, ttl });
+        return Promise.resolve(fileUploadResult);
+      }
+    },
+    Request: class{}
   };
 });
 describe('process publish assortment', () => {
@@ -1989,4 +2008,147 @@ describe('getEventsForItemFamilyChanges - conditional eventType', () => {
     );
   });
 
+});
+
+describe('sendToFlexPLM / handleVibeIQFile / sendPublishPayloadEvent', () => {
+  const config = {
+    taskId: 'task-abc',
+    event: '{"sourceEventId":"src-1"}'
+  } as unknown as FCConfig;
+  const mapFileUtil = new MapFileUtil(new Entities());
+  const dc = new DataConverter(config, mapFileUtil);
+  const events = [{ objectClass: 'LCSProductSeasonLink' }] as any;
+  const eventType = 'ASYNC_PUBLISH_SEASON';
+
+  beforeEach(() => {
+    createCallArg = undefined;
+    fileUploadCalls = [];
+    fileUploadResult = {
+      id: 'file-123',
+      downloadUrl: 'https://download.url',
+      adminDownloadUrl: 'https://admin.download.url'
+    };
+  });
+  afterEach(() => {
+    jest.restoreAllMocks();
+  });
+
+  it('sendToFlexPLM merges outboundPublishEvent into result and calls sendPublishPayloadEvent in parallel', async () => {
+    const bppa = new BaseProcessPublishAssortment(config, dc, mapFileUtil);
+    const flexResponse = { status: 200, data: { ok: true } };
+
+    let flexResolved = false;
+    let eventResolved = false;
+    const spyFlex = jest.spyOn(FlexPLMConnect.prototype, 'sendToFlexPLM')
+      .mockImplementation(async () => {
+        await new Promise(r => setTimeout(r, 5));
+        flexResolved = true;
+        return flexResponse as any;
+      });
+    const spyEvent = jest.spyOn(bppa, 'sendPublishPayloadEvent')
+      .mockImplementation(async () => {
+        await new Promise(r => setTimeout(r, 5));
+        eventResolved = true;
+      });
+
+    const result = await (bppa as any).sendToFlexPLM(events, eventType);
+
+    expect(spyFlex).toHaveBeenCalledTimes(1);
+    expect(spyEvent).toHaveBeenCalledTimes(1);
+    expect(flexResolved).toBe(true);
+    expect(eventResolved).toBe(true);
+
+    const passedOutboundPublishEvent = spyFlex.mock.calls[0][0] as any;
+    expect(passedOutboundPublishEvent.taskId).toBe('task-abc');
+    expect(passedOutboundPublishEvent.eventType).toBe(eventType);
+    expect(passedOutboundPublishEvent.objectClass).toBe('LCSSeason');
+    expect(passedOutboundPublishEvent.events).toBe(events);
+    expect(spyEvent).toHaveBeenCalledWith(passedOutboundPublishEvent);
+    expect(result).toEqual({ ...flexResponse, outboundPublishEvent: passedOutboundPublishEvent });
+  });
+
+  it('handleVibeIQFile (vibeiqfile) merges outboundPublishEvent into FlexPLM result and calls sendPublishPayloadEvent', async () => {
+    const bppa = new BaseProcessPublishAssortment(config, dc, mapFileUtil);
+    const flexResponse = { status: 200, data: { ok: true } };
+
+    const spyFlex = jest.spyOn(FlexPLMConnect.prototype, 'sendToFlexPLM')
+      .mockResolvedValue(flexResponse as any);
+    const spyEvent = jest.spyOn(bppa, 'sendPublishPayloadEvent')
+      .mockResolvedValue(undefined as any);
+
+    const result = await (bppa as any).handleVibeIQFile(events, eventType, 'vibeiqfile');
+
+    expect(fileUploadCalls).toHaveLength(1);
+    expect(fileUploadCalls[0].fileName).toBe('ASYNC_PUBLISH_SEASON-events.json');
+    expect(fileUploadCalls[0].mimeType).toBe('application/json');
+
+    const passedOutboundPublishEvent = spyFlex.mock.calls[0][0] as any;
+    expect(passedOutboundPublishEvent.taskId).toBe('task-abc');
+    expect(passedOutboundPublishEvent.eventType).toBe(eventType);
+    expect(passedOutboundPublishEvent.objectClass).toBe('LCSSeason');
+    expect(passedOutboundPublishEvent.eventsFileId).toBe('file-123');
+    expect(passedOutboundPublishEvent.eventsDownloadLink).toBe('https://download.url');
+    expect(passedOutboundPublishEvent.eventsAdminDownloadLink).toBe('https://admin.download.url');
+
+    expect(spyFlex).toHaveBeenCalledTimes(1);
+    expect(spyEvent).toHaveBeenCalledTimes(1);
+    expect(spyEvent).toHaveBeenCalledWith(passedOutboundPublishEvent);
+    expect(result).toEqual({ ...flexResponse, outboundPublishEvent: passedOutboundPublishEvent });
+  });
+
+  it('handleVibeIQFile (vibeiqfile-dontsendtoflexplm) skips FlexPLM but still calls sendPublishPayloadEvent', async () => {
+    const bppa = new BaseProcessPublishAssortment(config, dc, mapFileUtil);
+
+    const spyFlex = jest.spyOn(FlexPLMConnect.prototype, 'sendToFlexPLM')
+      .mockResolvedValue({} as any);
+    const spyEvent = jest.spyOn(bppa, 'sendPublishPayloadEvent')
+      .mockResolvedValue(undefined as any);
+
+    const result = await (bppa as any).handleVibeIQFile(events, eventType, 'vibeiqfile-dontsendtoflexplm');
+
+    expect(spyFlex).not.toHaveBeenCalled();
+    expect(spyEvent).toHaveBeenCalledTimes(1);
+
+    const passedOutboundPublishEvent = spyEvent.mock.calls[0][0] as any;
+    expect(passedOutboundPublishEvent.eventsFileId).toBe('file-123');
+    expect(result).toEqual({
+      message: 'Successfully Uploaded File.',
+      outboundPublishEvent: passedOutboundPublishEvent
+    });
+  });
+
+  it('sendPublishPayloadEvent creates an external-event with initialEvent parsed from config', async () => {
+    const bppa = new BaseProcessPublishAssortment(config, dc, mapFileUtil);
+    const outboundEvent = { foo: 'bar' };
+
+    await bppa.sendPublishPayloadEvent(outboundEvent);
+
+    expect(createCallArg).toEqual({
+      entityName: 'external-event',
+      object: {
+        originSystemType: 'VibeIQ',
+        objectClass: 'AssortmentPublishedToFlexPLM',
+        outboundEvent,
+        initialEvent: { sourceEventId: 'src-1' }
+      }
+    });
+  });
+
+  it('sendPublishPayloadEvent defaults initialEvent to {} when config has no event', async () => {
+    const bareConfig = { taskId: 'task-x' } as unknown as FCConfig;
+    const bppa = new BaseProcessPublishAssortment(bareConfig, dc, mapFileUtil);
+    const outboundEvent = { hello: 'world' };
+
+    await bppa.sendPublishPayloadEvent(outboundEvent);
+
+    expect(createCallArg).toEqual({
+      entityName: 'external-event',
+      object: {
+        originSystemType: 'VibeIQ',
+        objectClass: 'AssortmentPublishedToFlexPLM',
+        outboundEvent,
+        initialEvent: {}
+      }
+    });
+  });
 });

package/src/publish/base-process-publish-assortment.ts

@@ -685,7 +685,7 @@ export class BaseProcessPublishAssortment {
   }
 
   private async sendToFlexPLM(events: SeasonalPayload[], eventType: string) {
-    const asyncEvent: AsyncEventsPayloadType = {
+    const outboundPublishEvent: AsyncEventsPayloadType = {
       taskId: this.config.taskId,
       eventType,
       objectClass: 'LCSSeason',
@@ -693,7 +693,12 @@ export class BaseProcessPublishAssortment {
     };
 
     const flexPLMConnect = new FlexPLMConnect(this.config);
-    return await flexPLMConnect.sendToFlexPLM(asyncEvent);
+    const [result] = await Promise.all([
+      flexPLMConnect.sendToFlexPLM(outboundPublishEvent),
+      this.sendPublishPayloadEvent(outboundPublishEvent)
+    ]);
+    result['outboundPublishEvent'] = outboundPublishEvent;
+    return result;
   }
 
   private async saveToLocalFile(events: SeasonalPayload[], eventType: string) {
@@ -708,17 +713,18 @@ export class BaseProcessPublishAssortment {
       const fileName = `${path.sep}${eventDirName}${path.sep}events-${dateString}.json`;
       fileHandle = await fsPromise.open('.' + fileName, 'a');
 
-      const asyncEvent: AsyncEventsPayloadType = {
+      const outboundPublishEvent: AsyncEventsPayloadType = {
         taskId: this.config.taskId,
         eventType,
         objectClass: 'LCSSeason',
         events
       };
 
-      await fileHandle.writeFile(JSON.stringify(asyncEvent));
+      await fileHandle.writeFile(JSON.stringify(outboundPublishEvent));
 
       results = {
         message: 'Successfully Saved File',
+        outboundPublishEvent,
         fileLocation: dirName + fileName
       };
     } catch (e) {
@@ -735,26 +741,53 @@ export class BaseProcessPublishAssortment {
     const fileName = 'ASYNC_PUBLISH_SEASON-events.json';
     const uploadFile = await new Files().createAndUploadFileFromBuffer(eventBuffer, 'application/json', fileName, null, this.TTL);
 
-    const asyncEvent: AsyncEventsPayloadType = {
+    const outboundPublishEvent: AsyncEventsPayloadType = {
       taskId: this.config.taskId,
       eventType,
       objectClass: 'LCSSeason',
       eventsFileId: uploadFile.id,
       eventsDownloadLink: uploadFile.downloadUrl,
       eventsAdminDownloadLink: uploadFile.adminDownloadUrl
-};
+    };
 
     if (sendMode === 'vibeiqfile') {
       const flexPLMConnect = new FlexPLMConnect(this.config);
-      return await flexPLMConnect.sendToFlexPLM(asyncEvent);
+      const [result] = await Promise.all([
+        flexPLMConnect.sendToFlexPLM(outboundPublishEvent),
+        this.sendPublishPayloadEvent(outboundPublishEvent)
+      ]);
+      return { ...result, outboundPublishEvent };
     } else {
+      await this.sendPublishPayloadEvent(outboundPublishEvent);
       return {
         message: 'Successfully Uploaded File.',
-        asyncEvent
+        outboundPublishEvent
       };
     }
   }
 
+    public async sendPublishPayloadEvent(outboundEvent: any){
+    console.info('sendPublishPayloadEvent()');
+    let initialEvent = {};
+    if(this.config?.event){
+      initialEvent = (typeof this.config?.event === 'string')
+        ? JSON.parse(this.config?.event)
+        : this.config?.event;
+    }
+    const eventBody = {
+      originSystemType: 'VibeIQ',
+      objectClass: 'AssortmentPublishedToFlexPLM',
+      outboundEvent,
+      initialEvent
+    };
+
+    await new Entities().create({
+      entityName: 'external-event',
+      object: eventBody
+    });
+  }
+
+
   private getCurrentDateString() {
     const d = new Date();
     return '' + d.getUTCFullYear()

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];
   }
 
   /**