@contrail/flexplm 1.7.4-alpha.368c8b1 → 1.7.4-alpha.57ee2a7

package/lib/interfaces/interfaces.d.ts

@@ -15,6 +15,12 @@ export interface FCConfig {
     vibeEventEndpoint: string;
     csrfEndpoint: string;
     useDistinctRestEndPointForImages?: boolean;
+    /** Opt-in. When true, an item family that itself passes meetsCriteria() is published to the
+     *  season even when every one of its options is still in a pre-development lifecycle stage. */
+    publishReleasedFamilyWithPreDevelopmentOptions?: boolean;
+    /** Only meaningful when publishReleasedFamilyWithPreDevelopmentOptions is true. When true, such a
+     *  family is republished on EVERY publish, not only when one of its options actually changed. */
+    alwaysPublishReleasedFamilyWithPreDevelopmentOptions?: boolean;
     itemPreDevelopmentLifecycleStages: string[];
     identifierAtts?: {
         [key: string]: string[];

package/lib/interfaces/item-family-changes.d.ts

@@ -12,6 +12,12 @@ export declare class ItemFamilyChanges {
     colorDeletes: string[];
     colorUpdates: string[];
     colorUnchanged: string[];
+    /** Options that changed but are still pre-development. They do NOT produce
+     *  LCSSKUSeasonLink events - they only signal that the family needs republishing. */
+    preDevelopmentOptionChanges: string[];
+    /** True when at least one option row was tracked at family level only, because the option is
+     *  pre-development while the family itself is released. */
+    hasPreDevelopmentOnlyOptions: boolean;
     assortmentItemFullChangeMap: Map<string, any>;
     assortmentItemDeleteMap: Map<string, any>;
     itemToFederatedIdMapping: Map<string, string>;

package/lib/interfaces/item-family-changes.js

@@ -14,6 +14,12 @@ class ItemFamilyChanges {
         this.colorDeletes = [];
         this.colorUpdates = [];
         this.colorUnchanged = [];
+        /** Options that changed but are still pre-development. They do NOT produce
+         *  LCSSKUSeasonLink events - they only signal that the family needs republishing. */
+        this.preDevelopmentOptionChanges = [];
+        /** True when at least one option row was tracked at family level only, because the option is
+         *  pre-development while the family itself is released. */
+        this.hasPreDevelopmentOnlyOptions = false;
         this.assortmentItemFullChangeMap = new Map();
         this.assortmentItemDeleteMap = new Map();
         this.itemToFederatedIdMapping = new Map();
@@ -32,6 +38,8 @@ class ItemFamilyChanges {
         s += ' colorDeletes: [' + this.colorDeletes + ']\n';
         s += ' colorUpdates: [' + this.colorUpdates + ']\n';
         s += ' colorUnchanged: [' + this.colorUnchanged + ']\n';
+        s += ' preDevelopmentOptionChanges: [' + this.preDevelopmentOptionChanges + ']\n';
+        s += ' hasPreDevelopmentOnlyOptions: ' + this.hasPreDevelopmentOnlyOptions + '\n';
         s += 'assortmentItemFullChangeMap:\n';
         s += 'size: ' + this.assortmentItemFullChangeMap.size + '\n[';
         for (const key of this.assortmentItemFullChangeMap.keys()) {

package/lib/publish/base-process-publish-assortment.d.ts

@@ -62,6 +62,11 @@ export declare class BaseProcessPublishAssortment {
     getFullChangeAssortmentMap(fullChange: any): Map<string, object>;
     getDeleteChangesAssortmentMap(deleteChanges: any[]): Map<string, object>;
     getReleasedForDevelopmentItemAndFamilyIds(fullChange: any, deleteChanges: any): string[];
+    /** Adds item families that pass meetsCriteria() but whose option rows are all pre-development.
+     *  Only ever ADDS family ids - never option ids, and never removes anything. */
+    protected addReleasedFamiliesOfPreDevelopmentOptions(aItems: any[], releasedForDevelopmentItemIds: string[]): void;
+    protected publishReleasedFamilyWithPreDevOptions(): boolean;
+    protected alwaysPublishReleasedFamilyWithPreDevOptions(): boolean;
     meetsCriteria(aItem: any): boolean;
     processPublish(pcd: PublishChangeData, changeDetail: any, fullChange: any, deleteChanges: any): Promise<{
         results: {

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

@@ -11,6 +11,7 @@ const fsPromise = require("fs/promises");
 const path = require("path");
 const app_framework_1 = require("@contrail/app-framework");
 const event_short_message_status_1 = require("../util/event-short-message-status");
+const config_defaults_1 = require("../util/config-defaults");
 class BaseProcessPublishAssortment {
     constructor(_config, _dc, _mapFileUtil) {
         this.TTL = 30 * 24 * 60 * 60 * 1000; // 30 days
@@ -527,9 +528,43 @@ class BaseProcessPublishAssortment {
                 }
             }
         }
+        if (this.publishReleasedFamilyWithPreDevOptions()) {
+            this.addReleasedFamiliesOfPreDevelopmentOptions(assortmentItemsArray, releasedForDevelopmentItemIds);
+            this.addReleasedFamiliesOfPreDevelopmentOptions(deleteChanges, releasedForDevelopmentItemIds);
+        }
         console.info('releasedForDevelopmentItemIds: ' + releasedForDevelopmentItemIds);
         return releasedForDevelopmentItemIds;
     }
+    /** Adds item families that pass meetsCriteria() but whose option rows are all pre-development.
+     *  Only ever ADDS family ids - never option ids, and never removes anything. */
+    addReleasedFamiliesOfPreDevelopmentOptions(aItems, releasedForDevelopmentItemIds) {
+        for (const aItem of (aItems || [])) {
+            const item = aItem?.item;
+            const itemId = item?.id;
+            const itemFamilyId = item?.itemFamilyId;
+            if (!itemFamilyId || itemId === itemFamilyId) {
+                continue;
+            }
+            if (releasedForDevelopmentItemIds.includes(itemFamilyId)) {
+                continue;
+            }
+            if (this.meetsCriteria(aItem)) {
+                continue;
+            }
+            const familyItem = item?.itemFamily;
+            if (familyItem && this.meetsCriteria({ item: familyItem })) {
+                console.info('adding released family with pre-development options: ' + itemFamilyId);
+                releasedForDevelopmentItemIds.push(itemFamilyId);
+            }
+        }
+    }
+    publishReleasedFamilyWithPreDevOptions() {
+        return config_defaults_1.ConfigDefaults.isPropertyTrue(this.config?.publishReleasedFamilyWithPreDevelopmentOptions);
+    }
+    alwaysPublishReleasedFamilyWithPreDevOptions() {
+        return this.publishReleasedFamilyWithPreDevOptions()
+            && config_defaults_1.ConfigDefaults.isPropertyTrue(this.config?.alwaysPublishReleasedFamilyWithPreDevelopmentOptions);
+    }
     meetsCriteria(aItem) {
         const item = aItem?.item;
         const lifecycleStage = item?.lifecycleStage;
@@ -730,7 +765,12 @@ class BaseProcessPublishAssortment {
         for (const [itemId, aItem] of assortmentItemFullChangeMap) {
             const projectItem = aItem?.projectItem;
             const itemFamilyId = aItem?.item?.itemFamilyId;
-            if (!pcd.releasedForDevelopmentItemIds.includes(itemFamilyId) || !pcd.releasedForDevelopmentItemIds.includes(itemId)) {
+            const familyInScope = pcd.releasedForDevelopmentItemIds.includes(itemFamilyId);
+            const itemInScope = pcd.releasedForDevelopmentItemIds.includes(itemId);
+            // Released family + pre-development option: track at family level only (no SKU events).
+            const familyOnly = !itemInScope && familyInScope && itemId !== itemFamilyId
+                && this.publishReleasedFamilyWithPreDevOptions();
+            if (!familyInScope || (!itemInScope && !familyOnly)) {
                 continue;
             }
             const ifc = itemFamilyChanges.get(itemFamilyId) || new item_family_changes_1.ItemFamilyChanges(itemFamilyId, pcd.sinceDate);
@@ -738,10 +778,29 @@ class BaseProcessPublishAssortment {
                 ifc.itemFamilyObject = itemId === itemFamilyId ? aItem?.item : aItem?.item?.itemFamily;
                 itemFamilyChanges.set(itemFamilyId, ifc);
             }
+            else if (itemId === itemFamilyId && this.publishReleasedFamilyWithPreDevOptions()) {
+                // A pre-development option row may have created this bucket with the partial
+                // item.itemFamily; the family's own row carries the full item, so prefer it.
+                ifc.itemFamilyObject = aItem?.item;
+            }
             ifc.assortmentItemFullChangeMap.set(itemId, aItem);
             if (pcd.itemToFederatedIdMapping.has(itemId)) {
                 ifc.itemToFederatedIdMapping.set(itemId, pcd.itemToFederatedIdMapping.get(itemId));
             }
+            if (familyOnly) {
+                ifc.hasPreDevelopmentOnlyOptions = true;
+                if (addIds.includes(itemId) || deleteIds.includes(itemId) || updateIds.includes(itemId)
+                    || (projectItem && new Date(projectItem.updatedOn) > pcd.sinceDate)) {
+                    ifc.preDevelopmentOptionChanges.push(itemId);
+                }
+                else {
+                    ifc.colorUnchanged.push(itemId);
+                }
+                if (projectItem && !projectItem?.roles && aItem?.item?.roles) {
+                    projectItem.roles = aItem?.item?.roles;
+                }
+                continue;
+            }
             if (itemId === itemFamilyId) {
                 if (addIds.includes(itemId))
                     ifc.familyAdd = true;
@@ -780,7 +839,11 @@ class BaseProcessPublishAssortment {
         for (const [itemId, delEntity] of assortmentItemDeleteMap) {
             const itemFamilyId = delEntity?.item?.itemFamilyId;
             const item = delEntity?.item;
-            if (!pcd.releasedForDevelopmentItemIds.includes(itemFamilyId) || !pcd.releasedForDevelopmentItemIds.includes(itemId)) {
+            const familyInScope = pcd.releasedForDevelopmentItemIds.includes(itemFamilyId);
+            const itemInScope = pcd.releasedForDevelopmentItemIds.includes(itemId);
+            const familyOnly = !itemInScope && familyInScope && itemId !== itemFamilyId
+                && this.publishReleasedFamilyWithPreDevOptions();
+            if (!familyInScope || (!itemInScope && !familyOnly)) {
                 continue;
             }
             else {
@@ -810,6 +873,10 @@ class BaseProcessPublishAssortment {
             if (itemId === itemFamilyId) {
                 ifc.familyDelete = true;
             }
+            else if (familyOnly) {
+                ifc.hasPreDevelopmentOnlyOptions = true;
+                ifc.preDevelopmentOptionChanges.push(itemId);
+            }
             else {
                 ifc.colorDeletes.push(itemId);
             }
@@ -857,6 +924,8 @@ class BaseProcessPublishAssortment {
         const projectItem = this.getProjectItem(itemFamilyChanges, itemFamilyChanges.itemFamilyId);
         const familyAssortmentItem = itemFamilyChanges.familyAdd || itemFamilyChanges.familyUpdate || itemFamilyChanges.familyDelete
             || itemFamilyChanges.colorAdds.length > 0 || itemFamilyChanges.colorUpdates.length > 0 || itemFamilyChanges.colorDeletes.length > 0
+            || itemFamilyChanges.preDevelopmentOptionChanges.length > 0
+            || (this.alwaysPublishReleasedFamilyWithPreDevOptions() && itemFamilyChanges.hasPreDevelopmentOnlyOptions)
             || (projectItem && this.updatedSinceDate(projectItem, itemFamilyChanges.sinceDate));
         //familyItemRemoved is used when adding the first option to an assortment
         //and will have updates for the family item.

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

@@ -1874,3 +1874,259 @@ describe('sendToFlexPLM / handleVibeIQFile / sendPublishPayloadEvent', () => {
         });
     });
 });
+describe('publishReleasedFamilyWithPreDevelopmentOptions', () => {
+    const FAMILY_ID = 'AERfdvdAt1HHEVvQ';
+    const LIME_ID = 'limeGreenItemId__';
+    const MAROON_ID = 'maroonItemId_____';
+    const SINCE = new Date('2026-09-03T16:54:20.778Z');
+    const BEFORE_SINCE = '2026-09-01T00:00:00.000Z';
+    const AFTER_SINCE = '2026-09-03T17:00:00.000Z';
+    /** The full family item, as it appears on the family's own assortment row. */
+    const fullFamilyItem = {
+        id: FAMILY_ID, itemFamilyId: FAMILY_ID, name: 'Sweatpant', itemNumber: 11,
+        lifecycleStage: 'released', roles: ['family'], richFamilyOnlyField: 'PRESENT'
+    };
+    /** The partial family item, as hydrated onto an option row. */
+    const partialFamilyItem = {
+        id: FAMILY_ID, itemFamilyId: FAMILY_ID, name: 'Sweatpant', itemNumber: 11,
+        lifecycleStage: 'released', roles: ['family']
+    };
+    const familyRow = () => ({
+        entityType: 'assortment-item',
+        id: 'ai-' + FAMILY_ID,
+        itemId: FAMILY_ID,
+        item: { ...fullFamilyItem },
+        projectItem: { id: 'proj:' + FAMILY_ID, itemId: FAMILY_ID, updatedOn: BEFORE_SINCE, roles: ['family'] }
+    });
+    const optionRow = (itemId, optionName, projectItemUpdatedOn) => ({
+        entityType: 'assortment-item',
+        id: 'ai-' + itemId,
+        itemId,
+        item: {
+            id: itemId, itemFamilyId: FAMILY_ID, name: 'Sweatpant', optionName,
+            optionGroup: 'color', lifecycleStage: 'concept', roles: ['color', 'option'],
+            itemFamily: { ...partialFamilyItem }
+        },
+        projectItem: { id: 'proj:' + itemId, itemId, updatedOn: projectItemUpdatedOn, roles: ['color', 'option'] },
+        familyProjectItem: { id: 'proj:' + FAMILY_ID, itemId: FAMILY_ID, updatedOn: BEFORE_SINCE, roles: ['family'] }
+    });
+    const emptyDetail = { adds: [], deletes: [], updates: [], familyItemsRemoved: [] };
+    const baseConfig = { identifierAtts: { LCSProduct: ['itemNumber'] }, itemPreDevelopmentLifecycleStages: ['concept'] };
+    const makePpa2 = (flagOn, alwaysOn) => {
+        const cfg = {
+            ...baseConfig,
+            publishReleasedFamilyWithPreDevelopmentOptions: flagOn,
+            alwaysPublishReleasedFamilyWithPreDevelopmentOptions: alwaysOn
+        };
+        const mfu = new transform_data_1.MapFileUtil(new sdk_1.Entities());
+        return new base_process_publish_assortment_1.BaseProcessPublishAssortment(cfg, new data_converter_1.DataConverter(cfg, mfu), mfu);
+    };
+    const makePpa = (flagOn) => makePpa2(flagOn, false);
+    const makePcd = (releasedIds) => {
+        const sf = { entityReference: 'assortment:11EZML5dMn3tREuT', objectClass: 'LCSSeason' };
+        const pcd = new publish_change_data_1.PublishChangeData('11EZML5dMn3tREuT', sf, 'apc1', SINCE);
+        pcd.itemToFederatedIdMapping = new Map();
+        pcd.releasedForDevelopmentItemIds = releasedIds;
+        return pcd;
+    };
+    const eventSeasonFed = { entityReference: 'assortment:a1', objectClass: 'LCSSeason' };
+    const stubEventDeps = (ppa) => {
+        jest.spyOn(ppa, 'getAssortment').mockResolvedValue({ id: 'a1', publishToFlexPLM: true });
+        jest.spyOn(ppa, 'getSeasonalData').mockResolvedValue({});
+        jest.spyOn(map_utils_1.MapUtil, 'applyTransformMap').mockImplementation(async (...args) => args[2]);
+        jest.spyOn(type_conversion_utils_1.TypeConversionUtils, 'getIdentifierProperties').mockResolvedValue(['itemNumber']);
+        jest.spyOn(type_conversion_utils_1.TypeConversionUtils, 'getInformationalProperties').mockResolvedValue([]);
+        jest.spyOn(type_conversion_utils_1.TypeConversionUtils, 'isOutboundCreatableFromEntity').mockResolvedValue(true);
+    };
+    afterEach(() => { jest.restoreAllMocks(); });
+    /////////////////////////////////////////////////////////////////////////////
+    // getReleasedForDevelopmentItemAndFamilyIds
+    /////////////////////////////////////////////////////////////////////////////
+    it('REGRESSION: flag off - released family with all-concept options stays out of scope', () => {
+        const fullChange = { assortmentItems: [optionRow(LIME_ID, 'Lime Green', BEFORE_SINCE),
+                optionRow(MAROON_ID, 'Maroon', BEFORE_SINCE)] };
+        expect(makePpa(false).getReleasedForDevelopmentItemAndFamilyIds(fullChange, [])).toEqual([]);
+    });
+    it('flag on - released family enters scope; concept options do NOT', () => {
+        const fullChange = { assortmentItems: [optionRow(LIME_ID, 'Lime Green', BEFORE_SINCE),
+                optionRow(MAROON_ID, 'Maroon', BEFORE_SINCE)] };
+        expect(makePpa(true).getReleasedForDevelopmentItemAndFamilyIds(fullChange, [])).toEqual([FAMILY_ID]);
+    });
+    it('flag on - concept family with concept options still stays out of scope', () => {
+        const row = optionRow(LIME_ID, 'Lime Green', BEFORE_SINCE);
+        row.item.itemFamily = { ...partialFamilyItem, lifecycleStage: 'concept' };
+        expect(makePpa(true).getReleasedForDevelopmentItemAndFamilyIds({ assortmentItems: [row] }, [])).toEqual([]);
+    });
+    it('flag on - family reached only through a delete record', () => {
+        const deleted = optionRow(MAROON_ID, 'Maroon', BEFORE_SINCE);
+        expect(makePpa(true).getReleasedForDevelopmentItemAndFamilyIds({ assortmentItems: [] }, [deleted]))
+            .toEqual([FAMILY_ID]);
+    });
+    it('flag on - two concept options of the same family add the family only once', () => {
+        const fullChange = { assortmentItems: [optionRow(LIME_ID, 'Lime Green', BEFORE_SINCE),
+                optionRow(MAROON_ID, 'Maroon', BEFORE_SINCE)] };
+        expect(makePpa(true).getReleasedForDevelopmentItemAndFamilyIds(fullChange, [])).toHaveLength(1);
+    });
+    it('flag on - option row with no hydrated itemFamily is skipped without throwing', () => {
+        const bare = optionRow(LIME_ID, 'Lime Green', BEFORE_SINCE);
+        delete bare.item.itemFamily;
+        expect(makePpa(true).getReleasedForDevelopmentItemAndFamilyIds({ assortmentItems: [bare] }, [])).toEqual([]);
+    });
+    it('released family WITH its own assortment row is in scope with or without the flag', () => {
+        const rows = { assortmentItems: [familyRow(), optionRow(LIME_ID, 'Lime Green', BEFORE_SINCE)] };
+        expect(makePpa(false).getReleasedForDevelopmentItemAndFamilyIds(rows, [])).toEqual([FAMILY_ID]);
+        expect(makePpa(true).getReleasedForDevelopmentItemAndFamilyIds(rows, [])).toEqual([FAMILY_ID]);
+    });
+    it('string flag values from app config are honoured', () => {
+        const fullChange = { assortmentItems: [optionRow(LIME_ID, 'Lime Green', BEFORE_SINCE)] };
+        expect(makePpa('true').getReleasedForDevelopmentItemAndFamilyIds(fullChange, [])).toEqual([FAMILY_ID]);
+        expect(makePpa('false').getReleasedForDevelopmentItemAndFamilyIds(fullChange, [])).toEqual([]);
+    });
+    /////////////////////////////////////////////////////////////////////////////
+    // getItemFamilyChanges
+    /////////////////////////////////////////////////////////////////////////////
+    it('ACTION 2: deleting a concept option marks the released family for republish', () => {
+        const ppa = makePpa(true);
+        const remaining = optionRow(LIME_ID, 'Lime Green', BEFORE_SINCE);
+        const deleted = optionRow(MAROON_ID, 'Maroon', BEFORE_SINCE);
+        const pcd = makePcd([FAMILY_ID]);
+        pcd.itemFamilyChanges = ppa.getItemFamilyChanges(pcd, emptyDetail, ppa.getFullChangeAssortmentMap({ assortmentItems: [remaining] }), ppa.getDeleteChangesAssortmentMap([deleted]));
+        expect(pcd.itemFamilyChanges.size).toEqual(1);
+        const ifc = pcd.itemFamilyChanges.get(FAMILY_ID);
+        expect(ifc.preDevelopmentOptionChanges).toEqual([MAROON_ID]);
+        expect(ifc.hasPreDevelopmentOnlyOptions).toBe(true);
+        expect(ifc.colorDeletes).toEqual([]);
+        expect(ifc.colorAdds).toEqual([]);
+        expect(ifc.itemFamilyObject.id).toEqual(FAMILY_ID);
+    });
+    it('adding a concept option marks the family, not a colorAdd', () => {
+        const ppa = makePpa(true);
+        const added = optionRow(MAROON_ID, 'Maroon', BEFORE_SINCE);
+        const pcd = makePcd([FAMILY_ID]);
+        pcd.itemFamilyChanges = ppa.getItemFamilyChanges(pcd, { ...emptyDetail, adds: [{ id: MAROON_ID }] }, ppa.getFullChangeAssortmentMap({ assortmentItems: [added] }), new Map());
+        const ifc = pcd.itemFamilyChanges.get(FAMILY_ID);
+        expect(ifc.preDevelopmentOptionChanges).toEqual([MAROON_ID]);
+        expect(ifc.colorAdds).toEqual([]);
+    });
+    it('ACTION 1: nothing changed - family bucket exists but signals no change', () => {
+        const ppa = makePpa(true);
+        const pcd = makePcd([FAMILY_ID]);
+        const rows = { assortmentItems: [optionRow(LIME_ID, 'Lime Green', BEFORE_SINCE),
+                optionRow(MAROON_ID, 'Maroon', BEFORE_SINCE)] };
+        pcd.itemFamilyChanges = ppa.getItemFamilyChanges(pcd, emptyDetail, ppa.getFullChangeAssortmentMap(rows), new Map());
+        const ifc = pcd.itemFamilyChanges.get(FAMILY_ID);
+        expect(ifc.preDevelopmentOptionChanges).toEqual([]);
+        expect(ifc.colorUnchanged.sort()).toEqual([LIME_ID, MAROON_ID].sort());
+    });
+    it('REGRESSION: flag off - concept option rows produce no ItemFamilyChanges at all', () => {
+        const ppa = makePpa(false);
+        const pcd = makePcd([FAMILY_ID]);
+        pcd.itemFamilyChanges = ppa.getItemFamilyChanges(pcd, emptyDetail, ppa.getFullChangeAssortmentMap({ assortmentItems: [optionRow(LIME_ID, 'Lime Green', AFTER_SINCE)] }), new Map());
+        expect(pcd.itemFamilyChanges.size).toEqual(0);
+    });
+    it('REGRESSION: a released option is still a colorAdd, never a preDevelopmentOptionChange', () => {
+        const ppa = makePpa(true);
+        const released = optionRow(LIME_ID, 'Lime Green', BEFORE_SINCE);
+        released.item.lifecycleStage = 'development';
+        const pcd = makePcd([FAMILY_ID, LIME_ID]);
+        pcd.itemFamilyChanges = ppa.getItemFamilyChanges(pcd, { ...emptyDetail, adds: [{ id: LIME_ID }] }, ppa.getFullChangeAssortmentMap({ assortmentItems: [released] }), new Map());
+        const ifc = pcd.itemFamilyChanges.get(FAMILY_ID);
+        expect(ifc.colorAdds).toEqual([LIME_ID]);
+        expect(ifc.preDevelopmentOptionChanges).toEqual([]);
+        expect(ifc.hasPreDevelopmentOnlyOptions).toBe(false);
+    });
+    it('itemFamilyObject prefers the full family item when the OPTION row is iterated first', () => {
+        const ppa = makePpa(true);
+        const pcd = makePcd([FAMILY_ID]);
+        const map = new Map();
+        map.set(LIME_ID, optionRow(LIME_ID, 'Lime Green', BEFORE_SINCE));
+        map.set(FAMILY_ID, familyRow());
+        pcd.itemFamilyChanges = ppa.getItemFamilyChanges(pcd, emptyDetail, map, new Map());
+        const ifc = pcd.itemFamilyChanges.get(FAMILY_ID);
+        expect(ifc.itemFamilyObject.richFamilyOnlyField).toEqual('PRESENT');
+    });
+    it('itemFamilyObject is the full family item when the FAMILY row is iterated first', () => {
+        const ppa = makePpa(true);
+        const pcd = makePcd([FAMILY_ID]);
+        const map = new Map();
+        map.set(FAMILY_ID, familyRow());
+        map.set(LIME_ID, optionRow(LIME_ID, 'Lime Green', BEFORE_SINCE));
+        pcd.itemFamilyChanges = ppa.getItemFamilyChanges(pcd, emptyDetail, map, new Map());
+        const ifc = pcd.itemFamilyChanges.get(FAMILY_ID);
+        expect(ifc.itemFamilyObject.richFamilyOnlyField).toEqual('PRESENT');
+    });
+    it('delete record with a missing item entity is skipped safely', () => {
+        const ppa = makePpa(true);
+        const pcd = makePcd([FAMILY_ID]);
+        const delMap = new Map();
+        delMap.set('GHOST', { itemId: 'GHOST', item: undefined });
+        pcd.itemFamilyChanges = ppa.getItemFamilyChanges(pcd, emptyDetail, new Map(), delMap);
+        expect(pcd.itemFamilyChanges.size).toEqual(0);
+    });
+    /////////////////////////////////////////////////////////////////////////////
+    // getEventsForItemFamilyChanges
+    /////////////////////////////////////////////////////////////////////////////
+    it('emits exactly one LCSProductSeasonLink and zero LCSSKUSeasonLink', async () => {
+        const ppa = makePpa(true);
+        const ifc = new item_family_changes_1.ItemFamilyChanges(FAMILY_ID, SINCE);
+        ifc.itemFamilyObject = fullFamilyItem;
+        ifc.hasPreDevelopmentOnlyOptions = true;
+        ifc.preDevelopmentOptionChanges.push(MAROON_ID);
+        ifc.assortmentItemFullChangeMap.set(LIME_ID, optionRow(LIME_ID, 'Lime Green', BEFORE_SINCE));
+        stubEventDeps(ppa);
+        const events = await ppa.getEventsForItemFamilyChanges(ifc, 'a1', eventSeasonFed, new Map());
+        expect(events).toHaveLength(1);
+        expect(events[0].objectClass).toBe('LCSProductSeasonLink');
+        expect(events[0].eventType).toBe('UPSERT_ON_SEASON');
+        expect(events[0].entityReference).toBe('item:' + FAMILY_ID);
+        expect(events[0].LCSProduct['itemNumber']).toBe(11);
+    });
+    it('REGRESSION: an ItemFamilyChanges with no changes still emits nothing', async () => {
+        const ppa = makePpa(true);
+        const ifc = new item_family_changes_1.ItemFamilyChanges(FAMILY_ID, SINCE);
+        ifc.itemFamilyObject = fullFamilyItem;
+        ifc.colorUnchanged.push(LIME_ID, MAROON_ID);
+        ifc.assortmentItemFullChangeMap.set(LIME_ID, optionRow(LIME_ID, 'Lime Green', BEFORE_SINCE));
+        stubEventDeps(ppa);
+        expect(await ppa.getEventsForItemFamilyChanges(ifc, 'a1', eventSeasonFed, new Map())).toHaveLength(0);
+    });
+    /////////////////////////////////////////////////////////////////////////////
+    // alwaysPublishReleasedFamilyWithPreDevelopmentOptions
+    /////////////////////////////////////////////////////////////////////////////
+    const unchangedFamilyIfc = () => {
+        const ifc = new item_family_changes_1.ItemFamilyChanges(FAMILY_ID, SINCE);
+        ifc.itemFamilyObject = fullFamilyItem;
+        ifc.hasPreDevelopmentOnlyOptions = true;
+        ifc.colorUnchanged.push(LIME_ID, MAROON_ID);
+        ifc.assortmentItemFullChangeMap.set(LIME_ID, optionRow(LIME_ID, 'Lime Green', BEFORE_SINCE));
+        return ifc;
+    };
+    it('ACTION 1 with always-flag: unchanged family still emits one LCSProductSeasonLink', async () => {
+        const ppa = makePpa2(true, true);
+        stubEventDeps(ppa);
+        const events = await ppa.getEventsForItemFamilyChanges(unchangedFamilyIfc(), 'a1', eventSeasonFed, new Map());
+        expect(events).toHaveLength(1);
+        expect(events[0].objectClass).toBe('LCSProductSeasonLink');
+    });
+    it('always-flag off: unchanged family emits nothing', async () => {
+        const ppa = makePpa2(true, false);
+        stubEventDeps(ppa);
+        expect(await ppa.getEventsForItemFamilyChanges(unchangedFamilyIfc(), 'a1', eventSeasonFed, new Map()))
+            .toHaveLength(0);
+    });
+    it('always-flag cannot act alone when the primary flag is off', async () => {
+        const ppa = makePpa2(false, true);
+        stubEventDeps(ppa);
+        expect(await ppa.getEventsForItemFamilyChanges(unchangedFamilyIfc(), 'a1', eventSeasonFed, new Map()))
+            .toHaveLength(0);
+    });
+    it('REGRESSION: always-flag does not republish an ordinary unchanged released family', async () => {
+        const ppa = makePpa2(true, true);
+        stubEventDeps(ppa);
+        const ifc = new item_family_changes_1.ItemFamilyChanges(FAMILY_ID, SINCE);
+        ifc.itemFamilyObject = fullFamilyItem;
+        ifc.colorUnchanged.push(LIME_ID);
+        ifc.assortmentItemFullChangeMap.set(LIME_ID, optionRow(LIME_ID, 'Lime Green', BEFORE_SINCE));
+        expect(await ppa.getEventsForItemFamilyChanges(ifc, 'a1', eventSeasonFed, new Map())).toHaveLength(0);
+    });
+});

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

@@ -20,6 +20,8 @@ export declare class ConfigDefaults {
             processAsItem: boolean;
         };
         useDistinctRestEndPointForImages: boolean;
+        publishReleasedFamilyWithPreDevelopmentOptions: boolean;
+        alwaysPublishReleasedFamilyWithPreDevelopmentOptions: boolean;
         csrfEndpoint: string;
         vibeEventEndpoint: string;
         payloadDefaultAsArray: boolean;

package/lib/util/config-defaults.js

@@ -67,6 +67,8 @@ class ConfigDefaults {
                 processAsItem: false,
             },
             useDistinctRestEndPointForImages: false,
+            publishReleasedFamilyWithPreDevelopmentOptions: false,
+            alwaysPublishReleasedFamilyWithPreDevelopmentOptions: false,
             csrfEndpoint: '/servlet/rest/security/csrf',
             vibeEventEndpoint: '/rfa/vibeiq/vibeEvents',
             payloadDefaultAsArray: true,

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

@@ -393,3 +393,50 @@ describe('all tests', () => {
         });
     });
 });
+describe('publishReleasedFamilyWithPreDevelopmentOptions config', () => {
+    const config = {
+        apiHost: 'http://test.com',
+        userName: 'vibeiq',
+        password: 'vibeiq',
+        plmEnviornment: 'SB'
+    };
+    it('publishReleasedFamilyWithPreDevelopmentOptions-get default', async () => {
+        const startConfig = Object.assign({}, config);
+        const fcConfig = await config_defaults_1.ConfigDefaults.setConfigDefaults(startConfig);
+        expect(fcConfig['publishReleasedFamilyWithPreDevelopmentOptions']).toBe(false);
+    });
+    it('alwaysPublishReleasedFamilyWithPreDevelopmentOptions-get default', async () => {
+        const startConfig = Object.assign({}, config);
+        const fcConfig = await config_defaults_1.ConfigDefaults.setConfigDefaults(startConfig);
+        expect(fcConfig['alwaysPublishReleasedFamilyWithPreDevelopmentOptions']).toBe(false);
+    });
+    it('publishReleasedFamilyWithPreDevelopmentOptions-set boolean true', async () => {
+        const startConfig = Object.assign({}, config);
+        startConfig['publishReleasedFamilyWithPreDevelopmentOptions'] = true;
+        const fcConfig = await config_defaults_1.ConfigDefaults.setConfigDefaults(startConfig);
+        expect(config_defaults_1.ConfigDefaults.isPropertyTrue(fcConfig['publishReleasedFamilyWithPreDevelopmentOptions'])).toBe(true);
+    });
+    it('publishReleasedFamilyWithPreDevelopmentOptions-set string true from app config', async () => {
+        const startConfig = Object.assign({}, config);
+        startConfig['publishReleasedFamilyWithPreDevelopmentOptions'] = 'true';
+        const fcConfig = await config_defaults_1.ConfigDefaults.setConfigDefaults(startConfig);
+        expect(config_defaults_1.ConfigDefaults.isPropertyTrue(fcConfig['publishReleasedFamilyWithPreDevelopmentOptions'])).toBe(true);
+    });
+    it('publishReleasedFamilyWithPreDevelopmentOptions-string false stays off', async () => {
+        const startConfig = Object.assign({}, config);
+        startConfig['publishReleasedFamilyWithPreDevelopmentOptions'] = 'false';
+        const fcConfig = await config_defaults_1.ConfigDefaults.setConfigDefaults(startConfig);
+        expect(config_defaults_1.ConfigDefaults.isPropertyTrue(fcConfig['publishReleasedFamilyWithPreDevelopmentOptions'])).toBe(false);
+    });
+    it('both flags can be delivered through complexConfig', async () => {
+        const startConfig = Object.assign({}, config, {
+            complexConfig: {
+                publishReleasedFamilyWithPreDevelopmentOptions: true,
+                alwaysPublishReleasedFamilyWithPreDevelopmentOptions: 'true'
+            }
+        });
+        const fcConfig = await config_defaults_1.ConfigDefaults.setConfigDefaults(startConfig);
+        expect(config_defaults_1.ConfigDefaults.isPropertyTrue(fcConfig['publishReleasedFamilyWithPreDevelopmentOptions'])).toBe(true);
+        expect(config_defaults_1.ConfigDefaults.isPropertyTrue(fcConfig['alwaysPublishReleasedFamilyWithPreDevelopmentOptions'])).toBe(true);
+    });
+});

package/package.json

@@ -1,12 +1,11 @@
 {
   "name": "@contrail/flexplm",
-  "version": "1.7.4-alpha.368c8b1",
+  "version": "1.7.4-alpha.57ee2a7",
   "description": "Library used for integration with flexplm.",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
   "bin": {
-    "flexplm-mapping": "lib/cli/index.js",
-    "flexplm-config": "lib/cli/config-index.js"
+    "flexplm-mapping": "lib/cli/index.js"
   },
   "files": [
     "lib/**/*",

package/scripts/copy-template.js

@@ -2,13 +2,9 @@
 const fs = require('fs');
 const path = require('path');
 
-const TEMPLATES = ['mapping-template.ts.template', 'config-template.json.template'];
+const SRC = path.join('src', 'cli', 'template', 'mapping-template.ts.template');
+const DST = path.join('lib', 'cli', 'template', 'mapping-template.ts.template');
 
-for (const templateFilename of TEMPLATES) {
-  const SRC = path.join('src', 'cli', 'template', templateFilename);
-  const DST = path.join('lib', 'cli', 'template', templateFilename);
-
-  fs.mkdirSync(path.dirname(DST), { recursive: true });
-  fs.copyFileSync(SRC, DST);
-  console.log(`Copied ${SRC} -> ${DST}`);
-}
+fs.mkdirSync(path.dirname(DST), { recursive: true });
+fs.copyFileSync(SRC, DST);
+console.log(`Copied ${SRC} -> ${DST}`);

package/lib/cli/commands/config-create.d.ts

@@ -1,5 +0,0 @@
-export declare class ConfigCreateCommand {
-    private prompt;
-    private findTemplate;
-    run(): Promise<void>;
-}

package/lib/cli/commands/config-create.js

@@ -1,85 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ConfigCreateCommand = void 0;
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
-const readline = __importStar(require("readline"));
-const TEMPLATE_FILENAME = 'config-template.json.template';
-const ORG_PLACEHOLDER = '<ORG_NAME>';
-const APP_IDENTIFIER_PLACEHOLDER = '<APP_IDENTIFIER>';
-const DEFAULT_APP_IDENTIFIER = '@vibeiq/flexplm-connector';
-class ConfigCreateCommand {
-    prompt(rl, question) {
-        return new Promise((resolve) => {
-            rl.question(question, (answer) => resolve(answer));
-        });
-    }
-    findTemplate() {
-        const candidates = [
-            path.join(__dirname, '..', 'template', TEMPLATE_FILENAME),
-            path.join(__dirname, '..', '..', '..', 'src', 'cli', 'template', TEMPLATE_FILENAME),
-        ];
-        for (const candidate of candidates) {
-            if (fs.existsSync(candidate)) {
-                return candidate;
-            }
-        }
-        throw new Error(`Could not locate ${TEMPLATE_FILENAME}. Tried:\n  ${candidates.join('\n  ')}`);
-    }
-    async run() {
-        const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-        const onSigint = () => {
-            rl.close();
-            process.stdout.write('\n');
-            process.exit(130);
-        };
-        process.once('SIGINT', onSigint);
-        let orgName;
-        let appIdentifier;
-        try {
-            orgName = (await this.prompt(rl, 'orgName: ')).trim();
-            appIdentifier = (await this.prompt(rl, `appIdentifier (default: ${DEFAULT_APP_IDENTIFIER}): `)).trim() || DEFAULT_APP_IDENTIFIER;
-        }
-        finally {
-            process.removeListener('SIGINT', onSigint);
-            rl.close();
-        }
-        if (!orgName) {
-            throw new Error('orgName is required');
-        }
-        const templatePath = this.findTemplate();
-        const templateBody = fs.readFileSync(templatePath, 'utf8');
-        const rendered = templateBody.split(ORG_PLACEHOLDER).join(orgName).split(APP_IDENTIFIER_PLACEHOLDER).join(appIdentifier);
-        const outPath = path.resolve(process.cwd(), `${orgName}-flexplmConfig.json`);
-        if (fs.existsSync(outPath)) {
-            throw new Error(`Refusing to overwrite existing file: ${outPath}`);
-        }
-        fs.writeFileSync(outPath, rendered, 'utf8');
-        console.log(`Created ${outPath}`);
-        console.log('"orgName" and "appIdentifier" are pre-filled, but this file is not complete yet: FlexPLM connectivity also requires apiHost, userName, and password. See the "_availableAttributes" block in the file for these and other attributes this org can set (identifierAtts, LCSMaterial, etc.) — add the ones you need as real top-level keys, then delete "_availableAttributes"; the connector ignores it and applies defaults at runtime for anything you omit.');
-    }
-}
-exports.ConfigCreateCommand = ConfigCreateCommand;

package/lib/cli/commands/config-create.spec.d.ts

@@ -1 +0,0 @@
-export {};

package/lib/cli/commands/config-create.spec.js

@@ -1,80 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const fs = __importStar(require("fs"));
-const os = __importStar(require("os"));
-const path = __importStar(require("path"));
-let answers = [];
-jest.mock('readline', () => ({
-    createInterface: () => ({
-        question: (_q, cb) => cb(answers.shift() || ''),
-        close: () => { },
-    }),
-}));
-const config_create_1 = require("./config-create");
-describe('ConfigCreateCommand', () => {
-    let tempDir;
-    let originalCwd;
-    let logSpy;
-    beforeEach(() => {
-        originalCwd = process.cwd();
-        tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'flexplm-config-create-'));
-        process.chdir(tempDir);
-        logSpy = jest.spyOn(console, 'log').mockImplementation(() => { });
-        answers = [];
-    });
-    afterEach(() => {
-        logSpy.mockRestore();
-        process.chdir(originalCwd);
-        fs.rmSync(tempDir, { recursive: true, force: true });
-    });
-    it('writes <orgName>-flexplmConfig.json with orgName and appIdentifier filled in', async () => {
-        answers = ['acme', '@vibeiq/flexplm-connector'];
-        await new config_create_1.ConfigCreateCommand().run();
-        const outPath = path.join(tempDir, 'acme-flexplmConfig.json');
-        expect(fs.existsSync(outPath)).toBe(true);
-        const config = JSON.parse(fs.readFileSync(outPath, 'utf8'));
-        expect(config.orgName).toEqual('acme');
-        expect(config.appIdentifier).toEqual('@vibeiq/flexplm-connector');
-    });
-    it('defaults appIdentifier to @vibeiq/flexplm-connector when left blank', async () => {
-        answers = ['acme', ''];
-        await new config_create_1.ConfigCreateCommand().run();
-        const outPath = path.join(tempDir, 'acme-flexplmConfig.json');
-        const config = JSON.parse(fs.readFileSync(outPath, 'utf8'));
-        expect(config.appIdentifier).toEqual('@vibeiq/flexplm-connector');
-    });
-    it('throws when orgName is empty', async () => {
-        answers = ['   '];
-        await expect(new config_create_1.ConfigCreateCommand().run()).rejects.toThrow(/orgName is required/);
-    });
-    it('refuses to overwrite an existing file', async () => {
-        const existing = path.join(tempDir, 'acme-flexplmConfig.json');
-        fs.writeFileSync(existing, 'do not clobber', 'utf8');
-        answers = ['acme', '@vibeiq/flexplm-connector'];
-        await expect(new config_create_1.ConfigCreateCommand().run()).rejects.toThrow(/Refusing to overwrite/);
-        expect(fs.readFileSync(existing, 'utf8')).toEqual('do not clobber');
-    });
-});

package/lib/cli/commands/config-upload.d.ts

@@ -1,19 +0,0 @@
-interface ConfigUploadOptions {
-    filePath: string;
-    message?: string;
-    branch?: string;
-    skipGit: boolean;
-    updateConfig: boolean;
-}
-export declare class ConfigUploadCommand {
-    static parseArgs(args: string[]): ConfigUploadOptions;
-    static buildCommitMessage(userMessage: string, fileId: string): string;
-    private prompt;
-    private promptHidden;
-    private runGit;
-    private tryRunGit;
-    private commitToGit;
-    run(args: string[]): Promise<void>;
-    private setConfigFileOnAppOrg;
-}
-export {};

package/lib/cli/commands/config-upload.js

@@ -1,249 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ConfigUploadCommand = void 0;
-const child_process_1 = require("child_process");
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
-const readline = __importStar(require("readline"));
-const sdk_1 = require("@contrail/sdk");
-class ConfigUploadCommand {
-    static parseArgs(args) {
-        let filePath;
-        let message;
-        let branch;
-        let skipGit = false;
-        let updateConfig = false;
-        for (let i = 0; i < args.length; i++) {
-            const a = args[i];
-            if (a === '-m') {
-                message = args[++i];
-                if (message === undefined) {
-                    throw new Error('-m requires a commit message argument');
-                }
-            }
-            else if (a === '-b') {
-                branch = args[++i];
-                if (branch === undefined) {
-                    throw new Error('-b requires a branch name argument');
-                }
-            }
-            else if (a === '--skip-git' || a === '--skipGit') {
-                skipGit = true;
-            }
-            else if (a === '--update-config') {
-                updateConfig = true;
-            }
-            else if (a.startsWith('-')) {
-                throw new Error(`Unknown option: ${a}`);
-            }
-            else if (!filePath) {
-                filePath = a;
-            }
-            else {
-                throw new Error(`Unexpected argument: ${a}`);
-            }
-        }
-        if (!filePath) {
-            throw new Error('upload: missing <path.json> argument');
-        }
-        return { filePath, message, branch, skipGit, updateConfig };
-    }
-    static buildCommitMessage(userMessage, fileId) {
-        const lines = userMessage.split(/\r?\n/);
-        lines[0] = `${lines[0]} [fileId: ${fileId}]`;
-        return lines.join('\n');
-    }
-    prompt(question) {
-        const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-        return new Promise((resolve) => {
-            rl.question(question, (answer) => {
-                rl.close();
-                resolve(answer.trim());
-            });
-        });
-    }
-    promptHidden(question) {
-        return new Promise((resolve) => {
-            const rl = readline.createInterface({ input: process.stdin, output: process.stdout, terminal: true });
-            const rlAny = rl;
-            rlAny._writeToOutput = (str) => {
-                if (str.includes(question)) {
-                    rlAny.output.write(str);
-                }
-            };
-            rl.question(question, (answer) => {
-                rl.close();
-                process.stdout.write('\n');
-                resolve(answer);
-            });
-        });
-    }
-    runGit(args, cwd) {
-        return (0, child_process_1.execFileSync)('git', args, { cwd, encoding: 'utf8', stdio: ['ignore', 'pipe', 'pipe'] });
-    }
-    tryRunGit(args, cwd) {
-        try {
-            const stdout = this.runGit(args, cwd);
-            return { ok: true, stdout, stderr: '' };
-        }
-        catch (err) {
-            return {
-                ok: false,
-                stdout: err && err.stdout ? err.stdout.toString() : '',
-                stderr: err && err.stderr ? err.stderr.toString() : (err && err.message) || '',
-            };
-        }
-    }
-    async commitToGit(absPath, fileId, options) {
-        const repoDir = path.dirname(absPath);
-        const relPath = path.basename(absPath);
-        const versionCheck = this.tryRunGit(['--version'], repoDir);
-        if (!versionCheck.ok) {
-            console.log('git command not available; skipping git commit.');
-            return;
-        }
-        const insideRepo = this.tryRunGit(['rev-parse', '--is-inside-work-tree'], repoDir);
-        if (!insideRepo.ok || insideRepo.stdout.trim() !== 'true') {
-            console.log(`Not inside a git working tree (${repoDir}); skipping git commit.`);
-            return;
-        }
-        const tracked = this.tryRunGit(['ls-files', '--error-unmatch', relPath], repoDir);
-        if (!tracked.ok) {
-            const answer = (await this.prompt(`File is not tracked by git: ${relPath}\nAdd it to git? (Y/n): `)).toLowerCase();
-            if (answer === 'n' || answer === 'no') {
-                console.log('Nothing was done in git.');
-                return;
-            }
-        }
-        if (options.branch) {
-            const branchResult = this.tryRunGit(['checkout', '-b', options.branch], repoDir);
-            if (!branchResult.ok) {
-                throw new Error(`Failed to create branch "${options.branch}": ${branchResult.stderr.trim()}`);
-            }
-            console.log(`Created and switched to branch "${options.branch}"`);
-        }
-        let message = options.message;
-        if (!message) {
-            message = await this.prompt('Commit message: ');
-            if (!message) {
-                throw new Error('A commit message is required');
-            }
-        }
-        const finalMessage = ConfigUploadCommand.buildCommitMessage(message, fileId);
-        const addResult = this.tryRunGit(['add', '--', relPath], repoDir);
-        if (!addResult.ok) {
-            throw new Error(`git add failed: ${addResult.stderr.trim()}`);
-        }
-        const commitResult = this.tryRunGit(['commit', '-m', finalMessage, '--', relPath], repoDir);
-        if (!commitResult.ok) {
-            throw new Error(`git commit failed: ${commitResult.stderr.trim() || commitResult.stdout.trim()}`);
-        }
-        console.log(commitResult.stdout.trim());
-    }
-    async run(args) {
-        const options = ConfigUploadCommand.parseArgs(args);
-        const absPath = path.resolve(process.cwd(), options.filePath);
-        if (!fs.existsSync(absPath)) {
-            throw new Error(`File not found: ${absPath}`);
-        }
-        if (!absPath.endsWith('.json')) {
-            throw new Error(`Expected a .json file, got: ${absPath}`);
-        }
-        const raw = fs.readFileSync(absPath, 'utf8');
-        let config;
-        try {
-            config = JSON.parse(raw);
-        }
-        catch (err) {
-            throw new Error(`File is not valid JSON: ${absPath}\n${err && err.message ? err.message : err}`);
-        }
-        const orgName = config && config.orgName;
-        const appIdentifier = config && config.appIdentifier;
-        if (!orgName) {
-            throw new Error(`Config file is missing "orgName": ${absPath}`);
-        }
-        if (!appIdentifier) {
-            throw new Error(`Config file is missing "appIdentifier": ${absPath}`);
-        }
-        let email = process.env.CONTRAIL_CLI_EMAIL;
-        let password = process.env.CONTRAIL_CLI_PASSWORD;
-        if (!email) {
-            email = await this.prompt('Email: ');
-        }
-        if (!password) {
-            password = await this.promptHidden('Password: ');
-        }
-        if (!email || !password) {
-            throw new Error('Email and password are required');
-        }
-        await (0, sdk_1.login)({ orgSlug: orgName, email, password });
-        console.log(`Logged in to org "${orgName}" as ${email}`);
-        const apps = await new sdk_1.Entities().get({
-            entityName: 'app',
-            criteria: { identifier: appIdentifier },
-        });
-        if (!apps || apps.length !== 1) {
-            throw new Error(`Expected exactly one app with identifier "${appIdentifier}" in org "${orgName}", found ${apps ? apps.length : 0}`);
-        }
-        const app = apps[0];
-        const buffer = fs.readFileSync(absPath);
-        const fileName = path.basename(absPath);
-        const fileOwner = `app:${app.id}`;
-        const uploadedFile = await new sdk_1.Files().createAndUploadFileFromBuffer(buffer, 'application/json', fileName, fileOwner);
-        const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
-        const responsePath = `${absPath}.uploaded-${timestamp}.json`;
-        fs.writeFileSync(responsePath, JSON.stringify(uploadedFile, null, 2), 'utf8');
-        console.log(`Wrote response to ${responsePath}`);
-        console.log(`FILE ID: ${uploadedFile.id}`);
-        if (!options.skipGit) {
-            await this.commitToGit(absPath, uploadedFile.id, options);
-        }
-        if (options.updateConfig) {
-            await this.setConfigFileOnAppOrg(app.id, appIdentifier, orgName, uploadedFile.id);
-        }
-    }
-    async setConfigFileOnAppOrg(appId, appIdentifier, orgName, fileId) {
-        const appOrgs = await new sdk_1.Entities().get({
-            entityName: 'app-org',
-            criteria: { appId },
-        });
-        if (!appOrgs || appOrgs.length === 0) {
-            throw new Error(`Failed to set the file onto the app config for "${appIdentifier}" because it is not installed in org "${orgName}". Install it via the admin console before using --update-config. You can paste the uploaded file's ID into the app config without needing to re-run this command.`);
-        }
-        if (appOrgs.length > 1) {
-            throw new Error(`Failed to set the file onto the app config for "${appIdentifier}" in org "${orgName}" because ${appOrgs.length} installations were identified. Expected one. Please contact customer support for assistance.`);
-        }
-        const appOrg = appOrgs[0];
-        const nextAppConfig = { ...(appOrg.appConfig || {}), configFile: fileId };
-        await new sdk_1.Entities().update({
-            entityName: 'app-org',
-            id: appOrg.id,
-            object: { appConfig: nextAppConfig },
-        });
-        console.log(`Successfully set "appConfig.configFile" for installed "${appIdentifier}" to new FILE ID: "${fileId}" on org "${orgName}"`);
-    }
-}
-exports.ConfigUploadCommand = ConfigUploadCommand;

package/lib/cli/commands/config-upload.spec.d.ts

@@ -1 +0,0 @@
-export {};

package/lib/cli/commands/config-upload.spec.js

@@ -1,94 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-jest.mock('@contrail/sdk', () => ({
-    Entities: jest.fn(),
-    Files: jest.fn(),
-    login: jest.fn(),
-}));
-const config_upload_1 = require("./config-upload");
-describe('ConfigUploadCommand.parseArgs', () => {
-    it('parses a bare file path', () => {
-        const opts = config_upload_1.ConfigUploadCommand.parseArgs(['config.json']);
-        expect(opts).toEqual({
-            filePath: 'config.json',
-            message: undefined,
-            branch: undefined,
-            skipGit: false,
-            updateConfig: false,
-        });
-    });
-    it('parses -m commit message option', () => {
-        const opts = config_upload_1.ConfigUploadCommand.parseArgs(['config.json', '-m', 'my message']);
-        expect(opts.message).toEqual('my message');
-        expect(opts.skipGit).toBe(false);
-    });
-    it('parses -b branch option', () => {
-        const opts = config_upload_1.ConfigUploadCommand.parseArgs(['config.json', '-b', 'feature/x']);
-        expect(opts.branch).toEqual('feature/x');
-    });
-    it('parses --skip-git flag', () => {
-        const opts = config_upload_1.ConfigUploadCommand.parseArgs(['config.json', '--skip-git']);
-        expect(opts.skipGit).toBe(true);
-    });
-    it('accepts the legacy --skipGit alias', () => {
-        const opts = config_upload_1.ConfigUploadCommand.parseArgs(['config.json', '--skipGit']);
-        expect(opts.skipGit).toBe(true);
-    });
-    it('parses --update-config flag', () => {
-        const opts = config_upload_1.ConfigUploadCommand.parseArgs(['config.json', '--update-config']);
-        expect(opts.updateConfig).toBe(true);
-    });
-    it('throws when -m is missing its value', () => {
-        expect(() => config_upload_1.ConfigUploadCommand.parseArgs(['config.json', '-m'])).toThrow(/-m requires a commit message/);
-    });
-    it('throws on unknown option', () => {
-        expect(() => config_upload_1.ConfigUploadCommand.parseArgs(['config.json', '--bogus'])).toThrow(/Unknown option: --bogus/);
-    });
-    it('throws when no file path is provided', () => {
-        expect(() => config_upload_1.ConfigUploadCommand.parseArgs([])).toThrow(/missing <path\.json>/);
-    });
-});
-describe('ConfigUploadCommand.buildCommitMessage', () => {
-    it('appends fileId to the first line of a single-line message', () => {
-        expect(config_upload_1.ConfigUploadCommand.buildCommitMessage('initial commit', 'abc123')).toEqual('initial commit [fileId: abc123]');
-    });
-    it('handles CRLF line endings', () => {
-        const result = config_upload_1.ConfigUploadCommand.buildCommitMessage('header\r\nbody', 'fid');
-        expect(result).toEqual('header [fileId: fid]\nbody');
-    });
-});
-describe('ConfigUploadCommand.run', () => {
-    const fs = require('fs');
-    const os = require('os');
-    const path = require('path');
-    let tempDir;
-    beforeEach(() => {
-        tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'flexplm-config-upload-'));
-    });
-    afterEach(() => {
-        fs.rmSync(tempDir, { recursive: true, force: true });
-    });
-    it('throws when the config file is missing orgName', async () => {
-        const filePath = path.join(tempDir, 'bad.json');
-        fs.writeFileSync(filePath, JSON.stringify({ appIdentifier: '@vibeiq/flexplm-connector' }), 'utf8');
-        await expect(new config_upload_1.ConfigUploadCommand().run([filePath, '--skip-git'])).rejects.toThrow(/missing "orgName"/);
-    });
-    it('throws when the config file is missing appIdentifier', async () => {
-        const filePath = path.join(tempDir, 'bad.json');
-        fs.writeFileSync(filePath, JSON.stringify({ orgName: 'acme' }), 'utf8');
-        await expect(new config_upload_1.ConfigUploadCommand().run([filePath, '--skip-git'])).rejects.toThrow(/missing "appIdentifier"/);
-    });
-    it('throws when the file is not valid JSON', async () => {
-        const filePath = path.join(tempDir, 'bad.json');
-        fs.writeFileSync(filePath, '{not json', 'utf8');
-        await expect(new config_upload_1.ConfigUploadCommand().run([filePath, '--skip-git'])).rejects.toThrow(/not valid JSON/);
-    });
-    it('throws when the file does not exist', async () => {
-        await expect(new config_upload_1.ConfigUploadCommand().run([path.join(tempDir, 'nope.json'), '--skip-git'])).rejects.toThrow(/File not found/);
-    });
-    it('throws when the file is not a .json file', async () => {
-        const filePath = path.join(tempDir, 'config.txt');
-        fs.writeFileSync(filePath, '{}', 'utf8');
-        await expect(new config_upload_1.ConfigUploadCommand().run([filePath, '--skip-git'])).rejects.toThrow(/Expected a \.json file/);
-    });
-});

package/lib/cli/config-index.d.ts

@@ -1,5 +0,0 @@
-#!/usr/bin/env node
-export declare class ConfigCli {
-    main(): Promise<void>;
-}
-export declare function main(): Promise<void>;

package/lib/cli/config-index.js

@@ -1,61 +0,0 @@
-#!/usr/bin/env node
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.main = exports.ConfigCli = void 0;
-const config_create_1 = require("./commands/config-create");
-const config_upload_1 = require("./commands/config-upload");
-const USAGE = `Usage: flexplm-config <command> [args]
-
-Commands:
-  create                  Scaffold a new connector config .json file in the current directory
-  upload  <path.json> [opts] Upload a connector config .json file to VibeIQ
-
-Upload options:
-  -m <message>            Git commit message (prompted if omitted)
-  -b <branch>             Create a new git branch before committing
-  --skip-git              Skip the post-upload git commit (default: commit)
-  --update-config         Patch the app-org appConfig.configFile with the uploaded file ID without needing to paste into the admin console
-
-Environment (upload):
-  CONTRAIL_CLI_EMAIL      VibeIQ user email
-  CONTRAIL_CLI_PASSWORD   VibeIQ user password
-`;
-class ConfigCli {
-    async main() {
-        const [, , command, ...rest] = process.argv;
-        switch (command) {
-            case 'create':
-                await new config_create_1.ConfigCreateCommand().run();
-                return;
-            case 'upload':
-                if (!rest[0]) {
-                    console.error('upload: missing <path.json> argument');
-                    console.error(USAGE);
-                    process.exit(1);
-                }
-                await new config_upload_1.ConfigUploadCommand().run(rest);
-                return;
-            case undefined:
-            case '-h':
-            case '--help':
-            case 'help':
-                console.log(USAGE);
-                return;
-            default:
-                console.error(`Unknown command: ${command}`);
-                console.error(USAGE);
-                process.exit(1);
-        }
-    }
-}
-exports.ConfigCli = ConfigCli;
-function main() {
-    return new ConfigCli().main();
-}
-exports.main = main;
-if (require.main === module) {
-    main().catch((err) => {
-        console.error(err && err.message ? err.message : err);
-        process.exit(1);
-    });
-}

package/lib/cli/config-index.spec.d.ts

@@ -1 +0,0 @@
-export {};

package/lib/cli/config-index.spec.js

@@ -1,68 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const createRunMock = jest.fn().mockResolvedValue(undefined);
-const uploadRunMock = jest.fn().mockResolvedValue(undefined);
-jest.mock('./commands/config-create', () => ({
-    ConfigCreateCommand: jest.fn().mockImplementation(() => ({ run: createRunMock })),
-}));
-jest.mock('./commands/config-upload', () => ({
-    ConfigUploadCommand: jest.fn().mockImplementation(() => ({ run: uploadRunMock })),
-}));
-const config_index_1 = require("./config-index");
-describe('config cli main dispatcher', () => {
-    let originalArgv;
-    let logSpy;
-    let errorSpy;
-    let exitSpy;
-    beforeEach(() => {
-        originalArgv = process.argv;
-        createRunMock.mockClear();
-        uploadRunMock.mockClear();
-        logSpy = jest.spyOn(console, 'log').mockImplementation(() => { });
-        errorSpy = jest.spyOn(console, 'error').mockImplementation(() => { });
-        exitSpy = jest.spyOn(process, 'exit').mockImplementation(((code) => {
-            throw new Error(`__EXIT__:${code}`);
-        }));
-    });
-    afterEach(() => {
-        process.argv = originalArgv;
-        logSpy.mockRestore();
-        errorSpy.mockRestore();
-        exitSpy.mockRestore();
-    });
-    function setArgv(...args) {
-        process.argv = ['node', 'cli', ...args];
-    }
-    it('dispatches the create command', async () => {
-        setArgv('create');
-        await (0, config_index_1.main)();
-        expect(createRunMock).toHaveBeenCalledTimes(1);
-        expect(uploadRunMock).not.toHaveBeenCalled();
-    });
-    it('dispatches the upload command and forwards remaining args', async () => {
-        setArgv('upload', 'config.json', '-m', 'msg', '--skip-git');
-        await (0, config_index_1.main)();
-        expect(uploadRunMock).toHaveBeenCalledWith(['config.json', '-m', 'msg', '--skip-git']);
-    });
-    it('exits when upload is missing its argument', async () => {
-        setArgv('upload');
-        await expect((0, config_index_1.main)()).rejects.toThrow('__EXIT__:1');
-        expect(uploadRunMock).not.toHaveBeenCalled();
-        expect(errorSpy).toHaveBeenCalledWith(expect.stringMatching(/missing <path\.json>/));
-    });
-    it.each(['help', '-h', '--help'])('prints usage for %s', async (helpFlag) => {
-        setArgv(helpFlag);
-        await (0, config_index_1.main)();
-        expect(logSpy).toHaveBeenCalledWith(expect.stringMatching(/Usage: flexplm-config/));
-    });
-    it('prints usage when no command is provided', async () => {
-        setArgv();
-        await (0, config_index_1.main)();
-        expect(logSpy).toHaveBeenCalledWith(expect.stringMatching(/Usage: flexplm-config/));
-    });
-    it('exits on an unknown command', async () => {
-        setArgv('bogus');
-        await expect((0, config_index_1.main)()).rejects.toThrow('__EXIT__:1');
-        expect(errorSpy).toHaveBeenCalledWith(expect.stringMatching(/Unknown command: bogus/));
-    });
-});

package/lib/cli/template/config-template.json.template

@@ -1,30 +0,0 @@
-{
-  "orgName": "<ORG_NAME>",
-  "appIdentifier": "<APP_IDENTIFIER>",
-
-  "_availableAttributes": {
-    "_note": "Reference only — the connector never reads this key. Add any of the attributes below as real top-level keys if this org needs them, then delete this whole \"_availableAttributes\" block.",
-    "apiHost": "FlexPLM API host base URL. Required — throws NEED_CONFIG_VALUES if missing",
-    "userName": "FlexPLM user name used for Basic Auth. Required; rewritten to a () => string getter",
-    "password": "FlexPLM password used for Basic Auth. Required; rewritten to a () => string getter",
-    "urlContext": "Path prefix for FlexPLM URLs. Default: '/Windchill'",
-    "itemPreDevelopmentLifecycleStages": "Item lifecycle stages during which items are not synced to FlexPLM. Default: ['concept']",
-    "logLevel": "Possible values: error/warn/info/debug. Default: info",
-    "identifierAtts": "Deprecated. Map of FlexPLM object class to identifier attribute name(s), e.g. { \"LCSProduct\": [\"itemNumber\"] }",
-    "plmEnviornment": "Sent as the PLM_ENV header on every FlexPLM request. Only used by 1 customer. NOTE: this key is intentionally spelled \"plmEnviornment\" (matching the connector's actual config key) — do not \"fix\" the spelling to \"plmEnvironment\", it will silently stop working",
-    "propertyMapping": "Deprecated. Reserved for custom property-mapping overrides",
-    "complexConfig": "Object of additional attributes (see below) merged onto the top level of the config, then deleted; __proto__/constructor/prototype keys are stripped for safety. e.g. { \"complexConfig\": { \"csrfEndpoint\": \"...\" } }",
-    "csrfEndpoint (in complexConfig)": "CSRF token endpoint path. Default: '/servlet/rest/security/csrf'",
-    "dataConverter.useDisplayForEnumerationMatching (in complexConfig)": "Default: false",
-    "dataConverter.verboseDebug (in complexConfig)": "Default: false",
-    "flexplmConnect.staticHeaders (in complexConfig)": "Extra static headers added to every FlexPLM request",
-    "LCSMaterial.processAsItem (in complexConfig)": "true routes LCSMaterial to item:material instead of custom-entity. Default: false",
-    "max_thumbnail_size (in complexConfig)": "Max thumbnail size in bytes. Default: 5 MB",
-    "payloadDefaultAsArray (in complexConfig)": "Whether outbound payload values default to arrays. Default: true",
-    "search.<entityType>.useIdentityServiceForInboundData (in complexConfig)": "entityType is one of: item, color, custom-entity, project-item. Default: false",
-    "sendMode.ASYNC_PUBLISH_SEASON (in complexConfig)": "Default: 'vibeiqfile'",
-    "syncOptionSets (in complexConfig)": "Array of { flexInternalName, vibeSlug }",
-    "useDistinctRestEndPointForImages (in complexConfig)": "Default: false; when true routes image fetch through /rfa/vibeiq/image instead of the raw URL",
-    "vibeEventEndpoint (in complexConfig)": "Endpoint VibeIQ posts inbound events to. Default: '/rfa/vibeiq/vibeEvents'"
-  }
-}