idosell 0.4.32 → 0.4.38

package/dist/utils.d.ts

@@ -11,6 +11,16 @@ type GetLangDataFunction = <T extends {
     langId: string;
 }>(_array: T[], _langId?: string) => T | undefined;
 type ClearParametersLangDataFunction = (_products: SearchProductsResponse['results'], _langId?: string) => SearchProductsResponse['results'];
+type MappedParameterValue = {
+    valueId: number;
+    value: string;
+};
+type MappedParameter = {
+    id: number;
+    name: string;
+    values: MappedParameterValue[];
+};
+type MapProductParametersFunction = (_product: IdosellProduct, _langId?: string) => MappedParameter[];
 declare const _default: {
     /** @description The method allows you to build an IAI code from the product ID and size ID. */
     getIaiCode: GetIaICodeFunction;
@@ -30,5 +40,7 @@ declare const _default: {
     clearParametersLangData: ClearParametersLangDataFunction;
     /** @description Removes attachments to RMA that are returned by default, helps to reduce data if serialized or forwarded */
     removeRmaAttachments: (rmaResponse: GetRmaResponse) => GetRmaResponse;
+    /** @description Maps product parameters to a simplified structure for a given language. Skips parameters with no values. */
+    mapProductParameters: MapProductParametersFunction;
 };
 export default _default;

package/dist/utils.js

@@ -269,6 +269,23 @@ const removeRmaAttachments = (rmaResponse) => {
     }
     return rmaResponse;
 };
+const mapProductParameters = (product, langId = 'pol') => {
+    if (!product.productParameters)
+        return [];
+    return product.productParameters.reduce((acc, param) => {
+        if (!param.parameterValues?.length)
+            return acc;
+        const name = param.parameterDescriptionsLangData.find((l) => l.langId === langId)?.parameterName ?? '';
+        const values = param.parameterValues.reduce((valAcc, pv) => {
+            const value = pv.parameterValueDescriptionsLangData.find((l) => l.langId === langId)
+                ?.parameterValueName ?? '';
+            valAcc.push({ valueId: pv.parameterValueId, value });
+            return valAcc;
+        }, []);
+        acc.push({ id: param.parameterId, name, values });
+        return acc;
+    }, []);
+};
 export default {
     /** @description The method allows you to build an IAI code from the product ID and size ID. */
     getIaiCode,
@@ -287,5 +304,7 @@ export default {
     /** @description Modifies product response by removing all parameter names nad values that are not in selected langId */
     clearParametersLangData,
     /** @description Removes attachments to RMA that are returned by default, helps to reduce data if serialized or forwarded */
-    removeRmaAttachments
+    removeRmaAttachments,
+    /** @description Maps product parameters to a simplified structure for a given language. Skips parameters with no values. */
+    mapProductParameters,
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "idosell",
-  "version": "0.4.32",
+  "version": "0.4.38",
   "description": "Idosell 3 REST connector",
   "main": "dist/index.js",
   "types": "dist/gateways.d.ts",
@@ -23,7 +23,7 @@
   },
   "homepage": "https://idosell-converter.vercel.app",
   "dependencies": {
-    "axios": "^1.13.2"
+    "axios": "^1.17.0"
   },
   "type": "module"
 }

package/tests/utilMapProductParameters.test.js

@@ -0,0 +1,97 @@
+import { utils } from '../dist/index';
+import { PARAMETER_PRODUCT, PARAMETER_PRODUCT_RESULT } from './utilTestData';
+
+// mapProductParameters.test.ts
+import { describe, it, expect } from 'vitest';
+
+const makeLangData = (langId, name) => ({
+    langId,
+    parameterName: name,
+    parameterDescription: '',
+    parameterShopsData: [],
+});
+
+const makeValueLangData = (langId, valueName) => ({
+    langId,
+    parameterValueName: valueName,
+    parameterValueDescription: '',
+    parameterValueShopsData: [],
+});
+
+const makeParam = (id, name, values, langId = 'pol') => ({
+    parameterId: id,
+    parameterType: 'parameter',
+    parameterDescriptionsLangData: [makeLangData(langId, name)],
+    parameterValues: values.map((v) => ({
+        parameterValueId: v.id,
+        parameterValueDescriptionsLangData: [makeValueLangData(langId, v.name)],
+    })),
+});
+
+describe('mapProductParameters', () => {
+    it('returns [] when productParameters is undefined', () => {
+        expect(utils.mapProductParameters({})).toEqual([]);
+    });
+
+    it('returns [] when productParameters is empty', () => {
+        expect(utils.mapProductParameters({ productParameters: [] })).toEqual([]);
+    });
+
+    it('skips parameters with null parameterValues', () => {
+        const product = {
+            productParameters: [
+                { ...makeParam(1, 'Color', [{ id: 10, name: 'Red' }]), parameterValues: null },
+            ],
+        };
+        expect(utils.mapProductParameters(product)).toEqual([]);
+    });
+
+    it('skips parameters with empty parameterValues', () => {
+        const product = {
+            productParameters: [{ ...makeParam(1, 'Color', []), parameterValues: [] }],
+        };
+        expect(utils.mapProductParameters(product)).toEqual([]);
+    });
+
+    it('maps a single parameter with values using default lang (pol)', () => {
+        const product = {
+            productParameters: [makeParam(1, 'Color', [{ id: 10, name: 'Red' }])],
+        };
+        expect(utils.mapProductParameters(product)).toEqual([
+            { id: 1, name: 'Color', values: [{ valueId: 10, value: 'Red' }] },
+        ]);
+    });
+
+    it('maps multiple parameters and multiple values', () => {
+        const product = {
+            productParameters: [
+                makeParam(1, 'Color', [{ id: 10, name: 'Red' }, { id: 11, name: 'Blue' }]),
+                makeParam(2, 'Size', [{ id: 20, name: 'M' }, { id: 21, name: 'L' }]),
+            ],
+        };
+        expect(utils.mapProductParameters(product)).toEqual([
+            { id: 1, name: 'Color', values: [{ valueId: 10, value: 'Red' }, { valueId: 11, value: 'Blue' }] },
+            { id: 2, name: 'Size', values: [{ valueId: 20, value: 'M' }, { valueId: 21, value: 'L' }] },
+        ]);
+    });
+
+    it('uses provided langId instead of default', () => {
+        const product = {
+            productParameters: [makeParam(1, 'Kolor', [{ id: 10, name: 'Czerwony' }], 'eng')],
+        };
+        expect(utils.mapProductParameters(product, 'eng')).toEqual([
+            { id: 1, name: 'Kolor', values: [{ valueId: 10, value: 'Czerwony' }] },
+        ]);
+    });
+
+    it('falls back to empty string when langId has no matching entry', () => {
+        const product = {
+            productParameters: [makeParam(1, 'Color', [{ id: 10, name: 'Red' }], 'pol')],
+        };
+        expect(utils.mapProductParameters(product, 'deu')).toEqual([
+            { id: 1, name: '', values: [{ valueId: 10, value: '' }] },
+        ]);
+    });
+
+    expect(utils.mapProductParameters(PARAMETER_PRODUCT)).toEqual(PARAMETER_PRODUCT_RESULT)
+});

package/tests/utilTestData.ts

@@ -341,4 +341,241 @@ export const STOCK_PRODUCT: SearchProductsResponse['results'][number] = {
             "sizePanelName": "XL"
         }
     ]
-}
+}
+
+export const PARAMETER_PRODUCT: SearchProductsResponse['results'][number] = {
+    "productId": 356,
+    "productParameters": [
+        {
+            "parameterId": 326,
+            "parameterType": "parameter",
+            "parameterDescriptionsLangData": [
+                {
+                    "langId": "eng",
+                    "parameterName": "Kolor akcentów",
+                    "parameterDescription": "",
+                    "parameterShopsData": []
+                },
+                {
+                    "langId": "ger",
+                    "parameterName": "Kolor akcentów",
+                    "parameterDescription": "",
+                    "parameterShopsData": []
+                },
+                {
+                    "langId": "pol",
+                    "parameterName": "Kolor akcentów",
+                    "parameterDescription": "",
+                    "parameterShopsData": []
+                }
+            ],
+            "parameterValues": [
+                {
+                    "parameterValueId": 399,
+                    "parameterValueDescriptionsLangData": [
+                        {
+                            "langId": "eng",
+                            "parameterValueName": "Czarny",
+                            "parameterValueDescription": "",
+                            "parameterValueShopsData": []
+                        },
+                        {
+                            "langId": "ger",
+                            "parameterValueName": "Czarny",
+                            "parameterValueDescription": "",
+                            "parameterValueShopsData": []
+                        },
+                        {
+                            "langId": "pol",
+                            "parameterValueName": "Czarny",
+                            "parameterValueDescription": "",
+                            "parameterValueShopsData": []
+                        }
+                    ]
+                }
+            ]
+        },
+        {
+            "parameterId": 173,
+            "parameterType": "parameter",
+            "parameterDescriptionsLangData": [
+                {
+                    "langId": "eng",
+                    "parameterName": "Waga całkowita",
+                    "parameterDescription": "",
+                    "parameterShopsData": []
+                },
+                {
+                    "langId": "ger",
+                    "parameterName": "Waga całkowita",
+                    "parameterDescription": "",
+                    "parameterShopsData": []
+                },
+                {
+                    "langId": "pol",
+                    "parameterName": "Waga całkowita",
+                    "parameterDescription": "",
+                    "parameterShopsData": []
+                }
+            ],
+            "parameterValues": [
+                {
+                    "parameterValueId": 522,
+                    "parameterValueDescriptionsLangData": [
+                        {
+                            "langId": "eng",
+                            "parameterValueName": "100g",
+                            "parameterValueDescription": "",
+                            "parameterValueShopsData": []
+                        },
+                        {
+                            "langId": "ger",
+                            "parameterValueName": "100g",
+                            "parameterValueDescription": "",
+                            "parameterValueShopsData": []
+                        },
+                        {
+                            "langId": "pol",
+                            "parameterValueName": "100g",
+                            "parameterValueDescription": "",
+                            "parameterValueShopsData": []
+                        }
+                    ]
+                }
+            ]
+        },
+        {
+            "parameterId": 521,
+            "parameterType": "section",
+            "parameterDescriptionsLangData": [
+                {
+                    "langId": "eng",
+                    "parameterName": "XCut",
+                    "parameterDescription": "",
+                    "parameterShopsData": []
+                },
+                {
+                    "langId": "ger",
+                    "parameterName": "XCut",
+                    "parameterDescription": "",
+                    "parameterShopsData": []
+                },
+                {
+                    "langId": "pol",
+                    "parameterName": "XCut",
+                    "parameterDescription": "",
+                    "parameterShopsData": []
+                }
+            ]
+        },
+        {
+            "parameterId": 26,
+            "parameterType": "parameter",
+            "parameterDescriptionsLangData": [
+                {
+                    "langId": "eng",
+                    "parameterName": "Color",
+                    "parameterDescription": "",
+                    "parameterShopsData": []
+                },
+                {
+                    "langId": "ger",
+                    "parameterName": "Kolor",
+                    "parameterDescription": "",
+                    "parameterShopsData": []
+                },
+                {
+                    "langId": "pol",
+                    "parameterName": "Kolor",
+                    "parameterDescription": "",
+                    "parameterShopsData": []
+                }
+            ],
+            "parameterValues": [
+                {
+                    "parameterValueId": 48,
+                    "parameterValueDescriptionsLangData": [
+                        {
+                            "langId": "eng",
+                            "parameterValueName": "Black",
+                            "parameterValueDescription": "",
+                            "parameterValueShopsData": []
+                        },
+                        {
+                            "langId": "ger",
+                            "parameterValueName": "czarny",
+                            "parameterValueDescription": "",
+                            "parameterValueShopsData": []
+                        },
+                        {
+                            "langId": "pol",
+                            "parameterValueName": "czarny",
+                            "parameterValueDescription": "",
+                            "parameterValueShopsData": []
+                        }
+                    ]
+                },
+                {
+                    "parameterValueId": 96,
+                    "parameterValueDescriptionsLangData": [
+                        {
+                            "langId": "eng",
+                            "parameterValueName": "red",
+                            "parameterValueDescription": "",
+                            "parameterValueShopsData": []
+                        },
+                        {
+                            "langId": "ger",
+                            "parameterValueName": "czerwony",
+                            "parameterValueDescription": "",
+                            "parameterValueShopsData": []
+                        },
+                        {
+                            "langId": "pol",
+                            "parameterValueName": "czerwony",
+                            "parameterValueDescription": "",
+                            "parameterValueShopsData": []
+                        }
+                    ]
+                }
+            ]
+        }
+    ]
+}
+
+export const PARAMETER_PRODUCT_RESULT = [
+    {
+        "id": 326,
+        "name": "Kolor akcentów",
+        "values": [
+            {
+                "valueId": 399,
+                "value": "Czarny"
+            }
+        ]
+    },
+    {
+        "id": 173,
+        "name": "Waga całkowita",
+        "values": [
+            {
+                "valueId": 522,
+                "value": "100g"
+            }
+        ]
+    },
+    {
+        "id": 26,
+        "name": "Kolor",
+        "values": [
+            {
+                "valueId": 48,
+                "value": "czarny"
+            },
+            {
+                "valueId": 96,
+                "value": "czerwony"
+            }
+        ]
+    }
+]