@controleonline/ui-default 1.0.272 → 1.0.274

package/.github/workflows/publish-npm.yml

@@ -0,0 +1,91 @@
+name: Publish Package to npmjs
+
+on:
+  push:
+
+permissions:
+  contents: write
+  id-token: write
+
+concurrency:
+  group: ${{ github.repository }}-npm-release
+  cancel-in-progress: false
+
+jobs:
+  publish:
+    if: ${{ github.repository_owner == 'ControleOnline' && (github.ref == 'refs/heads/dev' || github.ref == 'refs/heads/master' || startsWith(github.ref, 'refs/tags/v')) }}
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ github.ref }}
+          fetch-depth: 0
+      - name: Validate package metadata and create version tag
+        id: release
+        env:
+          REF_TYPE: ${{ github.ref_type }}
+          REF_NAME: ${{ github.ref_name }}
+          EXPECTED_REPOSITORY: ${{ github.repository }}
+        run: |
+          node <<'NODE'
+          const fs = require('node:fs');
+          const cp = require('node:child_process');
+          const pkg = require('./package.json');
+          const expectedUrl = `https://github.com/${process.env.EXPECTED_REPOSITORY}`;
+          if (!/^\d+\.\d+\.\d+$/.test(String(pkg.version))) throw new Error(`Expected stable X.Y.Z, got ${pkg.version}`);
+          if (pkg.repository?.url !== expectedUrl) throw new Error(`repository.url must be ${expectedUrl}; got ${pkg.repository?.url}`);
+          const sourceSha = cp.execFileSync('git', ['rev-parse', 'HEAD'], {encoding:'utf8'}).trim();
+          let tag = '';
+          if (process.env.REF_TYPE === 'tag') {
+            tag = process.env.REF_NAME;
+            if (tag !== `v${pkg.version}`) throw new Error(`Tag ${tag} does not match package version ${pkg.version}`);
+          } else {
+            let previous = '';
+            try { previous = JSON.parse(cp.execFileSync('git', ['show', `${sourceSha}^:package.json`], {encoding:'utf8'})).version || ''; } catch {}
+            if (previous === pkg.version) { fs.appendFileSync(process.env.GITHUB_OUTPUT, 'release_tag=\n'); process.exit(0); }
+            const parts = String(pkg.version).split('.').map(Number);
+            if (previous) {
+              const old = String(previous).split('.').map(Number);
+              let cmp = 0; for (let i=0;i<3;i++) { if ((parts[i]||0)!==(old[i]||0)) { cmp=(parts[i]||0)>(old[i]||0)?1:-1; break; } }
+              if (cmp <= 0) throw new Error(`Version ${pkg.version} must be greater than first-parent version ${previous}`);
+            }
+            tag = `v${pkg.version}`;
+            const existing = cp.spawnSync('git', ['ls-remote', '--exit-code', '--refs', 'origin', `refs/tags/${tag}`], {encoding:'utf8'});
+            if (existing.status === 0) {
+              cp.execFileSync('git', ['fetch', 'origin', `refs/tags/${tag}:refs/tags/${tag}`], {stdio:'inherit'});
+              const tagged = cp.execFileSync('git', ['rev-parse', `${tag}^{commit}`], {encoding:'utf8'}).trim();
+              if (tagged !== sourceSha) throw new Error(`Immutable tag ${tag} already points at ${tagged}, not ${sourceSha}`);
+            } else {
+              cp.execFileSync('git', ['config', 'user.name', 'github-actions[bot]']);
+              cp.execFileSync('git', ['config', 'user.email', '41898282+github-actions[bot]@users.noreply.github.com']);
+              cp.execFileSync('git', ['tag', '-a', tag, sourceSha, '-m', `Release ${pkg.name}@${pkg.version}`], {stdio:'inherit'});
+              cp.execFileSync('git', ['push', 'origin', `refs/tags/${tag}`], {stdio:'inherit'});
+            }
+          }
+          fs.appendFileSync(process.env.GITHUB_OUTPUT, `release_tag=${tag}\n`);
+          console.log(`Validated ${pkg.name}@${pkg.version} from ${sourceSha}; release tag ${tag}`);
+          NODE
+      - uses: actions/setup-node@v4
+        if: steps.release.outputs.release_tag != ''
+        with:
+          node-version: 24
+      - name: Ensure npm 11.5.1+ (OIDC support)
+        if: steps.release.outputs.release_tag != ''
+        run: |
+          npm install --global npm@latest
+          npm --version
+      - name: Skip if version is already on npm
+        id: registry
+        if: steps.release.outputs.release_tag != ''
+        run: |
+          PACKAGE_NAME=$(node -p "require('./package.json').name")
+          PACKAGE_VERSION=$(node -p "require('./package.json').version")
+          if npm view "$PACKAGE_NAME@$PACKAGE_VERSION" version >/dev/null 2>&1; then
+            echo 'published=true' >> "$GITHUB_OUTPUT"
+            echo "$PACKAGE_NAME@$PACKAGE_VERSION is already published; skipping duplicate publish"
+          else
+            echo 'published=false' >> "$GITHUB_OUTPUT"
+          fi
+      - name: Publish to npmjs with trusted publishing
+        if: steps.release.outputs.release_tag != '' && steps.registry.outputs.published != 'true'
+        run: npm publish --access public --loglevel verbose

package/AGENTS.md

@@ -17,7 +17,7 @@
 | Página | O que documenta |
 | --- | --- |
 | [Índice Default*](https://github.com/ControleOnline/ui-default/wiki/Default-Components) | Mapa da família e arquitetura |
-| [DefaultTable](https://github.com/ControleOnline/ui-default/wiki/DefaultTable) | Listagens, store contract, view modes |
+| [DefaultTable](https://github.com/ControleOnline/ui-default/wiki/DefaultTable) | Listagens, store contract, view modes, **hydrate único de filtros** (`useDefaultTableStoreSync`, anti #185) |
 | [DefaultForm](https://github.com/ControleOnline/ui-default/wiki/DefaultForm) | Create/edit genérico |
 | [DefaultInput e DefaultSelect](https://github.com/ControleOnline/ui-default/wiki/DefaultInput-e-DefaultSelect) | Campos e listas |
 | [Contrato de colunas](https://github.com/ControleOnline/ui-default/wiki/Contrato-de-colunas) | Flags e serialização |

package/docs/technical/DefaultTable.md

@@ -188,16 +188,85 @@ Com colunas só via prop (store ainda sem columns):
 />
 ```
 
+
+## Sincronização com o store (`useDefaultTableStoreSync`)
+
+Hook interno que mantém props controladas do `DefaultTable` alinhadas ao slice Zustand **sem depender da identidade do objeto `store`** (Zustand troca a referência a cada commit).
+
+**Arquivo:** `src/react/components/table/useDefaultTableStoreSync.js`  
+**Testes:** `src/tests/react/components/table/useDefaultTableStoreSync.test.js`
+
+### O que sincroniza
+
+| Efeito | Origem → destino | Guard anti-loop |
+| --- | --- | --- |
+| Colunas | prop `columns` → `actions.setColumns` / `getters.columns` | só se o store ainda não tiver colunas |
+| Itens controlados | prop `data` → `actions.setItems` | mesma referência de array (`lastPublishedItemsRef`) |
+| Colunas visíveis | `localStorage` (escopo empresa/store/rota) → `setVisibleColumns` | sanitização por colunas atuais |
+| Filtros persistidos | `localStorage` → `setFilters` | **hydrate uma vez por scopeKey** + `areTableFiltersEqual` |
+| Configs | `defaultTableConfigs` → `setConfigs` | assinatura estável (`defaultTableConfigsSignature`) |
+
+Helpers exportados: `publishStoreValue`, `assignGetterValue`, `areTableFiltersEqual`.
+
+### Preferências de filtro — regra de hydrate único
+
+Filtros de tabela são lidos de `resolveStoredTableFiltersPreference(tablePreferenceScope)` e aplicados via `sanitizeTableFiltersPreference`.
+
+**`scopeKey`** (estável):
+
+```text
+companyKey :: storeKey :: routeKey :: colunas(key|name)|...
+```
+
+Regras canônicas (app-community#448 / ui-orders OrderHistoryPage):
+
+1. Hydrate de filtros persistidos ocorre **no máximo uma vez** por `scopeKey` (`lastHydratedFiltersKeyRef`).
+2. **Não** reagir a mudanças de `storeFilters` após o hydrate — perseguir o store recria o payload e gera React **#185** (Maximum update depth exceeded).
+3. Antes de `setFilters`, comparar com `areTableFiltersEqual` (JSON estável). Se já for equivalente, só marca o `scopeKey` e sai.
+4. Toggle típico que quebrava: período `today → all → today` em `OrderHistoryPage` (filtro externo de data + DefaultTable). O guard em `useOrderHistoryFilters` (`areHistoryFiltersEqual`) **não basta** se o loop nascer no hydrate do DefaultTable.
+
+```mermaid
+flowchart TD
+  A[DefaultTable mount / columns ready] --> B{stored filters?}
+  B -->|não| C[marca scopeKey]
+  B -->|sim| D[sanitize]
+  D --> E{scopeKey já hydrated?}
+  E -->|sim| F[return — não chase storeFilters]
+  E -->|não| G{areTableFiltersEqual?}
+  G -->|sim| C
+  G -->|não| H[setFilters + marca scopeKey]
+```
+
+### Por que não colocar `storeFilters` nas deps
+
+Incluir `storeFilters` no array de dependências do efeito de hydrate faz:
+
+`setFilters` → nova referência no store → efeito roda de novo → `setFilters` → **#185**.
+
+A correção remove `storeFilters` das deps e usa `storeFiltersRef` só para a comparação de igualdade no momento do hydrate.
+
+### Visões (`APP_TYPE`)
+
+`ui-default` **não** conhece domínio de pedido/CRM/POS. Qualquer tela que use `DefaultTable` + filtros de período (ex.: histórico de pedidos em `ui-orders`, listagens CRM) herda este contrato. O módulo consumidor não deve reaplicar filtros persistidos em todo change do store; o orquestrador já faz o hydrate único.
+
+### Testes mínimos esperados
+
+- Publicação de `data` uma vez por referência de array (Devices / #185 histórico).
+- Hydrate de filtros uma vez; após churn de `storeFilters` (simular today→all→today), `setFilters` continua 1×.
+- `areTableFiltersEqual` trata payloads de período equivalentes como iguais.
+
 ## Limites e cuidados
 
 - Filhos dependem de `configs` no store: não renderize Body isolado sem o orquestrador.
 - Preferências são por **empresa + store + rota**: mudou empresa ou rota, o escopo muda.
 - `stableSerialize` evita loops de `setConfigs`.
+- Hydrate de filtros persistidos é **único por scopeKey** — não recoloque `storeFilters` nas deps do efeito de hydrate (React #185; ver seção `useDefaultTableStoreSync`).
 - List stores com escopo de empresa (`categories`, `paymentType`, `wallet`) recebem `company`/`people` automaticamente nos loads de select/coluna.
 
 ## Arquivos relacionados
 
 - `DefaultTable.js`, `DefaultTable.utils.js`, `DefaultTable.styles.js`
-- Hooks: `useDefaultTablePagination.js`, `useDefaultTableSorting.js`, `useDefaultTableTheme.js`
+- Hooks: `useDefaultTablePagination.js`, `useDefaultTableSorting.js`, `useDefaultTableTheme.js`, **`useDefaultTableStoreSync.js`**
 - Preferências: `src/react/utils/tableVisibleColumnsPreferences`
 - Testes: `src/tests/react/utils/tableVisibleColumnsPreferences.test.js`
+- Testes store sync: `src/tests/react/components/table/useDefaultTableStoreSync.test.js`

package/package.json

@@ -1,22 +1,22 @@
-{
-  "name": "@controleonline/ui-default",
-  "version": "1.0.272",
-  "author": "ControleOnline",
-  "description": "ControleOnline Default Quasar UI Component",
-  "license": "MIT",
-  "main": "src/react/index.js",
-  "scripts": {},
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/ControleOnline/conline-quasar-ui"
-  },
-  "bugs": "",
-  "homepage": "https://www.controleonline.com/devs/plugins",
-  "browserslist": [
-    "last 1 version, not dead, ie >= 11"
-  ],
-  "dependencies": {
-    "@controleonline/ui-common": "*",
-    "react-native-vector-icons": "^10.3.0"
-  }
-}
+{
+  "name": "@controleonline/ui-default",
+  "version": "1.0.274",
+  "author": "ControleOnline",
+  "description": "ControleOnline Default Quasar UI Component",
+  "license": "MIT",
+  "main": "src/react/index.js",
+  "scripts": {},
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ControleOnline/ui-default"
+  },
+  "bugs": "",
+  "homepage": "https://www.controleonline.com/devs/plugins",
+  "browserslist": [
+    "last 1 version, not dead, ie >= 11"
+  ],
+  "dependencies": {
+    "@controleonline/ui-common": "*",
+    "react-native-vector-icons": "^10.3.0"
+  }
+}

package/src/react/components/address/DefaultAddress.js

@@ -16,12 +16,11 @@ import {
 } from '../../services/addressGeo';
 import {
   buildMapMarkerPayload,
-  formatCepMask,
   getCurrentCoordinates,
+  GEOCODE_MISS_MESSAGE,
   hasCoordinates,
   hydrateAddressFromRow,
   mergePostalCodeData,
-  normalizeCepDigits,
   onlyDigits,
   parseOptionalCoordinate,
 } from '../../services/addressFormUtils';
@@ -58,6 +57,8 @@ export default function DefaultAddress({
     loadingCep,
     cepError,
     setCepError,
+    geocodeMiss,
+    setGeocodeMiss,
     onCepBlur,
     runLookup,
     cancelPending,
@@ -133,10 +134,9 @@ export default function DefaultAddress({
     (key, value) => {
       setForm(prev => {
         let nextValue = value;
-        if (key === 'cep') {
-          nextValue = normalizeCepDigits(value);
-        } else if (key === 'latitude' || key === 'longitude') {
+        if (key === 'latitude' || key === 'longitude') {
           // Keep raw string while typing so decimals/signs are not truncated mid-edit.
+          // Persist number only when the full token parses; otherwise keep the draft string.
           const parsed = parseOptionalCoordinate(value);
           const trimmed = String(value ?? '').trim();
           const looksComplete =
@@ -150,6 +150,10 @@ export default function DefaultAddress({
             parsed != null && looksComplete ? parsed : value;
         }
         const next = {...prev, [key]: nextValue};
+        // Troca de CEP: número do imóvel anterior não se aplica (#746)
+        if (key === 'cep' && onlyDigits(value) !== onlyDigits(prev.cep)) {
+          next.number = '';
+        }
         onFormChange?.(next);
         return next;
       });
@@ -159,10 +163,11 @@ export default function DefaultAddress({
       if (key === 'cep') {
         setCepError(null);
         setError(null);
+        setGeocodeMiss(false);
         setCoordsManualEdit(false);
       }
     },
-    [onFormChange, setCepError],
+    [onFormChange, setCepError, setGeocodeMiss],
   );
 
   const onSelectCountry = useCallback(async item => {
@@ -269,8 +274,13 @@ export default function DefaultAddress({
       keyboardShouldPersistTaps="handled">
       <View style={[styles.formPane, isDesktop && styles.formPaneDesktop]}>
         {displayError ? <Text style={styles.error}>{displayError}</Text> : null}
+        {geocodeMiss ? (
+          <Text testID="address-geocode-miss" style={styles.hint}>
+            {GEOCODE_MISS_MESSAGE}
+          </Text>
+        ) : null}
         <Text style={styles.hint}>
-          Informe o CEP (8 dígitos) para autopreencher via ERP. Número/complemento/apelido são preservados.
+          Informe o CEP (8 dígitos) para autopreencher via ERP. Complemento/apelido são preservados; o número é limpo ao trocar o CEP.
         </Text>
 
         <Field label="Apelido">
@@ -287,7 +297,7 @@ export default function DefaultAddress({
             <TextInput
               testID="address-cep-input"
               style={[styles.input, styles.flex]}
-              value={formatCepMask(form.cep)}
+              value={form.cep}
               onChangeText={v => onChange('cep', v)}
               onBlur={onCepBlur}
               keyboardType="number-pad"
@@ -399,7 +409,7 @@ export default function DefaultAddress({
           form={form}
           styles={styles}
           Field={Field}
-          editable={!hasCoordinates(form) || coordsManualEdit}
+          editable={!hasCoordinates(form) || geocodeMiss || coordsManualEdit}
           onChange={onChange}
         />
 
@@ -433,3 +443,4 @@ function Field({label, children, style = null}) {
     </View>
   );
 }
+

package/src/react/components/address/DefaultAddressCoordFields.js

@@ -0,0 +1,59 @@
+/*
+ * Explicit Latitude/Longitude inputs for DefaultAddress (app-community#360).
+ */
+import React from 'react';
+import {Text, TextInput, View} from 'react-native';
+import styles from './DefaultAddress.styles';
+import {parseOptionalCoordinate} from '../../services/addressFormUtils';
+
+function Field({label, children, style = null}) {
+  return (
+    <View style={[styles.field, style]}>
+      <Text style={styles.label}>{label}</Text>
+      {children}
+    </View>
+  );
+}
+
+export default function DefaultAddressCoordFields({form, onChange}) {
+  return (
+    <View style={styles.coordRow}>
+      <View style={styles.coordHalf}>
+        <Field label="Latitude">
+          <TextInput
+            style={styles.input}
+            value={
+              form.latitude === null || form.latitude === undefined
+                ? ''
+                : String(form.latitude)
+            }
+            onChangeText={v => onChange('latitude', parseOptionalCoordinate(v))}
+            placeholder="-23.5505"
+            keyboardType="decimal-pad"
+            accessibilityLabel="Latitude"
+            testID="address-latitude-input"
+          />
+        </Field>
+      </View>
+      <View style={styles.coordHalf}>
+        <Field label="Longitude">
+          <TextInput
+            style={styles.input}
+            value={
+              form.longitude === null || form.longitude === undefined
+                ? ''
+                : String(form.longitude)
+            }
+            onChangeText={v =>
+              onChange('longitude', parseOptionalCoordinate(v))
+            }
+            placeholder="-46.6333"
+            keyboardType="decimal-pad"
+            accessibilityLabel="Longitude"
+            testID="address-longitude-input"
+          />
+        </Field>
+      </View>
+    </View>
+  );
+}

package/src/react/components/address/LatLonReadonlyFields.js

@@ -3,8 +3,8 @@ import {View, TextInput} from 'react-native';
 
 /**
  * Latitude / longitude fields.
- * Read-only when both coordinates are present and the user has not started
- * a manual edit; editable when coords are missing so the user can type them.
+ * Read-only after a successful geocode; editable when Nominatim misses
+ * so the user can type coordinates and drop a pin.
  */
 export default function LatLonReadonlyFields({
   form,

package/src/react/components/address/defaultAddressStyles.js

@@ -133,4 +133,16 @@ export const styles = StyleSheet.create({
   btnPrimaryText: {color: '#fff', fontWeight: '600'},
   btnSecondaryText: {color: '#475569', fontWeight: '600'},
   btnDisabled: {opacity: 0.6},
-});
+
+  coordRow: {
+    flexDirection: 'row',
+    gap: 12,
+  },
+  coordField: {
+    flex: 1,
+  },
+  inputReadonly: {
+    backgroundColor: '#F1F5F9',
+    color: '#475569',
+  },
+});

package/src/react/components/files/DefaultFile.js

@@ -4,8 +4,8 @@ import {useStore} from '@store';
 import {resolveDefaultFileSource} from '@controleonline/ui-common/src/react/utils/fileUrl';
 
 const resolveCompanyFromStore = peopleGetters => {
-  if (peopleGetters?.defaultCompany?.id) {
-    return peopleGetters.defaultCompany;
+  if (peopleGetters?.mainCompany?.id) {
+    return peopleGetters.mainCompany;
   }
 
   if (peopleGetters?.currentCompany?.id) {

package/src/react/components/files/DefaultFileColumn.js

@@ -19,7 +19,7 @@ const ICON_BY_KIND = {
 };
 
 const resolveCompanyFromStore = peopleGetters => {
-  if (peopleGetters?.defaultCompany?.id) return peopleGetters.defaultCompany;
+  if (peopleGetters?.mainCompany?.id) return peopleGetters.mainCompany;
   if (peopleGetters?.currentCompany?.id) return peopleGetters.currentCompany;
   return null;
 };

package/src/react/components/filters/DefaultColumnFilter.js

@@ -13,6 +13,7 @@ import {
 import CompactFilterSelector from './CompactFilterSelector';
 import DateShortcutFilter from './DateShortcutFilter';
 import { resolveNextDateFilterValue } from './dateFilterSelection';
+import { isFilledFilterValue } from './filterValue';
 import useDefaultTableTheme from '@controleonline/ui-default/src/react/components/table/useDefaultTableTheme';
 import {
   normalizeCollectionItems,
@@ -61,13 +62,7 @@ const DefaultColumnFilter = ({
 
       const currentFilters = store?.getters?.filters || {};
       const nextFilters = { ...(currentFilters || {}) };
-      const isEmpty =
-        value === null ||
-        value === undefined ||
-        normalizeText(value) === '' ||
-        (Array.isArray(value) && value.length === 0);
-
-      if (isEmpty) delete nextFilters[nextFieldName];
+      if (!isFilledFilterValue(value)) delete nextFilters[nextFieldName];
       else nextFilters[nextFieldName] = value;
 
       const columns = Array.isArray(store?.getters?.columns) ? store.getters.columns : [];

package/src/react/components/filters/DefaultExternalFilters.js

@@ -22,6 +22,7 @@ import {
 import CompactFilterSelector from './CompactFilterSelector';
 import DateShortcutFilter from './DateShortcutFilter';
 import { resolveNextDateFilterValue } from './dateFilterSelection';
+import { isFilledFilterValue, omitEmptyFilters } from './filterValue';
 import {
   persistTableFiltersPreference,
   resolveDefaultTablePreferenceScope,
@@ -108,15 +109,6 @@ const normalizeFilterValue = value => {
   return normalizeText(value);
 };
 
-const isFilledFilterValue = value => {
-  if (Array.isArray(value)) return value.length > 0;
-  if (value && typeof value === 'object') {
-    return Object.values(value).some(isFilledFilterValue);
-  }
-
-  return normalizeText(value) !== '';
-};
-
 const resolveDateState = filterValue => {
   if (!filterValue || typeof filterValue !== 'object') {
     return {
@@ -222,10 +214,11 @@ const DefaultExternalFilters = ({
   }, [activeCount, onActiveCountChange]);
 
   const applyFilters = useCallback(nextFilters => {
-    const resolvedFilters =
+    const resolvedFilters = omitEmptyFilters(
       nextFilters && typeof nextFilters === 'object' && !Array.isArray(nextFilters)
         ? nextFilters
-        : {};
+        : {},
+    );
     const columns = Array.isArray(externalFilterStore?.getters?.columns)
       ? externalFilterStore.getters.columns
       : [];

package/src/react/components/filters/filterValue.js

@@ -0,0 +1,65 @@
+const EMPTY_SHORTCUTS = new Set(['', 'all', 'none', '*']);
+
+const normalizeText = value => String(value ?? '').trim();
+
+export const isFilledFilterValue = value => {
+  if (value === null || value === undefined) {
+    return false;
+  }
+
+  if (Array.isArray(value)) {
+    return value.some(isFilledFilterValue);
+  }
+
+  if (typeof value === 'object') {
+    const shortcut = normalizeText(value.shortcut).toLowerCase();
+    const range = value.customRange && typeof value.customRange === 'object'
+      ? value.customRange
+      : null;
+    const rangeFrom = normalizeText(
+      range?.from ?? value.from ?? value.start ?? value.after,
+    );
+    const rangeTo = normalizeText(
+      range?.to ?? value.to ?? value.end ?? value.before,
+    );
+
+    if ('shortcut' in value || range || 'start' in value || 'end' in value || 'after' in value || 'before' in value) {
+      if (EMPTY_SHORTCUTS.has(shortcut) && !rangeFrom && !rangeTo) {
+        return false;
+      }
+      if ((shortcut === 'custom' || !shortcut) && !rangeFrom && !rangeTo) {
+        return false;
+      }
+    }
+
+    return Object.values(value).some(isFilledFilterValue);
+  }
+
+  return normalizeText(value) !== '';
+};
+
+export const countActiveFilters = (filters = {}) => {
+  if (!filters || typeof filters !== 'object' || Array.isArray(filters)) {
+    return 0;
+  }
+
+  return Object.keys(filters).filter(key => {
+    if (['page', 'itemsPerPage', 'order', 'sort', 'pagination'].includes(key)) {
+      return false;
+    }
+    return isFilledFilterValue(filters[key]);
+  }).length;
+};
+
+export const omitEmptyFilters = (filters = {}) => {
+  if (!filters || typeof filters !== 'object' || Array.isArray(filters)) {
+    return {};
+  }
+
+  return Object.keys(filters).reduce((accumulator, key) => {
+    if (isFilledFilterValue(filters[key])) {
+      accumulator[key] = filters[key];
+    }
+    return accumulator;
+  }, {});
+};