@configura/web-api 2.0.0-alpha.2 → 2.0.0-alpha.21

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (100) hide show
  1. package/.eslintrc.json +5 -18
  2. package/LICENSE +201 -201
  3. package/README.md +1 -1
  4. package/dist/CatalogueAPI.d.ts +597 -551
  5. package/dist/CatalogueAPI.js +328 -293
  6. package/dist/CfgMeasure.d.ts +32 -32
  7. package/dist/CfgMeasure.js +30 -30
  8. package/dist/CfgProduct.d.ts +328 -268
  9. package/dist/CfgProduct.js +934 -778
  10. package/dist/CfgReferencePathHelper.d.ts +26 -13
  11. package/dist/CfgReferencePathHelper.js +26 -13
  12. package/dist/ConfigurationConverter.d.ts +17 -4
  13. package/dist/ConfigurationConverter.js +175 -72
  14. package/dist/index.d.ts +23 -23
  15. package/dist/index.js +23 -23
  16. package/dist/io/CfgHistoryManager.d.ts +83 -50
  17. package/dist/io/CfgHistoryManager.js +144 -82
  18. package/dist/io/CfgHistoryToProdConfConnector.d.ts +21 -20
  19. package/dist/io/CfgHistoryToProdConfConnector.js +50 -56
  20. package/dist/io/CfgIOManager.d.ts +53 -48
  21. package/dist/io/CfgIOManager.js +134 -115
  22. package/dist/io/CfgIOProdConfConnector.d.ts +64 -52
  23. package/dist/io/CfgIOProdConfConnector.js +149 -141
  24. package/dist/io/CfgIOWarningSupplier.d.ts +4 -0
  25. package/dist/io/CfgIOWarningSupplier.js +1 -0
  26. package/dist/io/CfgObservableStateManager.d.ts +25 -21
  27. package/dist/io/CfgObservableStateManager.js +69 -65
  28. package/dist/io/CfgObservableStateToProdConfConnector.d.ts +14 -14
  29. package/dist/io/CfgObservableStateToProdConfConnector.js +16 -16
  30. package/dist/io/CfgWindowEventManager.d.ts +21 -21
  31. package/dist/io/CfgWindowEventManager.js +38 -38
  32. package/dist/io/CfgWindowMessageManager.d.ts +40 -40
  33. package/dist/io/CfgWindowMessageManager.js +91 -84
  34. package/dist/io/CfgWindowMessageToProdConfConnector.d.ts +16 -16
  35. package/dist/io/CfgWindowMessageToProdConfConnector.js +18 -18
  36. package/dist/io/index.d.ts +8 -8
  37. package/dist/io/index.js +8 -8
  38. package/dist/material/CfgMaterialMapping.d.ts +7 -7
  39. package/dist/material/CfgMaterialMapping.js +181 -181
  40. package/dist/material/CfgMtrlApplication.d.ts +18 -18
  41. package/dist/material/CfgMtrlApplication.js +43 -43
  42. package/dist/material/CfgMtrlApplicationSource.d.ts +7 -7
  43. package/dist/material/CfgMtrlApplicationSource.js +8 -8
  44. package/dist/material/CfgMtrlSource.d.ts +19 -19
  45. package/dist/material/CfgMtrlSource.js +40 -40
  46. package/dist/material/CfgMtrlSourceWithMetaData.d.ts +7 -7
  47. package/dist/material/CfgMtrlSourceWithMetaData.js +1 -1
  48. package/dist/productConfiguration/CfgFeature.d.ts +189 -187
  49. package/dist/productConfiguration/CfgFeature.js +658 -645
  50. package/dist/productConfiguration/CfgOption.d.ts +151 -151
  51. package/dist/productConfiguration/CfgOption.js +422 -416
  52. package/dist/productConfiguration/CfgProductConfiguration.d.ts +129 -117
  53. package/dist/productConfiguration/CfgProductConfiguration.js +340 -307
  54. package/dist/productConfiguration/filters.d.ts +15 -15
  55. package/dist/productConfiguration/filters.js +70 -70
  56. package/dist/productConfiguration/productParamsGenerator.d.ts +15 -15
  57. package/dist/productConfiguration/productParamsGenerator.js +51 -51
  58. package/dist/productConfiguration/utilitiesProductConfiguration.d.ts +17 -17
  59. package/dist/productConfiguration/utilitiesProductConfiguration.js +87 -80
  60. package/dist/productLoader.d.ts +33 -33
  61. package/dist/productLoader.js +49 -49
  62. package/dist/syncGroups/SyncGroupsApplyMode.d.ts +20 -20
  63. package/dist/syncGroups/SyncGroupsApplyMode.js +21 -21
  64. package/dist/syncGroups/SyncGroupsHandler.d.ts +47 -40
  65. package/dist/syncGroups/SyncGroupsHandler.js +370 -359
  66. package/dist/syncGroups/SyncGroupsPathHelper.d.ts +26 -26
  67. package/dist/syncGroups/SyncGroupsPathHelper.js +90 -90
  68. package/dist/syncGroups/SyncGroupsState.d.ts +39 -35
  69. package/dist/syncGroups/SyncGroupsState.js +167 -125
  70. package/dist/syncGroups/SyncGroupsTransaction.d.ts +154 -154
  71. package/dist/syncGroups/SyncGroupsTransaction.js +589 -576
  72. package/dist/tasks/TaskHandler.d.ts +77 -77
  73. package/dist/tasks/TaskHandler.js +276 -275
  74. package/dist/tasks/formats.d.ts +4 -4
  75. package/dist/tasks/formats.js +7 -7
  76. package/dist/tests/testData/collectorForTest.d.ts +73 -73
  77. package/dist/tests/testData/collectorForTest.js +194 -194
  78. package/dist/tests/testData/dummyProductForTest.d.ts +4 -4
  79. package/dist/tests/testData/dummyProductForTest.js +32 -32
  80. package/dist/tests/testData/testDataAdditionalProductInAdditionalProductInProductForTest.d.ts +11 -11
  81. package/dist/tests/testData/testDataAdditionalProductInAdditionalProductInProductForTest.js +282 -277
  82. package/dist/tests/testData/testDataCachedGetProduct.d.ts +5 -5
  83. package/dist/tests/testData/testDataCachedGetProduct.js +187 -185
  84. package/dist/tests/testData/testDataCachedPostValidate.d.ts +7 -7
  85. package/dist/tests/testData/testDataCachedPostValidate.js +185 -183
  86. package/dist/tests/testData/testDataNoAdditionalProductNoPropagateForTest.d.ts +3 -3
  87. package/dist/tests/testData/testDataNoAdditionalProductNoPropagateForTest.js +1099 -1099
  88. package/dist/tests/testData/testDataOptions.d.ts +12 -12
  89. package/dist/tests/testData/testDataOptions.js +60 -60
  90. package/dist/tests/testData/testDataProductAggregatedPrice.d.ts +6 -6
  91. package/dist/tests/testData/testDataProductAggregatedPrice.js +189 -187
  92. package/dist/tests/testData/testDataUpcharge.d.ts +8 -8
  93. package/dist/tests/testData/testDataUpcharge.js +121 -119
  94. package/dist/utilitiesCatalogueData.d.ts +47 -42
  95. package/dist/utilitiesCatalogueData.js +180 -173
  96. package/dist/utilitiesCataloguePermission.d.ts +38 -38
  97. package/dist/utilitiesCataloguePermission.js +79 -79
  98. package/dist/utilitiesNumericValues.d.ts +24 -24
  99. package/dist/utilitiesNumericValues.js +114 -109
  100. package/package.json +3 -3
@@ -1,49 +1,49 @@
1
- var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
2
- function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
3
- return new (P || (P = Promise))(function (resolve, reject) {
4
- function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
5
- function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
6
- function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
7
- step((generator = generator.apply(thisArg, _arguments || [])).next());
8
- });
9
- };
10
- import { PromiseCache } from "@configura/web-utilities";
11
- import { makeProductKey, makeSelOptionsKey, } from "./utilitiesCatalogueData.js";
12
- /**
13
- * Wraps a getProduct function so that it caches for the time it lives.
14
- *
15
- * It has no cache invalidation or timeouts, so whatever ends up in the cache stays there
16
- * indefinitely. For this reason we recommend using this with caution.
17
- *
18
- * In our Example App we use it to cache the internal calls in additional products as in such a
19
- * product you tend to frequently get calls to same sub-product. Such as loading the same table leg
20
- * four times.
21
- */
22
- export function wrapWithGetProductCache(getProduct) {
23
- const cache = new PromiseCache();
24
- return (params) => __awaiter(this, void 0, void 0, function* () { return cache.get(makeProductKey(params), () => getProduct(params)); });
25
- }
26
- /**
27
- * Wraps a postValidate function so that it caches for the time it lives.
28
- *
29
- * It has no cache invalidation or timeouts, so whatever ends up in the cache stays there
30
- * indefinitely. We recommend you do not use this unless you are really, really sure what you are
31
- * doing.
32
- *
33
- * The SDK uses it for additional products to avoid validating for example the same table legs four
34
- * times at the same time. There we make sure the this cache only stays in scope for one user
35
- * interaction. No longer than the actions caused by a user clicking an option.
36
- */
37
- export function wrapWithPostValidateCache(postValidate) {
38
- const cache = new PromiseCache();
39
- return (params, body) => __awaiter(this, void 0, void 0, function* () {
40
- return cache.get(`${makeProductKey(params)}-${makeSelOptionsKey(body.selOptions)}`, () => postValidate(params, body));
41
- });
42
- }
43
- /** Does both wrapWithGetProductCache and wrapWithPostValidateCache. */
44
- export function wrapWithCache(loader) {
45
- return {
46
- getProduct: wrapWithGetProductCache(loader.getProduct.bind(loader)),
47
- postValidate: wrapWithPostValidateCache(loader.postValidate.bind(loader)),
48
- };
49
- }
1
+ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
2
+ function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
3
+ return new (P || (P = Promise))(function (resolve, reject) {
4
+ function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
5
+ function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
6
+ function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
7
+ step((generator = generator.apply(thisArg, _arguments || [])).next());
8
+ });
9
+ };
10
+ import { PromiseCache } from "@configura/web-utilities";
11
+ import { makeProductKey, makeSelOptionsKey, } from "./utilitiesCatalogueData.js";
12
+ /**
13
+ * Wraps a getProduct function so that it caches for the time it lives.
14
+ *
15
+ * It has no cache invalidation or timeouts, so whatever ends up in the cache stays there
16
+ * indefinitely. For this reason we recommend using this with caution.
17
+ *
18
+ * In our Example App we use it to cache the internal calls in additional products as in such a
19
+ * product you tend to frequently get calls to same sub-product. Such as loading the same table leg
20
+ * four times.
21
+ */
22
+ export function wrapWithGetProductCache(getProduct) {
23
+ const cache = new PromiseCache();
24
+ return (params) => __awaiter(this, void 0, void 0, function* () { return cache.get(makeProductKey(params), () => getProduct(params)); });
25
+ }
26
+ /**
27
+ * Wraps a postValidate function so that it caches for the time it lives.
28
+ *
29
+ * It has no cache invalidation or timeouts, so whatever ends up in the cache stays there
30
+ * indefinitely. We recommend you do not use this unless you are really, really sure what you are
31
+ * doing.
32
+ *
33
+ * The SDK uses it for additional products to avoid validating for example the same table legs four
34
+ * times at the same time. There we make sure the this cache only stays in scope for one user
35
+ * interaction. No longer than the actions caused by a user clicking an option.
36
+ */
37
+ export function wrapWithPostValidateCache(postValidate) {
38
+ const cache = new PromiseCache();
39
+ return (params, body) => __awaiter(this, void 0, void 0, function* () {
40
+ return cache.get(`${makeProductKey(params)}-${makeSelOptionsKey(body.selOptions)}-${body.knownFeatureCodes.join(",")}`, () => postValidate(params, body));
41
+ });
42
+ }
43
+ /** Does both wrapWithGetProductCache and wrapWithPostValidateCache. */
44
+ export function wrapWithCache(loader) {
45
+ return {
46
+ getProduct: wrapWithGetProductCache(loader.getProduct.bind(loader)),
47
+ postValidate: wrapWithPostValidateCache(loader.postValidate.bind(loader)),
48
+ };
49
+ }
@@ -1,21 +1,21 @@
1
- /**
2
- * The SyncGroupsApplyMode controls how many SyncGroups can be updated in the SyncState for one
3
- * run of rootProductOntoSyncState.
4
- *
5
- * "Fast" will update any SyncGroup that should be updated before running syncStateOntoRootProduct
6
- * This way several SyncGroups can be applied in one go before sending the validation calls to the * server, making the whole process faster.
7
- *
8
- * The downside of this is that is not exactly how CET (the desktop software) works. CET will
9
- * instead apply Features to the SyncState as soon as it gets the chance.
10
- *
11
- * "Strict" tries to behave exactly as CET. This will potentially generate a lot more validate
12
- * calls, increasing delay and cost.
13
- *
14
- * Strict is the safer option of the two, but we still recommend trying out Fast since it should
15
- * work fine in most cases.
16
- */
17
- export declare enum SyncGroupsApplyMode {
18
- Strict = "Strict",
19
- Fast = "Fast"
20
- }
1
+ /**
2
+ * The SyncGroupsApplyMode controls how many SyncGroups can be updated in the SyncState for one
3
+ * run of rootProductOntoSyncState.
4
+ *
5
+ * "Fast" will update any SyncGroup that should be updated before running syncStateOntoRootProduct
6
+ * This way several SyncGroups can be applied in one go before sending the validation calls to the * server, making the whole process faster.
7
+ *
8
+ * The downside of this is that is not exactly how CET (the desktop software) works. CET will
9
+ * instead apply Features to the SyncState as soon as it gets the chance.
10
+ *
11
+ * "Strict" tries to behave exactly as CET. This will potentially generate a lot more validate
12
+ * calls, increasing delay and cost.
13
+ *
14
+ * Strict is the safer option of the two, but we still recommend trying out Fast since it should
15
+ * work fine in most cases.
16
+ */
17
+ export declare enum SyncGroupsApplyMode {
18
+ Strict = "Strict",
19
+ Fast = "Fast"
20
+ }
21
21
  //# sourceMappingURL=SyncGroupsApplyMode.d.ts.map
@@ -1,21 +1,21 @@
1
- /**
2
- * The SyncGroupsApplyMode controls how many SyncGroups can be updated in the SyncState for one
3
- * run of rootProductOntoSyncState.
4
- *
5
- * "Fast" will update any SyncGroup that should be updated before running syncStateOntoRootProduct
6
- * This way several SyncGroups can be applied in one go before sending the validation calls to the * server, making the whole process faster.
7
- *
8
- * The downside of this is that is not exactly how CET (the desktop software) works. CET will
9
- * instead apply Features to the SyncState as soon as it gets the chance.
10
- *
11
- * "Strict" tries to behave exactly as CET. This will potentially generate a lot more validate
12
- * calls, increasing delay and cost.
13
- *
14
- * Strict is the safer option of the two, but we still recommend trying out Fast since it should
15
- * work fine in most cases.
16
- */
17
- export var SyncGroupsApplyMode;
18
- (function (SyncGroupsApplyMode) {
19
- SyncGroupsApplyMode["Strict"] = "Strict";
20
- SyncGroupsApplyMode["Fast"] = "Fast";
21
- })(SyncGroupsApplyMode || (SyncGroupsApplyMode = {}));
1
+ /**
2
+ * The SyncGroupsApplyMode controls how many SyncGroups can be updated in the SyncState for one
3
+ * run of rootProductOntoSyncState.
4
+ *
5
+ * "Fast" will update any SyncGroup that should be updated before running syncStateOntoRootProduct
6
+ * This way several SyncGroups can be applied in one go before sending the validation calls to the * server, making the whole process faster.
7
+ *
8
+ * The downside of this is that is not exactly how CET (the desktop software) works. CET will
9
+ * instead apply Features to the SyncState as soon as it gets the chance.
10
+ *
11
+ * "Strict" tries to behave exactly as CET. This will potentially generate a lot more validate
12
+ * calls, increasing delay and cost.
13
+ *
14
+ * Strict is the safer option of the two, but we still recommend trying out Fast since it should
15
+ * work fine in most cases.
16
+ */
17
+ export var SyncGroupsApplyMode;
18
+ (function (SyncGroupsApplyMode) {
19
+ SyncGroupsApplyMode["Strict"] = "Strict";
20
+ SyncGroupsApplyMode["Fast"] = "Fast";
21
+ })(SyncGroupsApplyMode || (SyncGroupsApplyMode = {}));
@@ -1,41 +1,48 @@
1
- import { AggregatedLoadingObservable } from "@configura/web-utilities";
2
- import { _CfgProductInternal } from "../CfgProduct.js";
3
- import { _CfgOptionInternal } from "../productConfiguration/CfgOption.js";
4
- import { ProductLoader } from "../productLoader.js";
5
- import { SyncGroupsApplyMode } from "./SyncGroupsApplyMode.js";
6
- import { SyncGroupsTransaction } from "./SyncGroupsTransaction.js";
7
- export declare type SyncCode = string;
8
- export declare type OptionCode = string;
9
- /**
10
- * Is used to apply the SyncGroups functionality on the Configuration and the other way around.
11
- * It also keeps the SyncState.
12
- */
13
- export declare class SyncGroupsHandler {
14
- private _syncState;
15
- readonly updateMode: SyncGroupsApplyMode;
16
- private readonly _loadingObservable;
17
- private _currentTransaction;
18
- /**
19
- * @param verboseLogging Set to true to get verbose sync state changes logged to the console.
20
- */
21
- static make(updateMode?: SyncGroupsApplyMode, loadingObservable?: AggregatedLoadingObservable, verboseLogging?: boolean): SyncGroupsHandler;
22
- private constructor();
23
- /** Please note that clones will use the same loadingObservable as their source. */
24
- clone(): SyncGroupsHandler;
25
- get verboseLogging(): boolean;
26
- set verboseLogging(v: boolean);
27
- /** Used to initially apply the sync state onto a new product so that it is "in sync". */
28
- init(product: _CfgProductInternal, productLoader: ProductLoader): Promise<void>;
29
- /**
30
- * Used when an Option is selected or deselected to apply all consequences of the sync groups.
31
- * Can cause multiple extra validation calls to the server.
32
- */
33
- selectOption(product: _CfgProductInternal, option: _CfgOptionInternal, on: boolean, productLoader: ProductLoader): Promise<boolean>;
34
- private _pending;
35
- private setPending;
36
- get pending(): _CfgOptionInternal | undefined;
37
- private newTransaction;
38
- private closeTransaction;
39
- commitTransaction(transaction: SyncGroupsTransaction): Promise<void>;
40
- }
1
+ import { AggregatedLoadingObservable } from "@configura/web-utilities";
2
+ import { DtoSyncGroupState } from "../CatalogueAPI.js";
3
+ import { _CfgProductInternal } from "../CfgProduct.js";
4
+ import { _CfgOptionInternal } from "../productConfiguration/CfgOption.js";
5
+ import { ProductLoader } from "../productLoader.js";
6
+ import { SyncGroupsApplyMode } from "./SyncGroupsApplyMode.js";
7
+ import { SyncGroupsTransaction } from "./SyncGroupsTransaction.js";
8
+ export declare type SyncCode = string;
9
+ export declare type OptionCode = string;
10
+ /**
11
+ * Is used to apply the SyncGroups functionality on the Configuration and the other way around.
12
+ * It also keeps the SyncState.
13
+ */
14
+ export declare class SyncGroupsHandler {
15
+ private _syncState;
16
+ readonly updateMode: SyncGroupsApplyMode;
17
+ private readonly _loadingObservable;
18
+ private _currentTransaction;
19
+ /**
20
+ * @param verboseLogging Set to true to get verbose sync state changes logged to the console.
21
+ */
22
+ static make(updateMode?: SyncGroupsApplyMode, loadingObservable?: AggregatedLoadingObservable, initial?: DtoSyncGroupState, verboseLogging?: boolean): SyncGroupsHandler;
23
+ private constructor();
24
+ /** Please note that clones will use the same loadingObservable as their source. */
25
+ clone(): SyncGroupsHandler;
26
+ getCompactSyncGroupState(): DtoSyncGroupState;
27
+ /** Overwrites the sync state */
28
+ setCompactSyncGroupState(s: DtoSyncGroupState): void;
29
+ get verboseLogging(): boolean;
30
+ set verboseLogging(v: boolean);
31
+ /**
32
+ * Used to initially apply the sync state onto a new product so that it is "in sync"
33
+ * and to reapply the sync state when an optional additional product is selected.
34
+ */
35
+ init(product: _CfgProductInternal, productLoader: ProductLoader): Promise<void>;
36
+ /**
37
+ * Used when an Option is selected or deselected to apply all consequences of the sync groups.
38
+ * Can cause multiple extra validation calls to the server.
39
+ */
40
+ selectOption(product: _CfgProductInternal, option: _CfgOptionInternal, on: boolean, productLoader: ProductLoader): Promise<boolean>;
41
+ private _pending;
42
+ private setPending;
43
+ get pending(): _CfgOptionInternal | undefined;
44
+ private newTransaction;
45
+ private closeTransaction;
46
+ commitTransaction(transaction: SyncGroupsTransaction): Promise<void>;
47
+ }
41
48
  //# sourceMappingURL=SyncGroupsHandler.d.ts.map