@amadeus-it-group/ngrx-devtool 0.1.2

package/README.md

@@ -0,0 +1,77 @@
+# NgRx DevTool
+
+A development tool for visualizing and debugging NgRx state management in Angular applications. Real-time action monitoring, effect tracking, state visualization, diff viewer, and performance metrics — no browser extensions needed.
+
+## Install
+
+```bash
+npm install @amadeus-it-group/ngrx-devtool
+```
+
+> If your project uses a private npm registry and you get an E401 error:
+> ```bash
+> npm install @amadeus-it-group/ngrx-devtool --registry=https://registry.npmjs.org/
+> ```
+
+## Setup
+
+```typescript
+// app.config.ts
+import { provideNgrxDevTool, createDevToolMetaReducer } from '@amadeus-it-group/ngrx-devtool';
+
+export const appConfig: ApplicationConfig = {
+  providers: [
+    provideStore(
+      { /* your reducers */ },
+      { metaReducers: [createDevToolMetaReducer()] }
+    ),
+    provideEffects([YourEffects]),
+    provideNgrxDevTool({
+      wsUrl: 'ws://localhost:4000',
+      trackEffects: true,
+    }),
+  ]
+};
+```
+
+> **If you have a separate store module** (e.g. `RootStoreModule`), add `createDevToolMetaReducer()` inside that module's `StoreModule.forRoot()`, not in `app.config.ts`:
+>
+> ```typescript
+> // store.module.ts
+> @NgModule({
+>   imports: [
+>     StoreModule.forRoot(
+>       { /* your reducers */ },
+>       { metaReducers: [createDevToolMetaReducer()] }
+>     ),
+>     EffectsModule.forRoot([YourEffects])
+>   ]
+> })
+> export class RootStoreModule {}
+>
+> // app.config.ts - only add the devtool provider here
+> providers: [
+>   provideNgrxDevTool({ wsUrl: 'ws://localhost:4000', trackEffects: true }),
+> ]
+> ```
+
+## Run
+
+```bash
+npx ngrx-devtool
+```
+
+> If your project uses a private registry:
+> ```bash
+> npm_config_registry=https://registry.npmjs.org/ npx ngrx-devtool
+> ```
+
+Open [http://localhost:3000](http://localhost:3000) and start your Angular app.
+
+## GitHub
+
+[github.com/amadeusitgroup/ngrx-devtool](https://github.com/amadeusitgroup/ngrx-devtool)
+
+## License
+
+MIT

package/index.js

@@ -0,0 +1,52 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+var ws_1 = require("ws");
+var path = require("path");
+var express = require("express");
+var http_1 = require("http");
+var chalk = require('chalk');
+var PORT_WS = 4000;
+var PORT_UI = '3000';
+var wss = new ws_1.WebSocketServer({ port: PORT_WS });
+var clients = [];
+var logo = "\n                                    ***@  +**\n                                  **         ******%\n                               @**   .......-::       ++%\n                         #****%    ...................    *+\n                       **          . .....................   +\n                      #*....         .............:--=- :.     =\n                      # .          ...............:-%*%% %.      =\n                     **           ..................*. *-+@.      =\n                  %***           .......... ** ......    .......   +\n                *#              ....:::#********# ....  .. ....    =:\n               * ..           ...:::****+=@@@@@@@@@@@  .......    #=\n              %* ..:.       ...:: +*+.@@@@@@@@@@@@@@@@@@@@%###%%###*+\n               # ...      ...:::++=@@@@@@@@%%%%%%%%@@@@@@@@@#%%-## **     =\n               *# .      ..:::*++@@@@@@%%%%%%##%%%%%%%%@@@@@@@+###+:** ..\n               **       ..:::=+-@@@@@%%%           ##%%%%@@@@@@*.#@%+# ##..\n              %*       ..:::*=%@@@@%%%%%             ##%%%%%%@@@@+%%%%%*# #. *\n             *#       ..:::.=@@@@@%%%%%%########*     ####%%%%@@@@%*%## ##  .\n             *        .::::+.@@@@%%%%%%%%%%%#####*    @*###%%%%@%@#%%#%-@% #.\n             *  .     :::::=@@%%%%%%%%%%#####%@=       *####%%%%%%*### .%##%.\n             * ..     .::::=@@%%%%%%####               *####%%%%%%%##   %-# .\n             :*       ..:::-@@%%%%####*     @###*#     *####%%%%%%#*    ## -:\n             ..*#*     .:::-%@%%%%####     ######*     *#####%%*##@    @# .:=*\n              =+ +    =..:::%@%%%%####     ######*     *#####%%#*  ..    ..:@+\n              %+ -=    +..-: %%%%%####.                ####%%%% =..    ... @#*\n               *+ =   . + .--%%%%%%####*         %     ##%%%#-....    ... # *-\n               @*:++   : += -:%%%#######******#########%%%%%%%%%%%# =.    #*:*\n                ** **   : ++ =:%%%%##*********####%%%%%%%%%%%%%%@ :::...** :**\n                 ** ** . . .== . ### ++++++***####%%%%%%%%%%+  --:::: #* ::@#-\n                . ** ##       === %**   .::-++*###%% :.+-:::::::::@*% =---##%\n                 . ** *#@        =--==       :=**#%%%%%  :..:....::.====-%**:.\n                     +#@##           *-:        %*###%%%###-  :::==++==@%#%..\n                     +**:*##           .         .......:::::+===++==%%##.:.\n                    .  **#=####             ....:::--------==.-===+%%%#%::.\n                    . .  **#++####      .....:.::::::::-:::-====%%%*#%-:-:\n                      ...  *##-+#####@ .. .::::::.   .:::---%%%%#*#%---::\n                        ..:. **###*######%%@  .. ... @#%%%%%%#*#%.--=::\n                          ....  **##%=*####%%%%%%%%%%%#%****## ---:::\n                             ..... .*****%#%#=+***--####%=-:-:-:::\n                                        ::::====---- ===--=::::\n                                      . .:.:::-:::--:::::::\n                                         .........:\n";
+console.log(chalk.magenta(logo));
+console.log(chalk.dim('─'.repeat(60)));
+console.log(chalk.bold.white('  Amadeus | NgRx DevTools Server'));
+console.log(chalk.dim('─'.repeat(60)));
+wss.on('connection', function (socket) {
+    clients.push(socket);
+    socket.on('message', function (message) {
+        clients.forEach(function (client) {
+            if (client !== socket && client.readyState === ws_1.WebSocket.OPEN) {
+                client.send(message);
+            }
+        });
+    });
+});
+var app = express();
+app.use(express.static(path.resolve(__dirname, 'ngrx-devtool-ui/browser')));
+app.get('*', function (_req, res) {
+    res.sendFile(path.resolve(__dirname, 'ngrx-devtool-ui/browser/index.html'));
+});
+var uiServer = (0, http_1.createServer)(app);
+uiServer.listen(Number(PORT_UI), function () { });
+uiServer.on('error', function (error) {
+    console.error(chalk.red("  \u2717 Failed to start UI server: ".concat(error.message)));
+});
+process.on('SIGINT', function () {
+    console.log(chalk.dim('\n\n  Shutting down servers...'));
+    uiServer.close();
+    wss.close();
+    console.log(chalk.green('  ✓ Servers stopped. Goodbye!\n'));
+    process.exit(0);
+});
+console.log('');
+console.log(chalk.green("  \u2713 WebSocket"), chalk.dim("ws://localhost:".concat(PORT_WS)));
+console.log(chalk.green("  \u2713 UI Server"), chalk.dim("http://localhost:".concat(PORT_UI)));
+console.log('');
+console.log(chalk.dim('─'.repeat(60)));
+console.log(chalk.dim('  Press'), chalk.white('Ctrl+C'), chalk.dim('to stop all servers'));
+console.log(chalk.dim('─'.repeat(60)));
+console.log('');