idosell 0.4.34 → 0.4.41

package/dist/responses.d.ts

@@ -8404,7 +8404,7 @@ export type GetProductsResponse = {
                 productSizeQuantity: number;
             }[];
             /** @description Size data */
-            productSizesStocksLocations: {
+            productSizesStocksLocations?: {
                 /** @description Stock ID */
                 stockId: number;
                 productSizesLocation: {
@@ -8489,11 +8489,11 @@ export type GetProductsResponse = {
                 /** @description Gross price */
                 productRetailPrice: number;
                 /** @description Gross price after promotion. The item is returned when the 'showPromotionsPrices' parameter is specified in the request */
-                productPromoRetailPrice: number;
+                productPromoRetailPrice?: number;
                 /** @description Wholesale price */
                 productWholesalePrice: number;
                 /** @description Wholesale price after promotion. The item is returned when the 'showPromotionsPrices' parameter is specified in the request */
-                productPromoWholesalePrice: number;
+                productPromoWholesalePrice?: number;
                 /** @description Minimal price */
                 productMinimalPrice: number;
                 /** @description Price for automatic calculations */
@@ -8771,7 +8771,7 @@ export type GetProductsResponse = {
                 sizePanelName: string;
             }[];
             /** @description Available sizes of products in a set or collection for marketplaces */
-            bundledAvailableSizesInAuctions: {
+            bundledAvailableSizesInAuctions?: {
                 /** @description Size identifier */
                 sizeId: string;
                 /** @description Size name */
@@ -8805,7 +8805,7 @@ export type GetProductsResponse = {
                 }[];
             }[];
             /** @description Parameter values */
-            parameterValues?: {
+            parameterValues?: null | {
                 /** @description Parameter value ID */
                 parameterValueId: number;
                 /** @description Language data */
@@ -8972,7 +8972,7 @@ export type GetProductsResponse = {
         /** @description Minimum stock level */
         minStockLevel?: number;
     }[];
-} & { resultsLimit: number; };
+} & { resultsLimit: number };
 
 export type GetOrdersResponse = {
     Results: {
@@ -8997,7 +8997,7 @@ export type GetOrdersResponse = {
                 /** @description Customer's company name. */
                 clientFirm: string;
                 /** @description Product suggestion. */
-                clientAdditional: string;
+                clientAdditional?: string;
                 /** @description Street and number. */
                 clientStreet: string;
                 /** @description Customer's postal code. */
@@ -9007,7 +9007,7 @@ export type GetOrdersResponse = {
                 /** @description Region name takes priority over clientCountryId. */
                 clientCountryName: string;
                 /** @description Client NIP verification status */
-                clientNipUeVerified: string;
+                clientNipUeVerified: string | null;
                 /** @description Country ID in accordance with ISO-3166. */
                 clientCountryId: string;
                 /** @description Cell phone. */
@@ -9052,9 +9052,9 @@ export type GetOrdersResponse = {
                 /** @description Internal Receiving Point Identifier. */
                 clientDeliveryAddressPickupPointInternalId: number;
             };
-            clientPickupPointAddress: {
+            clientPickupPointAddress?: {
                 /** @description Collection point ID. */
-                pickupPointId: string;
+                pickupPointId: number;
                 /** @description External service collection point ID. */
                 externalPickupPointId: string;
                 /** @description Town / City. */
@@ -9071,9 +9071,11 @@ export type GetOrdersResponse = {
                 longitude: number;
                 /** @description Name. */
                 name: string;
+                /** @description Country (2 letter country code). */
+                country: string;
             };
             /** @description Buyer's address data. */
-            payerAddress: {
+            payerAddress?: {
                 /** @description Buyer's address id. */
                 payerAddressId: string;
                 /** @description Buyer's first name. */
@@ -9137,9 +9139,13 @@ export type GetOrdersResponse = {
             /** @description Order status. Allowed values: "finished_ext" - order status: completed in FA application, "finished" - completed, "new" - not handled, "payment_waiting" - awaiting payment, "delivery_waiting" - awaiting delivery, "on_order" - in progress, "packed" - being picked, "packed_fulfillment" - being picked - fulfilment, "packed_ready" - packed, "ready" - ready, "wait_for_dispatch" - awaiting dispatch date, "suspended" - on hold, "joined" - merged, "missing" - missing, "lost" - lost, "false" - false, "canceled" - Customer canceled. */
             orderStatus: string;
             /** @description Order status id */
-            orderStatusId: string;
+            orderStatusId?: number;
             /** @description Date of change of status to the currently set status in YYYY-MM-DD HH:MM:SS format. */
             orderStatusChangeDate: string;
+            /** @description Split payment MPP marking */
+            splitPayment: boolean;
+            /** @description Transaction type. */
+            transactionType: null |"national" | "oss" | "export" | "intra";
             /** @example dropshippingOrderStatus */
             dropshippingOrderStatus: string;
             /** @description Type of order confirmation. Confirmations listing: "none" - order unconfirmed , "email" - order confirmed by e-mail, "phone_client" - order confirmed by phone call made by client, "phone_service" - order confirmed by phone call made by staff, "postauction" - order confirmed by auction return page, "willingness" - confirmed by willingness to buy letter, "auctionfod" - confirmed by after-sales form Allegro. */
@@ -9147,11 +9153,11 @@ export type GetOrdersResponse = {
             /** @description Date of order placing in YYYY-MM-DD HH:MM:SS format. */
             orderAddDate: string;
             /** @description Date of order sending in YYYY-MM-DD HH:MM:SS format. */
-            orderDispatchDate: string | null;
+            orderDispatchDate: 0 | string | null;
             /** @example receivedDate */
             receivedDate: string;
             /** @description Order handling time in seconds. */
-            orderPrepareTime: string;
+            orderPrepareTime: number | null;
             /** @description Customer comments on order. */
             clientNoteToOrder: string;
             /** @description Customer remarks for courier. */
@@ -9171,7 +9177,7 @@ export type GetOrdersResponse = {
                     /** @description Currency average rate set for order (by default, an average rate of order adding date, if it wasn't manually changed). */
                     orderCurrencyValue: number;
                     /** @description Currency scaler. */
-                    orderCurrencyScale: number;
+                    orderCurrencyScale?: number;
                     /** @description Panel billing currency exchange rate in relation to billing currency in the shop . */
                     billingCurrencyRate: number;
                     /** @description Products cost. */
@@ -9204,7 +9210,7 @@ export type GetOrdersResponse = {
                 };
                 /** @description Order currency squaring method. "gross" - calculated in gross prices, "net" - squared in net prices. */
                 orderWorthCalculateType: "gross" | "net";
-                /** @description Information if the VAT for the current order was calculated: "y" - yes, "n" - no. */
+                /** @description Information if the VAT for the current order was calculated: "y" - yes, "n" - no, "p"  – requires approval by the store staff. */
                 orderVatExists: string;
             };
             /** @description Information about prepayment for the order. */
@@ -9236,9 +9242,9 @@ export type GetOrdersResponse = {
                 /** @description Currency ID */
                 currencyId: string;
                 /** @description Number of voucher used in a payment. */
-                voucherNumber: string;
+                voucherNumber?: string;
                 /** @description Number of gift card used in a payment. */
-                giftCardNumber: string;
+                giftCardNumber?: string;
             }[];
             /** @description Order source data. */
             orderSourceResults: {
@@ -9247,7 +9253,7 @@ export type GetOrdersResponse = {
                 /** @description Shop Id */
                 shopId: number;
                 /** @description Auction site order comes from. Auction sites listing: "allegro" - Allegro.pl, "testwebapi" - Allegro.pl test site, "ebay" - eBay. */
-                auctionsServiceName: string;
+                auctionsServiceName: string | null;
                 /** @description Detailed information on order source. */
                 orderSourceDetails: {
                     /** @description order source type - possible values:. "self_added" - Orders from panel, "shop" - Orders from shop, "search_engine" - Orders from search engines, "auction" - Orders from auctions, "advertisement_campaign" - Advertisement campaigns, "price_comparer" - Price comparison sites, "affiliate_program" - Affiliate programme, "api" - Order from API, "eletronic_offer" - Order from ODT price lst, "cpa" - Order from CPA program, "refferer_site" - Order from reference sites, "pos" - Orders from POS, "marketplace" - Order from the Marketplace, "iai_ads" - Orders from IAI Ads */
@@ -9259,11 +9265,11 @@ export type GetOrdersResponse = {
                     /** @description Numerical ID of order source. */
                     orderSourceId: number;
                     /** @example 1 */
-                    entryProductIdBeforeOrder: number;
+                    entryProductIdBeforeOrder?: number;
                     /** @example sourcePageUrl */
-                    sourcePageUrl: string;
+                    sourcePageUrl?: string;
                     /** @description The order ID of the external service */
-                    orderExternalId: string;
+                    orderExternalId: string | null;
                     /** @description Order from the InPost Fresh marketplace */
                     fresh: "y" | "n";
                     /** @description Order supported by InPost fulfillment */
@@ -9285,16 +9291,16 @@ export type GetOrdersResponse = {
             /** @description Data of auction, order comes from (only if it comes from auction). */
             auctionInfo: {
                 /** @description Account ID on auction site. */
-                auctionClientId: string;
+                auctionClientId?: string;
                 /** @description Account login on auction site. */
-                auctionClientLogin: string;
+                auctionClientLogin?: string;
                 /** @description #!TablicaNumerowAukcjiDoZamowienia!#. */
-                auctionItemsIds: {
+                auctionItemsIds?: {
                     /** @description Auction number. */
                     auctionItemId: string;
                 }[];
                 /** @description The customer's email address at the auction service. */
-                auctionClientEmail: string;
+                auctionClientEmail?: string;
             };
             /** @description Consignment data. */
             dispatch: {
@@ -9324,7 +9330,7 @@ export type GetOrdersResponse = {
                 /** @description External product system code */
                 productCode: string;
                 /** @description Name of the parameter value, e.g. orange, green, red */
-                versionName: string;
+                versionName?: string;
                 /** @description Size identifier */
                 sizeId: string;
                 /** @description Size name */
@@ -9334,7 +9340,7 @@ export type GetOrdersResponse = {
                 /** @description Stock ID */
                 stockId: number;
                 /** @description Serial number of the product. */
-                productSerialNumber: string;
+                productSerialNumber?: string;
                 /** @description Product quantity. */
                 productQuantity: number;
                 /** @description Weight. */
@@ -9342,7 +9348,7 @@ export type GetOrdersResponse = {
                 /** @description Value of VAT */
                 productVat: number;
                 /** @description Is product VAT free Allowed values "y" - yes, "n" - no. */
-                productVatFree: string;
+                productVatFree?: string;
                 /** @description Gross price of the product in the currency of the administration panel. */
                 productPanelPrice: number;
                 /** @description Net price of the product in the currency of the administration panel. */
@@ -9356,7 +9362,7 @@ export type GetOrdersResponse = {
                 /** @description Product net price of order in shop account currency. */
                 productOrderPriceNetBaseCurrency: number;
                 /** @description List of product suggestions . */
-                orderAdditionalList: {
+                orderAdditionalList?: {
                     /** @description Product suggestion. */
                     orderAdditional: {
                         /** @description Name of suggestion. */
@@ -9368,13 +9374,13 @@ export type GetOrdersResponse = {
                 /** @description Client's remarks on product. */
                 remarksToProduct: string;
                 /** @description Label for grouping products. */
-                label: string;
+                label: string | null;
                 /** @description Product selling mode. Available values: "money", "gift", "points". */
                 orderSalesMode: "money" | "gift" | "points";
                 /** @description A set's ID. */
                 bundleId: number;
                 /** @description Serial numbers. */
-                productSerialNumbers: string;
+                productSerialNumbers: string | null;
                 /** @description Additional information. */
                 productOrderAdditional: string;
                 /** @description Item in basket. */
@@ -9382,7 +9388,7 @@ export type GetOrdersResponse = {
                 /** @description price information. */
                 productPriceLog: string;
                 /** @description Information about the selected parameters in the configurator. */
-                priceFormulaParameters: {
+                priceFormulaParameters?: {
                     /** @description Parameter ID */
                     parameterId: string;
                     /** @description Parameter name. */
@@ -9409,7 +9415,7 @@ export type GetOrdersResponse = {
             /** @description Note to the order. */
             orderNote: string;
             /** @description Information on used discount code. */
-            discountCode: {
+            discountCode?: {
                 /** @description Campaign ID. */
                 campaignId: string;
                 /** @description Name of code. */
@@ -9418,14 +9424,14 @@ export type GetOrdersResponse = {
                 discountCodeValue: string;
             };
             /** @description Discount card */
-            discountCard: {
+            discountCard?: {
                 /** @description Name of card */
                 discountCardName: string;
             };
             /** @description Order handler. */
             orderOperatorLogin: string;
             /** @description Order picker. */
-            orderPackingPersonLogin: string;
+            orderPackingPersonLogin: string | null;
             /** @description Sale date. ISO 8602 format. */
             purchaseDate: string;
             /** @description Modification date in YYYY-MM-DD HH:MM:SS format . */
@@ -9440,14 +9446,9 @@ export type GetOrdersResponse = {
             verified: boolean;
         };
         /** @description Information on error that occurred during gate call. */
-        errors: {
-            /** @description Error code. */
-            faultCode: number;
-            /** @description Error description. */
-            faultString: string;
-        }[];
+        errors: FaultCodeString[];
     }[];
-};
+} & { resultsNumberAll: number };
 
 type PromotionErrorEntry = {
     /** @description Error code. */
@@ -9583,4 +9584,30 @@ export type GetRegulationsHistoryResponse = {
     pagination: PagedResponse;
 };
 
+export type GetProductsAttachmentsGetContentResponse = {
+    /** @description Product attachment content */
+    data: {
+        /** @description Product attachment content */
+        attachmentContent: string | null;
+        /** @description Product attachment content representation
+|null} */
+        attachmentContentRepresentation: "base64" | "url" | null;
+        /** @description Product attachment file extension */
+        attachmentContentFileExtension: string | null;
+    };
+    isError: boolean;
+    errors: {
+        /** @description Error code. */
+        code: string;
+        /** @description Field associated with the error. */
+        field: string | null;
+        /** @description Error description. */
+        message: string | null;
+        /** @description Value associated with the error. */
+        value: string | null;
+        /** @description Unique identifier of the error (for support). */
+        uid: string | null;
+    }[];
+};
+
 export { };

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/dist/webhooks.js

@@ -0,0 +1,124 @@
+/* eslint-disable no-unused-vars */
+import { normalizeIaiRequest, WebhookValidationError } from "./webhooks.normalizer.js";
+// ─── Runtime constants ────────────────────────────────────────────────────────
+export const WEBHOOK_OBJECT_TYPE = {
+    CLIENT: "client",
+    PRODUCT: "product",
+    ORDER: "order",
+    RETURN: "return",
+    RMA: "rma",
+};
+export const WEBHOOK_EVENT_TYPE = {
+    CLIENT_CREATED: "clientCreated",
+    CLIENT_UPDATED: "clientUpdated",
+    PRODUCT_CREATED: "productCreated",
+    PRODUCT_UPDATED: "productUpdated",
+    PRODUCT_PRICE_UPDATED: "productPriceUpdated",
+    PRODUCT_STOCK_UPDATED: "productStockUpdated",
+    PRODUCT_DISPOSITION_UPDATED: "productDispositionUpdated",
+    ORDER_CREATED: "orderCreated",
+    ORDER_UPDATED: "orderUpdated",
+    ORDER_PAID: "orderPaid",
+    ORDER_STATUS_UPDATED: "orderStatusUpdated",
+    ORDER_PACKAGE_CREATED: "orderPackageCreated",
+    ORDER_FILES_CREATED: "orderFilesCreated",
+    ORDER_SALE_DOCUMENT_CREATED: "orderSaleDocumentCreated",
+    ORDER_SALE_DOCUMENT_UPDATED: "orderSaleDocumentUpdated",
+    ORDER_SENT: "orderSent",
+    ORDER_DELIVERED: "orderDelivered",
+    ORDER_CANCELED: "orderCanceled",
+    RETURN_CREATED: "returnCreated",
+    RETURN_UPDATED: "returnUpdated",
+    RETURN_FUNDS_CONFIRMED: "returnFundsConfirmed",
+    RETURN_PACKAGE_CREATED: "returnPackageCreated",
+    RETURN_CONFIRMED: "returnConfirmed",
+    RETURN_CANCELED: "returnCanceled",
+    RMA_CREATED: "rmaCreated",
+    RMA_UPDATED: "rmaUpdated",
+    RMA_PACKAGE_CREATED: "rmaPackageCreated",
+    RMA_APPROVED: "rmaApproved",
+    RMA_REJECTED: "rmaRejected",
+};
+// ─── Runtime event → object map ───────────────────────────────────────────────
+const EVENT_OBJECT_MAP = {
+    clientCreated: "client",
+    clientUpdated: "client",
+    productCreated: "product",
+    productUpdated: "product",
+    productPriceUpdated: "product",
+    productStockUpdated: "product",
+    productDispositionUpdated: "product",
+    orderCreated: "order",
+    orderUpdated: "order",
+    orderPaid: "order",
+    orderStatusUpdated: "order",
+    orderPackageCreated: "order",
+    orderFilesCreated: "order",
+    orderSaleDocumentCreated: "order",
+    orderSaleDocumentUpdated: "order",
+    orderSent: "order",
+    orderDelivered: "order",
+    orderCanceled: "order",
+    returnCreated: "return",
+    returnUpdated: "return",
+    returnFundsConfirmed: "return",
+    returnPackageCreated: "return",
+    returnConfirmed: "return",
+    returnCanceled: "return",
+    rmaCreated: "rma",
+    rmaUpdated: "rma",
+    rmaPackageCreated: "rma",
+    rmaApproved: "rma",
+    rmaRejected: "rma",
+};
+export class WebhookChain {
+    slots = [];
+    validator = null;
+    validateHeaders(validator) {
+        this.validator = validator;
+        return this;
+    }
+    on(eventType, handler) {
+        this.slots.push({
+            eventType,
+            fn: handler,
+        });
+        return this;
+    }
+    async handle(req) {
+        const { headers, body } = await normalizeIaiRequest(req);
+        if (this.validator !== null) {
+            let valid = false;
+            try {
+                valid = await this.validator(headers);
+            }
+            catch {
+                valid = false;
+            }
+            if (!valid) {
+                return { matched: false, eventType: null, reason: "validation_failed" };
+            }
+        }
+        const incomingEvent = headers.eventType;
+        const expectedObject = EVENT_OBJECT_MAP[incomingEvent];
+        if (expectedObject !== undefined && headers.objectType !== expectedObject) {
+            throw new WebhookValidationError(`eventType "${incomingEvent}" expects objectType "${expectedObject}", got "${headers.objectType}"`, "x-iai-object-type");
+        }
+        const slot = this.slots.find(s => s.eventType === incomingEvent);
+        if (!slot) {
+            return { matched: false, eventType: incomingEvent };
+        }
+        await slot.fn({ headers, body });
+        return { matched: true, eventType: slot.eventType };
+    }
+}
+// ─── Entry point ──────────────────────────────────────────────────────────────
+export const webhooks = {
+    validateHeaders(validator) {
+        return new WebhookChain().validateHeaders(validator);
+    },
+    on(eventType, handler) {
+        return new WebhookChain().on(eventType, handler);
+    },
+};
+export default webhooks;

package/dist/webhooks.normalizer.js

@@ -0,0 +1,140 @@
+// ─── Errors ──────────────────────────────────────────────────────────────────
+export class WebhookValidationError extends Error {
+    field;
+    constructor(message, field) {
+        super(message);
+        this.field = field;
+        this.name = `WebhookValidationError ${field}`;
+    }
+}
+// ─── Internal helpers ────────────────────────────────────────────────────────
+function requireHeader(headers, key) {
+    const value = headers[key];
+    if (!value || value.trim() === "") {
+        throw new WebhookValidationError(`Missing or empty required header: ${key}`, key);
+    }
+    return value.trim();
+}
+function parseIntHeader(headers, key) {
+    const raw = requireHeader(headers, key);
+    const n = Number(raw);
+    if (!Number.isInteger(n) || n < 0) {
+        throw new WebhookValidationError(`Header ${key} must be a positive integer, got: "${raw}"`, key);
+    }
+    return n;
+}
+function parseDateHeader(headers, key) {
+    const raw = requireHeader(headers, key);
+    const date = new Date(raw);
+    if (isNaN(date.getTime())) {
+        throw new WebhookValidationError(`Header ${key} is not a valid date string, got: "${raw}"`, key);
+    }
+    return date;
+}
+function parseAuthHeader(headers) {
+    const raw = requireHeader(headers, "authorization");
+    const [scheme, token] = raw.split(" ");
+    if (scheme?.toLowerCase() !== "bearer" || !token) {
+        throw new WebhookValidationError(`Authorization header must use Bearer scheme, got: "${raw}"`, "authorization");
+    }
+    return token;
+}
+function extractHeaders(raw) {
+    return {
+        token: parseAuthHeader(raw),
+        apiVersion: parseIntHeader(raw, "x-iai-api-version"),
+        eventTime: parseDateHeader(raw, "x-iai-event-time"),
+        eventType: requireHeader(raw, "x-iai-event-type"),
+        eventUid: requireHeader(raw, "x-iai-event-uid"),
+        objectType: requireHeader(raw, "x-iai-object-type"),
+        panelId: parseIntHeader(raw, "x-iai-panel-id"),
+        signature: requireHeader(raw, "x-iai-signature"),
+        webhookTime: parseDateHeader(raw, "x-iai-webhook-time"),
+    };
+}
+// ─── Type guard ──────────────────────────────────────────────────────────────
+function isWebRequest(req) {
+    return typeof req.json === "function";
+}
+// ─── Raw headers flattening ──────────────────────────────────────────────────
+function flattenNodeHeaders(headers) {
+    const out = {};
+    for (const [key, value] of Object.entries(headers)) {
+        if (value !== undefined) {
+            out[key.toLowerCase()] = Array.isArray(value) ? value.join(", ") : value;
+        }
+    }
+    return out;
+}
+function flattenWebHeaders(headers) {
+    const out = {};
+    headers.forEach((value, key) => { out[key.toLowerCase()] = value; });
+    return out;
+}
+function readNodeStream(req) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        req.on("data", (chunk) => chunks.push(chunk));
+        req.on("end", () => resolve(Buffer.concat(chunks).toString("utf-8")));
+        req.on("error", reject);
+    });
+}
+// ─── Main normalizer ─────────────────────────────────────────────────────────
+/**
+ * Parses and validates an incoming IAI webhook request from any of:
+ *   - Express          (pass req directly — do NOT attach express.json())
+ *   - Next.js Pages    (disable bodyParser in route config)
+ *   - Next.js App      (Web Fetch API Request)
+ *   - SvelteKit        (Web Fetch API Request — pass event.request)
+ *
+ * Throws WebhookValidationError for any missing/malformed header or empty body.
+ *
+ * @example Express
+ * app.post('/webhook', async (req, res) => {
+ *   const { headers, body } = await normalizeIaiRequest(req);
+ * });
+ *
+ * @example SvelteKit
+ * export async function POST({ request }) {
+ *   const { headers, body } = await normalizeIaiRequest(request);
+ * }
+ *
+ * @example Next.js App Router
+ * export async function POST(request: Request) {
+ *   const { headers, body } = await normalizeIaiRequest(request);
+ * }
+ *
+ * @example Next.js Pages Router (add export const config = { api: { bodyParser: false } })
+ * export default async function handler(req, res) {
+ *   const { headers, body } = await normalizeIaiRequest(req);
+ * }
+ */
+export async function normalizeIaiRequest(req) {
+    let flatHeaders;
+    let rawBody;
+    if (isWebRequest(req)) {
+        flatHeaders = flattenWebHeaders(req.headers);
+        rawBody = await req.text();
+    }
+    else {
+        flatHeaders = flattenNodeHeaders(req.headers);
+        rawBody = req.body !== undefined
+            ? JSON.stringify(req.body)
+            : await readNodeStream(req);
+    }
+    if (!rawBody || rawBody.trim() === "") {
+        throw new WebhookValidationError("Request body is empty", "body");
+    }
+    let body;
+    try {
+        body = JSON.parse(rawBody);
+    }
+    catch {
+        throw new WebhookValidationError("Request body is not valid JSON", "body");
+    }
+    if (typeof body !== "object" || body === null || Array.isArray(body)) {
+        throw new WebhookValidationError("Request body must be a JSON object", "body");
+    }
+    const headers = extractHeaders(flatHeaders);
+    return { headers, body };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "idosell",
-  "version": "0.4.34",
+  "version": "0.4.41",
   "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"
 }