@controleonline/ui-customers 1.0.81

package/src/react/components/tabs/UsersTab.styles.test.js

@@ -0,0 +1,42 @@
+/**
+ * Regression: Salvar button must be a visible primary action (not text-only styles).
+ * Root cause of app-community#458 / #635: after task-428 modularization,
+ * inlineStyle_348_20 kept Cancelar text styles and was applied to the Salvar
+ * TouchableOpacity → white label on white modal made Salvar invisible.
+ */
+import {
+  inlineStyle_339_16,
+  inlineStyle_341_14,
+  inlineStyle_348_20,
+  timezoneListStyle,
+} from './UsersTab.styles';
+
+describe('UsersTab.styles — UserFormModal footer / Salvar visibility (#635)', () => {
+  it('footer row has padding and top border so actions stay visible', () => {
+    expect(inlineStyle_339_16.paddingHorizontal).toBe(24);
+    expect(inlineStyle_339_16.paddingBottom).toBe(24);
+    expect(inlineStyle_339_16.borderTopWidth).toBe(1);
+  });
+
+  it('Cancelar keeps outlined secondary style', () => {
+    expect(inlineStyle_341_14.flex).toBe(1);
+    expect(inlineStyle_341_14.borderWidth).toBe(1);
+    expect(inlineStyle_341_14.borderColor).toBe('#64748B');
+  });
+
+  it('Salvar is primary button with solid background (not text-only styles)', () => {
+    expect(inlineStyle_348_20.flex).toBe(1);
+    expect(inlineStyle_348_20.backgroundColor).toBe('#0F172A');
+    expect(inlineStyle_348_20.paddingVertical).toBe(14);
+    expect(inlineStyle_348_20.borderRadius).toBe(12);
+    expect(inlineStyle_348_20.alignItems).toBe('center');
+    // must NOT be the old text-only shape
+    expect(inlineStyle_348_20.fontSize).toBeUndefined();
+    expect(inlineStyle_348_20.color).toBeUndefined();
+  });
+
+  it('timezone list is height-capped so long lists do not push footer off-screen', () => {
+    expect(timezoneListStyle.maxHeight).toBe(220);
+    expect(timezoneListStyle.overflow).toBe('hidden');
+  });
+});

package/src/react/components/tabs/contactMutationMessage.js

@@ -0,0 +1,18 @@
+import {resolveSystemErrorMessage} from '@controleonline/ui-common/src/react/utils/systemErrorMessage'
+
+const PEOPLE_ITEM_NOT_FOUND_PATTERN = /Item not found for "\/people\/\d+"\./i
+
+export const resolveContactMutationMessage = (
+  error,
+  fallbackMessage = 'Nao foi possivel salvar este contato agora.',
+) => {
+  const message = resolveSystemErrorMessage(error)
+
+  if (PEOPLE_ITEM_NOT_FOUND_PATTERN.test(message)) {
+    return 'Este contato esta vinculado a empresa, mas o cadastro direto dele nao esta disponivel para edicao no momento.'
+  }
+
+  return message || fallbackMessage
+}
+
+export default resolveContactMutationMessage

package/src/react/components/tabs/employeeContacts.js

@@ -0,0 +1,214 @@
+const EMPLOYEE_CONTACT_LINK_TYPES = [
+  'employee',
+  'owner',
+  'director',
+  'manager',
+  'salesman',
+  'after-sales',
+  'courier',
+];
+
+const extractId = value => {
+  if (value == null || value === '') {
+    return '';
+  }
+  if (typeof value === 'object') {
+    return extractId(value.id ?? value['@id'] ?? '');
+  }
+  return String(value).replace(/\D/g, '');
+};
+
+const normalizeEmployeeLinkTypeStrict = value => {
+  const normalized = String(value || '')
+    .trim()
+    .toLowerCase();
+
+  return EMPLOYEE_CONTACT_LINK_TYPES.includes(normalized) ? normalized : '';
+};
+
+export const normalizeEmployeeLinkType = value => {
+  return normalizeEmployeeLinkTypeStrict(value) || 'employee';
+};
+
+export const extractPeopleLinkItems = payload => {
+  if (Array.isArray(payload)) {
+    return payload;
+  }
+
+  if (Array.isArray(payload?.member)) {
+    return payload.member;
+  }
+
+  if (Array.isArray(payload?.['hydra:member'])) {
+    return payload['hydra:member'];
+  }
+
+  return [];
+};
+
+/**
+ * Build GET /people_links query params.
+ * - company/people as numeric ids
+ * - linkType as array (API Platform SearchFilter)
+ * - itemsPerPage to avoid truncating contacts on large companies (#636)
+ */
+export const buildPeopleLinkReadParams = ({
+  companyId = '',
+  peopleId = '',
+  linkType = '',
+  linkTypes = [],
+  itemsPerPage,
+} = {}) => {
+  const params = {};
+  const normalizedCompanyId = extractId(companyId);
+  const normalizedPeopleId = extractId(peopleId);
+  const normalizedLinkType = String(linkType || '').trim();
+  const normalizedLinkTypes = Array.isArray(linkTypes)
+    ? linkTypes
+        .map(value => String(value || '').trim())
+        .filter(Boolean)
+    : [];
+
+  if (normalizedCompanyId) {
+    params.company = normalizedCompanyId;
+  }
+
+  if (normalizedPeopleId) {
+    params.people = normalizedPeopleId;
+  }
+
+  if (normalizedLinkType) {
+    // Scalar becomes a one-element array — API Platform rejects bare scalars here.
+    params.linkType = [normalizedLinkType];
+  } else if (normalizedLinkTypes.length > 0) {
+    params.linkType = normalizedLinkTypes;
+  }
+
+  const pageSize = Number(itemsPerPage);
+  if (Number.isFinite(pageSize) && pageSize > 0) {
+    params.itemsPerPage = pageSize;
+  }
+
+  return params;
+};
+
+export const filterPeopleLinksByScope = (
+  payload,
+  {companyId = '', peopleId = '', linkTypes = []} = {},
+) => {
+  const normalizedCompanyId = extractId(companyId);
+  const normalizedPeopleId = extractId(peopleId);
+  const normalizedLinkTypes = Array.isArray(linkTypes)
+    ? linkTypes
+        .map(value => String(value || '').trim().toLowerCase())
+        .filter(Boolean)
+    : [];
+
+  return extractPeopleLinkItems(payload).filter(link => {
+    // Accept embedded object or plain IRI string (/people/123).
+    const linkCompanyId = extractId(
+      link?.company?.id || link?.company?.['@id'] || link?.company,
+    );
+    const linkPeopleId = extractId(
+      link?.people?.id || link?.people?.['@id'] || link?.people,
+    );
+    const linkType = String(link?.linkType || '')
+      .trim()
+      .toLowerCase();
+
+    if (normalizedCompanyId && linkCompanyId !== normalizedCompanyId) {
+      return false;
+    }
+
+    if (normalizedPeopleId && linkPeopleId !== normalizedPeopleId) {
+      return false;
+    }
+
+    if (
+      normalizedLinkTypes.length > 0 &&
+      !normalizedLinkTypes.includes(linkType)
+    ) {
+      return false;
+    }
+
+    return true;
+  });
+};
+
+export const buildSalesmanLinksFromPeopleLinks = (
+  payload,
+  {clientId = '', linkType = 'sellers-client'} = {},
+) => {
+  return filterPeopleLinksByScope(payload, {
+    peopleId: clientId,
+    linkTypes: [linkType],
+  }).filter(link =>
+    extractId(link?.company?.id || link?.company?.['@id'] || link?.company),
+  );
+};
+
+export const buildEmployeeContactsFromPeopleLinks = (
+  payload,
+  {parentPeopleId = '', allowedLinkTypes = EMPLOYEE_CONTACT_LINK_TYPES} = {},
+) => {
+  const companyId = extractId(parentPeopleId);
+  const normalizedAllowedLinkTypes = Array.isArray(allowedLinkTypes)
+    ? allowedLinkTypes.map(normalizeEmployeeLinkTypeStrict).filter(Boolean)
+    : EMPLOYEE_CONTACT_LINK_TYPES;
+
+  return filterPeopleLinksByScope(payload, {
+    companyId,
+    linkTypes: normalizedAllowedLinkTypes,
+  })
+    .map(link => {
+      const person = link?.people;
+      const personId = extractId(
+        typeof person === 'string' || typeof person === 'number'
+          ? person
+          : person?.id || person?.['@id'],
+      );
+      const normalizedLinkType = normalizeEmployeeLinkTypeStrict(link?.linkType);
+
+      if (!personId || (companyId && personId === companyId)) {
+        return null;
+      }
+
+      if (
+        person &&
+        typeof person === 'object' &&
+        String(person?.peopleType || '').toUpperCase() === 'J'
+      ) {
+        return null;
+      }
+
+      if (
+        person &&
+        typeof person === 'object' &&
+        (person?.deleted === true || person?.deleted === 1 || person?.deleted === '1')
+      ) {
+        return null;
+      }
+
+      const enableRaw = link?.enable ?? link?.enabled;
+      if (enableRaw === 0 || enableRaw === false || enableRaw === '0') {
+        return null;
+      }
+
+      const base =
+        person && typeof person === 'object'
+          ? {...person}
+          : {id: personId, '@id': `/people/${personId}`};
+
+      return {
+        ...base,
+        // Prefer numeric id when the payload provided one; otherwise digits-only string.
+        id: base.id != null && base.id !== '' ? base.id : personId,
+        linkType: normalizedLinkType,
+        peopleLink: link,
+        peopleLinkId: extractId(link?.id || link?.['@id']),
+      };
+    })
+    .filter(Boolean);
+};
+
+export default buildEmployeeContactsFromPeopleLinks;

package/src/react/components/tabs/employeeUnlink.js

@@ -0,0 +1,68 @@
+import {Alert} from 'react-native';
+import {extractId} from './employeesTabHelpers';
+
+export const EMPLOYEE_UNLINK_TITLE = 'Remover colaborador';
+export const EMPLOYEE_UNLINK_MESSAGE =
+  'O colaborador será marcado como removido e o vínculo com a empresa será desativado. O registro permanece no banco (exclusão lógica). Deseja continuar?';
+
+export const extractEmployeeUnlinkIds = employee => ({
+  peopleId: extractId(employee?.id || employee?.['@id']),
+  linkId:
+    extractId(employee?.peopleLinkId) ||
+    extractId(employee?.peopleLink?.id || employee?.peopleLink?.['@id']),
+});
+
+export const confirmEmployeeRemoval = ({showDialog, onConfirm, onCancel}) => {
+  if (typeof showDialog === 'function') {
+    showDialog({
+      title: EMPLOYEE_UNLINK_TITLE,
+      message: EMPLOYEE_UNLINK_MESSAGE,
+      confirmLabel: 'Remover',
+      cancelLabel: 'Cancelar',
+      onConfirm,
+      onCancel,
+    });
+    return;
+  }
+
+  Alert.alert(EMPLOYEE_UNLINK_TITLE, EMPLOYEE_UNLINK_MESSAGE, [
+    {text: 'Cancelar', style: 'cancel', onPress: onCancel},
+    {text: 'Remover', style: 'destructive', onPress: onConfirm},
+  ]);
+};
+
+export const removeEmployeeFromCompany = async ({
+  peopleId,
+  linkId,
+  removePeople,
+  removePeopleLink,
+}) => {
+  if (peopleId && typeof removePeople === 'function') {
+    await removePeople(peopleId);
+    return {mode: 'people', peopleId, linkId};
+  }
+  if (linkId && typeof removePeopleLink === 'function') {
+    await removePeopleLink(linkId);
+    return {mode: 'link', peopleId, linkId};
+  }
+  const error = new Error(
+    'Não foi possível remover o colaborador (ação indisponível).',
+  );
+  error.code = 'UNAVAILABLE';
+  throw error;
+};
+
+export const filterEmployeesAfterUnlink = (list, {peopleId, linkId}) =>
+  (list || []).filter(item => {
+    const itemPeopleId = extractId(item?.id || item?.['@id']);
+    const itemLinkId = extractId(
+      item?.peopleLink?.id || item?.peopleLink?.['@id'] || item?.peopleLinkId,
+    );
+    if (peopleId && itemPeopleId === peopleId) {
+      return false;
+    }
+    if (linkId && itemLinkId === linkId) {
+      return false;
+    }
+    return true;
+  });

package/src/react/components/tabs/employeesTabHelpers.js

@@ -0,0 +1,227 @@
+import { resolveFileImageUrl } from '@controleonline/ui-common/src/react/utils/fileUrl';
+import {
+  } from '@controleonline/ui-common/src/react/utils/entityDisplay';
+import { normalizeEmployeeLinkType } from './employeeContacts';
+
+export const extractId = value => String(value || '').replace(/\D/g, '');
+export const normalizeIdentityValue = value => String(value);
+
+export const normalizeCollection = payload => {
+  if (Array.isArray(payload)) return payload;
+  if (!payload || typeof payload !== 'object') return [];
+  if (Array.isArray(payload.member)) return payload.member;
+  if (Array.isArray(payload['hydra:member'])) return payload['hydra:member'];
+  if (Array.isArray(payload.items)) return payload.items;
+  return [];
+};
+
+export const extractPeopleMediaUrl = (person, mediaType = 'avatar') => {
+  if (!person || typeof person !== 'object') {
+    return '';
+  }
+
+  const collection = normalizeCollection(
+    person.peopleMedia || person.people_media || person.media,
+  );
+  const wanted = String(mediaType || '').trim().toLowerCase();
+  const match =
+    collection.find(item => {
+      const type = String(
+        item?.mediaType?.type || item?.mediaType || item?.type || '',
+      )
+        .trim()
+        .toLowerCase();
+      return wanted ? type === wanted : Boolean(type);
+    }) || collection[0];
+
+  return resolveFileImageUrl(match?.file) || '';
+};
+
+export const fetchPeopleMediaUrls = async ({ peopleActions, mediaType, peopleIds }) => {
+  const uniqueIds = [...new Set((peopleIds || []).map(extractId).filter(Boolean))];
+  if (uniqueIds.length === 0) {
+    return {};
+  }
+
+  const buildMapFromCollection = response => {
+    const byPeopleId = {};
+    for (const media of normalizeCollection(response)) {
+      const peopleId = extractId(
+        media?.people?.['@id'] || media?.people?.id || media?.people,
+      );
+      if (!peopleId || byPeopleId[peopleId]) {
+        continue;
+      }
+      const imageUrl = resolveFileImageUrl(media?.file);
+      if (imageUrl) {
+        byPeopleId[peopleId] = imageUrl;
+      }
+    }
+    return byPeopleId;
+  };
+
+  // Batch: uma chamada people_media com people[] (SearchFilter exact multi-valor).
+  try {
+    const response = await peopleActions.getPeopleMedia({
+      people: uniqueIds.map(id => `/people/${id}`),
+      'mediaType.type': mediaType,
+      itemsPerPage: Math.max(uniqueIds.length, 1),
+    });
+    return buildMapFromCollection(response);
+  } catch {
+    // Fallback: N chamadas só se o filtro batch não for aceito pelo backend.
+    const entries = await Promise.all(
+      uniqueIds.map(async peopleId => {
+        try {
+          const response = await peopleActions.getPeopleMedia({
+            people: `/people/${peopleId}`,
+            'mediaType.type': mediaType,
+            itemsPerPage: 1,
+          });
+          const media = normalizeCollection(response)[0];
+          const imageUrl = resolveFileImageUrl(media?.file);
+          return imageUrl ? [peopleId, imageUrl] : null;
+        } catch {
+          return null;
+        }
+      }),
+    );
+
+    return entries
+      .filter(Boolean)
+      .reduce((accumulator, [peopleId, imageUrl]) => {
+        accumulator[peopleId] = imageUrl;
+        return accumulator;
+      }, {});
+  }
+};
+
+export const formatDateInput = text => {
+  const numbers = String(text || '').replace(/\D/g, '').slice(0, 8);
+  if (!numbers) {
+    return '';
+  }
+
+  if (numbers.length <= 2) {
+    return numbers;
+  }
+
+  if (numbers.length <= 4) {
+    return `${numbers.slice(0, 2)}/${numbers.slice(2)}`;
+  }
+
+  return `${numbers.slice(0, 2)}/${numbers.slice(2, 4)}/${numbers.slice(4)}`;
+};
+
+export const parseBrDateToYmd = value => {
+  const formatted = formatDateInput(value);
+  if (formatted.length !== 10) {
+    return null;
+  }
+
+  const [day, month, year] = formatted.split('/').map(v => parseInt(v, 10));
+  if (!day || !month || !year) {
+    return null;
+  }
+
+  const candidate = new Date(year, month - 1, day);
+  const isValid =
+    candidate.getFullYear() === year &&
+    candidate.getMonth() === month - 1 &&
+    candidate.getDate() === day;
+
+  if (!isValid) {
+    return null;
+  }
+
+  return `${year.toString().padStart(4, '0')}-${month
+    .toString()
+    .padStart(2, '0')}-${day.toString().padStart(2, '0')}`;
+};
+
+export const LINK_TYPE_OPTIONS = [
+  { value: 'employee', translationKey: 'employee' },
+  { value: 'owner', translationKey: 'owner' },
+  { value: 'director', translationKey: 'director' },
+  { value: 'manager', translationKey: 'manager' },
+  { value: 'courier', translationKey: 'courier' },
+];
+
+export const resolveEmployeeLinkType = employee =>
+  normalizeEmployeeLinkType(
+    employee?.linkType ||
+      employee?.link?.linkType ||
+      employee?.peopleLink?.linkType ||
+      (Array.isArray(employee?.link) ? employee.link[0]?.linkType : ''),
+  );
+
+
+/**
+ * Builds ClientDetails navigation params when opening an employee from
+ * EmployeesTab (juridical client). Always opens on the "general" tab so the
+ * PF detail does not land on contracts/contacts by mistake.
+ * Refs: ControleOnline/app-community#9
+ */
+export const buildEmployeeDetailNavParams = ({
+  employee,
+  parentPeopleId,
+}) => {
+  const clientId = extractId(employee?.id || employee?.['@id']);
+  if (!clientId) {
+    return null;
+  }
+
+  return {
+    clientId,
+    contextKey: 'contacts',
+    initialTab: 'general',
+    parentCompanyId: parentPeopleId,
+    linkType: resolveEmployeeLinkType(employee),
+  };
+};
+
+export const resolveEmployeeContactLinkType = employee =>
+  String(
+    employee?.peopleLink?.linkType ||
+      employee?.linkType ||
+      employee?.link?.linkType ||
+      (Array.isArray(employee?.link) ? employee.link[0]?.linkType : '') ||
+      '',
+  ).trim();
+
+export const formatEmployeeContactTitle = employee => {
+  const name = String(employee?.name || '').replace(/\s+/g, ' ').trim() || '-';
+  const alias = String(employee?.alias || '').replace(/\s+/g, ' ').trim();
+
+  return alias ? `${name} / ${alias}` : name;
+};
+
+export const formatEmployeeContactMeta = employee => {
+  const id = extractId(employee?.id || employee?.['@id']) || '-';
+  const linkType = resolveEmployeeContactLinkType(employee);
+
+  return linkType ? `ID: ${id} / ${linkType}` : `ID: ${id}`;
+};
+
+export const buildEmployeeCreatePayload = ({
+  name,
+  alias,
+  foundationDate,
+  linkType,
+  parentPeopleId,
+}) => {
+  const payload = {
+    name,
+    alias,
+    peopleType: 'F',
+    company: `/people/${parentPeopleId}`,
+    linkType: normalizeEmployeeLinkType(linkType),
+    'extra-data': {},
+  };
+
+  if (foundationDate) {
+    payload.foundationDate = foundationDate;
+  }
+
+  return payload;
+};

package/src/react/components/tabs/franchiseCommissionHelpers.js

@@ -0,0 +1,134 @@
+/**
+ * Pure helpers for franchise commission (people_link linkType=franchisee).
+ * Extracted to keep UI components under the absolute 500-line limit.
+ */
+
+const extractId = value => String(value || '').replace(/\D/g, '');
+
+const normalizeNumber = value => {
+  if (value === null || value === undefined || value === '') {
+    return null;
+  }
+  const n = Number(value);
+  return Number.isFinite(n) ? n : null;
+};
+
+/**
+ * Detect whether a people_link represents a franchisee of the franchisor.
+ */
+export const isFranchiseeLink = (link, {peopleId = '', companyId = ''} = {}) => {
+  if (!link) {
+    return false;
+  }
+  const linkType = String(link?.linkType || '').trim().toLowerCase();
+  if (linkType !== 'franchisee') {
+    return false;
+  }
+  const normalizedPeopleId = extractId(peopleId);
+  const normalizedCompanyId = extractId(companyId);
+  if (normalizedPeopleId) {
+    const linkPeopleId = extractId(link?.people?.id || link?.people?.['@id'] || link?.people);
+    if (linkPeopleId && linkPeopleId !== normalizedPeopleId) {
+      return false;
+    }
+  }
+  if (normalizedCompanyId) {
+    const linkCompanyId = extractId(link?.company?.id || link?.company?.['@id'] || link?.company);
+    if (linkCompanyId && linkCompanyId !== normalizedCompanyId) {
+      return false;
+    }
+  }
+  return true;
+};
+
+/**
+ * Pick the first franchisee link from a collection payload / array.
+ */
+export const pickFranchiseeLink = (payload, scope = {}) => {
+  const items = Array.isArray(payload)
+    ? payload
+    : Array.isArray(payload?.member)
+      ? payload.member
+      : Array.isArray(payload?.['hydra:member'])
+        ? payload['hydra:member']
+        : [];
+
+  return items.find(item => isFranchiseeLink(item, scope)) || null;
+};
+
+/**
+ * superadmin (ROLE_SUPER) or owner of the franchisor (owner_enabled).
+ */
+export const canEditFranchiseCommission = ({user = null, currentCompany = null} = {}) => {
+  const roles = Array.isArray(user?.roles) ? user.roles : [];
+  if (roles.includes('ROLE_SUPER')) {
+    return true;
+  }
+  return Boolean(currentCompany?.user?.owner_enabled);
+};
+
+/**
+ * Build read params for franchisee people_link lookup.
+ */
+export const buildFranchiseeLinkParams = ({peopleId = '', companyId = ''} = {}) => {
+  // API Platform exposes linkType as an array filter on people_links.
+  const params = {linkType: ['franchisee']};
+  const pid = extractId(peopleId);
+  const cid = extractId(companyId);
+  if (pid) {
+    params.people = pid;
+  }
+  if (cid) {
+    params.company = cid;
+  }
+  return params;
+};
+
+/**
+ * Normalize commission form values for display / save.
+ */
+export const normalizeCommissionFields = (link = {}) => ({
+  comission: normalizeNumber(link?.comission ?? link?.commission) ?? 0,
+  minimum_comission:
+    normalizeNumber(link?.minimum_comission ?? link?.minimumComission) ?? 0,
+});
+
+/**
+ * Validate commission inputs before save.
+ * comission is a percentage (0–100); minimum_comission is a monetary minimum (>= 0).
+ */
+export const validateCommissionFields = ({comission, minimum_comission} = {}) => {
+  const c = normalizeNumber(comission);
+  const m = normalizeNumber(minimum_comission);
+  if (c === null || c < 0 || c > 100) {
+    return {ok: false, error: 'invalidComission'};
+  }
+  if (m === null || m < 0) {
+    return {ok: false, error: 'invalidMinimumComission'};
+  }
+  return {ok: true, comission: c, minimum_comission: m};
+};
+
+/**
+ * Format percentage for read-only display.
+ */
+export const formatPercent = value => {
+  const n = normalizeNumber(value);
+  if (n === null) {
+    return '—';
+  }
+  return `${n}%`;
+};
+
+/**
+ * Format monetary minimum for read-only display (raw number, no currency symbol).
+ */
+export const formatMinimum = value => {
+  const n = normalizeNumber(value);
+  if (n === null) {
+    return '—';
+  }
+  return String(n);
+};
+
+export {extractId, normalizeNumber};