{"_id":"@bukiopay/template-builder","name":"@bukiopay/template-builder","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@bukiopay/template-builder","version":"1.0.0","description":"CLI oficial da BukioPay para editar templates da sua loja localmente com sincronização automática.","type":"module","bin":{"bukiopay-template":"bin/index.js"},"engines":{"node":">=18"},"scripts":{"start":"node bin/index.js"},"keywords":["bukiopay","template","cli","storefront","sync"],"license":"ISC","dependencies":{"axios":"^1.7.0","chalk":"^5.3.0","chokidar":"^3.6.0","commander":"^12.1.0","ora":"^8.1.0"},"gitHead":"d169978c5dc862ae9a29e02fec6a808c207e472e","_id":"@bukiopay/template-builder@1.0.0","_nodeVersion":"26.3.0","_npmVersion":"11.16.0","dist":{"integrity":"sha512-iLMIa405c6bHHPE46bwqZz0fuSqD86SXeEDrAixfwQSIFcOLJ43rA8GIO0kRnJy4v03yfr+ne8qptgb2ehheyg==","shasum":"edec1c49b06cba284e002ce700fdb44cf234103d","tarball":"https://registry.npmjs.org/@bukiopay/template-builder/-/template-builder-1.0.0.tgz","fileCount":12,"unpackedSize":26967,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDVpiAmfinncjrIFnan/oFkq6vwoWaW5/Q1gcGgzsu7FQIgfXXmb/gjhdUzeKsvNrqI/yYjyIwf7+HLS2zxTLsW9n8="}]},"_npmUser":{"name":"bukiopay","email":"wamberg236@gmail.com"},"directories":{},"maintainers":[{"name":"bukiopay","email":"wamberg236@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/template-builder_1.0.0_1782412811286_0.5600817693543343"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-25T18:40:11.111Z","1.0.0":"2026-06-25T18:40:11.433Z","modified":"2026-06-25T18:40:11.653Z"},"maintainers":[{"name":"bukiopay","email":"wamberg236@gmail.com"}],"description":"CLI oficial da BukioPay para editar templates da sua loja localmente com sincronização automática.","keywords":["bukiopay","template","cli","storefront","sync"],"license":"ISC","readme":"# @bukiopay/template-builder\r\n\r\nCLI oficial da **BukioPay** para editar os templates da sua loja localmente, no seu próprio editor (VS Code, etc.), com sincronização automática.\r\n\r\nVocê edita os arquivos no seu computador e, a cada vez que salva, a alteração sobe sozinha para o template da sua loja.\r\n\r\n## Começando\r\n\r\nNo painel da BukioPay, vá em **Personalização → Seus templates**, clique nos três pontos do template criado e em **Editar localmente**. Copie o comando exibido e cole no terminal, dentro de uma pasta vazia:\r\n\r\n```bash\r\nnpx @bukiopay/template-builder@latest --token SEU_TOKEN\r\n```\r\n\r\nIsso vai:\r\n\r\n1. Validar o token (vinculado à sua loja e a esse template).\r\n2. Criar uma pasta com o nome da sua loja (ex: `minha-loja-template/`).\r\n3. Baixar todos os arquivos do template.\r\n4. Iniciar o modo **watch** automaticamente.\r\n\r\nDepois é só abrir a pasta no VS Code e editar. Cada arquivo salvo é sincronizado.\r\n\r\n## O que você pode editar\r\n\r\nApenas estas pastas e extensões:\r\n\r\n```\r\ncomponents/   (.html)\r\nlayouts/      (.html)\r\npages/        (.html)\r\nscripts/      (.js)\r\nstyles/       (.css)\r\n```\r\n\r\nRegras importantes:\r\n\r\n- **Arquivos novos** criados localmente são **ignorados** (não é possível criar arquivos pelo editor local).\r\n- **Arquivos apagados** localmente **não** apagam nem alteram o remoto. Para restaurar o original, use `reset`.\r\n- Conteúdo de servidor não é permitido: nada de EJS executável (`<% %>`), `require`, `process`, `fs`, `eval`, `process.env` ou imports de módulos Node. Imports relativos de frontend (`./utils.js`) são permitidos em `.js`.\r\n- Limite de 512KB por arquivo.\r\n\r\n## Comandos\r\n\r\n| Comando | O que faz |\r\n|---|---|\r\n| `npx @bukiopay/template-builder@latest --token TOKEN` | Inicializa: baixa o template e começa a observar. |\r\n| `bukiopay-template watch` | Observa e sincroniza alterações (dentro do projeto). |\r\n| `bukiopay-template pull` | Rebaixa os arquivos do servidor (sobrescreve os locais). |\r\n| `bukiopay-template push [path]` | Envia tudo, ou um arquivo específico. |\r\n| `bukiopay-template reset <path>` | Restaura um arquivo para o original do template. |\r\n\r\nExemplos:\r\n\r\n```bash\r\nbukiopay-template reset pages/home.html\r\nbukiopay-template push styles/main.css\r\n```\r\n\r\n## Segurança do token\r\n\r\n- O token aparece **uma única vez** no painel, ao gerar. Se perder, gere outro.\r\n- Ele é **temporário** (expira) e pode ser **revogado** no painel.\r\n- É limitado a **uma loja** e a **um template**. Não dá acesso à sua conta.\r\n- Gerar um token novo **revoga** o anterior.\r\n- **Não compartilhe** o token. Quem tiver ele consegue editar este template enquanto for válido.\r\n\r\nA CLI guarda o token em `.env.local` (que entra no `.gitignore` automaticamente). Ele nunca é gravado no `.bukio/config.json`.\r\n\r\n## Estrutura criada\r\n\r\n```\r\nminha-loja-template/\r\n├── components/\r\n├── layouts/\r\n├── pages/\r\n├── scripts/\r\n├── styles/\r\n├── .bukio/\r\n│   ├── config.json     (loja, template, apiUrl, slug — sem o token)\r\n│   └── versions.json   (controle de versão por arquivo)\r\n├── .env.local          (BUKIO_SYNC_TOKEN — gitignored)\r\n└── .gitignore\r\n```\r\n\r\n## Conflitos\r\n\r\nSe o mesmo arquivo for alterado em outro lugar (ex: editor web do painel), o push retorna **409 Conflito** e a CLI **não sobrescreve**. Rode `bukiopay-template pull` para atualizar antes de continuar editando.\r\n\r\n## Variáveis de ambiente\r\n\r\n- `BUKIO_SYNC_TOKEN` — token (alternativa ao `--token`).\r\n- `BUKIO_API_URL` — URL da API (padrão: `https://api.bukiopay.com`).\r\n","readmeFilename":"README.md","_rev":"1-1243df4350de7fe374fec6ec8861a36a"}