@mframework/layer-commerce 0.0.3

package/app/normalizers/Config.query.ts

@@ -0,0 +1,224 @@
+/**
+ * ScandiPWA - Progressive Web App for Magento
+ *
+ * Copyright © Scandiweb, Inc. All rights reserved.
+ * See LICENSE for license details.
+ *
+ * @license OSL-3.0 (Open Software License ("OSL") v. 3.0)
+ * @package scandipwa/scandipwa-theme
+ * @link https://github.com/scandipwa/scandipwa-theme
+ */
+
+import { Field, Query } from '@tilework/opus';
+
+import { GQLCheckoutAgreementMode } from '../types/Graphql.type';
+
+import {
+    AvailableCurrency,
+    CheckoutAgreement,
+    Currencies,
+    CurrencyData,
+    ExchangeRate,
+    PriceTaxDisplay,
+    StoreConfig,
+    StoreConfigFields,
+    StoreItem,
+} from './Config.type';
+
+/** @namespace ../../normalizers/Config/Query */
+export class ConfigQuery {
+    getStoreListField(): Query<'storeList', StoreItem, true> {
+        return new Query<'storeList', StoreItem, true>('storeList', true)
+            .addFieldList(this._getStoreListFields());
+    }
+
+    getCheckoutAgreements(): Query<'checkoutAgreements', CheckoutAgreement, true> {
+        return new Query<'checkoutAgreements', CheckoutAgreement, true>('checkoutAgreements', true)
+            .addFieldList(this._getCheckoutAgreementFields());
+    }
+
+    getCurrencyData(): Query<'currencyData', CurrencyData> {
+        return new Query<'currencyData', CurrencyData>('currencyData')
+            .addFieldList([
+                this.getCurrencyFields(),
+                new Field<'current_currency_code', string>('current_currency_code'),
+            ]);
+    }
+
+    getCurrencyFields(): Field<'available_currencies_data', AvailableCurrency, true> {
+        return new Field<'available_currencies_data', AvailableCurrency, true>('available_currencies_data', true)
+            .addFieldList(this._getAvailableCurrenciesFields());
+    }
+
+    _getAvailableCurrenciesFields(): Array<
+    Field<'id', string>
+    | Field<'label', string>
+    | Field<'value', string>
+    > {
+        return [
+            new Field<'id', string>('id'),
+            new Field<'label', string>('label'),
+            new Field<'value', string>('value'),
+        ];
+    }
+
+    getCurrencyRates(): Query<'currency', Currencies> {
+        return new Query<'currency', Currencies>('currency').addFieldList(this.getCurrencyRatesFields());
+    }
+
+    getCurrencyRatesFields(): Array<
+    Field<'base_currency_code', string>
+    | Field<'exchange_rates', ExchangeRate, true>
+    > {
+        return [
+            new Field<'base_currency_code', string>('base_currency_code'),
+            new Field<
+            'exchange_rates',
+            ExchangeRate,
+            true
+            >('exchange_rates').addFieldList(this._getExchangeRatesFields()),
+        ];
+    }
+
+    _getExchangeRatesFields(): Array<
+    Field<'currency_to', string>
+    | Field<'rate', string>
+    > {
+        return [
+            new Field<'currency_to', string>('currency_to'),
+            new Field<'rate', string>('rate'),
+        ];
+    }
+
+    _getPriceDisplayTypeField(): Field<'priceTaxDisplay', PriceTaxDisplay> {
+        return new Field<'priceTaxDisplay', PriceTaxDisplay>('priceTaxDisplay')
+            .addFieldList([
+                new Field<'product_price_display_type', string>('product_price_display_type'),
+                new Field<'shipping_price_display_type', string>('shipping_price_display_type'),
+            ]);
+    }
+
+    _getCheckoutAgreementFields(): Array<
+    Field<'agreement_id', number>
+    | Field<'checkbox_text', string>
+    | Field<'content', string>
+    | Field<'content_height', number>
+    | Field<'is_html', boolean>
+    | Field<'mode', GQLCheckoutAgreementMode>
+    | Field<'name', string>
+    > {
+        return [
+            new Field<'agreement_id', number>('agreement_id'),
+            new Field<'checkbox_text', string>('checkbox_text'),
+            new Field<'content', string>('content'),
+            new Field<'content_height', number>('content_height'),
+            new Field<'is_html', boolean>('is_html'),
+            new Field<'mode', GQLCheckoutAgreementMode>('mode'),
+            new Field<'name', string>('name'),
+        ];
+    }
+
+    _getStoreListFields(): Array<
+    Field<'name', string>
+    | Field<'is_active', boolean>
+    | Field<'base_url', string>
+    | Field<'base_link_url', string>
+    | Field<'code', string>
+    > {
+        return [
+            new Field<'name', string>('name'),
+            new Field<'is_active', boolean>('is_active'),
+            new Field<'base_url', string>('base_url'),
+            new Field<'base_link_url', string>('base_link_url'),
+            new Field<'code', string>('code'),
+        ];
+    }
+
+    getQuery(): Query<'storeConfig', StoreConfig> {
+        return new Query<'storeConfig', StoreConfig>('storeConfig')
+            .addFieldList(this._getStoreConfigFields());
+    }
+
+    _getTimeDateFormatFields(): Array<
+    Field<'use_calendar', boolean>
+    | Field<'year_range', string>
+    | Field<'date_fields_order', string>
+    | Field<'time_format', string>
+    > {
+        return [
+            new Field<'use_calendar', boolean>('use_calendar'),
+            new Field<'year_range', string>('year_range'),
+            new Field<'date_fields_order', string>('date_fields_order'),
+            new Field<'time_format', string>('time_format'),
+        ];
+    }
+
+    _getStoreConfigFields(): StoreConfigFields {
+        return [
+            new Field<'code', string>('code'),
+            new Field<'is_active', boolean>('is_active'),
+            new Field<'cms_home_page', string>('cms_home_page'),
+            new Field<'cms_no_route', string>('cms_no_route'),
+            new Field<'copyright', string>('copyright'),
+            new Field<'timezone', string>('timezone'),
+            new Field<'header_logo_src', string>('header_logo_src'),
+            new Field<'title_prefix', string>('title_prefix'),
+            new Field<'title_suffix', string>('title_suffix'),
+            new Field<'default_display_currency_code', string>('default_display_currency_code'),
+            new Field<'default_keywords', string>('default_keywords'),
+            new Field<'default_title', string>('default_title'),
+            new Field<'default_description', string>('default_description'),
+            new Field<'default_country', string>('default_country'),
+            new Field<'downloadable_links_target_new_window', boolean>('downloadable_links_target_new_window'),
+            new Field<'secure_base_media_url', string>('secure_base_media_url'),
+            new Field<'logo_alt', string>('logo_alt'),
+            new Field<'logo_height', number>('logo_height'),
+            new Field<'logo_width', number>('logo_width'),
+            new Field<'cookie_text', string>('cookie_text'),
+            new Field<'cookie_link', string>('cookie_link'),
+            new Field<'terms_are_enabled', boolean>('terms_are_enabled'),
+            new Field<'address_lines_quantity', number>('address_lines_quantity'),
+            new Field<'base_url', string>('base_url'),
+            new Field<'pagination_frame', number>('pagination_frame'),
+            new Field<'pagination_frame_skip', number>('pagination_frame_skip'),
+            new Field<'anchor_text_for_previous', string>('anchor_text_for_previous'),
+            new Field<'anchor_text_for_next', string>('anchor_text_for_next'),
+            new Field<'reviews_are_enabled', boolean>('reviews_are_enabled'),
+            new Field<'reviews_allow_guest', boolean>('reviews_allow_guest'),
+            new Field<'wishlist_general_active', boolean>('wishlist_general_active'),
+            new Field<'demo_notice', boolean>('demo_notice'),
+            new Field<'guest_checkout', boolean>('guest_checkout'),
+            new Field<'is_email_confirmation_required', boolean>('is_email_confirmation_required'),
+            new Field<'display_product_stock_status', boolean>('display_product_stock_status'),
+            new Field<'base_link_url', string>('base_link_url'),
+            new Field<'show_vat_number_on_storefront', boolean>('show_vat_number_on_storefront'),
+            new Field<'show_tax_vat_number', boolean>('show_tax_vat_number'),
+            new Field<'product_use_categories', boolean>('product_use_categories'),
+            new Field<'category_url_suffix', string>('category_url_suffix'),
+            new Field<'cookie_lifetime', string>('cookie_lifetime'),
+            new Field<'plp_list_mode', string>('plp_list_mode'),
+            new Field<'layered_navigation_product_count_enabled', boolean>('layered_navigation_product_count_enabled'),
+            new Field<'region_display_all', boolean>('region_display_all'),
+            new Field<'redirect_dashboard', boolean>('redirect_dashboard'),
+            new Field<'product_alert_allow_price', boolean>('product_alert_allow_price'),
+            new Field<'product_alert_allow_stock', boolean>('product_alert_allow_stock'),
+            new Field<'newsletter_general_active', boolean>('newsletter_general_active'),
+            new Field<'newsletter_subscription_allow_guest_subscribe', boolean>(
+                'newsletter_subscription_allow_guest_subscribe',
+            ),
+            new Field<'newsletter_subscription_confirm', boolean>('newsletter_subscription_confirm'),
+            new Field<'delivery_instore_active', boolean>('delivery_instore_active'),
+            new Field<'access_token_lifetime', string>('access_token_lifetime'),
+            new Field<'is_allowed_reorder', boolean>('is_allowed_reorder'),
+            new Field<'rss_order_subscribe_allow', boolean>('rss_order_subscribe_allow'),
+            new Field<'downloadable_disable_guest_checkout', boolean>('downloadable_disable_guest_checkout'),
+            new Field<'minimun_password_length', number>('minimun_password_length'),
+            new Field<'required_character_classes_number', string>('required_character_classes_number'),
+            new Field<'catalog_default_sort_by', string>('catalog_default_sort_by'),
+            ...this._getTimeDateFormatFields(),
+            this._getPriceDisplayTypeField(),
+        ];
+    }
+}
+
+export default new ConfigQuery();

package/app/normalizers/Config.type.ts

@@ -0,0 +1,196 @@
+/**
+ * ScandiPWA - Progressive Web App for Magento
+ *
+ * Copyright © Scandiweb, Inc. All rights reserved.
+ * See LICENSE for license details.
+ *
+ * @license OSL-3.0 (Open Software License ("OSL") v. 3.0)
+ * @package scandipwa/scandipwa-theme
+ * @link https://github.com/scandipwa/scandipwa
+ */
+
+import { Field } from '@tilework/opus';
+
+import { GQLCheckoutAgreementMode, GQLCurrencyEnum } from '../types/Graphql.type';
+
+export interface PriceTaxDisplay {
+    product_price_display_type: string;
+    shipping_price_display_type: string;
+}
+
+export type StoreConfigFields = Array<
+Field<'code', string>
+| Field<'is_active', boolean>
+| Field<'cms_home_page', string>
+| Field<'cms_no_route', string>
+| Field<'copyright', string>
+| Field<'timezone', string>
+| Field<'header_logo_src', string>
+| Field<'title_prefix', string>
+| Field<'title_suffix', string>
+| Field<'default_display_currency_code', string>
+| Field<'default_keywords', string>
+| Field<'default_title', string>
+| Field<'default_description', string>
+| Field<'default_country', string>
+| Field<'downloadable_links_target_new_window', boolean>
+| Field<'secure_base_media_url', string>
+| Field<'logo_alt', string>
+| Field<'logo_height', number>
+| Field<'logo_width', number>
+| Field<'cookie_text', string>
+| Field<'cookie_link', string>
+| Field<'terms_are_enabled', boolean>
+| Field<'address_lines_quantity', number>
+| Field<'base_url', string>
+| Field<'pagination_frame', number>
+| Field<'pagination_frame_skip', number>
+| Field<'anchor_text_for_previous', string>
+| Field<'anchor_text_for_next', string>
+| Field<'reviews_are_enabled', boolean>
+| Field<'reviews_allow_guest', boolean>
+| Field<'wishlist_general_active', boolean>
+| Field<'demo_notice', boolean>
+| Field<'guest_checkout', boolean>
+| Field<'is_email_confirmation_required', boolean>
+| Field<'display_product_stock_status', boolean>
+| Field<'base_link_url', string>
+| Field<'show_vat_number_on_storefront', boolean>
+| Field<'show_tax_vat_number', boolean>
+| Field<'product_use_categories', boolean>
+| Field<'category_url_suffix', string>
+| Field<'cookie_lifetime', string>
+| Field<'plp_list_mode', string>
+| Field<'layered_navigation_product_count_enabled', boolean>
+| Field<'region_display_all', boolean>
+| Field<'redirect_dashboard', boolean>
+| Field<'product_alert_allow_price', boolean>
+| Field<'product_alert_allow_stock', boolean>
+| Field<'newsletter_general_active', boolean>
+| Field<'newsletter_subscription_allow_guest_subscribe', boolean>
+| Field<'newsletter_subscription_confirm', boolean>
+| Field<'delivery_instore_active', boolean>
+| Field<'access_token_lifetime', string>
+| Field<'is_allowed_reorder', boolean>
+| Field<'rss_order_subscribe_allow', boolean>
+| Field<'downloadable_disable_guest_checkout', boolean>
+| Field<'minimun_password_length', number>
+| Field<'required_character_classes_number', string>
+| Field<'use_calendar', boolean>
+| Field<'year_range', string>
+| Field<'date_fields_order', string>
+| Field<'time_format', string>
+| Field<'priceTaxDisplay', PriceTaxDisplay>
+| Field<'catalog_default_sort_by', string>
+>;
+
+export interface StoreConfig {
+    code: string;
+    is_active: boolean;
+    cms_home_page: string;
+    cms_no_route: string;
+    copyright: string;
+    timezone: string;
+    header_logo_src: string;
+    title_prefix: string;
+    title_suffix: string;
+    default_display_currency_code: string;
+    default_keywords: string;
+    default_title: string;
+    default_description: string;
+    default_country: string;
+    downloadable_links_target_new_window: boolean;
+    secure_base_media_url: string;
+    logo_alt: string;
+    logo_height: number;
+    logo_width: number;
+    cookie_text: string;
+    cookie_link: string;
+    terms_are_enabled: boolean;
+    address_lines_quantity: number;
+    base_url: string;
+    pagination_frame: number;
+    pagination_frame_skip: number;
+    anchor_text_for_previous: string;
+    anchor_text_for_next: string;
+    reviews_are_enabled: boolean;
+    reviews_allow_guest: boolean;
+    wishlist_general_active: boolean;
+    demo_notice: boolean;
+    guest_checkout: boolean;
+    is_email_confirmation_required: boolean;
+    display_product_stock_status: boolean;
+    base_link_url: string;
+    show_vat_number_on_storefront: boolean;
+    show_tax_vat_number: string;
+    product_use_categories: boolean;
+    category_url_suffix: string;
+    cookie_lifetime: string;
+    plp_list_mode: string;
+    layered_navigation_product_count_enabled: boolean;
+    region_display_all: boolean;
+    redirect_dashboard: boolean;
+    product_alert_allow_price: boolean;
+    product_alert_allow_stock: boolean;
+    newsletter_general_active: boolean;
+    newsletter_subscription_allow_guest_subscribe: boolean;
+    newsletter_subscription_confirm: boolean;
+    delivery_instore_active: boolean;
+    access_token_lifetime: string;
+    is_allowed_reorder: boolean;
+    rss_order_subscribe_allow: boolean;
+    downloadable_disable_guest_checkout: boolean;
+    minimun_password_length: number;
+    required_character_classes_number: string;
+    use_calendar: boolean;
+    year_range: string;
+    date_fields_order: string;
+    time_format: string;
+    priceTaxDisplay: PriceTaxDisplay;
+    catalog_default_sort_by: string;
+}
+
+export interface StoreItem {
+    name: string;
+    is_active: boolean;
+    base_url: string;
+    base_link_url: string;
+    code: string;
+}
+
+export interface Currency {
+    id: string;
+    label: string;
+    value: string;
+}
+
+export interface CurrencyData {
+    available_currencies_data: Currency[];
+    current_currency_code: GQLCurrencyEnum;
+}
+
+export interface CheckoutAgreement {
+    agreement_id: number;
+    checkbox_text: string;
+    content: string;
+    content_height: number;
+    is_html: boolean;
+    mode: GQLCheckoutAgreementMode;
+    name: string;
+}
+
+export interface AvailableCurrency {
+    id: string;
+    label: string;
+    value: string;
+}
+
+export interface ExchangeRate {
+    currency_to: string;
+    rate: string;
+}
+
+export interface Currencies {
+    base_currency_code: string;
+    exchange_rates: ExchangeRate[];
+}

package/app/normalizers/ContactForm.query.ts

@@ -0,0 +1,49 @@
+/**
+ * ScandiPWA - Progressive Web App for Magento
+ *
+ * Copyright © Scandiweb, Inc. All rights reserved.
+ * See LICENSE for license details.
+ *
+ * @license OSL-3.0 (Open Software License ("OSL") v. 3.0)
+ * @package scandipwa/scandipwa-theme
+ * @link https://github.com/scandipwa/scandipwa-theme
+ */
+
+import { Field, Mutation, Query } from '@tilework/opus';
+
+import { NetworkError } from '../types/Common.type';
+import { GQLContactForm } from '../types/Graphql.type';
+
+/** @namespace ../../normalizers/ContactForm/Query */
+export class ContactFormQuery {
+    getSendContactFormMutation(options: GQLContactForm): Mutation<'contactForm', NetworkError> {
+        const mutation = new Mutation<'contactForm', NetworkError>('contactForm');
+
+        this._addSendContactFormMutationArguments(mutation, options);
+        mutation.addFieldList(this._getSendContactFormMutationResponse());
+
+        return mutation;
+    }
+
+    getContactPageConfigQuery(): Query<'contactPageConfig', { enabled: boolean }> {
+        return new Query<'contactPageConfig', { enabled: boolean }>('contactPageConfig')
+            .addFieldList(this._getContactPageConfigFields());
+    }
+
+    _addSendContactFormMutationArguments(
+        mutation: Mutation<'contactForm', NetworkError>,
+        options: GQLContactForm,
+    ): Mutation<'contactForm', NetworkError> {
+        return mutation.addArgument('contact', 'ContactForm!', options);
+    }
+
+    _getSendContactFormMutationResponse(): Field<'message', string>[] {
+        return [new Field<'message', string>('message')];
+    }
+
+    _getContactPageConfigFields(): Field<'enabled', boolean>[] {
+        return [new Field<'enabled', boolean>('enabled')];
+    }
+}
+
+export default new ContactFormQuery();

package/app/normalizers/CreditMemo.type.ts

@@ -0,0 +1,49 @@
+import { normalizeOrder } from './Order.type';
+import type { Order as DomainOrder } from '../types/domain';
+
+// Map credit memo (refund) shapes into a predictable structure. Keep a
+// permissive fallback to `normalizeOrder` for unfamiliar shapes.
+export function normalizeCreditMemo(raw: any): DomainOrder {
+  if (!raw) return raw;
+
+  const id = raw?.id ?? raw?.creditmemo_id ?? raw?.increment_id ?? '';
+  const number = raw?.increment_id ?? raw?.number ?? raw?.creditmemo_number ?? '';
+  const created_at = raw?.created_at ?? raw?.creditmemo_date ?? raw?.date;
+  const status = raw?.status ?? raw?.state ?? 'refunded';
+
+  const items = Array.isArray(raw?.items)
+    ? raw.items.map((it: any) => ({
+        id: String(it?.id ?? it?.item_id ?? ''),
+        sku: it?.sku ?? it?.product_sku ?? it?.product?.sku,
+        quantity: it?.quantity_refunded ?? it?.qty ?? it?.qty_refunded ?? 0,
+        price: it?.price ?? it?.row_subtotal ?? undefined,
+        product: it?.product ? {
+          id: String(it.product?.id ?? it.product?.sku ?? ''),
+          sku: it.product?.sku,
+          title: it.product?.name ?? it.product?.title,
+        } : undefined,
+        raw: it,
+      }))
+    : [];
+
+  const total = raw?.total ?? raw?.refund_amount ?? raw?.grand_total ?? raw?.amount;
+
+  if (!id && !number && !Array.isArray(raw?.items)) return normalizeOrder(raw);
+
+  return {
+    id: String(id),
+    number,
+    created_at,
+    status,
+    items,
+    total,
+    raw,
+  };
+}
+
+export const normalizeCreditMemos = (raw: any): DomainOrder[] => {
+  if (!raw) return [];
+  if (Array.isArray(raw)) return raw.map(normalizeCreditMemo);
+  if (Array.isArray(raw.items)) return raw.items.map(normalizeCreditMemo);
+  return [];
+};

package/app/normalizers/GiftCard.type.ts

@@ -0,0 +1,24 @@
+import { GiftCard as DomainGiftCard } from '../types/domain';
+
+export interface GiftCardFragment {
+  code: string;
+  balance?: number;
+  currency?: string;
+}
+
+export function normalizeGiftCard(raw: any): DomainGiftCard {
+  if (!raw) return raw;
+  return {
+    code: raw?.code ?? raw?.giftcard_code ?? '',
+    balance: raw?.balance ?? raw?.amount ?? raw?.balance_amount,
+    currency: raw?.currency ?? raw?.currency_code,
+    raw,
+  } as DomainGiftCard;
+}
+
+export function normalizeGiftCards(raw: any): DomainGiftCard[] {
+  if (!raw) return [];
+  if (Array.isArray(raw)) return raw.map(normalizeGiftCard);
+  if (Array.isArray(raw?.items)) return raw.items.map(normalizeGiftCard);
+  return [];
+}

package/app/normalizers/Invoice.type.ts

@@ -0,0 +1,58 @@
+import { normalizeOrder } from './Order.type';
+import type { Order as DomainOrder } from '../types/domain';
+
+// Provide a richer invoice normalizer that maps common invoice fields into
+// a predictable shape consumers expect. We still fall back to `normalizeOrder`
+// for unknown shapes to remain permissive.
+export function normalizeInvoice(raw: any): DomainOrder {
+  if (!raw) return raw;
+
+  // Base fields: id/number/date/status/raw
+  const id = raw?.id ?? raw?.invoice_id ?? raw?.increment_id ?? '';
+  const number = raw?.increment_id ?? raw?.number ?? raw?.invoice_number ?? '';
+  const created_at = raw?.created_at ?? raw?.invoice_date ?? raw?.date;
+  const status = raw?.status ?? raw?.state;
+
+  // Normalize items: try common shapes (invoice.items, items, lines)
+  const items = Array.isArray(raw?.items)
+    ? raw.items.map((it: any) => ({
+        id: String(it?.id ?? it?.item_id ?? it?.uid ?? ''),
+        sku: it?.sku ?? it?.product_sku ?? it?.product?.sku,
+        quantity: it?.quantity ?? it?.qty ?? it?.quantity_invoiced ?? 0,
+        price: it?.price ?? it?.price_incl_tax ?? it?.row_subtotal ?? undefined,
+        product: it?.product ? {
+          id: String(it.product?.id ?? it.product?.sku ?? ''),
+          sku: it.product?.sku,
+          title: it.product?.name ?? it.product?.title,
+          price: (it.product?.price && (it.product.price.final_price?.value ?? it.product.price)) ?? undefined,
+          images: Array.isArray(it.product?.media_gallery_entries)
+            ? it.product.media_gallery_entries.map((m: any) => ({ url: m.file ?? m.url }))
+            : []
+        } : undefined,
+        raw: it,
+      }))
+    : [];
+
+  // Total mapping: prefer structured totals, fall back to simple grand_total
+  const total = raw?.total ?? raw?.grand_total ?? raw?.total_amount ?? raw?.amount;
+
+  // If the shape is unusual, fall back to order normalizer for maximum compatibility
+  if (!id && !number && !Array.isArray(raw?.items)) return normalizeOrder(raw);
+
+  return {
+    id: String(id),
+    number,
+    created_at,
+    status,
+    items,
+    total,
+    raw,
+  };
+}
+
+export const normalizeInvoices = (raw: any): DomainOrder[] => {
+  if (!raw) return [];
+  if (Array.isArray(raw)) return raw.map(normalizeInvoice);
+  if (Array.isArray(raw.items)) return raw.items.map(normalizeInvoice);
+  return [];
+};

package/app/normalizers/Menu.query.ts

@@ -0,0 +1,54 @@
+/**
+ * ScandiPWA - Progressive Web App for Magento
+ *
+ * Copyright © Scandiweb, Inc. All rights reserved.
+ * See LICENSE for license details.
+ *
+ * @license OSL-3.0 (Open Software License ("OSL") v. 3.0)
+ * @package scandipwa/scandipwa-theme
+ * @link https://github.com/scandipwa/scandipwa-theme
+ */
+
+import { Field, Query } from '@tilework/opus';
+
+import { CategoryDisplayMode } from '../routes/CategoryPage/CategoryPage.config';
+
+import { MenuItem } from './Menu.type';
+/**
+ * Menu Query
+ * @class MenuQuery
+ * @namespace ../../normalizers/Menu/Query */
+export class MenuQuery {
+    /**
+     * get Menu query
+     * @return {Field} Menu query
+     * @memberof MenuQuery
+     */
+    getQuery(): Query<'menu', MenuItem, true> {
+        return new Query<'menuItems', MenuItem, true>('menuItems', true)
+            .addFieldList(this._getMenuItemFields())
+            .setAlias('menu');
+    }
+
+    _getMenuItemFields(): Array<
+    Field<'url', string>
+    | Field<'title', string>
+    | Field<'item_id', string>
+    | Field<'position', number>
+    | Field<'parent_id', number>
+    | Field<'category_id', number>
+    | Field<'display_mode', CategoryDisplayMode>
+    > {
+        return [
+            new Field<'url', string>('url'),
+            new Field<'title', string>('title'),
+            new Field<'item_id', string>('item_id'),
+            new Field<'position', number>('position'),
+            new Field<'parent_id', number>('parent_id'),
+            new Field<'category_id', number>('category_id'),
+            new Field<'display_mode', CategoryDisplayMode>('display_mode'),
+        ];
+    }
+}
+
+export default new MenuQuery();

package/app/normalizers/Menu.type.ts

@@ -0,0 +1,22 @@
+/**
+ * ScandiPWA - Progressive Web App for Magento
+ *
+ * Copyright © Scandiweb, Inc. All rights reserved.
+ * See LICENSE for license details.
+ *
+ * @license OSL-3.0 (Open Software License ("OSL") v. 3.0)
+ * @package scandipwa/scandipwa-theme
+ * @link https://github.com/scandipwa/scandipwa
+ */
+
+import { CategoryDisplayMode } from '../routes/CategoryPage/CategoryPage.config';
+
+export interface MenuItem {
+    url: string;
+    title: string;
+    item_id: string;
+    position: number;
+    parent_id: number;
+    category_id: number;
+    display_mode: CategoryDisplayMode;
+}