@configura/web-api 2.0.0-alpha.14 → 2.0.0-alpha.15

package/dist/CatalogueAPI.d.ts

@@ -1,3 +1,8 @@
+/** AdditionalProductConf */
+export interface DtoAdditionalProductConf extends DtoProductConf {
+    refKey: string;
+    selected: boolean;
+}
 /** AdditionalProductConfiguration */
 export interface DtoAdditionalProductConfiguration {
     refKey?: string;
@@ -5,11 +10,6 @@ export interface DtoAdditionalProductConfiguration {
     selOptions: Array<DtoSelectedOption>;
     additionalProducts?: Array<DtoAdditionalProductConfiguration>;
 }
-/** AdditionalProductConfigurationV2 */
-export interface DtoAdditionalProductConfigurationV2 extends DtoProductConfiguration {
-    refKey: string;
-    selected: boolean;
-}
 /** AdditionalProductRef */
 export interface DtoAdditionalProductRef {
     refKey: string;
@@ -52,7 +52,7 @@ export interface DtoCatalogueParams extends DtoCatalogueParamsWithoutCid {
 export interface DtoCatalogueParamsWithLang extends DtoCatalogueParams {
     lang: string;
 }
-/** CatalogueParamsWithoutCid */
+/** CatalogueParamsWithoutCid - To identify one catalogue the Portfolio ID CID is needed in addition to the parameters in this object. However as of now CID is not used in API calls and therefore this version without CID is needed. */
 export interface DtoCatalogueParamsWithoutCid {
     enterprise: string;
     prdCat: string;
@@ -127,12 +127,12 @@ export interface DtoFeature {
     syncGroup?: DtoSyncGroup;
     unit?: string;
 }
-/** FeatureConfiguration */
-export interface DtoFeatureConfiguration {
+/** FeatureConf */
+export interface DtoFeatureConf {
     code: string;
     groupCode?: string;
     unit?: string;
-    options?: Array<DtoOptionConfiguration>;
+    options?: Array<DtoOptionConf>;
 }
 /** FeatureRef */
 export interface DtoFeatureRef {
@@ -248,12 +248,12 @@ export interface DtoOption {
     upcharge?: number;
     priceCodes?: Array<string>;
 }
-/** OptionConfiguration */
-export interface DtoOptionConfiguration {
+/** OptionConf */
+export interface DtoOptionConf {
     code: string;
     selected: boolean;
     numericValue?: DtoValueWithUnit;
-    features?: Array<DtoFeatureConfiguration>;
+    features?: Array<DtoFeatureConf>;
 }
 /** Orientation */
 export interface DtoOrientation {
@@ -353,10 +353,10 @@ export interface DtoProductCatalogueInfo {
     exchangeRate: number;
     lastModified: string;
 }
-/** ProductConfiguration */
-export interface DtoProductConfiguration {
-    features?: Array<DtoFeatureConfiguration>;
-    additionalProducts?: Array<DtoAdditionalProductConfigurationV2>;
+/** ProductConf - This is intended to eventually supersede AdditionalProductConfiguration as the format for sending/receiving how a Product is configured. */
+export interface DtoProductConf {
+    features?: Array<DtoFeatureConf>;
+    additionalProducts?: Array<DtoAdditionalProductConf>;
     prodParams?: DtoProductParamsWithLang;
 }
 /** ProductData */

package/dist/CfgProduct.d.ts

@@ -1,5 +1,5 @@
 import { AggregatedLoadingObservable, LengthUnit, Observable, SingleArgCallback } from "@configura/web-utilities";
-import { DtoAdditionalProductConfiguration, DtoAdditionalProductRef, DtoCatalogueParams, DtoMeasureParam, DtoMtrlApplication, DtoPrices, DtoProductConfiguration, DtoProductParamsWithLang, DtoTransform } from "./CatalogueAPI.js";
+import { DtoAdditionalProductConfiguration, DtoAdditionalProductRef, DtoCatalogueParams, DtoMeasureParam, DtoMtrlApplication, DtoPrices, DtoProductConf, DtoProductParamsWithLang, DtoTransform } from "./CatalogueAPI.js";
 import { CfgMeasureDefinition } from "./CfgMeasure.js";
 import { _CfgFeatureInternal } from "./productConfiguration/CfgFeature.js";
 import { ProductConfigurationBubbleMode } from "./productConfiguration/CfgOption.js";
@@ -93,7 +93,13 @@ export declare class _CfgProductInternal {
     get selected(): boolean;
     readonly isAdditionalProduct: boolean;
     clone(parent?: _CfgProductInternal, root?: _CfgProductInternal): Promise<_CfgProductInternal>;
+    /** Mark this and its descendants as destroyed and remove all listeners */
     destroy: () => void;
+    /**
+     * Internal use. Used when this product is an additional product, and
+     * changing a parent product has made the settings for this product
+     * change.
+     */
     _updateAdditionalProdRef(p: DtoAdditionalProductRef): void;
     get description(): string | undefined;
     get rootNodeSources(): RootNodeSource[] | undefined;
@@ -136,8 +142,8 @@ export declare class _CfgProductInternal {
     _additionalProductHasChanged: (freshRef: CfgProduct, bubbleMode: CfgProductBubbleMode, committed: boolean) => Promise<void>;
     /** Called by the configuration to tell its parent that it has changed. */
     _configurationHasChanged: (freshRef: CfgProductConfiguration, bubbleMode: ProductConfigurationBubbleMode, committed: boolean) => Promise<void>;
-    getDtoConfiguration: (includeExtendedData: boolean, includeProductParams: boolean) => DtoProductConfiguration;
-    setDtoConfiguration: (s: DtoProductConfiguration, doValidate: boolean, productLoaderForGroupedLoad?: ProductLoader | undefined) => Promise<boolean>;
+    getDtoConf: (includeExtendedData: boolean, includeProductParams: boolean) => DtoProductConf;
+    setDtoConf: (s: DtoProductConf, doValidate: boolean, productLoaderForGroupedLoad?: ProductLoader | undefined) => Promise<boolean>;
     setApiSelection: (s: DtoAdditionalProductConfiguration, doValidate: boolean, productLoaderForGroupedLoad?: ProductLoader | undefined) => Promise<boolean>;
     copyFrom: (source: _CfgProductInternal, doValidate: boolean, productLoaderForGroupedLoad?: ProductLoader | undefined) => Promise<boolean>;
     private _setApiSelectionWithOtherProduct;
@@ -254,11 +260,43 @@ export declare class CfgProduct {
      * Gets what selections has been made on the product, recursively including product
      * configuration, optional products and additional products. Used when a full view of all
      * selections on a product is needed, such as when doing Render or Export.
+     * @deprecated getDtoConf provides a newer format.
+     * @see getDtoConf
      */
     getApiSelection: () => DtoAdditionalProductConfiguration;
-    getDtoConfiguration: (includeExtendedData?: boolean, includeProductParams?: boolean) => DtoProductConfiguration;
-    setDtoConfiguration: (s: DtoProductConfiguration, doValidate?: boolean) => Promise<boolean>;
-    setApiSelection: (s: DtoAdditionalProductConfiguration, doValidate?: boolean) => Promise<boolean>;
+    /**
+     * Applies the configuration (selections) in the passed object onto the product recursively
+     * including product configuration, optional products and additional products.
+     * @param doValidate Makes a server side validation call. These are necessary to ensure that
+     *                   the right models are loaded.
+     * @deprecated setDtoConf uses a newer format.
+     */
+    setApiSelection: (configuration: DtoAdditionalProductConfiguration, doValidate?: boolean) => Promise<boolean>;
+    /**
+     * A newer alternative version of getApiSelection. This returns the configuration (selections)
+     * on the product, recursively including product configuration, optional products and additional
+     * products.
+     * This version has the following advantages over getApiSelection:
+     * - The format is clearer, designed to be readable
+     * - Makes less assumptions about the structure in the Product being unchanging over time. In
+     *   particular, the Feature codes are included in the data, so that changes to what Features
+     *   are used in a Product is less likely to lead to unexpected results.
+     * - You can request ExtendedData and/or ProductParams to be included in the result. This extra
+     *   data is ignored when passed back into the API, but it can be very useful for external
+     *   applications.
+     * The other version (getApiSelection) has the advantage of using a format directly compatible with the API:s.
+     * @param includeExtendedData  Includes extra data which is not an actual part of the configuration,
+     *                             i.e. units and groupCodes
+     * @param includeProductParams Includes what Product this was generated for, and the same for any
+     *                             Additional Products.
+     */
+    getDtoConf: (includeExtendedData?: boolean, includeProductParams?: boolean) => DtoProductConf;
+    /**
+     * A newer alternative version of setApiSelection.
+     * @param doValidate Makes a server side validation call. These are necessary to ensure that
+     *                   the right models are loaded.
+     */
+    setDtoConf: (configuration: DtoProductConf, doValidate?: boolean) => Promise<boolean>;
     listenForChange: (l: SingleArgCallback<CfgProductChangeNotification>) => void;
     stopListenForChange: (l: SingleArgCallback<CfgProductChangeNotification>) => void;
     stopAllListenForChange: () => void;

package/dist/CfgProduct.js

@@ -9,7 +9,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 import { AggregatedLoadingObservable, assert, assertDefined, augmentErrorMessage, compareArrays, count, Observable, toLengthUnit, } from "@configura/web-utilities";
 import { CfgMeasureDefinition } from "./CfgMeasure.js";
-import { convertDtoProductConfigurationToV1 } from "./ConfigurationConverter.js";
+import { convertDtoProductConfToV1 } from "./ConfigurationConverter.js";
 import { ProductConfigurationBubbleMode } from "./productConfiguration/CfgOption.js";
 import { CfgProductConfiguration } from "./productConfiguration/CfgProductConfiguration.js";
 import { collectAdditionalProductRefs } from "./productConfiguration/utilitiesProductConfiguration.js";
@@ -67,11 +67,13 @@ export class _CfgProductInternal {
         this._destroyed = false;
         this.additionalProducts = [];
         this.changeObservable = new Observable();
+        /** Mark this and its descendants as destroyed and remove all listeners */
         this.destroy = () => {
+            var _a;
             this._destroyed = true;
             this.changeObservable.stopAllListen();
             this.configuration.stopAllListenForChange();
-            for (const additionalProduct of this.additionalProducts || []) {
+            for (const additionalProduct of (_a = this.additionalProducts) !== null && _a !== void 0 ? _a : []) {
                 additionalProduct.destroy();
             }
         };
@@ -140,9 +142,9 @@ export class _CfgProductInternal {
                     return;
             }
         });
-        this.getDtoConfiguration = (includeExtendedData, includeProductParams) => {
+        this.getDtoConf = (includeExtendedData, includeProductParams) => {
             const conf = {};
-            const features = this.configuration._internal.getDtoConfiguration(includeExtendedData);
+            const features = this.configuration._internal.getDtoConf(includeExtendedData);
             if (0 < features.length) {
                 conf.features = features;
             }
@@ -151,7 +153,7 @@ export class _CfgProductInternal {
             }
             const additionalProducts = this.additionalProducts;
             if (0 < additionalProducts.length) {
-                conf.additionalProducts = additionalProducts.map((p) => p._internal.getDtoConfiguration(includeExtendedData, includeProductParams));
+                conf.additionalProducts = additionalProducts.map((p) => p._internal.getDtoConf(includeExtendedData, includeProductParams));
             }
             if (this.isAdditionalProduct) {
                 const refKey = this.refKey;
@@ -164,14 +166,14 @@ export class _CfgProductInternal {
             }
             return conf;
         };
-        this.setDtoConfiguration = (s, doValidate, productLoaderForGroupedLoad) => __awaiter(this, void 0, void 0, function* () {
-            return yield this.setApiSelection(convertDtoProductConfigurationToV1(s), doValidate, productLoaderForGroupedLoad);
+        this.setDtoConf = (s, doValidate, productLoaderForGroupedLoad) => __awaiter(this, void 0, void 0, function* () {
+            return yield this.setApiSelection(convertDtoProductConfToV1(s), doValidate, productLoaderForGroupedLoad);
         });
         this.setApiSelection = (s, doValidate, productLoaderForGroupedLoad) => __awaiter(this, void 0, void 0, function* () {
             return yield this._setApiSelectionWithOtherProduct(s, doValidate, productLoaderForGroupedLoad, undefined);
         });
         this.copyFrom = (source, doValidate, productLoaderForGroupedLoad) => __awaiter(this, void 0, void 0, function* () {
-            return yield this._setApiSelectionWithOtherProduct(convertDtoProductConfigurationToV1(source.getDtoConfiguration(false, false)), doValidate, productLoaderForGroupedLoad, source);
+            return yield this._setApiSelectionWithOtherProduct(convertDtoProductConfToV1(source.getDtoConf(false, false)), doValidate, productLoaderForGroupedLoad, source);
         });
         this._setApiSelectionWithOtherProduct = (s, doValidate, productLoaderForGroupedLoad, sourceProduct) => __awaiter(this, void 0, void 0, function* () {
             // Wrap with cache will make getProduct for this function call use the same server call
@@ -312,7 +314,7 @@ export class _CfgProductInternal {
             const token = this.loadingObservable.startChildLoading();
             this._revalidateInProgressToken = token;
             try {
-                const response = yield productLoader.postValidate(correctDefaultsOnCatalogueParams(this.prodParams), { selOptions: configuration.getApiSelection() });
+                const response = yield productLoader.postValidate(correctDefaultsOnCatalogueParams(this.prodParams), { selOptions: configuration._internal.getApiSelection() });
                 // The revalidateInProgressToken is used to know if some other revalidate
                 // call has happened after this call, thereby making this call obsolete.
                 // This is a bit crude in that it does not actually cancel previous validate
@@ -350,7 +352,7 @@ export class _CfgProductInternal {
                 return true;
             }
             catch (e) {
-                throw augmentErrorMessage(e, "Validate product configuration request failure");
+                throw augmentErrorMessage(e, `Validate product configuration request (${this.prodParams.partNumber}) failure`);
             }
             finally {
                 this.loadingObservable.stopChildLoading(token);
@@ -435,7 +437,7 @@ export class _CfgProductInternal {
                 var _a;
                 const p = new _CfgProductInternal(() => {
                     initSuccess(p);
-                }, initFail, this._productLoaderRaw, this.prodParams, this.settings, this.optional, this.selected, this._configuration.rootFeatureRefs, this._configuration.allRawFeatures, this.uuid, this._rawUnit, this._rawProductData, this.configuration.getApiSelection(), new AggregatedLoadingObservable(), parent, root, this._additionalProductRef, (_a = this._syncGroupHandler) === null || _a === void 0 ? void 0 : _a.clone());
+                }, initFail, this._productLoaderRaw, this.prodParams, this.settings, this.optional, this.selected, this._configuration.rootFeatureRefs, this._configuration.allRawFeatures, this.uuid, this._rawUnit, this._rawProductData, this.configuration._internal.getApiSelection(), new AggregatedLoadingObservable(), parent, root, this._additionalProductRef, (_a = this._syncGroupHandler) === null || _a === void 0 ? void 0 : _a.clone());
             });
             for (const additionalProduct of this.additionalProducts) {
                 product.additionalProducts.push(CfgProduct._makeNewRefFrom(yield additionalProduct._internal.clone(product, root || product)));
@@ -443,6 +445,11 @@ export class _CfgProductInternal {
             return product;
         });
     }
+    /**
+     * Internal use. Used when this product is an additional product, and
+     * changing a parent product has made the settings for this product
+     * change.
+     */
     _updateAdditionalProdRef(p) {
         this._additionalProductRef = p;
         if (p.optional !== this.optional) {
@@ -611,7 +618,7 @@ prodParams, settings, optional, loadingObservable, parent, root, additionalProdu
         return product;
     }
     catch (e) {
-        throw augmentErrorMessage(e, "Load product request failure");
+        throw augmentErrorMessage(e, `Load product request (${prodParams.partNumber}) failure`);
     }
 });
 export class CfgProduct {
@@ -650,11 +657,43 @@ export class CfgProduct {
          * Gets what selections has been made on the product, recursively including product
          * configuration, optional products and additional products. Used when a full view of all
          * selections on a product is needed, such as when doing Render or Export.
+         * @deprecated getDtoConf provides a newer format.
+         * @see getDtoConf
+         */
+        this.getApiSelection = () => convertDtoProductConfToV1(this._internal.getDtoConf(false, false), true);
+        /**
+         * Applies the configuration (selections) in the passed object onto the product recursively
+         * including product configuration, optional products and additional products.
+         * @param doValidate Makes a server side validation call. These are necessary to ensure that
+         *                   the right models are loaded.
+         * @deprecated setDtoConf uses a newer format.
+         */
+        this.setApiSelection = (configuration, doValidate = true) => __awaiter(this, void 0, void 0, function* () { return yield this._internal.setApiSelection(configuration, doValidate); });
+        /**
+         * A newer alternative version of getApiSelection. This returns the configuration (selections)
+         * on the product, recursively including product configuration, optional products and additional
+         * products.
+         * This version has the following advantages over getApiSelection:
+         * - The format is clearer, designed to be readable
+         * - Makes less assumptions about the structure in the Product being unchanging over time. In
+         *   particular, the Feature codes are included in the data, so that changes to what Features
+         *   are used in a Product is less likely to lead to unexpected results.
+         * - You can request ExtendedData and/or ProductParams to be included in the result. This extra
+         *   data is ignored when passed back into the API, but it can be very useful for external
+         *   applications.
+         * The other version (getApiSelection) has the advantage of using a format directly compatible with the API:s.
+         * @param includeExtendedData  Includes extra data which is not an actual part of the configuration,
+         *                             i.e. units and groupCodes
+         * @param includeProductParams Includes what Product this was generated for, and the same for any
+         *                             Additional Products.
+         */
+        this.getDtoConf = (includeExtendedData = false, includeProductParams = false) => this._internal.getDtoConf(includeExtendedData, includeProductParams);
+        /**
+         * A newer alternative version of setApiSelection.
+         * @param doValidate Makes a server side validation call. These are necessary to ensure that
+         *                   the right models are loaded.
          */
-        this.getApiSelection = () => convertDtoProductConfigurationToV1(this._internal.getDtoConfiguration(false, false), true);
-        this.getDtoConfiguration = (includeExtendedData = false, includeProductParams = false) => this._internal.getDtoConfiguration(includeExtendedData, includeProductParams);
-        this.setDtoConfiguration = (s, doValidate = true) => __awaiter(this, void 0, void 0, function* () { return yield this._internal.setDtoConfiguration(s, doValidate); });
-        this.setApiSelection = (s, doValidate = true) => __awaiter(this, void 0, void 0, function* () { return yield this._internal.setApiSelection(s, doValidate); });
+        this.setDtoConf = (configuration, doValidate = true) => __awaiter(this, void 0, void 0, function* () { return yield this._internal.setDtoConf(configuration, doValidate); });
         this.listenForChange = (l) => this._internal.changeObservable.listen(l);
         this.stopListenForChange = (l) => this._internal.changeObservable.stopListen(l);
         this.stopAllListenForChange = () => this._internal.changeObservable.stopAllListen();

package/dist/ConfigurationConverter.d.ts

@@ -1,14 +1,14 @@
-import { DtoAdditionalProductConfiguration, DtoAdditionalProductConfigurationV2, DtoFeatureConfiguration, DtoProductConfiguration, DtoSelectedOption } from "./CatalogueAPI.js";
-export declare const isDtoProductConfigurationAdditional: (value: DtoProductConfiguration) => value is DtoAdditionalProductConfigurationV2;
-export declare const convertDtoProductConfigurationToV1: (conf: DtoProductConfiguration, silenceWarnings?: boolean) => DtoAdditionalProductConfiguration;
-export declare const convertDtoFeatureConfigurationsToSelOptions: (features: DtoFeatureConfiguration[], silenceWarnings?: boolean) => DtoSelectedOption[];
+import { DtoAdditionalProductConf, DtoAdditionalProductConfiguration, DtoFeatureConf, DtoProductConf, DtoSelectedOption } from "./CatalogueAPI.js";
+export declare const isDtoProductConfAdditional: (value: DtoProductConf) => value is DtoAdditionalProductConf;
+export declare const convertDtoProductConfToV1: (conf: DtoProductConf, silenceWarnings?: boolean) => DtoAdditionalProductConfiguration;
+export declare const convertDtoFeatureConfsToSelOptions: (features: DtoFeatureConf[], silenceWarnings?: boolean) => DtoSelectedOption[];
 /**
  * Serializes and compacts the configuration into a format especially suited for URLs
  */
-export declare const dtoProductConfigurationToCompactString: (conf: DtoProductConfiguration) => string;
+export declare const dtoProductConfigurationToCompactString: (conf: DtoProductConf) => string;
 /**
  * Deserializes and inflates the configuration from the compacted format
  */
-export declare const compactStringToDtoProductConfiguration: (versionAndConf: string) => DtoProductConfiguration;
-export declare const stripExtendedDataFromDtoProductConfiguration: (conf: DtoProductConfiguration) => DtoProductConfiguration;
+export declare const compactStringToDtoProductConf: (versionAndConf: string) => DtoProductConf;
+export declare const stripExtendedDataFromDtoProductConf: (conf: DtoProductConf) => DtoProductConf;
 //# sourceMappingURL=ConfigurationConverter.d.ts.map

package/dist/ConfigurationConverter.js

@@ -1,33 +1,33 @@
-export const isDtoProductConfigurationAdditional = (value) => "refKey" in value;
+export const isDtoProductConfAdditional = (value) => "refKey" in value;
 // As this has potential to flood the terminal we only inform once
 let hasInformedAboutProdParams = false;
 let hasInformedAboutGroupCode = false;
 let hasInformedAboutUnit = false;
-export const convertDtoProductConfigurationToV1 = (conf, silenceWarnings = false) => {
+export const convertDtoProductConfToV1 = (conf, silenceWarnings = false) => {
     var _a, _b;
     if (!silenceWarnings && conf.prodParams !== undefined && !hasInformedAboutProdParams) {
         hasInformedAboutProdParams = true;
-        console.info("Incoming DtoProductConfiguration contains prodParams. These will be ignored.");
+        console.info("Incoming DtoProductConf contains prodParams. These will be ignored.");
     }
     const result = {
         selOptions: ((_a = conf.features) !== null && _a !== void 0 ? _a : []).map((f) => ({
             code: "!~!",
-            next: convertDtoFeatureConfigurationToApiSelection(f, silenceWarnings),
+            next: convertDtoFeatureConfToApiSelection(f, silenceWarnings),
         })),
-        additionalProducts: ((_b = conf.additionalProducts) !== null && _b !== void 0 ? _b : []).map((p) => convertDtoProductConfigurationToV1(p, silenceWarnings)),
+        additionalProducts: ((_b = conf.additionalProducts) !== null && _b !== void 0 ? _b : []).map((p) => convertDtoProductConfToV1(p, silenceWarnings)),
         selected: true,
     };
-    if (isDtoProductConfigurationAdditional(conf)) {
+    if (isDtoProductConfAdditional(conf)) {
         result.refKey = conf.refKey;
         result.selected = conf.selected;
     }
     return result;
 };
-export const convertDtoFeatureConfigurationsToSelOptions = (features, silenceWarnings = false) => (features !== null && features !== void 0 ? features : []).map((f) => ({
+export const convertDtoFeatureConfsToSelOptions = (features, silenceWarnings = false) => (features !== null && features !== void 0 ? features : []).map((f) => ({
     code: "!~!",
-    next: convertDtoFeatureConfigurationToApiSelection(f, silenceWarnings),
+    next: convertDtoFeatureConfToApiSelection(f, silenceWarnings),
 }));
-const convertDtoFeatureConfigurationToApiSelection = (feature, silenceWarnings) => {
+const convertDtoFeatureConfToApiSelection = (feature, silenceWarnings) => {
     const { groupCode, options, unit } = feature;
     if (!silenceWarnings && groupCode !== undefined && !hasInformedAboutGroupCode) {
         hasInformedAboutGroupCode = true;
@@ -39,13 +39,13 @@ const convertDtoFeatureConfigurationToApiSelection = (feature, silenceWarnings)
     }
     const result = {};
     for (const option of (options !== null && options !== void 0 ? options : []).filter((o) => o.selected)) {
-        result[option.code] = convertDtoOptionConfigurationToSelectedOption(option, silenceWarnings);
+        result[option.code] = convertDtoOptionConfToSelectedOption(option, silenceWarnings);
     }
     return result;
 };
-const convertDtoOptionConfigurationToSelectedOption = (option, silenceWarnings) => {
+const convertDtoOptionConfToSelectedOption = (option, silenceWarnings) => {
     const { features, code, numericValue } = option;
-    const selectionTrees = (features !== null && features !== void 0 ? features : []).map((f) => convertDtoFeatureConfigurationToApiSelection(f, silenceWarnings));
+    const selectionTrees = (features !== null && features !== void 0 ? features : []).map((f) => convertDtoFeatureConfToApiSelection(f, silenceWarnings));
     const mergedSelectionTree = {};
     let anyItems = false;
     for (const selectionTree of selectionTrees) {
@@ -76,7 +76,7 @@ const swapForUrlAdaptedRegex = /[-~_{}"]/g;
 const shortToLong = new Map();
 const longToShort = new Map();
 // The replacement scheme here assumes this will only be used for keys
-// in DtoProductConfiguration and the knowledge that it contains no one
+// in DtoProductConf and the knowledge that it contains no one
 // one char keys.
 for (const [long, short] of [
     ["configuration", "c"],
@@ -116,17 +116,17 @@ const jsonStringSwapCharsForUrl = (data) => data.replace(swapForUrlAdaptedRegex,
             throw new Error(`Unexpected char "${char}" in swap for URL`);
     }
 });
-const compactDtoProductConfigurationJsonKeys = (data) => data.replace(jsonKeyRegex, (_, key) => { var _a; return `"${(_a = longToShort.get(key)) !== null && _a !== void 0 ? _a : key}":`; });
-const expandDtoProductConfigurationJsonKeys = (data) => data.replace(jsonKeyRegex, (_, key) => { var _a; return `"${(_a = shortToLong.get(key)) !== null && _a !== void 0 ? _a : key}":`; });
+const compactDtoProductConfJsonKeys = (data) => data.replace(jsonKeyRegex, (_, key) => { var _a; return `"${(_a = longToShort.get(key)) !== null && _a !== void 0 ? _a : key}":`; });
+const expandDtoProductConfJsonKeys = (data) => data.replace(jsonKeyRegex, (_, key) => { var _a; return `"${(_a = shortToLong.get(key)) !== null && _a !== void 0 ? _a : key}":`; });
 /**
  * Serializes and compacts the configuration into a format especially suited for URLs
  */
 export const dtoProductConfigurationToCompactString = (conf) => "v1" +
-    jsonStringSwapCharsForUrl(compactDtoProductConfigurationJsonKeys(JSON.stringify(conf, undefined, "")));
+    jsonStringSwapCharsForUrl(compactDtoProductConfJsonKeys(JSON.stringify(conf, undefined, "")));
 /**
  * Deserializes and inflates the configuration from the compacted format
  */
-export const compactStringToDtoProductConfiguration = (versionAndConf) => {
+export const compactStringToDtoProductConf = (versionAndConf) => {
     const match = versionedRegex.exec(versionAndConf);
     if (match === null) {
         throw new Error("Could not match version string");
@@ -138,29 +138,29 @@ export const compactStringToDtoProductConfiguration = (versionAndConf) => {
     if (conf === "") {
         throw new Error("No conf found");
     }
-    return JSON.parse(expandDtoProductConfigurationJsonKeys(jsonStringSwapCharsForUrl(conf)));
+    return JSON.parse(expandDtoProductConfJsonKeys(jsonStringSwapCharsForUrl(conf)));
 };
-export const stripExtendedDataFromDtoProductConfiguration = (conf) => {
+export const stripExtendedDataFromDtoProductConf = (conf) => {
     var _a, _b;
     return ({
-        features: (_a = conf.features) === null || _a === void 0 ? void 0 : _a.map(stripExtendedDataFromDtoFeatureConfiguration),
+        features: (_a = conf.features) === null || _a === void 0 ? void 0 : _a.map(stripExtendedDataFromDtoFeatureConf),
         additionalProducts: (_b = conf.additionalProducts) === null || _b === void 0 ? void 0 : _b.map(stripExtendedDataFromDtoAdditionalProductConfiguration),
     });
 };
-const stripExtendedDataFromDtoAdditionalProductConfiguration = (conf) => (Object.assign(Object.assign({}, stripExtendedDataFromDtoProductConfiguration(conf)), { refKey: conf.refKey, selected: conf.selected }));
-const stripExtendedDataFromDtoFeatureConfiguration = (conf) => {
+const stripExtendedDataFromDtoAdditionalProductConfiguration = (conf) => (Object.assign(Object.assign({}, stripExtendedDataFromDtoProductConf(conf)), { refKey: conf.refKey, selected: conf.selected }));
+const stripExtendedDataFromDtoFeatureConf = (conf) => {
     var _a;
     return ({
         code: conf.code,
-        options: (_a = conf.options) === null || _a === void 0 ? void 0 : _a.map(stripExtendedDataFromDtoOptionConfiguration),
+        options: (_a = conf.options) === null || _a === void 0 ? void 0 : _a.map(stripExtendedDataFromDtoOptionConf),
     });
 };
-const stripExtendedDataFromDtoOptionConfiguration = (conf) => {
+const stripExtendedDataFromDtoOptionConf = (conf) => {
     var _a;
     return ({
         code: conf.code,
         selected: conf.selected,
         numericValue: conf.numericValue,
-        features: (_a = conf.features) === null || _a === void 0 ? void 0 : _a.map(stripExtendedDataFromDtoFeatureConfiguration),
+        features: (_a = conf.features) === null || _a === void 0 ? void 0 : _a.map(stripExtendedDataFromDtoFeatureConf),
     });
 };

package/dist/io/CfgHistoryManager.d.ts

@@ -2,6 +2,21 @@ import { CfgWindowEventManager } from "./CfgWindowEventManager.js";
 declare type CfgHistoryManagerMessageData = {
     initial: boolean;
 };
+/**
+ * How the history is updated.
+ * @param DoNotWrite Only listens to initial URL-values.
+ * @param Replace Replaces the current history frame at updates.
+ * @param Push Adds history frames at updates.
+ * @param ReplaceAndUpdateUrl Replaces the current history frame at updates and updates the browser URL
+ * @param PushAndUpdateUrl Adds history frames at updates and updates the browser URL
+ */
+export declare enum HistoryMode {
+    DoNotWrite = 0,
+    Replace = 1,
+    Push = 2,
+    ReplaceAndUpdateUrl = 3,
+    PushAndUpdateUrl = 4
+}
 /**
  * The collected data used when sending. For history this both contains the message, which is
  * used as the "state" in the history-frame, and the qsKeyValues, which are query string
@@ -11,7 +26,7 @@ declare type CfgHistoryManagerMessageData = {
  */
 export declare type CfgHistoryManagerSendData<D> = {
     message: D;
-    useHistoryPush: boolean;
+    mode: HistoryMode;
     qsKeyValues: Map<string, string | undefined>;
 };
 /**
@@ -22,6 +37,22 @@ export declare class CfgHistoryManager extends CfgWindowEventManager<"popstate",
     private static _instance;
     static get instance(): CfgHistoryManager;
     private constructor();
+    private _aggregatedQsKeyValues;
+    private _urlUpdateObservable;
+    /**
+     * @returns The current browser URL updated with the latest updates from
+     *          the Connectors.
+     */
+    getUrl(): string;
+    /**
+     * Listen for updated URL:s. This doesn't have to mean the URL in the
+     * browser has been updated.
+     */
+    listenForUrl(listener: (url: string) => void): void;
+    /**
+     * Stop listen.
+     */
+    stopListenForUrl(listener: (url: string) => void): void;
     /**
      * Write to the history
      */
@@ -47,6 +78,7 @@ export declare class CfgHistoryManager extends CfgWindowEventManager<"popstate",
     private static _makeUpdatedState;
     protected readonly eventType = "popstate";
     protected getDataFromEvent(event: PopStateEvent): unknown;
+    static getMessageFromCurrentHistoryState(messageKey: string): unknown | undefined;
 }
 export {};
 //# sourceMappingURL=CfgHistoryManager.d.ts.map

package/dist/io/CfgHistoryManager.js

@@ -1,6 +1,22 @@
-import { mapQueryString, unmapQueryString } from "@configura/web-utilities";
+import { mapQueryString, Observable, unmapQueryString } from "@configura/web-utilities";
 import { CfgIOManager } from "./CfgIOManager.js";
 import { CfgWindowEventManager } from "./CfgWindowEventManager.js";
+/**
+ * How the history is updated.
+ * @param DoNotWrite Only listens to initial URL-values.
+ * @param Replace Replaces the current history frame at updates.
+ * @param Push Adds history frames at updates.
+ * @param ReplaceAndUpdateUrl Replaces the current history frame at updates and updates the browser URL
+ * @param PushAndUpdateUrl Adds history frames at updates and updates the browser URL
+ */
+export var HistoryMode;
+(function (HistoryMode) {
+    HistoryMode[HistoryMode["DoNotWrite"] = 0] = "DoNotWrite";
+    HistoryMode[HistoryMode["Replace"] = 1] = "Replace";
+    HistoryMode[HistoryMode["Push"] = 2] = "Push";
+    HistoryMode[HistoryMode["ReplaceAndUpdateUrl"] = 3] = "ReplaceAndUpdateUrl";
+    HistoryMode[HistoryMode["PushAndUpdateUrl"] = 4] = "PushAndUpdateUrl";
+})(HistoryMode || (HistoryMode = {}));
 /**
  * This class is used to coordinate writing and reading to the browser history.
  * It handles messages sent from the connectors.
@@ -8,6 +24,8 @@ import { CfgWindowEventManager } from "./CfgWindowEventManager.js";
 export class CfgHistoryManager extends CfgWindowEventManager {
     constructor() {
         super();
+        this._aggregatedQsKeyValues = new Map();
+        this._urlUpdateObservable = new Observable();
         this.eventType = "popstate";
     }
     static get instance() {
@@ -16,22 +34,56 @@ export class CfgHistoryManager extends CfgWindowEventManager {
         }
         return this._instance;
     }
+    /**
+     * @returns The current browser URL updated with the latest updates from
+     *          the Connectors.
+     */
+    getUrl() {
+        return CfgHistoryManager._makeUpdatedUrl(this._aggregatedQsKeyValues);
+    }
+    /**
+     * Listen for updated URL:s. This doesn't have to mean the URL in the
+     * browser has been updated.
+     */
+    listenForUrl(listener) {
+        this._urlUpdateObservable.listen(listener);
+    }
+    /**
+     * Stop listen.
+     */
+    stopListenForUrl(listener) {
+        this._urlUpdateObservable.stopListen(listener);
+    }
     /**
      * Write to the history
      */
     send(messageKey, data) {
-        const { qsKeyValues, message, useHistoryPush } = data;
+        const { qsKeyValues, message, mode } = data;
+        for (const keyValue of qsKeyValues) {
+            this._aggregatedQsKeyValues.set(keyValue[0], keyValue[1]);
+        }
+        this._urlUpdateObservable.notifyAll(this.getUrl());
+        if (mode === HistoryMode.DoNotWrite) {
+            return;
+        }
         // Initial data is before user interaction has happened
         const initial = message.initial;
+        const url = CfgHistoryManager._makeUpdatedUrl(qsKeyValues);
         // At initial we do not replace the URL as we presumable have the defaults
-        const newUrl = initial ? null : CfgHistoryManager._makeUpdatedUrl(qsKeyValues);
+        const writeUrl = initial ||
+            !(mode === HistoryMode.PushAndUpdateUrl || mode === HistoryMode.ReplaceAndUpdateUrl)
+            ? null
+            : url;
         // ...but we do replace the state so that we can in the future browse back to here
         const newState = CfgHistoryManager._makeUpdatedState(window.history.state, message, messageKey);
-        if (initial || !useHistoryPush || this.receiveInProgress) {
-            window.history.replaceState(newState, "", newUrl);
+        if (initial ||
+            mode === HistoryMode.Replace ||
+            mode === HistoryMode.ReplaceAndUpdateUrl ||
+            this.receiveInProgress) {
+            window.history.replaceState(newState, "", writeUrl);
         }
         else {
-            window.history.pushState(newState, "", newUrl);
+            window.history.pushState(newState, "", writeUrl);
         }
     }
     /**
@@ -79,4 +131,14 @@ export class CfgHistoryManager extends CfgWindowEventManager {
     getDataFromEvent(event) {
         return event.state;
     }
+    static getMessageFromCurrentHistoryState(messageKey) {
+        const state = window.history.state;
+        if (!CfgIOManager.isIOContainer(state)) {
+            return undefined;
+        }
+        if (!CfgIOManager.hasIOContainerMessageKey(state, messageKey)) {
+            return undefined;
+        }
+        return CfgIOManager.getMessageFromIOContainer(state, messageKey);
+    }
 }

package/dist/io/CfgHistoryToProdConfConnector.d.ts

@@ -1,19 +1,18 @@
-import { DtoProductConfiguration } from "../CatalogueAPI.js";
-import { CfgHistoryManager, CfgHistoryManagerSendData } from "./CfgHistoryManager.js";
+import { DtoProductConf } from "../CatalogueAPI.js";
+import { CfgHistoryManager, CfgHistoryManagerSendData, HistoryMode } from "./CfgHistoryManager.js";
 import { CfgIOProdConfConnector, CfgProdConfMessage } from "./CfgIOProdConfConnector.js";
 /**
  * Instantiating this will make the browser history (and URL) update with the product configuration.
  */
 export declare class CfgHistoryToProdConfConnector extends CfgIOProdConfConnector<CfgHistoryManagerSendData<CfgProdConfMessage>> {
-    private readonly _useHistoryPush;
+    private readonly _mode;
     private readonly _qsKey;
     /**
-     * @param _useHistoryPush As opposed to replace. Push makes the web browser navigation buttons navigate configuration changes. Replace just updates the URL.
+     * @param _mode
      * @param _qsKey The Query String key for product configuration.
-     * @param doValidate When popping from the history stack (navigating in the browser), should a navigate call be sent to the server to verify that the product configuration is still valid?
      */
-    constructor(manager: CfgHistoryManager, _useHistoryPush: boolean, _qsKey?: string, doValidate?: boolean);
-    protected getInitialProdConf(): DtoProductConfiguration | undefined;
-    protected makeSendData(conf: DtoProductConfiguration, initial: boolean): CfgHistoryManagerSendData<CfgProdConfMessage>;
+    constructor(manager: CfgHistoryManager, _mode: HistoryMode, _qsKey?: string);
+    protected getInitialProdConf(): DtoProductConf | undefined;
+    protected makeSendData(conf: DtoProductConf, initial: boolean): CfgHistoryManagerSendData<CfgProdConfMessage>;
 }
 //# sourceMappingURL=CfgHistoryToProdConfConnector.d.ts.map

package/dist/io/CfgHistoryToProdConfConnector.js

@@ -1,26 +1,39 @@
-import { compactStringToDtoProductConfiguration, dtoProductConfigurationToCompactString, } from "../ConfigurationConverter.js";
+import { augmentErrorMessage } from "@configura/web-utilities";
+import { compactStringToDtoProductConf, dtoProductConfigurationToCompactString, } from "../ConfigurationConverter.js";
 import { CfgHistoryManager } from "./CfgHistoryManager.js";
-import { CfgIOProdConfConnector, CfgProdConfMessageVersions, STAGE_PROD_CONF_MESSAGE_KEY, } from "./CfgIOProdConfConnector.js";
+import { CfgIOProdConfConnector, CfgProdConfMessageVersions, getHighestVersionProdConfMessage, isCfgProdConfMessageV2, STAGE_PROD_CONF_MESSAGE_KEY, } from "./CfgIOProdConfConnector.js";
 /**
  * Instantiating this will make the browser history (and URL) update with the product configuration.
  */
 export class CfgHistoryToProdConfConnector extends CfgIOProdConfConnector {
     /**
-     * @param _useHistoryPush As opposed to replace. Push makes the web browser navigation buttons navigate configuration changes. Replace just updates the URL.
+     * @param _mode
      * @param _qsKey The Query String key for product configuration.
-     * @param doValidate When popping from the history stack (navigating in the browser), should a navigate call be sent to the server to verify that the product configuration is still valid?
      */
-    constructor(manager, _useHistoryPush, _qsKey = STAGE_PROD_CONF_MESSAGE_KEY, doValidate = true) {
-        super(manager, doValidate, false, false);
-        this._useHistoryPush = _useHistoryPush;
+    constructor(manager, _mode, _qsKey = STAGE_PROD_CONF_MESSAGE_KEY) {
+        super(manager, false, false);
+        this._mode = _mode;
         this._qsKey = _qsKey;
     }
     getInitialProdConf() {
-        const s = CfgHistoryManager.currentQsKeyValues().get(this._qsKey);
-        if (s === undefined) {
-            return undefined;
+        // First try to use the state, if that doesn't work use the query string
+        const initialMessage = CfgHistoryManager.getMessageFromCurrentHistoryState(STAGE_PROD_CONF_MESSAGE_KEY);
+        if (initialMessage !== undefined) {
+            const highestVersionMessage = getHighestVersionProdConfMessage(initialMessage.subMessages);
+            if (isCfgProdConfMessageV2(highestVersionMessage)) {
+                return highestVersionMessage.conf;
+            }
+        }
+        try {
+            const s = CfgHistoryManager.currentQsKeyValues().get(this._qsKey);
+            if (s === undefined) {
+                return undefined;
+            }
+            return compactStringToDtoProductConf(s);
+        }
+        catch (err) {
+            throw augmentErrorMessage(err, "Failed read configuration from query string");
         }
-        return compactStringToDtoProductConfiguration(s);
     }
     makeSendData(conf, initial) {
         return {
@@ -28,7 +41,7 @@ export class CfgHistoryToProdConfConnector extends CfgIOProdConfConnector {
             qsKeyValues: new Map([
                 [STAGE_PROD_CONF_MESSAGE_KEY, dtoProductConfigurationToCompactString(conf)],
             ]),
-            useHistoryPush: this._useHistoryPush,
+            mode: this._mode,
         };
     }
 }

package/dist/io/CfgIOManager.js

@@ -81,7 +81,7 @@ export class CfgIOManager {
                     if (item.messageKey !== messageKey) {
                         continue;
                     }
-                    // async, not waiting. Might need to change.
+                    // async, not waiting on each other. Might need to change.
                     promises.push(item.l(message));
                 }
             }

package/dist/io/CfgIOProdConfConnector.d.ts

@@ -1,4 +1,4 @@
-import { DtoAdditionalProductConfiguration, DtoProductConfiguration } from "../CatalogueAPI.js";
+import { DtoAdditionalProductConfiguration, DtoProductConf } from "../CatalogueAPI.js";
 import { CfgProduct, CfgProductChangeNotification } from "../CfgProduct.js";
 import { CfgIOManager } from "./CfgIOManager.js";
 export declare const isCfgProdConfMessage: (data: unknown) => data is CfgProdConfMessageV1 | CfgProdConfMessageV2;
@@ -9,7 +9,7 @@ export declare type CfgProdConfMessageV1 = {
 export declare const isCfgProdConfMessageV1: (data: unknown) => data is CfgProdConfMessageV1;
 export declare type CfgProdConfMessageV2 = {
     version: "2.0";
-    conf: DtoProductConfiguration;
+    conf: DtoProductConf;
 };
 export declare const isCfgProdConfMessageV2: (data: unknown) => data is CfgProdConfMessageV2;
 export declare type CfgProdConfMessage = {
@@ -23,26 +23,25 @@ export declare enum CfgProdConfMessageVersions {
 }
 export declare const STAGE_PROD_CONF_MESSAGE_KEY = "stageprodconf";
 declare type ProdConfMessageCallback = (message: CfgProdConfMessage) => Promise<void>;
-declare type ProdConfCallback = (conf: DtoProductConfiguration) => Promise<void>;
+declare type ProdConfCallback = (conf: DtoProductConf) => Promise<void>;
 /**
  * Base class for connecting the product configuration to an IO channel
  */
 export declare abstract class CfgIOProdConfConnector<S> {
     private readonly _ioManager;
-    private readonly _doValidate;
     private readonly _includeExtendedDataInSend;
     private readonly _includeProdParamsInSend;
     private _product;
     private _stopListenToMessage;
     private _stopListenToProdConf;
-    constructor(_ioManager: CfgIOManager<S>, _doValidate: boolean, _includeExtendedDataInSend: boolean, // Only v2.0
+    constructor(_ioManager: CfgIOManager<S>, _includeExtendedDataInSend: boolean, // Only v2.0
     _includeProdParamsInSend: boolean);
     destroy: () => void;
     setProduct: (product: CfgProduct | undefined) => Promise<void>;
     private _send;
-    protected getInitialProdConf(): DtoProductConfiguration | undefined;
-    protected abstract makeSendData(conf: DtoProductConfiguration, initial: boolean): S;
-    static makeMessage(conf: DtoProductConfiguration, initial: boolean, sendVersions: CfgProdConfMessageVersions): CfgProdConfMessage;
+    protected getInitialProdConf(): DtoProductConf | undefined;
+    protected abstract makeSendData(conf: DtoProductConf, initial: boolean): S;
+    static makeMessage(conf: DtoProductConf, initial: boolean, sendVersions: CfgProdConfMessageVersions): CfgProdConfMessage;
     static makeMessageListener(callback: ProdConfMessageCallback): (message: unknown) => Promise<void>;
     /**
      * Register the callback to listen for Product Configuration messages

package/dist/io/CfgIOProdConfConnector.js

@@ -7,7 +7,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-import { convertDtoProductConfigurationToV1 } from "../ConfigurationConverter.js";
+import { convertDtoProductConfToV1 } from "../ConfigurationConverter.js";
 export const isCfgProdConfMessage = (data) => typeof data === "object" && data !== null && "version" in data && "conf" in data;
 export const isCfgProdConfMessageV1 = (data) => isCfgProdConfMessage(data) && data.version === "1.0";
 export const isCfgProdConfMessageV2 = (data) => isCfgProdConfMessage(data) && data.version === "2.0";
@@ -24,11 +24,10 @@ export const STAGE_PROD_CONF_MESSAGE_KEY = "stageprodconf";
  * Base class for connecting the product configuration to an IO channel
  */
 export class CfgIOProdConfConnector {
-    constructor(_ioManager, _doValidate, _includeExtendedDataInSend, // Only v2.0
+    constructor(_ioManager, _includeExtendedDataInSend, // Only v2.0
     _includeProdParamsInSend // Only v2.0
     ) {
         this._ioManager = _ioManager;
-        this._doValidate = _doValidate;
         this._includeExtendedDataInSend = _includeExtendedDataInSend;
         this._includeProdParamsInSend = _includeProdParamsInSend;
         this._stopListenToMessage = undefined;
@@ -58,12 +57,17 @@ export class CfgIOProdConfConnector {
             }
             // We only try to load initial configuration at first load
             if (currentProduct === undefined) {
-                const initialProdConf = this.getInitialProdConf();
-                if (initialProdConf !== undefined) {
-                    yield newProduct.setDtoConfiguration(initialProdConf, this._doValidate);
+                try {
+                    const initialProdConf = this.getInitialProdConf();
+                    if (initialProdConf !== undefined) {
+                        yield newProduct.setDtoConf(initialProdConf);
+                    }
+                }
+                catch (err) {
+                    console.error(err);
                 }
             }
-            this._send(this.makeSendData(newProduct.getDtoConfiguration(this._includeExtendedDataInSend, this._includeProdParamsInSend), true));
+            this._send(this.makeSendData(newProduct.getDtoConf(this._includeExtendedDataInSend, this._includeProdParamsInSend), true));
             this._stopListenToMessage = CfgIOProdConfConnector.listenForMessage((messages) => __awaiter(this, void 0, void 0, function* () {
                 const subMessages = messages.subMessages;
                 if (subMessages.length === 0) {
@@ -72,11 +76,11 @@ export class CfgIOProdConfConnector {
                 }
                 const highestVersionMessage = getHighestVersionProdConfMessage(subMessages);
                 if (isCfgProdConfMessageV1(highestVersionMessage)) {
-                    yield newProduct.setApiSelection(highestVersionMessage.conf, this._doValidate);
+                    yield newProduct.setApiSelection(highestVersionMessage.conf);
                     return;
                 }
                 if (isCfgProdConfMessageV2(highestVersionMessage)) {
-                    yield newProduct.setDtoConfiguration(highestVersionMessage.conf, this._doValidate);
+                    yield newProduct.setDtoConf(highestVersionMessage.conf);
                     return;
                 }
                 throw new Error("Unknown message version");
@@ -94,7 +98,7 @@ export class CfgIOProdConfConnector {
             CfgProdConfMessageVersions.V1dot0) {
             const v1 = {
                 version: "1.0",
-                conf: convertDtoProductConfigurationToV1(conf, true),
+                conf: convertDtoProductConfToV1(conf, true),
             };
             result.push(v1);
         }
@@ -130,7 +134,7 @@ export class CfgIOProdConfConnector {
             if (!n.committed) {
                 return;
             }
-            callback(n.freshRef.getDtoConfiguration(includeExtendedDataInSend, includeProdParamsInSend));
+            callback(n.freshRef.getDtoConf(includeExtendedDataInSend, includeProdParamsInSend));
         };
     }
     static listenForProdConf(product, callback, includeExtendedDataInSend, includeProdParamsInSend) {

package/dist/io/CfgObservableStateToProdConfConnector.d.ts

@@ -1,16 +1,15 @@
-import { DtoProductConfiguration } from "../CatalogueAPI.js";
+import { DtoProductConf } from "../CatalogueAPI.js";
 import { CfgIOProdConfConnector, CfgProdConfMessage, CfgProdConfMessageVersions } from "./CfgIOProdConfConnector.js";
 import { CfgObservableStateManager } from "./CfgObservableStateManager.js";
 /**
  * Instantiating this will make the observable state update with the product configuration.
- * @param doValidate Run server side product validation for incoming
  * @param sendVersions What versions of the productConfiguration shall be sent? Multiple can be selected
  * @param includeExtendedDataInSend Only for version 2.0. Includes unit and groupCode.
  * @param includeProdParamsInSend Only for version 2.0. Includes product params, in both main and additional products.
  */
 export declare class CfgObservableStateToProdConfConnector extends CfgIOProdConfConnector<CfgProdConfMessage> {
     private _sendVersions;
-    constructor(manager: CfgObservableStateManager, doValidate?: boolean, _sendVersions?: CfgProdConfMessageVersions, includeExtendedDataInSend?: boolean, includeProdParamsInSend?: boolean);
-    protected makeSendData(conf: DtoProductConfiguration, initial: boolean): CfgProdConfMessage;
+    constructor(manager: CfgObservableStateManager, _sendVersions?: CfgProdConfMessageVersions, includeExtendedDataInSend?: boolean, includeProdParamsInSend?: boolean);
+    protected makeSendData(conf: DtoProductConf, initial: boolean): CfgProdConfMessage;
 }
 //# sourceMappingURL=CfgObservableStateToProdConfConnector.d.ts.map

package/dist/io/CfgObservableStateToProdConfConnector.js

@@ -1,14 +1,13 @@
 import { CfgIOProdConfConnector, CfgProdConfMessageVersions, } from "./CfgIOProdConfConnector.js";
 /**
  * Instantiating this will make the observable state update with the product configuration.
- * @param doValidate Run server side product validation for incoming
  * @param sendVersions What versions of the productConfiguration shall be sent? Multiple can be selected
  * @param includeExtendedDataInSend Only for version 2.0. Includes unit and groupCode.
  * @param includeProdParamsInSend Only for version 2.0. Includes product params, in both main and additional products.
  */
 export class CfgObservableStateToProdConfConnector extends CfgIOProdConfConnector {
-    constructor(manager, doValidate = true, _sendVersions = CfgProdConfMessageVersions.V2dot0, includeExtendedDataInSend = false, includeProdParamsInSend = false) {
-        super(manager, doValidate, includeExtendedDataInSend, includeProdParamsInSend);
+    constructor(manager, _sendVersions = CfgProdConfMessageVersions.V2dot0, includeExtendedDataInSend = false, includeProdParamsInSend = false) {
+        super(manager, includeExtendedDataInSend, includeProdParamsInSend);
         this._sendVersions = _sendVersions;
     }
     makeSendData(conf, initial) {

package/dist/io/CfgWindowMessageToProdConfConnector.d.ts

@@ -1,18 +1,17 @@
-import { DtoProductConfiguration } from "../CatalogueAPI.js";
+import { DtoProductConf } from "../CatalogueAPI.js";
 import { CfgIOProdConfConnector, CfgProdConfMessage, CfgProdConfMessageVersions } from "./CfgIOProdConfConnector.js";
 import { CfgWindowMessageManager } from "./CfgWindowMessageManager.js";
 /**
  * Instantiating this will make Stage send product configuration changes using the post message-API.
  * It will also make Stage listen for incoming product configuration update messages.
  * This can be used to communicate in and out of an iframe for example.
- * @param doValidate Run server side product validation for incoming
  * @param sendVersions What versions of the productConfiguration shall be sent? Multiple can be selected
  * @param includeExtendedDataInSend Only for version 2.0. Includes unit and groupCode.
  * @param includeProdParamsInSend Only for version 2.0. Includes product params, in both main and additional products.
  */
 export declare class CfgWindowMessageToProdConfConnector extends CfgIOProdConfConnector<CfgProdConfMessage> {
     private _sendVersions;
-    constructor(manager: CfgWindowMessageManager, doValidate?: boolean, _sendVersions?: CfgProdConfMessageVersions, includeExtendedDataInSend?: boolean, includeProdParamsInSend?: boolean);
-    protected makeSendData(conf: DtoProductConfiguration, initial: boolean): CfgProdConfMessage;
+    constructor(manager: CfgWindowMessageManager, _sendVersions?: CfgProdConfMessageVersions, includeExtendedDataInSend?: boolean, includeProdParamsInSend?: boolean);
+    protected makeSendData(conf: DtoProductConf, initial: boolean): CfgProdConfMessage;
 }
 //# sourceMappingURL=CfgWindowMessageToProdConfConnector.d.ts.map

package/dist/io/CfgWindowMessageToProdConfConnector.js

@@ -3,14 +3,13 @@ import { CfgIOProdConfConnector, CfgProdConfMessageVersions, } from "./CfgIOProd
  * Instantiating this will make Stage send product configuration changes using the post message-API.
  * It will also make Stage listen for incoming product configuration update messages.
  * This can be used to communicate in and out of an iframe for example.
- * @param doValidate Run server side product validation for incoming
  * @param sendVersions What versions of the productConfiguration shall be sent? Multiple can be selected
  * @param includeExtendedDataInSend Only for version 2.0. Includes unit and groupCode.
  * @param includeProdParamsInSend Only for version 2.0. Includes product params, in both main and additional products.
  */
 export class CfgWindowMessageToProdConfConnector extends CfgIOProdConfConnector {
-    constructor(manager, doValidate = true, _sendVersions = CfgProdConfMessageVersions.V2dot0, includeExtendedDataInSend = false, includeProdParamsInSend = false) {
-        super(manager, doValidate, includeExtendedDataInSend, includeProdParamsInSend);
+    constructor(manager, _sendVersions = CfgProdConfMessageVersions.V2dot0, includeExtendedDataInSend = false, includeProdParamsInSend = false) {
+        super(manager, includeExtendedDataInSend, includeProdParamsInSend);
         this._sendVersions = _sendVersions;
     }
     makeSendData(conf, initial) {

package/dist/productConfiguration/CfgFeature.d.ts

@@ -1,5 +1,5 @@
 import { LengthUnit, Observable, SingleArgCallback } from "@configura/web-utilities";
-import { DtoFeature, DtoFeatureConfiguration, DtoSelectedOption, DtoSyncGroup, DtoSyncGroupMethods } from "../CatalogueAPI.js";
+import { DtoFeature, DtoFeatureConf, DtoSelectedOption, DtoSyncGroup, DtoSyncGroupMethods } from "../CatalogueAPI.js";
 import { CfgProduct, _CfgProductInternal } from "../CfgProduct.js";
 import { CfgMtrlApplication } from "../material/CfgMtrlApplication.js";
 import { SyncCode } from "../syncGroups/SyncGroupsHandler.js";
@@ -99,7 +99,7 @@ export declare class _CfgFeatureInternal {
      * as nonexisting children can not call their parent.
      */
     _childHasChanged: (childOption: _CfgOptionInternal, bubbleMode: ProductConfigurationBubbleMode, committed: boolean) => Promise<void>;
-    getDtoConfiguration: (includeExtendedData: boolean) => DtoFeatureConfiguration;
+    getDtoConf: (includeExtendedData: boolean) => DtoFeatureConf;
     setApiSelection: (apiOptionSelectionMap: {
         [index: string]: DtoSelectedOption;
     } | undefined) => Promise<boolean>;

package/dist/productConfiguration/CfgFeature.js

@@ -114,7 +114,7 @@ export class _CfgFeatureInternal {
             }
             yield this._notifyAllOfChange(bubbleMode, committed);
         });
-        this.getDtoConfiguration = (includeExtendedData) => {
+        this.getDtoConf = (includeExtendedData) => {
             const result = {
                 code: this.code,
             };
@@ -124,10 +124,16 @@ export class _CfgFeatureInternal {
             }
             const selectedOptions = this._selectedOptions;
             if (0 < selectedOptions.length) {
-                result.options = selectedOptions.map((o) => o._internal.getDtoConfiguration(includeExtendedData));
+                result.options = selectedOptions.map((o) => o._internal.getDtoConf(includeExtendedData));
             }
             return result;
         };
+        // DtoFeatureConf is the newer more easily readable format for configuration. As
+        // the API:s are still using the older format (and will for the forseeable future) we need
+        // to support both formats. The new format can be converted to the old, but not the other
+        // way around. For that reason the get-method above uses the new format, and the set-method
+        // below the old format. As these functions are meant to only be used internally this should't
+        // cause too much confusion.
         this.setApiSelection = (apiOptionSelectionMap) => __awaiter(this, void 0, void 0, function* () {
             const selectionType = this.selectionType;
             const isGroup = selectionType === SelectionType.Group;

package/dist/productConfiguration/CfgOption.d.ts

@@ -1,5 +1,5 @@
 import { LengthUnit, Observable, SingleArgCallback } from "@configura/web-utilities";
-import { DtoFeature, DtoOption, DtoOptionConfiguration, DtoSelectedOption } from "../CatalogueAPI.js";
+import { DtoFeature, DtoOption, DtoOptionConf, DtoSelectedOption } from "../CatalogueAPI.js";
 import { CfgProduct, _CfgProductInternal } from "../CfgProduct.js";
 import { CfgMtrlApplication } from "../material/CfgMtrlApplication.js";
 import { NumericValuesSelection } from "../utilitiesNumericValues.js";
@@ -89,7 +89,7 @@ export declare class _CfgOptionInternal {
     get features(): CfgFeature[];
     /** Called by child to tell its parent that it has changed. */
     _childHasChanged: (freshRef: CfgFeature, bubbleMode: ProductConfigurationBubbleMode, committed: boolean) => Promise<void>;
-    getDtoConfiguration: (includeExtendedData: boolean) => DtoOptionConfiguration;
+    getDtoConf: (includeExtendedData: boolean) => DtoOptionConf;
     setApiSelection: (apiOptionSelection: DtoSelectedOption | undefined) => Promise<boolean>;
     structureCompare: (other: _CfgOptionInternal, strictOrder?: boolean, descriptionMatch?: boolean) => boolean;
     tryMatchSelection: (other: CfgOption, descriptionMatch?: boolean) => Promise<boolean>;

package/dist/productConfiguration/CfgOption.js

@@ -110,7 +110,7 @@ export class _CfgOptionInternal {
                 yield this.parent._childHasChanged(this, bubbleMode, committed);
             }
         });
-        this.getDtoConfiguration = (includeExtendedData) => {
+        this.getDtoConf = (includeExtendedData) => {
             const { features, isUseNumericValue, code, selected, numericValue } = this;
             if (!selected) {
                 throw new Error("Currently only useable on selected options. Selected in the result is for future use.");
@@ -128,10 +128,16 @@ export class _CfgOptionInternal {
                 }
             }
             if (0 < features.length) {
-                result.features = features.map((f) => f._internal.getDtoConfiguration(includeExtendedData));
+                result.features = features.map((f) => f._internal.getDtoConf(includeExtendedData));
             }
             return result;
         };
+        // DtoOptionConf is the newer more easily readable format for configuration. As
+        // the API:s are still using the older format (and will for the forseeable future) we need
+        // to support both formats. The new format can be converted to the old, but not the other
+        // way around. For that reason the get-method above uses the new format, and the set-method
+        // below the old format. As these functions are meant to only be used internally this should't
+        // cause too much confusion.
         this.setApiSelection = (apiOptionSelection) => __awaiter(this, void 0, void 0, function* () {
             let features;
             if (apiOptionSelection === undefined) {

package/dist/productConfiguration/CfgProductConfiguration.d.ts

@@ -1,5 +1,5 @@
 import { LengthUnit, LengthValue, Observable, SingleArgCallback } from "@configura/web-utilities";
-import { DtoFeature, DtoFeatureConfiguration, DtoFeatureRef, DtoSelectedOption } from "../CatalogueAPI.js";
+import { DtoFeature, DtoFeatureConf, DtoFeatureRef, DtoSelectedOption } from "../CatalogueAPI.js";
 import { CfgProduct, _CfgProductInternal } from "../CfgProduct.js";
 import { CfgFeature, _CfgFeatureInternal } from "./CfgFeature.js";
 import { ProductConfigurationBubbleMode } from "./CfgOption.js";
@@ -34,10 +34,12 @@ export declare class _CfgProductConfigurationInternal {
     _freshRefDescendants(): void;
     /** Called by child to tell its parent that it has changed. */
     _childHasChanged: (freshRef: CfgFeature, bubbleMode: ProductConfigurationBubbleMode, committed: boolean) => Promise<void>;
-    getDtoConfiguration: (includeExtendedData: boolean) => DtoFeatureConfiguration[];
+    getDtoConf: (includeExtendedData: boolean) => DtoFeatureConf[];
+    getApiSelection: () => DtoSelectedOption[];
     /**
      * When used internally the notifications are taken care off by the caller, but if set from
      * outside we want notifications to bubble all the way to the root.
+     * This method will not cause validation calls. Data is assumed to already be validated.
      */
     setApiSelection: (selectedOptions: DtoSelectedOption[], bubbleToRoot: boolean) => Promise<boolean>;
     structureCompare: (other: _CfgProductConfigurationInternal, strictOrder: boolean, descriptionMatch: boolean) => boolean;
@@ -94,12 +96,6 @@ export declare class CfgProductConfiguration {
      * This method will cause validation calls.
      */
     tryMatchSelection: (other: CfgProductConfiguration, descriptionMatch?: boolean) => Promise<boolean>;
-    getApiSelection: () => DtoSelectedOption[];
-    /**
-     * This method does not propagate its selections.
-     * This method will not cause validation calls. Data is assumed to already be validated.
-     */
-    setApiSelection: (selectedOptions: DtoSelectedOption[]) => Promise<boolean>;
     /**
      * Set how stretched a certain measure should be measureParamCode is the measure to be
      * stretched referenceLength is a value relative to the initial length of the measure. If the

package/dist/productConfiguration/CfgProductConfiguration.js

@@ -9,7 +9,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 import { compareArrays, count, isEqualLength, isLengthUnit, Observable, toError, toLengthUnit, } from "@configura/web-utilities";
 import { CfgProduct } from "../CfgProduct.js";
-import { convertDtoFeatureConfigurationsToSelOptions } from "../ConfigurationConverter.js";
+import { convertDtoFeatureConfsToSelOptions } from "../ConfigurationConverter.js";
 import { CfgFeature } from "./CfgFeature.js";
 import { ProductConfigurationBubbleMode } from "./CfgOption.js";
 import { syncCfgFeatures } from "./utilitiesProductConfiguration.js";
@@ -55,10 +55,12 @@ export class _CfgProductConfigurationInternal {
             features[i] = freshRef;
             yield this._notifyAllOfChange(bubbleMode, committed);
         });
-        this.getDtoConfiguration = (includeExtendedData) => this._features.map((f) => f._internal.getDtoConfiguration(includeExtendedData));
+        this.getDtoConf = (includeExtendedData) => this._features.map((f) => f._internal.getDtoConf(includeExtendedData));
+        this.getApiSelection = () => convertDtoFeatureConfsToSelOptions(this.getDtoConf(false), true);
         /**
          * When used internally the notifications are taken care off by the caller, but if set from
          * outside we want notifications to bubble all the way to the root.
+         * This method will not cause validation calls. Data is assumed to already be validated.
          */
         this.setApiSelection = (selectedOptions, bubbleToRoot) => __awaiter(this, void 0, void 0, function* () {
             const featuresLength = this._features.length;
@@ -233,12 +235,6 @@ export class CfgProductConfiguration {
          */
         this.tryMatchSelection = (other, descriptionMatch = false // Match on case insensitive description, not code
         ) => __awaiter(this, void 0, void 0, function* () { return yield this._internal.tryMatchSelection(other._internal, descriptionMatch, true); });
-        this.getApiSelection = () => convertDtoFeatureConfigurationsToSelOptions(this._internal.getDtoConfiguration(false), true);
-        /**
-         * This method does not propagate its selections.
-         * This method will not cause validation calls. Data is assumed to already be validated.
-         */
-        this.setApiSelection = (selectedOptions) => __awaiter(this, void 0, void 0, function* () { return yield this._internal.setApiSelection(selectedOptions, true); });
         /**
          * Set how stretched a certain measure should be measureParamCode is the measure to be
          * stretched referenceLength is a value relative to the initial length of the measure. If the

package/dist/tasks/TaskHandler.js

@@ -9,6 +9,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 import { augmentErrorMessage, Observable } from "@configura/web-utilities";
 import { dtoExportFormatNames, dtoRenderFormatNames, } from "../CatalogueAPI.js";
+import { convertDtoProductConfToV1 } from "../ConfigurationConverter.js";
 import { isExportFormat, isRenderFormat } from "./formats.js";
 export class _TaskHandlerInternal {
     constructor(api) {
@@ -175,7 +176,7 @@ export class Task {
             this.taskHandler.removeTask(this);
         };
         this._productParams = product.prodParams;
-        this._apiSelection = product.getApiSelection();
+        this._apiSelection = convertDtoProductConfToV1(product.getDtoConf());
         if (getPreviewUrl !== undefined) {
             void getPreviewUrl().then((dataUrl) => {
                 this._previewUrl = dataUrl;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@configura/web-api",
-	"version": "2.0.0-alpha.14",
+	"version": "2.0.0-alpha.15",
 	"license": "Apache-2.0",
 	"type": "module",
 	"main": "dist/index.js",
@@ -23,7 +23,7 @@
 		"access": "public"
 	},
 	"dependencies": {
-		"@configura/web-utilities": "2.0.0-alpha.14"
+		"@configura/web-utilities": "2.0.0-alpha.15"
 	},
-	"gitHead": "b3d0439069dc8cca134143d00fcd2f964525ceca"
+	"gitHead": "9f9facc3e6b6c16c02ff6950a1f6c86e44671957"
 }