wake-runner 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kelven Souza
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,190 @@
+# wake-runner
+
+CLI to start Wake storefront projects from the project root.
+
+`wake-runner` automates two common tasks in Wake projects:
+
+- Start `fbits.storefront` using the token from `Configs/settings.json`
+- Start `tailwindcss --watch` for every `input*.css` file inside `Assets/CSS/`
+
+## Requirements
+
+- Node.js installed
+- `fbits.storefront` installed on your machine and available in your PATH
+- Tailwind CSS **3.4.18** installed on your machine (via standalone CLI in PATH or npm)—required for compatibility with the [Wake template padrão](https://wakecommerce.readme.io/docs/template-padrao#tailwindcss)
+- A Wake project containing:
+  - `Configs/settings.json`
+  - `Assets/CSS/`
+
+## External tools
+
+Before using `wake-runner`, install the required CLIs on your machine.
+
+### `fbits.storefront`
+
+`fbits.storefront` is required to start the local Wake Storefront server.
+
+Follow the official Wake Commerce installation guide for your operating system:
+
+- https://wakecommerce.readme.io/docs/local#download
+
+After installation, make sure `fbits.storefront` is available from your terminal.
+
+### Tailwind CSS (v3.4.18)
+
+The default Wake template uses Tailwind CSS and recommends **version 3.4.18**. You must have this version installed. See the [Wake Commerce – Template Padrão (TailwindCSS)](https://wakecommerce.readme.io/docs/template-padrao#tailwindcss) documentation for details.
+
+You can install Tailwind in either of these ways:
+
+1. **Standalone CLI (recommended in Wake docs)**  
+   Download the [Tailwind CSS CLI release v3.4.18](https://github.com/tailwindlabs/tailwindcss/releases/tag/v3.4.18), add the binary to your system PATH, and ensure the `tailwindcss` command is available in your terminal.
+
+2. **npm**  
+   Install globally or in your Wake project:
+
+   ```bash
+   npm install -g tailwindcss@3.4.18
+   ```
+
+   Or locally in the Wake project:
+
+   ```bash
+   npm install -D tailwindcss@3.4.18
+   ```
+
+When you run `wake tailwind` or `wake`, the CLI will:
+
+- use the local npm Tailwind when `node_modules/.bin/tailwindcss` exists in the current project
+- otherwise use the global `tailwindcss` command from your PATH
+
+## Expected project structure
+
+Run the commands from the root of your Wake project:
+
+```text
+your-wake-project/
+├── Configs/
+│   └── settings.json
+└── Assets/
+    └── CSS/
+        ├── input.css
+        ├── input_login.css
+        └── input_checkout.css
+```
+
+`settings.json` must contain an `access_token` field:
+
+```json
+{
+  "access_token": "your-token-here"
+}
+```
+
+## Installation
+
+Install globally from npm:
+
+```bash
+npm install -g wake-runner
+```
+
+For local development of this package, inside the package folder:
+
+```bash
+npm install -g .
+```
+
+## Usage
+
+Go to your Wake project root and run one of the commands below.
+
+If you are using a local npm Tailwind installation, run these commands from the same project root where `tailwindcss` was installed.
+
+### Start everything
+
+Starts `fbits.storefront` and all Tailwind watchers:
+
+```bash
+wake
+```
+
+### Start only storefront
+
+```bash
+wake storefront
+```
+
+Or:
+
+```bash
+wake-storefront
+```
+
+### Start only Tailwind watchers
+
+Starts one watcher for each `input*.css` file found directly inside `Assets/CSS/`.
+
+```bash
+wake tailwind
+```
+
+Or:
+
+```bash
+wake-tailwind
+```
+
+## CSS file mapping
+
+Each input file is mapped to an output file by replacing the leading `input` prefix with `output`.
+
+Examples:
+
+- `input.css` -> `output.css`
+- `input_login.css` -> `output_login.css`
+- `input_partner.css` -> `output_partner.css`
+
+## How it works
+
+### `wake storefront`
+
+- Reads `Configs/settings.json`
+- Extracts `access_token`
+- Runs:
+
+```bash
+fbits.storefront --token <access_token>
+```
+
+### `wake tailwind`
+
+- Reads files directly from `Assets/CSS/`
+- Finds files that start with `input` and end with `.css`
+- Starts one process per file
+- Uses local npm Tailwind when available, otherwise uses the global `tailwindcss` command:
+
+```bash
+tailwindcss -i ./Assets/CSS/input.css -o ./Assets/CSS/output.css --watch
+```
+
+## Errors
+
+The CLI exits with code `1` when:
+
+- `Configs/settings.json` does not exist
+- `Configs/settings.json` is invalid JSON
+- `access_token` is missing or empty
+- `Assets/CSS/` does not exist
+- No `input*.css` files are found
+
+## Notes
+
+- Only files directly inside `Assets/CSS/` are scanned
+- Subdirectories are not scanned
+- The CLI uses only Node.js built-in modules
+- Tailwind 3.4.18 can be installed via the standalone CLI (add to PATH) or via npm (global or local in the Wake project)
+- On Windows, separate commands are exposed as `wake-storefront` and `wake-tailwind` instead of names containing `:`
+
+## License
+
+MIT

package/bin/wake-storefront.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+
+process.env.WAKE_MODE = 'storefront';
+require('./wake');

package/bin/wake-tailwind.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+
+process.env.WAKE_MODE = 'tailwind';
+require('./wake');

package/bin/wake.js

@@ -0,0 +1,178 @@
+#!/usr/bin/env node
+
+const fs = require('fs');
+const path = require('path');
+const { spawn } = require('child_process');
+
+const cwd = process.cwd();
+
+function exitWithError(message) {
+  console.error(message);
+  process.exit(1);
+}
+
+function parseJsonFile(filePath, fileLabel) {
+  try {
+    return JSON.parse(fs.readFileSync(filePath, 'utf8').replace(/^\uFEFF/, ''));
+  } catch (error) {
+    exitWithError(`Erro: ${fileLabel} inválido.`);
+  }
+}
+
+function getToken() {
+  const settingsPath = path.join(cwd, 'Configs', 'settings.json');
+
+  if (!fs.existsSync(settingsPath)) {
+    exitWithError('Erro: Configs/settings.json não encontrado. Execute dentro de um projeto Wake.');
+  }
+
+  const settings = parseJsonFile(settingsPath, 'Configs/settings.json');
+  const token = settings.access_token;
+
+  if (!token) {
+    exitWithError('Erro: access_token não encontrado no settings.json.');
+  }
+
+  return token;
+}
+
+function getInputFiles() {
+  const cssDir = path.join(cwd, 'Assets', 'CSS');
+
+  if (!fs.existsSync(cssDir)) {
+    exitWithError('Erro: pasta Assets/CSS não encontrada.');
+  }
+
+  const inputFiles = fs.readdirSync(cssDir, { withFileTypes: true })
+    .filter(
+      entry => entry.isFile() && entry.name.startsWith('input') && entry.name.endsWith('.css')
+    )
+    .map(entry => entry.name);
+
+  if (inputFiles.length === 0) {
+    exitWithError('Erro: nenhum arquivo input*.css encontrado em Assets/CSS.');
+  }
+
+  return inputFiles;
+}
+
+function spawnCommand(command, args) {
+  spawn(command, args, {
+    stdio: 'inherit',
+    cwd,
+    shell: true,
+  });
+}
+
+function hasLocalTailwindBinary() {
+  const localBinNames = process.platform === 'win32'
+    ? ['tailwindcss.cmd', 'tailwindcss']
+    : ['tailwindcss'];
+
+  return localBinNames.some(binName =>
+    fs.existsSync(path.join(cwd, 'node_modules', '.bin', binName))
+  );
+}
+
+function getTailwindCommand() {
+  if (hasLocalTailwindBinary()) {
+    return {
+      command: 'npm',
+      argsPrefix: ['exec', 'tailwindcss', '--'],
+      sourceLabel: 'npm local',
+    };
+  }
+
+  return {
+    command: 'tailwindcss',
+    argsPrefix: [],
+    sourceLabel: 'PATH global',
+  };
+}
+
+function runStorefront() {
+  const token = getToken();
+
+  console.log(`Token carregado: ${token.slice(0, 10)}...`);
+  console.log('Iniciando fbits.storefront...');
+
+  spawnCommand('fbits.storefront', ['--token', token]);
+}
+
+function runTailwind() {
+  const inputFiles = getInputFiles();
+  const tailwind = getTailwindCommand();
+
+  console.log(`Arquivos CSS encontrados: ${inputFiles.join(', ')}\n`);
+  console.log(`Usando Tailwind via ${tailwind.sourceLabel}.`);
+
+  for (const inputFile of inputFiles) {
+    const outputFile = inputFile.replace(/^input/, 'output');
+    const inputPath = `./Assets/CSS/${inputFile}`;
+    const outputPath = `./Assets/CSS/${outputFile}`;
+
+    console.log(`Iniciando Tailwind: ${inputFile} -> ${outputFile}`);
+    spawnCommand(tailwind.command, [
+      ...tailwind.argsPrefix,
+      '-i',
+      inputPath,
+      '-o',
+      outputPath,
+      '--watch',
+    ]);
+  }
+}
+
+function printUsage() {
+  console.log('Uso:');
+  console.log('  wake');
+  console.log('  wake storefront');
+  console.log('  wake tailwind');
+  console.log('  wake-storefront');
+  console.log('  wake-tailwind');
+}
+
+function runCli(mode) {
+  switch (mode) {
+    case 'all':
+      runStorefront();
+      runTailwind();
+      break;
+    case 'storefront':
+      runStorefront();
+      break;
+    case 'tailwind':
+      runTailwind();
+      break;
+    default:
+      printUsage();
+      process.exit(1);
+  }
+}
+
+function isCliEntrypoint() {
+  const mainFilename = require.main && require.main.filename;
+
+  if (!mainFilename) {
+    return false;
+  }
+
+  const allowedEntrypoints = [
+    __filename,
+    path.join(__dirname, 'wake-storefront.js'),
+    path.join(__dirname, 'wake-tailwind.js'),
+  ];
+
+  return allowedEntrypoints.some(entrypoint =>
+    path.resolve(mainFilename) === path.resolve(entrypoint)
+  );
+}
+
+if (isCliEntrypoint()) {
+  const mode = process.env.WAKE_MODE || process.argv[2] || 'all';
+  runCli(mode);
+}
+
+module.exports = {
+  runCli,
+};

package/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "wake-runner",
+  "version": "1.0.0",
+  "description": "CLI to start Wake storefront projects",
+  "keywords": [
+    "wake",
+    "cli",
+    "storefront",
+    "fbits",
+    "tailwindcss",
+    "automation"
+  ],
+  "author": "Kelvin Simons",
+  "bin": {
+    "wake": "bin/wake.js",
+    "wake-storefront": "bin/wake-storefront.js",
+    "wake-tailwind": "bin/wake-tailwind.js"
+  },
+  "license": "MIT"
+}