@controleonline/ui-common 1.2.71 → 1.2.75

package/.github/actions/workers/manager/action.yml

@@ -0,0 +1,147 @@
+name: Manager Subworker
+description: Resolve/cria issue, aplica labels e decide quais workers invocar (padrão de branch = master)
+inputs:
+  gh_token:
+    description: PAT (GH_TOKEN)
+    required: true
+  branch:
+    description: Branch do push (master|dev|staging)
+    required: true
+outputs:
+  issue_number:
+    description: Número da issue fonte
+    value: ${{ steps.resolve.outputs.issue_number }}
+  created:
+    description: true se a issue foi criada agora
+    value: ${{ steps.resolve.outputs.created }}
+  found:
+    description: true se issue veio do commit
+    value: ${{ steps.resolve.outputs.found }}
+  run_qa:
+    description: Manager decide invocar QA
+    value: ${{ steps.resolve.outputs.run_qa }}
+  run_security:
+    description: Manager decide invocar Security
+    value: ${{ steps.resolve.outputs.run_security }}
+  run_docs:
+    description: Manager decide invocar Technical Documenter
+    value: ${{ steps.resolve.outputs.run_docs }}
+  run_gates:
+    description: Manager decide checar quarteto em master
+    value: ${{ steps.resolve.outputs.run_gates }}
+  base_branch:
+    description: Branch canônico (sempre master se veio main)
+    value: ${{ steps.resolve.outputs.base_branch }}
+runs:
+  using: composite
+  steps:
+    - name: Resolve issue, labels e plano de workers
+      id: resolve
+      shell: bash
+      env:
+        GH_TOKEN: ${{ inputs.gh_token }}
+        BRANCH_IN: ${{ inputs.branch }}
+        REPO: ${{ github.repository }}
+        SHA: ${{ github.sha }}
+        MSG: ${{ github.event.head_commit.message }}
+        BEFORE: ${{ github.event.before }}
+      run: |
+        set -euo pipefail
+
+        # Padrão da org: master (nunca main como branch de trabalho)
+        BRANCH="$BRANCH_IN"
+        if [ "$BRANCH" = "main" ]; then
+          echo "AVISO: branch main detectada — tratando como master (padrão org)"
+          BRANCH="master"
+        fi
+        echo "base_branch=$BRANCH" >> "$GITHUB_OUTPUT"
+
+        MESSAGES=$(git log --pretty=format:"%s %b" "${BEFORE}..${SHA}" 2>/dev/null || git log -1 --pretty=format:"%s %b")
+        ISSUE_REF=$(echo "$MESSAGES" | grep -oE '([A-Za-z0-9_.-]+/[A-Za-z0-9_.-]+)?#([0-9]+)' | head -1 || true)
+
+        if [ -n "$ISSUE_REF" ]; then
+          NUM=$(echo "$ISSUE_REF" | grep -oE '[0-9]+$')
+          echo "found=true" >> "$GITHUB_OUTPUT"
+          echo "created=false" >> "$GITHUB_OUTPUT"
+          echo "issue_number=$NUM" >> "$GITHUB_OUTPUT"
+          echo "Issue fonte: #$NUM"
+        else
+          echo "Push sem issue → Manager cria issue"
+          TITLE="ops: orquestração automática (push ${BRANCH} ${SHA:0:7})"
+          BODY=$(cat <<EOF
+        ## Manager Worker — issue automática
+
+        Push em \`${BRANCH}\` sem referência de issue no commit.
+
+        - **Commit**: ${SHA}
+        - **Mensagem**: ${MSG}
+
+        O Manager aplica labels e **invoca** os workers necessários (QA / Security / Technical Documenter) conforme o branch.
+
+        Fonte: https://raw.githubusercontent.com/ControleOnline/agents-mcp/master/agents/roles/manager/agent.md
+        EOF
+        )
+
+          LABELS='["agent:manager"]'
+          case "$BRANCH" in
+            master)
+              LABELS='["agent:manager","agent:technical-documenter"]'
+              ;;
+            dev)
+              LABELS='["agent:manager","agent:qa","agent:security","agent:developer:done"]'
+              ;;
+            staging)
+              LABELS='["agent:manager","agent:qa","agent:security"]'
+              ;;
+          esac
+
+          RESPONSE=$(gh api --method POST \
+            -H "Accept: application/vnd.github+json" \
+            -H "X-GitHub-Api-Version: 2022-11-28" \
+            "/repos/${REPO}/issues" \
+            --input - <<EOF
+          {
+            "title": $(echo "$TITLE" | jq -Rs .),
+            "body": $(echo "$BODY" | jq -Rs .),
+            "labels": $LABELS
+          }
+          EOF
+          )
+          NUM=$(echo "$RESPONSE" | jq -r .number)
+          echo "found=false" >> "$GITHUB_OUTPUT"
+          echo "created=true" >> "$GITHUB_OUTPUT"
+          echo "issue_number=$NUM" >> "$GITHUB_OUTPUT"
+          echo "Issue criada: #$NUM"
+        fi
+
+        # Manager decide quais workers invocar
+        run_qa=false
+        run_security=false
+        run_docs=false
+        run_gates=false
+
+        case "$BRANCH" in
+          master)
+            run_docs=true
+            run_gates=true
+            gh issue edit "$NUM" --repo "$REPO" --add-label "agent:technical-documenter" || true
+            ;;
+          dev)
+            run_qa=true
+            run_security=true
+            gh issue edit "$NUM" --repo "$REPO" --add-label "agent:qa" --add-label "agent:security" --add-label "agent:developer:done" || true
+            ;;
+          staging)
+            run_qa=true
+            run_security=true
+            gh issue edit "$NUM" --repo "$REPO" --add-label "agent:qa" --add-label "agent:security" || true
+            ;;
+        esac
+
+        echo "run_qa=$run_qa" >> "$GITHUB_OUTPUT"
+        echo "run_security=$run_security" >> "$GITHUB_OUTPUT"
+        echo "run_docs=$run_docs" >> "$GITHUB_OUTPUT"
+        echo "run_gates=$run_gates" >> "$GITHUB_OUTPUT"
+
+        gh issue comment "$NUM" --repo "$REPO" --body \
+          "**Manager** orquestrou push \`${BRANCH}\`: run_qa=$run_qa run_security=$run_security run_docs=$run_docs run_gates=$run_gates. Workers serão invocados a seguir."

package/.github/actions/workers/qa/action.yml

@@ -0,0 +1,44 @@
+name: QA Worker
+description: Assign Copilot as QA — single link to agents-mcp
+inputs:
+  gh_token:
+    required: true
+  issue_number:
+    required: true
+  base_branch:
+    default: dev
+runs:
+  using: composite
+  steps:
+    - name: Assign Copilot as QA
+      shell: bash
+      env:
+        GH_TOKEN: ${{ inputs.gh_token }}
+        ISSUE: ${{ inputs.issue_number }}
+        REPO: ${{ github.repository }}
+        BASE: ${{ inputs.base_branch }}
+      run: |
+        set -euo pipefail
+        CUSTOM_INSTRUCTIONS='Atue 100% como QA do ControleOnline.
+Leia e siga OBRIGATORIAMENTE a fonte canônica única:
+https://raw.githubusercontent.com/ControleOnline/agents-mcp/master/agents/roles/qa/agent.md'
+
+        gh issue edit "$ISSUE" --repo "$REPO" --add-label "agent:qa" || true
+
+        gh api --method POST \
+          -H "Accept: application/vnd.github+json" \
+          -H "X-GitHub-Api-Version: 2022-11-28" \
+          "/repos/${REPO}/issues/${ISSUE}/assignees" \
+          --input - <<EOFINNER
+        {
+          "assignees": ["copilot-swe-agent[bot]"],
+          "agent_assignment": {
+            "target_repo": "${REPO}",
+            "base_branch": "${BASE}",
+            "custom_instructions": $(echo "$CUSTOM_INSTRUCTIONS" | jq -Rs .)
+          }
+        }
+        EOFINNER
+
+        gh issue comment "$ISSUE" --repo "$REPO" --body \
+          "Manager Worker → **QA**. Fonte: agents-mcp/agents/roles/qa/agent.md"

package/.github/actions/workers/security/action.yml

@@ -0,0 +1,44 @@
+name: Security Worker
+description: Assign Copilot as Security — single link to agents-mcp
+inputs:
+  gh_token:
+    required: true
+  issue_number:
+    required: true
+  base_branch:
+    default: dev
+runs:
+  using: composite
+  steps:
+    - name: Assign Copilot as Security
+      shell: bash
+      env:
+        GH_TOKEN: ${{ inputs.gh_token }}
+        ISSUE: ${{ inputs.issue_number }}
+        REPO: ${{ github.repository }}
+        BASE: ${{ inputs.base_branch }}
+      run: |
+        set -euo pipefail
+        CUSTOM_INSTRUCTIONS='Atue 100% como Security do ControleOnline.
+Leia e siga OBRIGATORIAMENTE a fonte canônica única:
+https://raw.githubusercontent.com/ControleOnline/agents-mcp/master/agents/roles/security/agent.md'
+
+        gh issue edit "$ISSUE" --repo "$REPO" --add-label "agent:security" || true
+
+        gh api --method POST \
+          -H "Accept: application/vnd.github+json" \
+          -H "X-GitHub-Api-Version: 2022-11-28" \
+          "/repos/${REPO}/issues/${ISSUE}/assignees" \
+          --input - <<EOFINNER
+        {
+          "assignees": ["copilot-swe-agent[bot]"],
+          "agent_assignment": {
+            "target_repo": "${REPO}",
+            "base_branch": "${BASE}",
+            "custom_instructions": $(echo "$CUSTOM_INSTRUCTIONS" | jq -Rs .)
+          }
+        }
+        EOFINNER
+
+        gh issue comment "$ISSUE" --repo "$REPO" --body \
+          "Manager Worker → **Security**. Fonte: agents-mcp/agents/roles/security/agent.md"

package/.github/actions/workers/technical-documenter/action.yml

@@ -0,0 +1,51 @@
+name: Technical Documenter Worker
+description: Assign Copilot as technical-documenter — rules live only in agents-mcp
+inputs:
+  gh_token:
+    required: true
+  issue_number:
+    required: true
+  base_branch:
+    default: master
+runs:
+  using: composite
+  steps:
+    - name: Assign Copilot as technical-documenter
+      shell: bash
+      env:
+        GH_TOKEN: ${{ inputs.gh_token }}
+        ISSUE: ${{ inputs.issue_number }}
+        REPO: ${{ github.repository }}
+        BASE: ${{ inputs.base_branch }}
+      run: |
+        set -euo pipefail
+        # Regras 100% no agents-mcp — não copiar checklist/labels aqui
+        CUSTOM_INSTRUCTIONS='Atue 100% como technical-documenter do ControleOnline.
+Leia e siga OBRIGATORIAMENTE (fonte canônica única):
+https://raw.githubusercontent.com/ControleOnline/agents-mcp/master/agents/roles/technical-documenter/agent.md
+
+Também leia:
+https://raw.githubusercontent.com/ControleOnline/agents-mcp/master/agents/skills/shared/operations/copilot-cooperation.md
+https://raw.githubusercontent.com/ControleOnline/agents-mcp/master/agents/skills/by-role/technical-documenter/README.md
+
+Não use regras embutidas neste assignment; a fonte acima prevalece.'
+
+        gh issue edit "$ISSUE" --repo "$REPO" --add-label "agent:technical-documenter" || true
+
+        gh api --method POST \
+          -H "Accept: application/vnd.github+json" \
+          -H "X-GitHub-Api-Version: 2022-11-28" \
+          "/repos/${REPO}/issues/${ISSUE}/assignees" \
+          --input - <<EOFINNER
+        {
+          "assignees": ["copilot-swe-agent[bot]"],
+          "agent_assignment": {
+            "target_repo": "${REPO}",
+            "base_branch": "${BASE}",
+            "custom_instructions": $(echo "$CUSTOM_INSTRUCTIONS" | jq -Rs .)
+          }
+        }
+        EOFINNER
+
+        gh issue comment "$ISSUE" --repo "$REPO" --body \
+          "Manager Worker → **technical-documenter**. Fonte: agents-mcp/agents/roles/technical-documenter/agent.md"

package/.github/workflows/manager-worker.yml

@@ -0,0 +1,168 @@
+name: Manager Worker
+
+on:
+  push:
+    branches: [master, dev, staging]
+
+permissions:
+  contents: write
+  issues: write
+  pull-requests: write
+
+# Orquestrador: Manager resolve/cria issue e decide quais workers invocar.
+# Padrão de branch da org = master (não usar main).
+# Em master: bump patch + tag vX.Y.Z → dispara publish-npm.yml (Trusted Publishing).
+jobs:
+  manager:
+    name: Manager — resolve + plano de workers
+    runs-on: ubuntu-latest
+    outputs:
+      issue_number: ${{ steps.mgr.outputs.issue_number }}
+      created: ${{ steps.mgr.outputs.created }}
+      run_qa: ${{ steps.mgr.outputs.run_qa }}
+      run_security: ${{ steps.mgr.outputs.run_security }}
+      run_docs: ${{ steps.mgr.outputs.run_docs }}
+      run_gates: ${{ steps.mgr.outputs.run_gates }}
+      base_branch: ${{ steps.mgr.outputs.base_branch }}
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Manager subworker
+        id: mgr
+        uses: ./.github/actions/workers/manager
+        with:
+          gh_token: ${{ secrets.GH_TOKEN }}
+          branch: ${{ github.ref_name }}
+
+  # Workers invocados pelo plano do Manager (paralelo quando ambos true)
+  qa:
+    name: QA (invocado pelo Manager)
+    needs: manager
+    if: needs.manager.outputs.run_qa == 'true'
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ./.github/actions/workers/qa
+        with:
+          gh_token: ${{ secrets.GH_TOKEN }}
+          issue_number: ${{ needs.manager.outputs.issue_number }}
+          base_branch: ${{ needs.manager.outputs.base_branch }}
+
+  security:
+    name: Security (invocado pelo Manager)
+    needs: manager
+    if: needs.manager.outputs.run_security == 'true'
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ./.github/actions/workers/security
+        with:
+          gh_token: ${{ secrets.GH_TOKEN }}
+          issue_number: ${{ needs.manager.outputs.issue_number }}
+          base_branch: ${{ needs.manager.outputs.base_branch }}
+
+  technical-documenter:
+    name: Technical Documenter (invocado pelo Manager)
+    needs: manager
+    if: needs.manager.outputs.run_docs == 'true'
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ./.github/actions/workers/technical-documenter
+        with:
+          gh_token: ${{ secrets.GH_TOKEN }}
+          issue_number: ${{ needs.manager.outputs.issue_number }}
+          base_branch: ${{ needs.manager.outputs.base_branch }}
+
+  # master: se faltar gate do quarteto → tags + workers faltantes
+  master-gates:
+    name: Master gates (quarteto)
+    needs: manager
+    if: needs.manager.outputs.run_gates == 'true'
+    runs-on: ubuntu-latest
+    outputs:
+      need_qa: ${{ steps.check.outputs.need_qa }}
+      need_security: ${{ steps.check.outputs.need_security }}
+      need_docs: ${{ steps.check.outputs.need_docs }}
+    steps:
+      - uses: actions/checkout@v4
+      - name: Inspect quarteto e tags
+        id: check
+        env:
+          GH_TOKEN: ${{ secrets.GH_TOKEN }}
+          ISSUE: ${{ needs.manager.outputs.issue_number }}
+          REPO: ${{ github.repository }}
+        run: |
+          set -euo pipefail
+          LABELS=$(gh issue view "$ISSUE" --repo "$REPO" --json labels --jq '[.labels[].name] | join(",")')
+          echo "Labels: $LABELS"
+
+          need_qa=false
+          need_security=false
+          need_docs=false
+
+          echo "$LABELS" | grep -q 'qa:accepted' || need_qa=true
+          echo "$LABELS" | grep -q 'security:accepted' || need_security=true
+          echo "$LABELS" | grep -q 'agent:technical-documenter:done' || need_docs=true
+
+          echo "need_qa=$need_qa" >> "$GITHUB_OUTPUT"
+          echo "need_security=$need_security" >> "$GITHUB_OUTPUT"
+          echo "need_docs=$need_docs" >> "$GITHUB_OUTPUT"
+
+          [ "$need_qa" = true ] && gh issue edit "$ISSUE" --repo "$REPO" --add-label "agent:qa" || true
+          [ "$need_security" = true ] && gh issue edit "$ISSUE" --repo "$REPO" --add-label "agent:security" || true
+          [ "$need_docs" = true ] && gh issue edit "$ISSUE" --repo "$REPO" --add-label "agent:technical-documenter" || true
+
+          gh issue comment "$ISSUE" --repo "$REPO" --body \
+            "Master gates (Manager): need_qa=$need_qa need_security=$need_security need_docs=$need_docs"
+
+  master-qa:
+    name: QA (master gap via Manager)
+    needs: [manager, master-gates]
+    if: needs.master-gates.outputs.need_qa == 'true'
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ./.github/actions/workers/qa
+        with:
+          gh_token: ${{ secrets.GH_TOKEN }}
+          issue_number: ${{ needs.manager.outputs.issue_number }}
+          base_branch: master
+
+  master-security:
+    name: Security (master gap via Manager)
+    needs: [manager, master-gates]
+    if: needs.master-gates.outputs.need_security == 'true'
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ./.github/actions/workers/security
+        with:
+          gh_token: ${{ secrets.GH_TOKEN }}
+          issue_number: ${{ needs.manager.outputs.issue_number }}
+          base_branch: master
+
+  # Em push para master: bump patch + cria tag vX.Y.Z (dispara publish-npm.yml)
+  # Ignora commits de release ([skip bump]) para evitar loop.
+  version-tag:
+    name: Bump version + tag
+    if: github.ref == 'refs/heads/master' && !contains(github.event.head_commit.message, '[skip bump]')
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          token: ${{ secrets.GH_TOKEN }}
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '24'
+
+      - name: Bump patch + tag
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+          npm version patch -m "chore(release): %s [skip bump]"
+          git push origin HEAD:master --follow-tags

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

@@ -0,0 +1,45 @@
+name: Publish Package to npmjs
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+permissions:
+  id-token: write
+  contents: read
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+      contents: read
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '24'
+
+      - name: Ensure npm 11.5.1+ (OIDC support)
+        run: |
+          npm install -g npm@latest
+          echo "node=$(node -v) npm=$(npm -v)"
+
+      - name: Prepare registry (OIDC only — no classic token)
+        run: |
+          unset NODE_AUTH_TOKEN NPM_TOKEN || true
+          rm -f .npmrc "$HOME/.npmrc" || true
+          npm config delete //registry.npmjs.org/:_authToken 2>/dev/null || true
+          npm config set registry https://registry.npmjs.org/
+          echo "NODE_AUTH_TOKEN=${NODE_AUTH_TOKEN-<unset>}"
+          echo "ACTIONS_ID_TOKEN_REQUEST_URL=${ACTIONS_ID_TOKEN_REQUEST_URL:+set}"
+          echo "ACTIONS_ID_TOKEN_REQUEST_TOKEN=${ACTIONS_ID_TOKEN_REQUEST_TOKEN:+set}"
+          npm config list 2>/dev/null | grep -E "registry|auth|token" || true
+          cat "$HOME/.npmrc" 2>/dev/null || echo "(no ~/.npmrc)"
+
+      - name: Publish to npmjs (Trusted Publishing / OIDC)
+        run: |
+          unset NODE_AUTH_TOKEN NPM_TOKEN || true
+          npm publish --access public --loglevel verbose

package/.gitmodules

@@ -0,0 +1,3 @@
+[submodule "docs/wiki"]
+	path = docs/wiki
+	url = https://github.com/ControleOnline/ui-common.wiki.git

package/AGENTS.md

@@ -0,0 +1,6 @@
+## Ponto de entrada
+
+- A documentação funcional e de regras deste modulo vive na wiki do proprio repositório e na wiki principal do app.
+- Regras transversais de qualidade, modularizacao e limites de componente vivem em `https://github.com/ControleOnline/agents-mcp/blob/master/skills/shared/code-quality.md`.
+- Quando houver detalhe especifico de implementacao, prefira comentar no codigo em ingles perto da regra.
+- Este arquivo deve ficar curto e servir apenas como ponte para as fontes oficiais.

package/README.md

@@ -0,0 +1,14 @@
+# UI Common
+
+Shared runtime, API, and cross-application utilities for ControleOnline clients.
+
+## Device request identity
+
+Authenticated device requests send the `DEVICE` identifier and, when available, its matching operational `DEVICE-TYPE`. The runtime resolves the `POS` application view to the canonical sales device type `PDV` before persisting the device context.
+
+## Links obrigatorios
+
+- [Documentacao para clientes](http://ajuda.controleonline.com/)
+- [Site institucional](http://controleonline.com/)
+- [Wiki tecnica](https://github.com/ControleOnline/ui-common/wiki)
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@controleonline/ui-common",
-  "version": "1.2.71",
+  "version": "1.2.75",
   "author": "ControleOnline",
   "description": "ControleOnline Common Quasar UI Component",
   "license": "MIT",
@@ -26,6 +26,7 @@
     "last 1 version, not dead, ie >= 11"
   ],
   "dependencies": {
-    "@controleonline/ui-default": "*"
+    "@controleonline/ui-default": "*",
+    "md5": "^2.3.0"
   }
 }

package/src/api/fetch.js

@@ -1,4 +1,4 @@
-import { APP_ENV } from "../../../../../config/env.js";
+import {env as APP_ENV} from '@env';
 import resolveSystemErrorMessage from '@controleonline/ui-common/src/react/utils/systemErrorMessage';
 import {resolveApiEntryPoint} from '@controleonline/ui-common/src/utils/apiEntryPoint';