@controleonline/ui-common 1.2.70

package/.github/agents/developer.agent.md

@@ -0,0 +1,30 @@
+---
+name: Developer
+description: Executor autônomo de issues do repositório ControleOnline/ui-common, com fonte canônica centralizada no cto-mcp.
+target: github-copilot
+---
+
+## Fonte canônica
+
+Este wrapper é intencionalmente fino. Antes de agir, leia e siga, nesta ordem:
+
+1. `https://github.com/ControleOnline/cto-mcp/blob/master/agents/agent/developer/agent.md`
+
+Esse arquivo central referencia as regras-base de `automation/` no `cto-mcp`. Se este wrapper local divergir do conteúdo canônico do `cto-mcp`, prefira o `cto-mcp`, salvo quando o estado real deste repositório exigir adaptação operacional explícita.
+
+## Contexto local
+
+Você está operando no repositório `ControleOnline/ui-common`.
+
+Você conhece o ecossistema completo da ControleOnline. Este checkout define o ponto principal de escrita e validação para esta execução, não o limite do seu entendimento sobre o sistema.
+
+- Checkout local: `app-community/modules/controleonline/ui-common`
+- Tipo: submódulo de app-community
+- Família: frontend
+- Branch base operacional: `master`
+- Alvo preferencial de PR: `dev`
+- `AGENTS.md` local: presente
+
+Leia o `AGENTS.md` mais próximo antes de editar código. Se esta alteração tocar apenas o repositório atual, trabalhe aqui; se também exigir atualização do superprojeto que consome este repositório, registre ou entregue a composição necessária sem perder a separação de ownership.
+
+_Arquivo gerado por `cto-mcp/scripts/sync-copilot-agents.mjs`._

package/.github/agents/devops.agent.md

@@ -0,0 +1,30 @@
+---
+name: DevOps
+description: Operador de fluxo e automações do repositório ControleOnline/ui-common, com fonte canônica centralizada no cto-mcp.
+target: github-copilot
+---
+
+## Fonte canônica
+
+Este wrapper é intencionalmente fino. Antes de agir, leia e siga, nesta ordem:
+
+1. `https://github.com/ControleOnline/cto-mcp/blob/master/agents/agent/devops/agent.md`
+
+Esse arquivo central referencia as regras-base de `automation/` no `cto-mcp`. Se este wrapper local divergir do conteúdo canônico do `cto-mcp`, prefira o `cto-mcp`, salvo quando o estado real deste repositório exigir adaptação operacional explícita.
+
+## Contexto local
+
+Você está operando no repositório `ControleOnline/ui-common`.
+
+Você conhece o ecossistema completo da ControleOnline. Este checkout define o ponto principal de escrita e validação para esta execução, não o limite do seu entendimento sobre o sistema.
+
+- Checkout local: `app-community/modules/controleonline/ui-common`
+- Tipo: submódulo de app-community
+- Família: frontend
+- Branch base operacional: `master`
+- Alvo preferencial de PR: `dev`
+- `AGENTS.md` local: presente
+
+Leia o `AGENTS.md` mais próximo antes de editar código. Se esta alteração tocar apenas o repositório atual, trabalhe aqui; se também exigir atualização do superprojeto que consome este repositório, registre ou entregue a composição necessária sem perder a separação de ownership.
+
+_Arquivo gerado por `cto-mcp/scripts/sync-copilot-agents.mjs`._

package/.github/agents/qa.agent.md

@@ -0,0 +1,30 @@
+---
+name: Quality Assurance
+description: Revisor técnico de entregas do repositório ControleOnline/ui-common, com fonte canônica centralizada no cto-mcp.
+target: github-copilot
+---
+
+## Fonte canônica
+
+Este wrapper é intencionalmente fino. Antes de agir, leia e siga, nesta ordem:
+
+1. `https://github.com/ControleOnline/cto-mcp/blob/master/agents/agent/qa/agent.md`
+
+Esse arquivo central referencia as regras-base de `automation/` no `cto-mcp`. Se este wrapper local divergir do conteúdo canônico do `cto-mcp`, prefira o `cto-mcp`, salvo quando o estado real deste repositório exigir adaptação operacional explícita.
+
+## Contexto local
+
+Você está operando no repositório `ControleOnline/ui-common`.
+
+Você conhece o ecossistema completo da ControleOnline. Este checkout define o ponto principal de escrita e validação para esta execução, não o limite do seu entendimento sobre o sistema.
+
+- Checkout local: `app-community/modules/controleonline/ui-common`
+- Tipo: submódulo de app-community
+- Família: frontend
+- Branch base operacional: `master`
+- Alvo preferencial de PR: `dev`
+- `AGENTS.md` local: presente
+
+Leia o `AGENTS.md` mais próximo antes de editar código. Se esta alteração tocar apenas o repositório atual, trabalhe aqui; se também exigir atualização do superprojeto que consome este repositório, registre ou entregue a composição necessária sem perder a separação de ownership.
+
+_Arquivo gerado por `cto-mcp/scripts/sync-copilot-agents.mjs`._

package/.github/agents/security.agent.md

@@ -0,0 +1,30 @@
+---
+name: Security
+description: Revisor de segurança do repositório ControleOnline/ui-common, com fonte canônica centralizada no cto-mcp.
+target: github-copilot
+---
+
+## Fonte canônica
+
+Este wrapper é intencionalmente fino. Antes de agir, leia e siga, nesta ordem:
+
+1. `https://github.com/ControleOnline/cto-mcp/blob/master/agents/agent/security/agent.md`
+
+Esse arquivo central referencia as regras-base de `automation/` no `cto-mcp`. Se este wrapper local divergir do conteúdo canônico do `cto-mcp`, prefira o `cto-mcp`, salvo quando o estado real deste repositório exigir adaptação operacional explícita.
+
+## Contexto local
+
+Você está operando no repositório `ControleOnline/ui-common`.
+
+Você conhece o ecossistema completo da ControleOnline. Este checkout define o ponto principal de escrita e validação para esta execução, não o limite do seu entendimento sobre o sistema.
+
+- Checkout local: `app-community/modules/controleonline/ui-common`
+- Tipo: submódulo de app-community
+- Família: frontend
+- Branch base operacional: `master`
+- Alvo preferencial de PR: `dev`
+- `AGENTS.md` local: presente
+
+Leia o `AGENTS.md` mais próximo antes de editar código. Se esta alteração tocar apenas o repositório atual, trabalhe aqui; se também exigir atualização do superprojeto que consome este repositório, registre ou entregue a composição necessária sem perder a separação de ownership.
+
+_Arquivo gerado por `cto-mcp/scripts/sync-copilot-agents.mjs`._

package/.github/workflows/npmjs.yml

@@ -0,0 +1,35 @@
+name: Publish Package to npmjs
+
+on:
+  push:
+    branches:
+      - master
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - uses: actions/checkout@v5
+        with:
+          fetch-depth: 2
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20.x'
+          registry-url: 'https://registry.npmjs.org'
+          scope: '@controleonline'
+
+      - run: npm install
+      - run: npm whoami || true
+      - run: |
+          rm -f ~/.npmrc
+          rm -f .npmrc
+      - run: |
+          CURRENT=$(node -p "require('./package.json').version")
+          PREVIOUS=$(git show HEAD~1:package.json | node -p "JSON.parse(require('fs').readFileSync(0)).version")
+          [ "$CURRENT" = "$PREVIOUS" ] && exit 0 || true
+
+      - run: npm publish --provenance --access public

package/.github/workflows/pull-request-checks.yml

@@ -0,0 +1,19 @@
+name: Pull Request Checks
+
+on:
+  pull_request:
+  push:
+    branches-ignore:
+      - master
+
+jobs:
+  tests:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20.x'
+
+      - run: npm test

package/.scrutinizer.yml

@@ -0,0 +1,24 @@
+checks:
+  javascript: true
+
+build:
+  nodes:
+    analysis:
+      environment:
+        node: v16
+      project_setup:
+        override: true
+      tests:
+        override:
+          - js-scrutinizer-run
+          - command: npm run test:coverage
+            coverage:
+              file: coverage/clover.xml
+              format: clover
+
+filter:
+  excluded_paths:
+    - "build/*"
+    - "coverage/*"
+    - "dist/*"
+    - "node_modules/*"

package/FUNDING.yml

@@ -0,0 +1 @@
+github: [controleonline]

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@controleonline/ui-common",
+  "version": "1.2.70",
+  "author": "ControleOnline",
+  "description": "ControleOnline Common Quasar UI Component",
+  "license": "MIT",
+  "main": "src/react/index.js",
+  "scripts": {
+    "test": "npm run test:imports-status && npm run test:runtime-language && npm run test:runtime-footer && npm run test:invoice-presentation",
+    "test:imports-status": "mkdir -p node_modules/@controleonline && ln -sfn ../.. node_modules/@controleonline/ui-common && node --test src/tests/react/utils/importStatus.test.js",
+    "test:runtime-language": "node --test src/tests/react/utils/runtimeLanguage.test.js",
+    "test:runtime-footer": "node --test src/tests/react/utils/runtimeFooter.test.js",
+    "test:invoice-presentation": "node --test src/tests/react/utils/invoicePresentation.test.mjs",
+    "test:coverage": "c8 --reporter=clover --report-dir coverage npm test"
+  },
+  "devDependencies": {
+    "c8": "^10.1.3"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ControleOnline/ui-common.git"
+  },
+  "bugs": "",
+  "homepage": "https://www.controleonline.com/devs/plugins",
+  "browserslist": [
+    "last 1 version, not dead, ie >= 11"
+  ]
+}

package/src/api/fetch.js

@@ -0,0 +1,74 @@
+import { APP_ENV } from "../../../../../config/env.js";
+import resolveSystemErrorMessage from '@controleonline/ui-common/src/react/utils/systemErrorMessage';
+import {resolveApiEntryPoint} from '@controleonline/ui-common/src/utils/apiEntryPoint';
+
+const buildHttpError = (response, body) => {
+  const message =
+    resolveSystemErrorMessage(body) ||
+    String(response.statusText || 'Request failed');
+
+  return {
+    message: message || 'Request failed',
+    code: response.status,
+    status: response.status,
+    body,
+  };
+};
+
+const readResponseBody = async (response, responseType) => {
+  if (responseType === 'text') {
+    return response.text();
+  }
+
+  const text = await response.text();
+  if (!text) {
+    return null;
+  }
+
+  try {
+    return JSON.parse(text);
+  } catch (error) {
+    return text;
+  }
+};
+
+export default function (resourceEndpoint, options = {}) {
+  const apiEntryPoint = resolveApiEntryPoint(APP_ENV.API_ENTRYPOINT);
+  const entryPoint =
+    apiEntryPoint + (apiEntryPoint.endsWith("/") ? "" : "/");
+
+  if (!resourceEndpoint || !entryPoint) return;
+
+  // if (resourceEndpoint == "/people/companies/my")
+  //console.log(entryPoint, resourceEndpoint, options);
+
+  //console.log(entryPoint, resourceEndpoint);
+
+  return fetch(new URL(resourceEndpoint, entryPoint), options).then(async response => {
+    const body = await readResponseBody(response, options.responseType);
+
+    if (options.method == "DELETE") {
+      if (!response.ok) {
+        throw buildHttpError(response, body);
+      }
+
+      return;
+    }
+
+    if (!response.ok) {
+      throw buildHttpError(response, body);
+    }
+
+    if (options.responseType == "text") {
+      return body;
+    }
+
+    if (body && typeof body === 'object') {
+      if (body["@type"] == "Error" || body["@type"] == "ConstraintViolationList") {
+        throw buildHttpError(response, body);
+      }
+    }
+
+    return body;
+  });
+}

package/src/api/index.js

@@ -0,0 +1,155 @@
+import myFetch from '@controleonline/ui-common/src/api/fetch';
+import axios from 'axios';
+import { APP_ENV } from '../../../../../config/env';
+import { resolveAppDomain } from '@controleonline/ui-common/src/utils/appDomain';
+import { resolveApiEntryPoint } from '@controleonline/ui-common/src/utils/apiEntryPoint';
+
+const MIME_TYPE = 'application/ld+json';
+
+export const api = {
+  device: JSON.parse(localStorage.getItem('device') || '{}'),
+  masterDevice: JSON.parse(localStorage.getItem('master-device') || '{}'),
+
+
+  upload: async function (uri, formData) {
+    const token = await this.getToken();
+    const appDomain = resolveAppDomain(APP_ENV.DOMAIN);
+    const apiEntryPoint = resolveApiEntryPoint(APP_ENV.API_ENTRYPOINT);
+    const entryPoint = apiEntryPoint + (apiEntryPoint.endsWith("/") ? "" : "/");
+    const url = new URL(uri.startsWith('/') ? uri.substring(1) : uri, entryPoint).href;
+
+    return axios.post(url, formData, {
+      headers: {
+        'API-TOKEN': token,
+        'App-Domain': appDomain,
+        'Accept': '*/*',
+        // IMPORTANTE: Deixe vazio para o Axios/Browser definir o boundary do multipart
+      }
+    });
+  },
+  fetch: async function (uri, options = {}) {
+    if (typeof options.headers === 'undefined')
+      Object.assign(options, { headers: new Headers() });
+
+    // Always refresh device from localStorage in case it was set after module load
+    try {
+      this.device = JSON.parse(localStorage.getItem('device') || '{}');
+    } catch (e) {
+      this.device = {};
+    }
+
+    try {
+      this.masterDevice = JSON.parse(
+        localStorage.getItem('master-device') || '{}',
+      );
+    } catch (e) {
+      this.masterDevice = {};
+    }
+
+    let token = await this.getToken();
+    if (token) options.headers.set('API-TOKEN', token);
+
+    let bodyDeviceId = null;
+    if (options.body) {
+      if (typeof options.body === 'object') {
+        bodyDeviceId = options.body.device || null;
+      } else if (typeof options.body === 'string') {
+        try {
+          const parsedBody = JSON.parse(options.body);
+          bodyDeviceId = parsedBody?.device || null;
+        } catch (e) {
+          bodyDeviceId = null;
+        }
+      }
+    }
+
+    const headerDeviceId =
+      this.masterDevice?.id || this.device?.id || bodyDeviceId;
+    if (headerDeviceId) options.headers.set('DEVICE', headerDeviceId);
+    if (options.responseType != 'text') {
+      options.headers.set('Content-Type', MIME_TYPE);
+      options.headers.set('Accept', MIME_TYPE);
+    }
+    options.headers.set('App-Domain', resolveAppDomain(APP_ENV.DOMAIN));
+
+    if (options.body && typeof options.body != 'string') {
+      options.body = JSON.stringify(options.body);
+    }
+    if (options.params) {
+      uri = this.buildQueryString(uri, options);
+    }
+    return myFetch(uri, options).catch(e => {
+      throw e;
+    });
+  },
+  async getToken() {
+    const sessionString = localStorage.getItem('session');
+    let session = null;
+    if (sessionString) {
+      try {
+        const cleanString =
+          typeof sessionString == 'string' &&
+            sessionString.startsWith('__q_objt|')
+            ? sessionString.substring('__q_objt|'.length)
+            : sessionString;
+        session = JSON.parse(cleanString); // Transforma a string em objeto
+      } catch (e) {
+        console.error('Failed to parse session from localStorage', e);
+      }
+    }
+
+    return session?.token || session?.api_key;
+  },
+  serialize(obj, prefix = '') {
+    const pairs = [];
+
+    for (const key in obj) {
+      if (obj.hasOwnProperty(key)) {
+        const value = obj[key];
+        let fullKey = prefix ? `${prefix}.${key}` : key; // Usa ponto para objetos
+
+        if (value === null || value === undefined) {
+          pairs.push(`${fullKey}=`);
+        } else if (typeof value === 'object' && !Array.isArray(value)) {
+          // Objeto aninhado: chama serialize recursivamente com ponto
+          pairs.push(...this.serialize(value, fullKey));
+        } else if (Array.isArray(value)) {
+          // Array: adiciona [] e itera sobre os valores
+          if (value.length === 0) {
+            pairs.push(`${fullKey}[]=`);
+          } else {
+            value.forEach(val => {
+              if (typeof val === 'object' && val !== null) {
+                pairs.push(...this.serialize(val, `${fullKey}[]`));
+              } else {
+                pairs.push(`${fullKey}[]=${encodeURIComponent(val)}`);
+              }
+            });
+          }
+        } else {
+          // Valor simples
+          pairs.push(`${fullKey}=${encodeURIComponent(value)}`);
+        }
+      }
+    }
+    return pairs;
+  },
+
+  buildQueryString(uri, options) {
+    if (options.params) {
+      const params = this.serialize(options.params);
+      uri = `${uri}?${params.join('&')}`;
+    }
+    return uri;
+  },
+  post: async function (uri, body = {}) {
+    const options = {
+      method: 'POST',
+      body: body,
+    };
+    return await this.fetch(uri, options);
+  },
+  execute: function (params) {
+    return axios(params);
+  },
+};

package/src/api/localDB.js

@@ -0,0 +1,131 @@
+import { openDB } from "idb";
+
+const DB_NAME = "ControleOnline";
+
+export default class localDB {
+  constructor(state) {
+    this.state = state;
+
+    this.checkAndGetDB();
+  }
+
+  async initDB() {
+    let dbPromise = openDB(DB_NAME, this.currentVersion, {
+      upgrade: (db) => {
+        if (!db.objectStoreNames.contains(this.state.resourceEndpoint)) {
+          const store = db.createObjectStore(this.state.resourceEndpoint, {
+            keyPath: "id",
+          });
+          this.state.columns
+            .filter((col) => col.sortable || col.externalFilter === false)
+            .forEach((col) => {
+              store.createIndex(col.name, col.name, { unique: false });
+            });
+        }
+      },
+    });
+    return dbPromise;
+  }
+
+  async getCurrentVersion() {
+    // Obtém a versão atual do banco de dados
+    return new Promise((resolve) => {
+      const request = indexedDB.open(DB_NAME);
+      request.onsuccess = () => {
+        const db = request.result;
+        const currentVersion = db.currentVersion;
+        db.close();
+        resolve(currentVersion);
+        this.currentVersion = currentVersion;
+      };
+      request.onerror = () => resolve(1);
+    });
+  }
+
+  async checkAndGetDB() {
+    return this.getCurrentVersion().then(() => {
+      return this.initDB().then((db) => {
+        if (!this.storeExists()) {
+          this.currentVersion = db.currentVersion + 1;
+          db.close();
+          return this.initDB();
+        }
+        return db;
+      });
+    });
+  }
+
+  async storeExists() {
+    return this.checkAndGetDB().then((db) => {
+      return db.objectStoreNames.contains(this.state.resourceEndpoint);
+    });
+  }
+
+  async getAll() {
+    if (!(await this.storeExists())) {
+      return null;
+    }
+    const db = await this.checkAndGetDB();
+    return db.getAll(this.state.resourceEndpoint);
+  }
+
+  async getItemsByColumn(columnName, value) {
+    if (!(await this.storeExists())) {
+      return null;
+    }
+    const db = await this.checkAndGetDB();
+    const tx = db.transaction(this.state.resourceEndpoint, "readonly");
+    const store = tx.objectStore(this.state.resourceEndpoint);
+    const index = store.index(columnName);
+    const results = await index.getAll(value);
+    await tx.done;
+    return results;
+  }
+
+  async get(id) {
+    if (!(await this.storeExists())) {
+      return null;
+    }
+    const db = await this.checkAndGetDB();
+    return db.get(this.state.resourceEndpoint, id);
+  }
+
+  async saveItems(items) {
+    const db = await this.checkAndGetDB();
+    const tx = db.transaction(this.state.resourceEndpoint, "readwrite");
+    const store = tx.objectStore(this.state.resourceEndpoint);
+    await Promise.all(items.map((item) => store.put(item)));
+    await tx.done;
+  }
+
+  async saveItem(item) {
+    const db = await this.checkAndGetDB();
+    return db.put(this.state.resourceEndpoint, item);
+  }
+
+  async getItemsByFilters() {
+    if (!(await this.storeExists())) {
+      return null;
+    }
+    const db = await this.checkAndGetDB();
+    if (Object.keys(this.state.filters).length === 0) {
+      return this.getAll();
+    }
+
+    const filterPromises = Object.entries(this.state.filters).map(
+      async ([key, value]) => {
+        const column = this.state.columns.find((col) => col.name === key);
+        if (column && (column.sortable || column.externalFilter === false)) {
+          return this.getItemsByColumn(key, value);
+        }
+        return null;
+      }
+    );
+
+    const filterResults = await Promise.all(filterPromises);
+    return filterResults.reduce((acc, curr) => {
+      if (!acc || acc.length === 0) return curr;
+      return acc.filter((item) => curr.some((result) => result.id === item.id));
+    }, []);
+  }
+}

package/src/api/queue.js

@@ -0,0 +1,66 @@
+class Queue {
+  constructor() {
+    this.queue = [];
+    this.isProcessing = false;
+    this.timeout = [];
+    this.onFinish = null;
+  }
+  addToQueue(func) {
+    this.queue.push(func);
+  }
+  executeQueue(func, callback) {
+    this.addToQueue(func);
+    this.initQueue(callback);
+  }
+
+  execute(func, id, wait = 10) {
+    const debounced = function (...args) {
+      clearTimeout(this.timeout[id]);
+      this.timeout[id] = setTimeout(() => {
+        this.addToQueue(() => func(...args));
+      }, wait);
+    };
+
+    debounced.cancel = id => {
+      clearTimeout(this.timeout[id]);
+    };
+    return debounced;
+  }
+
+  finalize = () => {
+    if (this.onFinish && typeof this.onFinish == 'function') this.onFinish();
+    this.isProcessing = false;
+    this.onFinish = null;
+  };
+
+  processQueue() {
+    if (this.queue.length === 0) return this.finalize();
+    else this.isProcessing = true;
+
+    if (this.isProcessing === false) return;
+
+    const func = this.queue[0];
+
+    return func()
+      .then(() => {
+        this.queue.shift();
+        return this.processQueue();
+      })
+      .catch(error => {
+        console.log(
+          'Erro ao processar a fila. Nova tentativa em 5 segundos',
+          error,
+        );
+
+        setTimeout(() => {
+          return this.processQueue();
+        }, 10);
+      });
+  }
+  initQueue(callback) {
+    if (typeof callback == 'function') this.onFinish = callback;
+    if (this.isProcessing === true) return;
+    this.processQueue();
+  }
+}
+export const queue = new Queue();