@configura/web-api 1.6.1 → 2.0.0-alpha.0

package/dist/CatalogueAPI.js

@@ -1,5 +1,5 @@
-// TODO: Fix the linter issue in Tygen and regenerate this file.
-/* eslint-disable @typescript-eslint/explicit-module-boundary-types */
+// WARNING: This file was auto generated by the code in web-rnd/tygen.
+// Do not commit manual changes to this file.
 var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
     function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
     return new (P || (P = Promise))(function (resolve, reject) {
@@ -9,7 +9,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-export const exportFormatNames = [
+export const dtoExportFormatNames = [
     "glb",
     "gltf",
     "fbx",
@@ -18,21 +18,21 @@ export const exportFormatNames = [
     "cmfav",
     "cmsym",
 ];
-export const exportStatusStatusNames = [
+export const dtoExportStatusStatusNames = [
     "pending",
     "running",
     "finished",
     "failed",
 ];
-export const renderFormatNames = ["jpg", "png"];
-export const renderStatusStatusNames = [
+export const dtoRenderFormatNames = ["jpg", "png"];
+export const dtoRenderStatusStatusNames = [
     "pending",
     "running",
     "finished",
     "failed",
 ];
-export const syncGroupMethodsNames = ["pull", "push", "twoWay"];
-export class APIError extends Error {
+export const dtoSyncGroupMethodsNames = ["pull", "push", "twoWay"];
+export class DtoAPIError extends Error {
 }
 export class CatalogueAPI {
     constructor(_fetch = window.fetch.bind(window)) {
@@ -66,7 +66,7 @@ export class CatalogueAPI {
                 body = yield response.text();
                 const parsed = JSON.parse(body);
                 if ("error" in parsed) {
-                    err = new APIError(parsed.error);
+                    err = new DtoAPIError(parsed.error);
                     err.body = body;
                     err.status = response.status;
                     err.parsed = parsed;
@@ -77,7 +77,7 @@ export class CatalogueAPI {
             }
             catch (e) {
                 const msg = e instanceof Error ? e.message : `${e}`;
-                err = new APIError(msg);
+                err = new DtoAPIError(msg);
                 err.body = body;
                 err.status = response && response.status;
                 err.error = e instanceof Error ? e : Error(msg);
@@ -278,3 +278,16 @@ export class CatalogueAPI {
         });
     }
 }
+export const DTO_OPERATION_ID_TO_DEBIT_GROUP = {
+    postPublicAccessTokenAuthorize: "base",
+    getApplicationAreas: "base",
+    postExport: "export",
+    getPriceLists: "base",
+    getProduct: "base",
+    postRender: "render",
+    postValidate: "base",
+    getTocTree: "base",
+    getTocFlat: "base",
+    getExportById: "base",
+    getRenderById: "base",
+};

package/dist/CfgMeasure.d.ts

@@ -1,4 +1,4 @@
-import { Measurement, ValueWithUnit } from "./CatalogueAPI.js";
+import { DtoMeasurement, DtoValueWithUnit } from "./CatalogueAPI.js";
 /**
  * Measures can be used to Anchor items (Models or Additional Products).
  *
@@ -25,9 +25,9 @@ export declare type CfgMeasurePriority = {
  */
 export declare class CfgMeasureDefinition {
     readonly measureParamCode: string;
-    readonly numericValue: ValueWithUnit | undefined;
+    readonly numericValue: DtoValueWithUnit | undefined;
     readonly measurePriorities: CfgMeasurePriority[];
-    static make(measurement: Measurement): CfgMeasureDefinition | undefined;
+    static make(measurement: DtoMeasurement): CfgMeasureDefinition | undefined;
     private constructor();
 }
 //# sourceMappingURL=CfgMeasure.d.ts.map

package/dist/CfgProduct.d.ts

@@ -1,5 +1,5 @@
 import { AggregatedLoadingObservable, LengthUnit, Observable, SingleArgCallback } from "@configura/web-utilities";
-import { AdditionalProductConfiguration, AdditionalProductRef, CatalogueParams, MeasureParam, MtrlApplication, Prices, Transform } from "./CatalogueAPI.js";
+import { DtoAdditionalProductConfiguration, DtoAdditionalProductRef, DtoCatalogueParams, DtoConfProd, DtoMeasureParam, DtoMtrlApplication, DtoPrices, DtoProductParamsWithLang, DtoTransform } from "./CatalogueAPI.js";
 import { CfgMeasureDefinition } from "./CfgMeasure.js";
 import { _CfgFeatureInternal } from "./productConfiguration/CfgFeature.js";
 import { ProductConfigurationBubbleMode } from "./productConfiguration/CfgOption.js";
@@ -8,8 +8,16 @@ import { ProductLoader } from "./productLoader.js";
 import { SyncGroupsApplyMode } from "./syncGroups/SyncGroupsApplyMode.js";
 import { SyncGroupsHandler } from "./syncGroups/SyncGroupsHandler.js";
 import { CfgProductData, RootNodeSource } from "./utilitiesCatalogueData.js";
+/**
+ * @freshRef a new pointer to the same product, backed by the same original object
+ * @committed false is an indication that this is a potentially transient state. It could
+ * be the expected outcome of a SyncGroups transaction, or dragging to stretch a Product.
+ * Uncommitted notifications can be used to update for instance spinners, but should not
+ * be sent to server or such.
+ */
 export declare type CfgProductChangeNotification = {
     freshRef: CfgProduct;
+    committed: boolean;
 };
 export declare type CfgProductSettings = {
     /**
@@ -64,9 +72,7 @@ export declare type CfgPrice = {
  */
 export declare class _CfgProductInternal {
     readonly _productLoaderRaw: ProductLoader;
-    readonly lang: string;
-    readonly catId: CatalogueParams;
-    readonly partNumber: string;
+    readonly prodParams: DtoProductParamsWithLang;
     readonly settings: CfgProductSettings;
     readonly uuid: string;
     private readonly _rawUnit;
@@ -75,7 +81,7 @@ export declare class _CfgProductInternal {
     readonly parent: _CfgProductInternal | undefined;
     private _additionalProductRef;
     private readonly _syncGroupHandler;
-    static make: (productLoaderRaw: ProductLoader, productLoaderForGroupedLoad: ProductLoader | undefined, lang: string, catId: CatalogueParams, partNumber: string, settings: CfgProductSettings, optional: boolean, loadingObservable: AggregatedLoadingObservable, parent: _CfgProductInternal | undefined, root: _CfgProductInternal | undefined, additionalProductRef: AdditionalProductRef | undefined) => Promise<_CfgProductInternal>;
+    static make: (productLoaderRaw: ProductLoader, productLoaderForGroupedLoad: ProductLoader | undefined, prodParams: DtoProductParamsWithLang, settings: CfgProductSettings, optional: boolean, loadingObservable: AggregatedLoadingObservable, parent: _CfgProductInternal | undefined, root: _CfgProductInternal | undefined, additionalProductRef: DtoAdditionalProductRef | undefined) => Promise<_CfgProductInternal>;
     private constructor();
     readonly root: _CfgProductInternal;
     private _destroyed;
@@ -88,19 +94,19 @@ export declare class _CfgProductInternal {
     readonly isAdditionalProduct: boolean;
     clone(parent?: _CfgProductInternal, root?: _CfgProductInternal): Promise<_CfgProductInternal>;
     destroy: () => void;
-    _updateAdditionalProdRef(p: AdditionalProductRef): void;
+    _updateAdditionalProdRef(p: DtoAdditionalProductRef): void;
     get description(): string | undefined;
     get rootNodeSources(): RootNodeSource[] | undefined;
-    get mtrlApplications(): MtrlApplication[] | undefined;
+    get mtrlApplications(): DtoMtrlApplication[] | undefined;
     get currency(): string;
     get fractionDigits(): number;
-    get prices(): Prices | undefined;
+    get prices(): DtoPrices | undefined;
     private _measureDefinitions;
     get measureDefinitions(): CfgMeasureDefinition[];
     private _unit;
     get refKey(): string | undefined;
-    get transform(): Transform | undefined;
-    get anchor(): MeasureParam | undefined;
+    get transform(): DtoTransform | undefined;
+    get anchor(): DtoMeasureParam | undefined;
     /** @throws an error if the actual unit sent by the server was not a LengthUnit */
     get unit(): LengthUnit;
     get aggregatedPrice(): CfgPrice;
@@ -123,15 +129,16 @@ export declare class _CfgProductInternal {
      * It does not affect the visibility of anything in the 3D view at all.
      */
     get visible(): boolean;
-    _notifyAllOfChange: (bubbleMode: CfgProductBubbleMode) => Promise<void>;
+    _notifyAllOfChange: (bubbleMode: CfgProductBubbleMode, committed: boolean) => Promise<void>;
     /** Called when a child (additional product or the configuration) has changed. */
     private _childHasChanged;
     /** Called by child to tell its parent that it has changed. */
-    _additionalProductHasChanged: (freshRef: CfgProduct, bubbleMode: CfgProductBubbleMode) => Promise<void>;
+    _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) => Promise<void>;
-    getApiSelection: () => AdditionalProductConfiguration;
-    setApiSelection: (s: AdditionalProductConfiguration, doValidate: boolean, productLoaderForGroupedLoad?: ProductLoader | undefined) => Promise<boolean>;
+    _configurationHasChanged: (freshRef: CfgProductConfiguration, bubbleMode: ProductConfigurationBubbleMode, committed: boolean) => Promise<void>;
+    getDtoConf: (includeExtendedData: boolean, includeProductParams: boolean) => DtoConfProd;
+    setDtoConf: (s: DtoConfProd, 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;
     get syncGroupHandler(): SyncGroupsHandler | undefined;
@@ -150,7 +157,7 @@ export declare class _CfgProductInternal {
      * product in isolation. The validation result is applied on the configuration. Then additional
      * products are synced (unloaded, loaded etc.) Finally the changes bubble up the tree.
      */
-    _revalidate: (bubbleMode: CfgProductBubbleMode, productLoader: ProductLoader) => Promise<boolean>;
+    _revalidate: (bubbleMode: CfgProductBubbleMode, productLoader: ProductLoader, committed: boolean) => Promise<boolean>;
     /**
      * Based on this configuration find what additional products should be shown and not, unload
      * (i.e. destroy) those that should no longer be shown, load the new ones.
@@ -159,7 +166,7 @@ export declare class _CfgProductInternal {
 }
 export declare class CfgProduct {
     readonly _internal: _CfgProductInternal;
-    static make(productLoader: ProductLoader, lang: string, catId: CatalogueParams, partNumber: string, settings?: Partial<CfgProductSettings>): Promise<CfgProduct>;
+    static make(productLoader: ProductLoader, prodParams: DtoProductParamsWithLang, settings?: Partial<CfgProductSettings>): Promise<CfgProduct>;
     /**
      * Makes an object wrapping the passed object. This is not a clone method, it is a method to
      * make a new outer reference. Like a shallow copy. We use this to help frameworks that are
@@ -186,8 +193,9 @@ export declare class CfgProduct {
      * It will be unique amongst child products, but not globally unique.
      */
     get refKey(): string | undefined;
+    get prodParams(): DtoProductParamsWithLang;
     get lang(): string;
-    get catId(): CatalogueParams;
+    get catId(): DtoCatalogueParams;
     get partNumber(): string;
     get isAdditionalProduct(): boolean;
     /** Only used when this product is an additional product. Root products are never optional. */
@@ -220,7 +228,7 @@ export declare class CfgProduct {
     get description(): string | undefined;
     get additionalProducts(): CfgProduct[];
     get configuration(): CfgProductConfiguration;
-    get transform(): Transform | undefined;
+    get transform(): DtoTransform | undefined;
     get currency(): string;
     /**
      * If positive the number of fraction digits.
@@ -247,8 +255,10 @@ export declare class CfgProduct {
      * 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.
      */
-    getApiSelection: () => AdditionalProductConfiguration;
-    setApiSelection: (s: AdditionalProductConfiguration, doValidate?: boolean) => Promise<boolean>;
+    getApiSelection: () => DtoAdditionalProductConfiguration;
+    getDtoConf: (includeExtendedData?: boolean, includeProductParams?: boolean) => DtoConfProd;
+    setDtoConf: (s: DtoConfProd, doValidate?: boolean) => Promise<boolean>;
+    setApiSelection: (s: DtoAdditionalProductConfiguration, doValidate?: boolean) => Promise<boolean>;
     listenForChange: (l: SingleArgCallback<CfgProductChangeNotification>) => void;
     stopListenForChange: (l: SingleArgCallback<CfgProductChangeNotification>) => void;
     stopAllListenForChange: () => void;

package/dist/CfgProduct.js

@@ -9,6 +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 { convertDtoConfProdToV1 } from "./ConfigurationConverter.js";
 import { ProductConfigurationBubbleMode } from "./productConfiguration/CfgOption.js";
 import { CfgProductConfiguration } from "./productConfiguration/CfgProductConfiguration.js";
 import { collectAdditionalProductRefs } from "./productConfiguration/utilitiesProductConfiguration.js";
@@ -51,12 +52,10 @@ function isDescriptionMatch(l, r) {
  * the class that should be used and interacted with.
  */
 export class _CfgProductInternal {
-    constructor(initSuccess, initFail, _productLoaderRaw, lang, catId, partNumber, settings, optional, selected, rootFeatureRefs, allRawFeatures, uuid, _rawUnit, _rawProductData, apiSelection, loadingObservable, parent, root, _additionalProductRef, _syncGroupHandler) {
+    constructor(initSuccess, initFail, _productLoaderRaw, prodParams, settings, optional, selected, rootFeatureRefs, allRawFeatures, uuid, _rawUnit, _rawProductData, apiSelection, loadingObservable, parent, root, _additionalProductRef, _syncGroupHandler) {
         var _a;
         this._productLoaderRaw = _productLoaderRaw;
-        this.lang = lang;
-        this.catId = catId;
-        this.partNumber = partNumber;
+        this.prodParams = prodParams;
         this.settings = settings;
         this.uuid = uuid;
         this._rawUnit = _rawUnit;
@@ -76,31 +75,31 @@ export class _CfgProductInternal {
                 additionalProduct.destroy();
             }
         };
-        this._notifyAllOfChange = (bubbleMode) => __awaiter(this, void 0, void 0, function* () {
+        this._notifyAllOfChange = (bubbleMode, committed) => __awaiter(this, void 0, void 0, function* () {
             if (bubbleMode === CfgProductBubbleMode.Stop) {
                 return;
             }
             const parent = this.parent;
             const freshRef = CfgProduct._makeNewRefFrom(this);
-            this.changeObservable.notifyAll({ freshRef });
+            this.changeObservable.notifyAll({ freshRef, committed });
             if (parent !== undefined) {
                 yield parent._additionalProductHasChanged(freshRef, bubbleMode === CfgProductBubbleMode.OneLevel
                     ? CfgProductBubbleMode.Stop
-                    : bubbleMode);
+                    : bubbleMode, committed);
             }
         });
         /** Called when a child (additional product or the configuration) has changed. */
-        this._childHasChanged = (bubbleMode) => __awaiter(this, void 0, void 0, function* () {
+        this._childHasChanged = (bubbleMode, committed) => __awaiter(this, void 0, void 0, function* () {
             if (bubbleMode === CfgProductBubbleMode.ToRootAndBubbleSelected &&
                 this.optional &&
                 !this.selected) {
                 yield this.setSelected(true, bubbleMode);
                 return;
             }
-            yield this._notifyAllOfChange(bubbleMode);
+            yield this._notifyAllOfChange(bubbleMode, committed);
         });
         /** Called by child to tell its parent that it has changed. */
-        this._additionalProductHasChanged = (freshRef, bubbleMode) => __awaiter(this, void 0, void 0, function* () {
+        this._additionalProductHasChanged = (freshRef, bubbleMode, committed) => __awaiter(this, void 0, void 0, function* () {
             const i = this.additionalProducts.findIndex((a) => a.isBackedBySame(freshRef));
             if (i !== -1) {
                 // Child additional product might not be found. This probably means that propagate
@@ -110,48 +109,67 @@ export class _CfgProductInternal {
                 // C no longer is part of the tree. Odd, but fully permitted.
                 this.additionalProducts[i] = freshRef;
             }
-            yield this._childHasChanged(bubbleMode);
+            yield this._childHasChanged(bubbleMode, committed);
         });
         /** Called by the configuration to tell its parent that it has changed. */
-        this._configurationHasChanged = (freshRef, bubbleMode) => __awaiter(this, void 0, void 0, function* () {
+        this._configurationHasChanged = (freshRef, bubbleMode, committed) => __awaiter(this, void 0, void 0, function* () {
             this._configuration = freshRef;
             switch (bubbleMode) {
                 case ProductConfigurationBubbleMode.ValidateAndBubbleSelected:
                     // The revalidate call will continue the bubble
-                    yield this._revalidate(CfgProductBubbleMode.ToRootAndBubbleSelected, this._productLoaderRaw);
+                    yield this._revalidate(CfgProductBubbleMode.ToRootAndBubbleSelected, this._productLoaderRaw, committed);
                     return;
                 case ProductConfigurationBubbleMode.BubbleSelected:
-                    yield this._childHasChanged(CfgProductBubbleMode.ToRootAndBubbleSelected);
+                    yield this._childHasChanged(CfgProductBubbleMode.ToRootAndBubbleSelected, committed);
                     return;
                 case ProductConfigurationBubbleMode.Validate:
                     // The revalidate call will continue the bubble
-                    yield this._revalidate(CfgProductBubbleMode.ToRoot, this._productLoaderRaw);
+                    yield this._revalidate(CfgProductBubbleMode.ToRoot, this._productLoaderRaw, committed);
                     return;
                 case ProductConfigurationBubbleMode.ToParentProduct:
                     // Do not continue bubble as we have reached the parent CfgProduct
                     return;
                 case ProductConfigurationBubbleMode.OneLevel:
-                    yield this._childHasChanged(CfgProductBubbleMode.OneLevel);
+                    yield this._childHasChanged(CfgProductBubbleMode.OneLevel, committed);
                     return;
                 case ProductConfigurationBubbleMode.Stop:
-                    yield this._childHasChanged(CfgProductBubbleMode.Stop);
+                    yield this._childHasChanged(CfgProductBubbleMode.Stop, committed);
                     return;
                 case ProductConfigurationBubbleMode.ToRoot:
-                    yield this._childHasChanged(CfgProductBubbleMode.ToRoot);
+                    yield this._childHasChanged(CfgProductBubbleMode.ToRoot, committed);
                     return;
             }
         });
-        this.getApiSelection = () => ({
-            refKey: this.refKey,
-            selected: this.selected,
-            selOptions: this.configuration.getApiSelection(),
-            additionalProducts: this.additionalProducts.map((additionalProduct) => additionalProduct.getApiSelection()),
-        });
+        this.getDtoConf = (includeExtendedData, includeProductParams) => {
+            const conf = {};
+            const features = this.configuration._internal.getDtoConf(includeExtendedData);
+            if (0 < features.length) {
+                conf.features = features;
+            }
+            if (includeProductParams) {
+                conf.prodParams = this.prodParams;
+            }
+            const additionalProducts = this.additionalProducts;
+            if (0 < additionalProducts.length) {
+                conf.additionalProducts = additionalProducts.map((p) => p._internal.getDtoConf(includeExtendedData, includeProductParams));
+            }
+            if (this.isAdditionalProduct) {
+                const refKey = this.refKey;
+                if (refKey === undefined) {
+                    throw new Error("AdditionalProduct without refKey, this should not happen");
+                }
+                const confAddProd = conf;
+                confAddProd.refKey = refKey;
+                confAddProd.selected = this.selected;
+            }
+            return conf;
+        };
+        this.setDtoConf = (s, doValidate, productLoaderForGroupedLoad) => this.setApiSelection(convertDtoConfProdToV1(s), doValidate, productLoaderForGroupedLoad);
         this.setApiSelection = (s, doValidate, productLoaderForGroupedLoad) => __awaiter(this, void 0, void 0, function* () {
             return this._setApiSelectionWithOtherProduct(s, doValidate, productLoaderForGroupedLoad, undefined);
         });
         this.copyFrom = (source, doValidate, productLoaderForGroupedLoad) => __awaiter(this, void 0, void 0, function* () {
-            return yield this._setApiSelectionWithOtherProduct(source.getApiSelection(), doValidate, productLoaderForGroupedLoad, source);
+            return yield this._setApiSelectionWithOtherProduct(convertDtoConfProdToV1(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
@@ -203,13 +221,13 @@ export class _CfgProductInternal {
                 change = true;
             }
             if (doValidate && configurationChange) {
-                yield this._revalidate(CfgProductBubbleMode.ToRoot, productLoaderForGroupedLoad);
+                yield this._revalidate(CfgProductBubbleMode.ToRoot, productLoaderForGroupedLoad, true);
             }
             else if (change) {
                 // As setApiSelection is done recursively each level takes care of its own notifications
                 // so we only need to bubble one level to notify this and swap out the reference in the
                 // parent.
-                yield this._notifyAllOfChange(CfgProductBubbleMode.OneLevel);
+                yield this._notifyAllOfChange(CfgProductBubbleMode.OneLevel, true);
             }
             return change;
         });
@@ -235,10 +253,10 @@ export class _CfgProductInternal {
             const configurationChange = yield this.configuration._internal.tryMatchSelection(other.configuration._internal, descriptionMatch, false);
             if (configurationChange) {
                 change = true;
-                yield this._revalidate(CfgProductBubbleMode.ToRootAndBubbleSelected, productLoaderForGroupedLoad);
+                yield this._revalidate(CfgProductBubbleMode.ToRootAndBubbleSelected, productLoaderForGroupedLoad, true);
             }
             else if (change) {
-                yield this._notifyAllOfChange(CfgProductBubbleMode.ToRootAndBubbleSelected);
+                yield this._notifyAllOfChange(CfgProductBubbleMode.ToRootAndBubbleSelected, true);
             }
             const thisAdditionalProducts = this.additionalProducts;
             const otherAdditionalProducts = other.additionalProducts;
@@ -287,12 +305,12 @@ export class _CfgProductInternal {
          * product in isolation. The validation result is applied on the configuration. Then additional
          * products are synced (unloaded, loaded etc.) Finally the changes bubble up the tree.
          */
-        this._revalidate = (bubbleMode, productLoader) => __awaiter(this, void 0, void 0, function* () {
+        this._revalidate = (bubbleMode, productLoader, committed) => __awaiter(this, void 0, void 0, function* () {
             const { _configuration: configuration } = this;
             const token = this.loadingObservable.startChildLoading();
             this._revalidateInProgressToken = token;
             try {
-                const response = yield productLoader.postValidate(Object.assign(Object.assign({ lang: this.lang }, correctDefaultsOnCatalogueParams(this.catId)), { partNumber: this.partNumber }), { selOptions: configuration.getApiSelection() });
+                const response = yield productLoader.postValidate(correctDefaultsOnCatalogueParams(this.prodParams), { selOptions: configuration.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
@@ -326,7 +344,7 @@ export class _CfgProductInternal {
                 if (this._destroyed) {
                     return false;
                 }
-                yield this._notifyAllOfChange(bubbleMode);
+                yield this._notifyAllOfChange(bubbleMode, committed);
                 return true;
             }
             catch (e) {
@@ -341,7 +359,7 @@ export class _CfgProductInternal {
          * (i.e. destroy) those that should no longer be shown, load the new ones.
          */
         this._syncAndLoadAdditionalProducts = (productLoaderForGroupedLoad) => __awaiter(this, void 0, void 0, function* () {
-            const { lang, _productLoaderRaw: productLoaderRaw, rawProductData: productData, configuration, additionalProducts: currentAdditionalProducts, } = this;
+            const { _productLoaderRaw: productLoaderRaw, rawProductData: productData, configuration, additionalProducts: currentAdditionalProducts, } = this;
             const additionalProductRefs = [
                 ...(productData.additionalProductRefs || []),
                 ...collectAdditionalProductRefs(configuration),
@@ -385,7 +403,7 @@ export class _CfgProductInternal {
                     const additionalProductRef = p.prodRef;
                     return {
                         originalIndex: p.originalIndex,
-                        product: CfgProduct._makeNewRefFrom(yield _CfgProductInternal.make(productLoaderRaw, productLoaderForGroupedLoad, lang, additionalProductRef.catId, additionalProductRef.partNumber, this.settings, additionalProductRef.optional === true, this.loadingObservable, this, this.root, additionalProductRef)),
+                        product: CfgProduct._makeNewRefFrom(yield _CfgProductInternal.make(productLoaderRaw, productLoaderForGroupedLoad, Object.assign(Object.assign({}, additionalProductRef.catId), { cid: this.prodParams.cid, lang: this.prodParams.lang, partNumber: additionalProductRef.partNumber }), this.settings, additionalProductRef.optional === true, this.loadingObservable, this, this.root, additionalProductRef)),
                     };
                 }))()));
                 if (this._destroyed) {
@@ -401,7 +419,7 @@ export class _CfgProductInternal {
             }
         });
         this.root = root !== null && root !== void 0 ? root : this;
-        this.key = makeProductKey(catId, (_a = _additionalProductRef === null || _additionalProductRef === void 0 ? void 0 : _additionalProductRef.refKey) !== null && _a !== void 0 ? _a : partNumber);
+        this.key = makeProductKey(prodParams, (_a = _additionalProductRef === null || _additionalProductRef === void 0 ? void 0 : _additionalProductRef.refKey) !== null && _a !== void 0 ? _a : prodParams.partNumber);
         this._selected = optional ? selected : undefined;
         this.isAdditionalProduct = parent !== undefined;
         this._configuration = CfgProductConfiguration.make(initSuccess, initFail, rootFeatureRefs, allRawFeatures, apiSelection, this, this.root);
@@ -415,7 +433,7 @@ export class _CfgProductInternal {
                 var _a;
                 const p = new _CfgProductInternal(() => {
                     initSuccess(p);
-                }, initFail, this._productLoaderRaw, this.lang, this.catId, this.partNumber, 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.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)));
@@ -513,7 +531,7 @@ export class _CfgProductInternal {
                 return false;
             }
             this._selected = v;
-            yield this._notifyAllOfChange(bubbleMode);
+            yield this._notifyAllOfChange(bubbleMode, true);
             return true;
         });
     }
@@ -565,7 +583,7 @@ export class _CfgProductInternal {
     }
 }
 _CfgProductInternal.make = (productLoaderRaw, productLoaderForGroupedLoad, // Used when instantiating the current product
-lang, catId, partNumber, settings, optional, loadingObservable, parent, root, additionalProductRef) => __awaiter(void 0, void 0, void 0, function* () {
+prodParams, settings, optional, loadingObservable, parent, root, additionalProductRef) => __awaiter(void 0, void 0, void 0, function* () {
     // Wrap with cache will make getProduct for this function call use the same server call
     // for the same product with the same params. Not retained for future calls, only used
     // at this initial load.
@@ -575,7 +593,7 @@ lang, catId, partNumber, settings, optional, loadingObservable, parent, root, ad
         ? SyncGroupsHandler.make(settings.syncGroupsApplyMode, loadingObservable)
         : undefined;
     try {
-        const productResponse = yield productLoaderForGroupedLoad.getProduct(Object.assign(Object.assign({ lang }, correctDefaultsOnCatalogueParams(catId)), { partNumber }));
+        const productResponse = yield productLoaderForGroupedLoad.getProduct(correctDefaultsOnCatalogueParams(prodParams));
         const { productData, rootFeatureRefs, features: allRawFeatures, uuid, unit, } = productResponse;
         const product = yield new Promise((initSuccess, initFail) => {
             const p = new _CfgProductInternal(() => {
@@ -583,7 +601,7 @@ lang, catId, partNumber, settings, optional, loadingObservable, parent, root, ad
                 // But we can not set the api selection synchronously. And the product configuration needs "this". So we use this callback.
                 // Feel free to find a nicer more readable solution :)
                 initSuccess(p);
-            }, initFail, productLoaderRaw, lang, catId, partNumber, settings, optional, !optional, rootFeatureRefs, allRawFeatures, uuid, unit, productData, productData.partsData.selOptions || [], loadingObservable, parent, root, additionalProductRef, syncGroupHandler);
+            }, initFail, productLoaderRaw, prodParams, settings, optional, !optional, rootFeatureRefs, allRawFeatures, uuid, unit, productData, productData.partsData.selOptions || [], loadingObservable, parent, root, additionalProductRef, syncGroupHandler);
         });
         yield product._syncAndLoadAdditionalProducts(productLoaderForGroupedLoad);
         // Product is guaranteed to be root
@@ -631,7 +649,9 @@ export class CfgProduct {
          * 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.
          */
-        this.getApiSelection = () => this._internal.getApiSelection();
+        this.getApiSelection = () => convertDtoConfProdToV1(this._internal.getDtoConf(false, false), true);
+        this.getDtoConf = (includeExtendedData = false, includeProductParams = false) => this._internal.getDtoConf(includeExtendedData, includeProductParams);
+        this.setDtoConf = (s, doValidate = false) => __awaiter(this, void 0, void 0, function* () { return yield this._internal.setDtoConf(s, doValidate); });
         this.setApiSelection = (s, doValidate = false) => __awaiter(this, void 0, void 0, function* () { return yield this._internal.setApiSelection(s, doValidate); });
         this.listenForChange = (l) => this._internal.changeObservable.listen(l);
         this.stopListenForChange = (l) => this._internal.changeObservable.stopListen(l);
@@ -640,9 +660,9 @@ export class CfgProduct {
         this.stopListenForLoading = (l) => this._internal.loadingObservable.stopListen(l);
         this.stopAllListenForLoading = () => this._internal.loadingObservable.stopAllListen();
     }
-    static make(productLoader, lang, catId, partNumber, settings) {
+    static make(productLoader, prodParams, settings) {
         return __awaiter(this, void 0, void 0, function* () {
-            return this._makeNewRefFrom(yield _CfgProductInternal.make(productLoader, undefined, lang, catId, partNumber, completeSettings(settings), false, new AggregatedLoadingObservable(), undefined, undefined, undefined));
+            return this._makeNewRefFrom(yield _CfgProductInternal.make(productLoader, undefined, prodParams, completeSettings(settings), false, new AggregatedLoadingObservable(), undefined, undefined, undefined));
         });
     }
     /**
@@ -668,14 +688,25 @@ export class CfgProduct {
     get refKey() {
         return this._internal.refKey;
     }
+    get prodParams() {
+        return this._internal.prodParams;
+    }
     get lang() {
-        return this._internal.lang;
+        return this._internal.prodParams.lang;
     }
     get catId() {
-        return this._internal.catId;
+        const { cid, enterprise, prdCat, prdCatVersion, priceList, vendor } = this._internal.prodParams;
+        return {
+            cid,
+            enterprise,
+            prdCat,
+            prdCatVersion,
+            priceList,
+            vendor,
+        };
     }
     get partNumber() {
-        return this._internal.partNumber;
+        return this._internal.prodParams.partNumber;
     }
     get isAdditionalProduct() {
         return this._internal.isAdditionalProduct;

package/dist/CfgReferencePathHelper.d.ts

@@ -0,0 +1,14 @@
+import { DtoCatalogueParamsWithLang, DtoProductParamsWithLang } from "./CatalogueAPI";
+/**
+ * These methods aims to provide a default suggested way of building
+ * URLs to Products and Catalogues. By using consistent URL:s copy-paste
+ * between systems becomes easy and this can aid when debugging.
+ * Using this format on URL is no requirement. In fact, most of our
+ * integrators do not, as they do not expose the Catalogue-path.
+ * Internally at Configura we try to stick with this format.
+ */
+export declare class CfgReferencePathHelper {
+    static getCataloguePath: (browsingRootUrl: string, catParams: DtoCatalogueParamsWithLang) => string;
+    static getProductPath: (browsingRootUrl: string, productParams: DtoProductParamsWithLang) => string;
+}
+//# sourceMappingURL=CfgReferencePathHelper.d.ts.map

package/dist/CfgReferencePathHelper.js

@@ -0,0 +1,13 @@
+import { encodeURIComponents } from "@configura/web-utilities";
+/**
+ * These methods aims to provide a default suggested way of building
+ * URLs to Products and Catalogues. By using consistent URL:s copy-paste
+ * between systems becomes easy and this can aid when debugging.
+ * Using this format on URL is no requirement. In fact, most of our
+ * integrators do not, as they do not expose the Catalogue-path.
+ * Internally at Configura we try to stick with this format.
+ */
+export class CfgReferencePathHelper {
+}
+CfgReferencePathHelper.getCataloguePath = (browsingRootUrl, catParams) => `${browsingRootUrl}/${encodeURIComponents(catParams.cid, catParams.lang, catParams.enterprise, catParams.prdCat, catParams.prdCatVersion, catParams.vendor, catParams.priceList)}`;
+CfgReferencePathHelper.getProductPath = (browsingRootUrl, productParams) => `${CfgReferencePathHelper.getCataloguePath(browsingRootUrl, productParams)}/product/${encodeURIComponent(productParams.partNumber)}`;

package/dist/ConfigurationConverter.d.ts

@@ -0,0 +1,5 @@
+import { DtoAdditionalProductConfiguration, DtoConfAddProd, DtoConfFeature, DtoConfProd, DtoSelectedOption } from "./CatalogueAPI.js";
+export declare const isDtoConfProdAdditional: (value: DtoConfProd) => value is DtoConfAddProd;
+export declare const convertDtoConfProdToV1: (conf: DtoConfProd, silenceWarnings?: boolean) => DtoAdditionalProductConfiguration;
+export declare const convertDtoConfFeaturesToSelOptions: (features: DtoConfFeature[], silenceWarnings?: boolean) => DtoSelectedOption[];
+//# sourceMappingURL=ConfigurationConverter.d.ts.map