@configura/web-api 2.0.0-alpha.9 → 2.1.0-alpha.0

package/.eslintrc.json

@@ -1,18 +1,5 @@
 {
 	"parser": "@typescript-eslint/parser",
 	"plugins": ["@typescript-eslint"],
-	"extends": [
-		"eslint:recommended",
-		"plugin:@typescript-eslint/recommended",
-		"prettier"
-
-		// TODO: Type-checking rules require a proper tsconfig-file to work,
-		//       pointed at by the parserOption.project setting.
-		//
-		//"plugin:@typescript-eslint/recommended-requiring-type-checking"
-	]
-	//"rules": { "@typescript-eslint/no-floating-promises": "error" }
-	//"parserOptions": {
-	//	"project": "./tsconfig.json"
-	//}
+	"extends": ["eslint:recommended", "plugin:@typescript-eslint/recommended", "prettier"]
 }

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;
@@ -44,22 +44,22 @@ export interface DtoCatalogueAPISession {
     features?: Array<string>;
     permissions?: Array<DtoCataloguePermission>;
 }
-/** CatalogueParams */
-export interface DtoCatalogueParams extends DtoCatalogueParamsWithoutCid {
-    cid: number;
-}
-/** CatalogueParamsWithLang */
-export interface DtoCatalogueParamsWithLang extends DtoCatalogueParams {
-    lang: string;
-}
-/** CatalogueParamsWithoutCid */
-export interface DtoCatalogueParamsWithoutCid {
+/** CatalogueParams - 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 DtoCatalogueParams {
     enterprise: string;
     prdCat: string;
     prdCatVersion: string;
     vendor: string;
     priceList: string;
 }
+/** CatalogueParamsWithCid */
+export interface DtoCatalogueParamsWithCid extends DtoCatalogueParams {
+    cid: number;
+}
+/** CatalogueParamsWithCidAndLang */
+export interface DtoCatalogueParamsWithCidAndLang extends DtoCatalogueParamsWithCid {
+    lang: string;
+}
 /** CataloguePermission */
 export interface DtoCataloguePermission {
     cid: number;
@@ -119,6 +119,7 @@ export interface DtoFeature {
     mtrlApplications?: Array<DtoMtrlApplication>;
     multiple?: boolean;
     numericOrder: boolean;
+    omitOnOrder?: boolean;
     optional?: boolean;
     options: Array<DtoOption>;
     hideIfMainProduct?: boolean;
@@ -126,13 +127,14 @@ export interface DtoFeature {
     measureParams?: Array<DtoMeasureParam>;
     syncGroup?: DtoSyncGroup;
     unit?: string;
+    noteRefs?: Array<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 {
@@ -163,6 +165,16 @@ export interface DtoGetPriceListsParams {
     vendor: string;
     priceList: string;
 }
+/** GetProductLegacyV2Params represents the URL parameters of getProductLegacyV2 */
+export interface DtoGetProductLegacyV2Params {
+    lang: string;
+    enterprise: string;
+    prdCat: string;
+    prdCatVersion: string;
+    vendor: string;
+    priceList: string;
+    partNumber: string;
+}
 /** GetProductParams represents the URL parameters of getProduct */
 export interface DtoGetProductParams {
     lang: string;
@@ -222,6 +234,12 @@ export interface DtoMeasureParam {
 export interface DtoMeasurePriority {
     url: string;
 }
+/** MiscFile */
+export interface DtoMiscFile {
+    key: string;
+    url: string;
+    preview?: string;
+}
 /** Model */
 export interface DtoModel {
     cid: number;
@@ -236,6 +254,17 @@ export interface DtoMtrlApplication {
     preview?: string;
     cid?: number;
 }
+/** Note */
+export interface DtoNote {
+    code: string;
+    severity?: DtoNoteSeverity;
+    key?: string;
+    title?: string;
+    body: string;
+}
+/** NoteSeverity - WIP */
+export declare type DtoNoteSeverity = "Information" | "Critical" | "Warning";
+export declare const dtoNoteSeverityNames: DtoNoteSeverity[];
 /** Option */
 export interface DtoOption {
     additionalProductRefs?: Array<DtoAdditionalProductRef>;
@@ -247,13 +276,15 @@ export interface DtoOption {
     codeRanges?: Array<DtoCodeRange>;
     upcharge?: number;
     priceCodes?: Array<string>;
+    noteRefs?: Array<string>;
+    miscFiles?: Array<DtoMiscFile>;
 }
-/** OptionConfiguration */
-export interface DtoOptionConfiguration {
+/** OptionConf */
+export interface DtoOptionConf {
     code: string;
     selected: boolean;
     numericValue?: DtoValueWithUnit;
-    features?: Array<DtoFeatureConfiguration>;
+    features?: Array<DtoFeatureConf>;
 }
 /** Orientation */
 export interface DtoOrientation {
@@ -314,6 +345,16 @@ export interface DtoPostRenderParams {
     priceList: string;
     partNumber: string;
 }
+/** PostValidateLegacyV1Params represents the URL parameters of postValidateLegacyV1 */
+export interface DtoPostValidateLegacyV1Params {
+    lang: string;
+    enterprise: string;
+    prdCat: string;
+    prdCatVersion: string;
+    vendor: string;
+    priceList: string;
+    partNumber: string;
+}
 /** PostValidateParams represents the URL parameters of postValidate */
 export interface DtoPostValidateParams {
     lang: string;
@@ -353,11 +394,12 @@ export interface DtoProductCatalogueInfo {
     exchangeRate: number;
     lastModified: string;
 }
-/** ProductConfiguration */
-export interface DtoProductConfiguration {
-    features?: Array<DtoFeatureConfiguration>;
-    additionalProducts?: Array<DtoAdditionalProductConfigurationV2>;
-    prodParams?: DtoProductParamsWithLang;
+/** 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?: DtoProductParamsWithCidAndLang;
+    syncGroupState?: DtoSyncGroupState;
 }
 /** ProductData */
 export interface DtoProductData {
@@ -382,13 +424,15 @@ export interface DtoProductData {
     width?: string;
     models?: Array<DtoModel>;
     partsData: DtoPartsData;
+    noteRefs?: Array<string>;
+    miscFiles?: Array<DtoMiscFile>;
 }
-/** ProductParams */
-export interface DtoProductParams extends DtoCatalogueParams {
+/** ProductParamsWithCid */
+export interface DtoProductParamsWithCid extends DtoCatalogueParamsWithCid {
     partNumber: string;
 }
-/** ProductParamsWithLang */
-export interface DtoProductParamsWithLang extends DtoProductParams {
+/** ProductParamsWithCidAndLang */
+export interface DtoProductParamsWithCidAndLang extends DtoProductParamsWithCid {
     lang: string;
 }
 /** ProductRef */
@@ -409,6 +453,7 @@ export interface DtoProductResponse {
     productData: DtoProductData;
     unit: string;
     uuid: string;
+    notes?: Array<DtoNote>;
 }
 /** RefreshSessionTokenResponse */
 export interface DtoRefreshSessionTokenResponse {
@@ -462,6 +507,20 @@ export interface DtoSyncGroup {
 /** SyncGroupMethods */
 export declare type DtoSyncGroupMethods = "pull" | "push" | "twoWay";
 export declare const dtoSyncGroupMethodsNames: DtoSyncGroupMethods[];
+/** SyncGroupState */
+export interface DtoSyncGroupState {
+    selectOne?: Array<DtoSyncToOptionCode>;
+    selectMany?: Array<DtoSyncToOptionCodeToSelected>;
+}
+/** SyncToOptionCode */
+export interface DtoSyncToOptionCode {
+    syncCode: string;
+    optionCode: string;
+}
+/** SyncToOptionCodeToSelected */
+export interface DtoSyncToOptionCodeToSelected extends DtoSyncToOptionCode {
+    selected: boolean;
+}
 /** TargetCameraArgs */
 export interface DtoTargetCameraArgs {
     location?: DtoPoint;
@@ -489,11 +548,21 @@ export interface DtoTransform {
     rot: DtoOrientation;
 }
 /** ValidateRequest */
-export interface DtoValidateRequest {
+export interface DtoValidateRequest extends DtoValidateRequestLegacyV1 {
+    knownFeatureCodes: Array<string>;
+}
+/** ValidateRequestLegacyV1 */
+export interface DtoValidateRequestLegacyV1 {
     selOptions: Array<DtoSelectedOption>;
 }
 /** ValidateResponse */
-export interface DtoValidateResponse {
+export interface DtoValidateResponse extends DtoValidateResponseLegacyV1 {
+    features: Array<DtoFeature>;
+    unit: string;
+    notes?: Array<DtoNote>;
+}
+/** ValidateResponseLegacyV1 */
+export interface DtoValidateResponseLegacyV1 {
     productData: DtoProductData;
     uuid: string;
     validated: boolean;
@@ -536,8 +605,10 @@ export declare class CatalogueAPI {
     getApplicationAreas(params: DtoGetApplicationAreasParams): Promise<DtoApplicationAreasResponse>;
     postExport(params: DtoPostExportParams, body: DtoExportRequest): Promise<DtoExportResponse>;
     getPriceLists(params: DtoGetPriceListsParams): Promise<DtoPriceListsResponse>;
+    getProductLegacyV2(params: DtoGetProductLegacyV2Params): Promise<DtoProductResponse>;
     getProduct(params: DtoGetProductParams): Promise<DtoProductResponse>;
     postRender(params: DtoPostRenderParams, body: DtoRenderRequest): Promise<DtoRenderResponse>;
+    postValidateLegacyV1(params: DtoPostValidateLegacyV1Params, body: DtoValidateRequestLegacyV1): Promise<DtoValidateResponseLegacyV1>;
     postValidate(params: DtoPostValidateParams, body: DtoValidateRequest): Promise<DtoValidateResponse>;
     getTocTree(params: DtoGetTocTreeParams): Promise<DtoTOCResponse>;
     getTocFlat(params: DtoGetTocFlatParams): Promise<DtoTOCResponse>;

package/dist/CatalogueAPI.js

@@ -9,10 +9,29 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-export const dtoExportFormatNames = ["glb", "gltf", "fbx", "dwg", "cmdrw", "cmfav", "cmsym"];
-export const dtoExportStatusStatusNames = ["pending", "running", "finished", "failed"];
+export const dtoExportFormatNames = [
+    "glb",
+    "gltf",
+    "fbx",
+    "dwg",
+    "cmdrw",
+    "cmfav",
+    "cmsym",
+];
+export const dtoExportStatusStatusNames = [
+    "pending",
+    "running",
+    "finished",
+    "failed",
+];
+export const dtoNoteSeverityNames = ["Information", "Critical", "Warning"];
 export const dtoRenderFormatNames = ["jpg", "png"];
-export const dtoRenderStatusStatusNames = ["pending", "running", "finished", "failed"];
+export const dtoRenderStatusStatusNames = [
+    "pending",
+    "running",
+    "finished",
+    "failed",
+];
 export const dtoSyncGroupMethodsNames = ["pull", "push", "twoWay"];
 export class DtoAPIError extends Error {
 }
@@ -31,7 +50,9 @@ export class CatalogueAPI {
         }
     }
     hasFeature(feature) {
-        return this.auth !== undefined && this.auth.apiSession.features !== undefined && this.auth.apiSession.features.indexOf(feature) > -1;
+        return (this.auth !== undefined &&
+            this.auth.apiSession.features !== undefined &&
+            this.auth.apiSession.features.indexOf(feature) > -1);
     }
     fetch(url, options) {
         return __awaiter(this, void 0, void 0, function* () {
@@ -127,7 +148,7 @@ export class CatalogueAPI {
             return this.fetch(this.auth.endpoint + url, options);
         });
     }
-    getProduct(params) {
+    getProductLegacyV2(params) {
         return __awaiter(this, void 0, void 0, function* () {
             if (this.auth === undefined) {
                 throw new Error("missing auth");
@@ -143,6 +164,22 @@ export class CatalogueAPI {
             return this.fetch(this.auth.endpoint + url, options);
         });
     }
+    getProduct(params) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this.auth === undefined) {
+                throw new Error("missing auth");
+            }
+            const url = `/v1/catalogue/${encodeURIComponent(params.lang)}/${encodeURIComponent(params.enterprise)}/${encodeURIComponent(params.prdCat)}/${encodeURIComponent(params.prdCatVersion)}/${encodeURIComponent(params.vendor)}/${encodeURIComponent(params.priceList)}/product-v3/${encodeURIComponent(params.partNumber)}`;
+            const options = {
+                method: "GET",
+                headers: { "X-API-Key": this.auth.secretToken || "" },
+            };
+            if (this._alternativeReferer) {
+                options.headers["Alternative-Referer"] = this._alternativeReferer;
+            }
+            return this.fetch(this.auth.endpoint + url, options);
+        });
+    }
     postRender(params, body) {
         return __awaiter(this, void 0, void 0, function* () {
             if (this.auth === undefined) {
@@ -160,7 +197,7 @@ export class CatalogueAPI {
             return this.fetch(this.auth.endpoint + url, options);
         });
     }
-    postValidate(params, body) {
+    postValidateLegacyV1(params, body) {
         return __awaiter(this, void 0, void 0, function* () {
             if (this.auth === undefined) {
                 throw new Error("missing auth");
@@ -177,6 +214,23 @@ export class CatalogueAPI {
             return this.fetch(this.auth.endpoint + url, options);
         });
     }
+    postValidate(params, body) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this.auth === undefined) {
+                throw new Error("missing auth");
+            }
+            const url = `/v1/catalogue/${encodeURIComponent(params.lang)}/${encodeURIComponent(params.enterprise)}/${encodeURIComponent(params.prdCat)}/${encodeURIComponent(params.prdCatVersion)}/${encodeURIComponent(params.vendor)}/${encodeURIComponent(params.priceList)}/product/${encodeURIComponent(params.partNumber)}/validate-v2`;
+            const options = {
+                method: "POST",
+                headers: { "X-API-Key": this.auth.secretToken || "" },
+                body: JSON.stringify(body),
+            };
+            if (this._alternativeReferer) {
+                options.headers["Alternative-Referer"] = this._alternativeReferer;
+            }
+            return this.fetch(this.auth.endpoint + url, options);
+        });
+    }
     getTocTree(params) {
         return __awaiter(this, void 0, void 0, function* () {
             if (this.auth === undefined) {
@@ -263,8 +317,10 @@ export const DTO_OPERATION_ID_TO_DEBIT_GROUP = {
     getApplicationAreas: "base",
     postExport: "export",
     getPriceLists: "base",
+    getProductLegacyV2: "base",
     getProduct: "base",
     postRender: "render",
+    postValidateLegacyV1: "base",
     postValidate: "base",
     getTocTree: "base",
     getTocFlat: "base",

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, DtoCatalogueParamsWithCid, DtoMeasureParam, DtoMiscFile, DtoMtrlApplication, DtoNote, DtoPrices, DtoProductConf, DtoProductParamsWithCidAndLang, DtoTransform } from "./CatalogueAPI.js";
 import { CfgMeasureDefinition } from "./CfgMeasure.js";
 import { _CfgFeatureInternal } from "./productConfiguration/CfgFeature.js";
 import { ProductConfigurationBubbleMode } from "./productConfiguration/CfgOption.js";
@@ -8,6 +8,7 @@ import { ProductLoader } from "./productLoader.js";
 import { SyncGroupsApplyMode } from "./syncGroups/SyncGroupsApplyMode.js";
 import { SyncGroupsHandler } from "./syncGroups/SyncGroupsHandler.js";
 import { CfgProductData, RootNodeSource } from "./utilitiesCatalogueData.js";
+import { CfgProdConfParts } from "./utilitiesConfiguration.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
@@ -72,7 +73,7 @@ export declare type CfgPrice = {
  */
 export declare class _CfgProductInternal {
     readonly _productLoaderRaw: ProductLoader;
-    readonly prodParams: DtoProductParamsWithLang;
+    readonly prodParams: DtoProductParamsWithCidAndLang;
     readonly settings: CfgProductSettings;
     readonly uuid: string;
     private readonly _rawUnit;
@@ -81,7 +82,8 @@ export declare class _CfgProductInternal {
     readonly parent: _CfgProductInternal | undefined;
     private _additionalProductRef;
     private readonly _syncGroupHandler;
-    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>;
+    static make: (productLoaderRaw: ProductLoader, productLoaderForGroupedLoad: ProductLoader | undefined, prodParams: DtoProductParamsWithCidAndLang, settings: CfgProductSettings, optional: boolean, loadingObservable: AggregatedLoadingObservable, parent: _CfgProductInternal | undefined, root: _CfgProductInternal | undefined, additionalProductRef: DtoAdditionalProductRef | undefined, initialProductConfiguration: DtoProductConf | DtoAdditionalProductConfiguration | undefined) => Promise<_CfgProductInternal>;
+    _initialClone: _CfgProductInternal | undefined;
     private constructor();
     readonly root: _CfgProductInternal;
     private _destroyed;
@@ -89,12 +91,43 @@ export declare class _CfgProductInternal {
     readonly additionalProducts: CfgProduct[];
     private _selected;
     private _configuration;
+    private _notes;
     readonly changeObservable: Observable<CfgProductChangeNotification>;
     get selected(): boolean;
     readonly isAdditionalProduct: boolean;
+    /**
+     * Please note that cloning an additional product will make the clone believe is is
+     * an additional product, even if it has no parent and root.
+     * Providing the parent and root of what you clone as arguments is unwise as it will
+     * make changes you do on the clone be propagated up to the original non-clone root product.
+     */
     clone(parent?: _CfgProductInternal, root?: _CfgProductInternal): Promise<_CfgProductInternal>;
+    /** Mark this and its descendants as destroyed and remove all listeners */
     destroy: () => void;
+    /**
+     * Reset will reset the product to its initial state
+     */
+    reset: () => Promise<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;
+    /**
+     * Return a DtoNode using noteRef as a key.
+     * Throws an error if no note is found.
+     */
+    getNote(noteRef: string): DtoNote;
+    /**
+     * noteRefs is a list of keys coming from CfgOption, CfgFeature or CfgProduct.
+     * The keys are used to get a DtoNote[] from notes at CfgProduct.
+     */
+    getNotes(noteRefs: string[]): DtoNote[];
+    private addNotes;
+    get notes(): DtoNote[];
+    get miscFiles(): DtoMiscFile[];
+    get hasRootFeaturesChanged(): boolean;
     get description(): string | undefined;
     get rootNodeSources(): RootNodeSource[] | undefined;
     get mtrlApplications(): DtoMtrlApplication[] | undefined;
@@ -111,7 +144,7 @@ export declare class _CfgProductInternal {
     get unit(): LengthUnit;
     get aggregatedPrice(): CfgPrice;
     get optional(): boolean;
-    setSelected(v: boolean, bubbleMode: CfgProductBubbleMode): Promise<boolean>;
+    setSelected(selected: boolean, bubbleMode: CfgProductBubbleMode, interactive: boolean): Promise<boolean>;
     get configuration(): CfgProductConfiguration;
     get rawProductData(): CfgProductData;
     /**
@@ -136,8 +169,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>;
-    getDtoConf: (includeExtendedData: boolean, includeProductParams: boolean) => DtoProductConfiguration;
-    setDtoConf: (s: DtoProductConfiguration, doValidate: boolean, productLoaderForGroupedLoad?: ProductLoader | undefined) => Promise<boolean>;
+    getDtoConf: (include: CfgProdConfParts) => 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;
@@ -162,11 +195,11 @@ export declare class _CfgProductInternal {
      * 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.
      */
-    _syncAndLoadAdditionalProducts: (productLoaderForGroupedLoad: ProductLoader) => Promise<boolean>;
+    _syncAndLoadAdditionalProducts: (productLoaderForGroupedLoad: ProductLoader, initialProductConfiguration: DtoAdditionalProductConfiguration | undefined) => Promise<boolean>;
 }
 export declare class CfgProduct {
     readonly _internal: _CfgProductInternal;
-    static make(productLoader: ProductLoader, prodParams: DtoProductParamsWithLang, settings?: Partial<CfgProductSettings>): Promise<CfgProduct>;
+    static make(productLoader: ProductLoader, prodParams: DtoProductParamsWithCidAndLang, settings?: Partial<CfgProductSettings>, initialProductConfiguration?: DtoProductConf | DtoAdditionalProductConfiguration): 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
@@ -193,9 +226,11 @@ export declare class CfgProduct {
      * It will be unique amongst child products, but not globally unique.
      */
     get refKey(): string | undefined;
-    get prodParams(): DtoProductParamsWithLang;
+    get notes(): DtoNote[];
+    get miscFiles(): DtoMiscFile[];
+    get prodParams(): DtoProductParamsWithCidAndLang;
     get lang(): string;
-    get catId(): DtoCatalogueParams;
+    get catId(): DtoCatalogueParamsWithCid;
     get partNumber(): string;
     get isAdditionalProduct(): boolean;
     /** Only used when this product is an additional product. Root products are never optional. */
@@ -208,7 +243,7 @@ export declare class CfgProduct {
     /**
      * Please note that this relates to the visibility in the Configuration tree.
      * It does not affect the visibility of anything in the 3D view at all.
-     * Visibility is affects the Configuration for this Product, but any Additional Products
+     * Visibility affects the Configuration for this Product, but any Additional Products
      * will not be affected.
      */
     get visible(): boolean;
@@ -218,6 +253,18 @@ export declare class CfgProduct {
      *  assumed to always be legal.
      */
     setSelected: (v: boolean) => Promise<boolean>;
+    /**
+     * Functional selection is a Catalogues feature where selecting Options on Features result in that you
+     * "jump" to another Product as a result of the Validate call. You normally do not notice that a functional
+     * selection has occurred except for the styleNr changing. Functional selection can change which Features
+     * from the original product call are used as root Features. This can in turn affect if serialized
+     * configuration can be applied or not.
+     *
+     * The SDK can currently only apply serialized configuration if the list of root Features has not changed.
+     * For this reason, when functional selection has happened, extracting data for external systems might work
+     * well, but reapplying back into Stage will probably fail.
+     */
+    get hasRootFeaturesChanged(): boolean;
     get rawProductData(): CfgProductData;
     get uuid(): string;
     get unit(): LengthUnit;
@@ -254,11 +301,40 @@ 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;
-    getDtoConf: (includeExtendedData?: boolean, includeProductParams?: boolean) => DtoProductConfiguration;
-    setDtoConf: (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, ProductParams and/or SyncGroupState 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 include   Includes extra data which is not an actual part of the configuration
+     */
+    getDtoConf: (include?: CfgProdConfParts) => 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;