@slingr/cli 0.0.3 → 0.0.4

package/oclif.manifest.json

@@ -1,5 +1,71 @@
 {
   "commands": {
+    "build": {
+      "aliases": [],
+      "args": {},
+      "description": "Build a Slingr application: sync metadata, compile backend TypeScript, and build frontend.\n\nUse this command instead of running `npm run build` directly. It ensures all generated files\n(view registries, GraphQL schema and SDK) are up-to-date before TypeScript compilation,\npreventing errors like \"Cannot find module '../src/views/...'\" in generated/ files.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --skip-frontend",
+        "<%= config.bin %> <%= command.id %> --skip-metadata",
+        "<%= config.bin %> <%= command.id %> --verbose"
+      ],
+      "flags": {
+        "help": {
+          "char": "h",
+          "description": "Show CLI help.",
+          "name": "help",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "skip-metadata": {
+          "char": "m",
+          "description": "Skip sync-metadata step (view registries, schema, SDK generation)",
+          "name": "skip-metadata",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "skip-backend": {
+          "char": "b",
+          "description": "Skip backend TypeScript compilation",
+          "name": "skip-backend",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "skip-frontend": {
+          "char": "f",
+          "description": "Skip frontend build",
+          "name": "skip-frontend",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "verbose": {
+          "char": "v",
+          "description": "Show detailed build and compilation output",
+          "name": "verbose",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "build",
+      "pluginAlias": "@slingr/cli",
+      "pluginName": "@slingr/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": false,
+      "relativePath": [
+        "dist",
+        "commands",
+        "build.js"
+      ]
+    },
     "cli-build": {
       "aliases": [
         "cli-build"
@@ -40,8 +106,8 @@
         "<%= config.bin %> <%= command.id %>",
         "<%= config.bin %> <%= command.id %> my-app",
         "<%= config.bin %> <%= command.id %> task-manager",
-        "<%= config.bin %> <%= command.id %> my-crm --type=\"CRM\" --database=postgres --description=\"A CRM system for managing customers\"",
-        "<%= config.bin %> <%= command.id %> my-crm --type=\"CRM\" --database=postgres --description=\"A CRM system for managing customers\" -T"
+        "<%= config.bin %> <%= command.id %> my-crm --database=postgres --description=\"A CRM system for managing customers\"",
+        "<%= config.bin %> <%= command.id %> my-crm --database=postgres --description=\"A CRM system for managing customers\" -T"
       ],
       "flags": {
         "backend": {
@@ -99,19 +165,97 @@
           "name": "templates",
           "allowNo": false,
           "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "create-app",
+      "pluginAlias": "@slingr/cli",
+      "pluginName": "@slingr/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": false,
+      "relativePath": [
+        "dist",
+        "commands",
+        "create-app.js"
+      ]
+    },
+    "debug": {
+      "aliases": [],
+      "args": {},
+      "description": "Run a Slingr application locally with Node.js debugging enabled.\n\nBehaves exactly like \"slingr run\" but starts the backend with the Node.js inspector. Use --dev for hot-reload development mode (ts-node + UI dev server, both with debugger).\nWithout --dev, runs in production mode (compiled backend, static UI, single port).",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --skip-infra",
+        "<%= config.bin %> <%= command.id %> --inspect-brk",
+        "<%= config.bin %> <%= command.id %> --inspect-port 9230",
+        "<%= config.bin %> <%= command.id %> --dev",
+        "<%= config.bin %> <%= command.id %> --dev --inspect-brk"
+      ],
+      "flags": {
+        "help": {
+          "char": "h",
+          "description": "Show CLI help.",
+          "name": "help",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "dev": {
+          "char": "d",
+          "description": "Run in development mode with hot-reload (ts-node + UI dev server). The debugger is attached via NODE_OPTIONS.",
+          "name": "dev",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
         },
-        "type": {
-          "char": "t",
-          "description": "Type of app (e.g., CRM, task manager, ERP)",
-          "name": "type",
+        "inspect-brk": {
+          "char": "b",
+          "description": "Break before user code starts (--inspect-brk)",
+          "name": "inspect-brk",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "inspect-port": {
+          "char": "p",
+          "description": "Port for Node.js debugger (default: 9229)",
+          "name": "inspect-port",
+          "required": false,
+          "default": 9229,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "skip-infra": {
+          "char": "i",
+          "description": "Skip infrastructure setup and checks",
+          "name": "skip-infra",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "port": {
+          "description": "Custom port for the server (default: 3000)",
+          "name": "port",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "verbose": {
+          "char": "v",
+          "description": "Show detailed build and setup output",
+          "name": "verbose",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "create-app",
+      "id": "debug",
       "pluginAlias": "@slingr/cli",
       "pluginName": "@slingr/cli",
       "pluginType": "core",
@@ -121,7 +265,7 @@
       "relativePath": [
         "dist",
         "commands",
-        "create-app.js"
+        "debug.js"
       ]
     },
     "ds": {
@@ -133,11 +277,12 @@
           "required": true
         },
         "action": {
-          "description": "Action to perform (load or reset)",
+          "description": "Action to perform (load, reset, or indexes)",
           "name": "action",
           "options": [
             "load",
-            "reset"
+            "reset",
+            "indexes"
           ],
           "required": true
         },
@@ -148,14 +293,44 @@
           "required": false
         }
       },
-      "description": "Manage datasets for datasources",
+      "description": "Manage datasets and inspect datasources",
       "examples": [
-        "slingr ds postgres load",
-        "slingr ds postgres load custom-dataset",
-        "slingr ds mysql load default",
-        "slingr ds postgres reset"
+        "<%= config.bin %> <%= command.id %> mainDs load",
+        "<%= config.bin %> <%= command.id %> postgres load custom-dataset",
+        "<%= config.bin %> <%= command.id %> mainDs load --includeModels=User,Project",
+        "<%= config.bin %> <%= command.id %> mainDs load --includeModels=\"User,Project\"",
+        "<%= config.bin %> <%= command.id %> mainDs load --excludeModels=TestData",
+        "<%= config.bin %> <%= command.id %> mainDs load --verbose",
+        "<%= config.bin %> <%= command.id %> postgres reset",
+        "<%= config.bin %> <%= command.id %> mainDs indexes",
+        "<%= config.bin %> <%= command.id %> mainDs indexes --verbose"
       ],
-      "flags": {},
+      "flags": {
+        "includeModels": {
+          "description": "Comma-separated list of model names to load. Only these models will be loaded (overrides datasetOptions.json). Use --includeModels=Model1,Model2 or --includeModels \"Model1,Model2\" syntax.",
+          "name": "includeModels",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "excludeModels": {
+          "description": "Comma-separated list of model names to skip. All other models will be loaded (overrides datasetOptions.json). Use --excludeModels=Model1,Model2 or --excludeModels \"Model1,Model2\" syntax.",
+          "name": "excludeModels",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "verbose": {
+          "char": "v",
+          "description": "Show detailed logs during dataset loading. Without this flag, only success and validation error messages are displayed.",
+          "name": "verbose",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
       "id": "ds",
@@ -216,10 +391,13 @@
     "run": {
       "aliases": [],
       "args": {},
-      "description": "Run a Slingr application locally",
+      "description": "Run a Slingr application locally with both backend and frontend on a single port.\n\nBy default, runs in production mode (unified server). Use --dev flag for hot-reload development with separate processes.",
       "examples": [
         "<%= config.bin %> <%= command.id %>",
-        "<%= config.bin %> <%= command.id %> --skip-infra"
+        "<%= config.bin %> <%= command.id %> --skip-infra",
+        "<%= config.bin %> <%= command.id %> --dev",
+        "<%= config.bin %> <%= command.id %> --ui-only",
+        "<%= config.bin %> <%= command.id %> --backend"
       ],
       "flags": {
         "help": {
@@ -231,11 +409,63 @@
         },
         "skip-infra": {
           "char": "i",
-          "description": "Skip infrastructure setup and checks",
+          "description": "Skip infrastructure setup and checks (use when database containers are already running)",
           "name": "skip-infra",
           "required": false,
           "allowNo": false,
           "type": "boolean"
+        },
+        "dev": {
+          "char": "d",
+          "description": "Run in development mode with hot-reload (starts UI dev server and backend separately). Mutually exclusive with --ui-only and --backend.",
+          "exclusive": [
+            "ui-only",
+            "backend"
+          ],
+          "name": "dev",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "ui-only": {
+          "description": "Start only the UI development server (backend must be running separately). Mutually exclusive with --dev and --backend.",
+          "exclusive": [
+            "dev",
+            "backend"
+          ],
+          "name": "ui-only",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "backend": {
+          "char": "b",
+          "description": "Start only the backend server (use with --ui-only for split development). Mutually exclusive with --dev and --ui-only.",
+          "exclusive": [
+            "dev",
+            "ui-only"
+          ],
+          "name": "backend",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "port": {
+          "char": "p",
+          "description": "Custom port for the server (default: 3000 or first available)",
+          "name": "port",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "verbose": {
+          "char": "v",
+          "description": "Show detailed build and setup output and enable DEBUG level logs",
+          "name": "verbose",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
@@ -304,6 +534,201 @@
         "setup.js"
       ]
     },
+    "sync-metadata": {
+      "aliases": [],
+      "args": {},
+      "description": "Sync all generated metadata files (view registries, GraphQL schema, and SDK)",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --skip-views",
+        "<%= config.bin %> <%= command.id %> --skip-sdk"
+      ],
+      "flags": {
+        "skip-views": {
+          "description": "Skip view registry generation",
+          "name": "skip-views",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "skip-schema": {
+          "description": "Skip GraphQL schema generation",
+          "name": "skip-schema",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "skip-sdk": {
+          "description": "Skip GraphQL SDK generation",
+          "name": "skip-sdk",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "sync-metadata",
+      "pluginAlias": "@slingr/cli",
+      "pluginName": "@slingr/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": false,
+      "relativePath": [
+        "dist",
+        "commands",
+        "sync-metadata.js"
+      ]
+    },
+    "users": {
+      "aliases": [],
+      "args": {
+        "action": {
+          "description": "Action to perform",
+          "name": "action",
+          "options": [
+            "list",
+            "create",
+            "set-password",
+            "reset-password",
+            "activate",
+            "deactivate",
+            "delete"
+          ],
+          "required": true
+        },
+        "email": {
+          "description": "User email (required for set-password, reset-password, activate, deactivate, delete)",
+          "name": "email",
+          "required": false
+        }
+      },
+      "description": "Manage application users",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> list",
+        "<%= config.bin %> <%= command.id %> create",
+        "<%= config.bin %> <%= command.id %> create --email john@example.com --first-name John --last-name Doe --password pass123 --roles \"Admin,User\"",
+        "<%= config.bin %> <%= command.id %> set-password john@example.com",
+        "<%= config.bin %> <%= command.id %> set-password john@example.com --new-password newpass123",
+        "<%= config.bin %> <%= command.id %> reset-password john@example.com",
+        "<%= config.bin %> <%= command.id %> activate john@example.com",
+        "<%= config.bin %> <%= command.id %> deactivate john@example.com",
+        "<%= config.bin %> <%= command.id %> delete john@example.com --force"
+      ],
+      "flags": {
+        "help": {
+          "char": "h",
+          "description": "Show CLI help.",
+          "name": "help",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "first-name": {
+          "description": "User first name",
+          "name": "first-name",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "last-name": {
+          "description": "User last name",
+          "name": "last-name",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "email": {
+          "char": "e",
+          "description": "User email address",
+          "name": "email",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "password": {
+          "char": "p",
+          "description": "User password",
+          "name": "password",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "roles": {
+          "char": "r",
+          "description": "Comma-separated list of roles",
+          "name": "roles",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "new-password": {
+          "description": "New password for the user",
+          "name": "new-password",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "force": {
+          "char": "f",
+          "description": "Skip confirmation prompts for destructive operations",
+          "name": "force",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "datasource": {
+          "char": "d",
+          "description": "DataSource name (auto-discovered from User model if not specified)",
+          "name": "datasource",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "users",
+      "pluginAlias": "@slingr/cli",
+      "pluginName": "@slingr/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": false,
+      "relativePath": [
+        "dist",
+        "commands",
+        "users.js"
+      ]
+    },
+    "views": {
+      "aliases": [],
+      "args": {
+        "action": {
+          "description": "Action to perform (generate-context)",
+          "name": "action",
+          "options": [
+            "generate-context"
+          ],
+          "required": true
+        }
+      },
+      "description": "Manage custom views for your Slingr application",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> generate-context"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "views",
+      "pluginAlias": "@slingr/cli",
+      "pluginName": "@slingr/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": false,
+      "relativePath": [
+        "dist",
+        "commands",
+        "views.js"
+      ]
+    },
     "infra:down": {
       "aliases": [],
       "args": {},
@@ -431,5 +856,5 @@
       ]
     }
   },
-  "version": "0.0.3"
+  "version": "0.0.4"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@slingr/cli",
   "description": "Slingr CLI tool for creating and managing Slingr applications",
-  "version": "0.0.3",
+  "version": "0.0.4",
   "publishConfig": {
     "access": "public"
   },
@@ -12,43 +12,47 @@
     "@faker-js/faker": "^8.4.1",
     "@oclif/core": "^4",
     "@oclif/plugin-help": "^6",
+    "@types/cli-progress": "^3.11.6",
     "@types/fs-extra": "^11.0.4",
     "@types/inquirer": "^8.2.12",
     "@types/js-yaml": "^4.0.9",
+    "cli-progress": "^3.12.0",
     "fs-extra": "^11.3.1",
-    "glob": "^11.0.0",
+    "glob": "^11.0.3",
     "graphql": "^16.11.0",
     "inquirer": "^8.2.7",
     "js-yaml": "^4.1.0",
     "mocha": "^11.7.4",
-    "reflect-metadata": "^0.2.2"
+    "reflect-metadata": "^0.2.2",
+    "@slingr/framework-backend": "0.2.1"
   },
   "devDependencies": {
     "@eslint/compat": "^1",
     "@oclif/prettier-config": "^0.2.1",
     "@oclif/test": "^4",
     "@types/chai": "^4",
+    "@types/cli-progress": "^3.11.6",
     "@types/mocha": "^10.0.6",
-    "@types/node": "^18",
+    "@types/node": "^20",
+    "c8": "^10.1.3",
     "chai": "^4",
+    "cli-progress": "^3.12.0",
     "eslint": "^9",
     "eslint-config-oclif": "^6",
     "eslint-config-prettier": "^10",
-    "nyc": "^17.1.0",
     "oclif": "^4",
     "shx": "^0.3.3",
     "ts-node": "^10.9.2",
-    "typescript": "^5"
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.2"
   },
   "overrides": {
-    "glob": "^11.0.0",
-    "inflight": "npm:@lukekarrys/inflight@^1.0.6",
-    "nyc": {
-      "rimraf": "^5.0.0"
-    }
+    "glob": "^11.0.3",
+    "inflight": "npm:@lukekarrys/inflight@^1.0.6"
   },
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=20.0.0",
+    "npm": ">=10.0.0"
   },
   "files": [
     "./bin",
@@ -83,18 +87,8 @@
     ],
     "topicSeparator": " "
   },
-  "scripts": {
-    "build": "shx rm -rf dist && tsc -b && shx cp -r src/templates dist/ && shx cp -r src/scripts dist/",
-    "lint": "eslint",
-    "postpack": "shx rm -f oclif.manifest.json",
-    "prepack": "npm run build && oclif manifest && oclif readme",
-    "setup": "npm run build && npm run prepack && npm link",
-    "test": "mocha -r ts-node/register --timeout 60000 --forbid-only \"test/**/*.test.ts\"",
-    "coverage": "nyc --reporter=text --reporter=text-summary --reporter=json-summary mocha --forbid-only \"test/**/*.test.ts\"",
-    "version": "oclif readme && git add README.md"
-  },
   "types": "dist/index.d.ts",
-  "nyc": {
+  "c8": {
     "include": [
       "src/**/*.ts"
     ],
@@ -110,8 +104,17 @@
       "json-summary"
     ],
     "sourceMap": true,
-    "instrument": true,
-    "all": true,
-    "cache": false
+    "all": true
+  },
+  "scripts": {
+    "build": "shx rm -rf dist lib/node_modules && tsc -b && shx cp -r src/templates dist/ && shx cp -r src/scripts dist/",
+    "lint": "eslint",
+    "setup": "npm run build && npm run prepack && npm link",
+    "test": "node scripts/run-mocha.js -r ts-node/register --timeout 60000 --forbid-only --default-spec test/**/*.test.ts --",
+    "test:unit": "node scripts/run-mocha.js -r ts-node/register --timeout 30000 --forbid-only --default-spec test/*.test.ts --default-spec test/commands/**/*.test.ts --",
+    "test:integration": "node scripts/run-mocha.js -r ts-node/register --timeout 120000 --forbid-only --default-spec test/integration/**/*.test.ts --",
+    "coverage": "c8 --reporter=text --reporter=text-summary --reporter=json-summary node scripts/run-mocha.js -r ts-node/register --timeout 60000 --forbid-only --default-spec test/**/*.test.ts --",
+    "coverage:integration": "c8 --reporter=text --reporter=text-summary --reporter=json-summary node scripts/run-mocha.js -r ts-node/register --timeout 120000 --forbid-only --default-spec test/integration/**/*.test.ts --",
+    "version": "oclif readme && git add README.md"
   }
 }

package/src/templates/.env.template

@@ -0,0 +1,23 @@
+# Slingr Application Configuration
+# This file contains environment-specific configuration for your Slingr app.
+# Copy this file to .env and customize the values as needed.
+
+# GraphQL Server Configuration
+GRAPHQL_HOST=localhost
+GRAPHQL_PORT=3000
+GRAPHQL_ENABLE_EXPLORER=true
+
+# Note: These values can be overridden by:
+# 1. app.configure() method in your code
+# 2. app.run() options parameter
+# Configuration priority: .env < configure() < run(options)
+
+# JWT Configuration
+JWT_SECRET=your-secret-key-change-in-production
+
+# Database Configuration
+DB_HOST=localhost
+DB_PORT=5432
+DB_USER=postgres
+DB_PASSWORD=postgres
+DB_NAME={{APP_NAME}}

package/src/templates/.firebaserc.template

@@ -0,0 +1,5 @@
+{
+  "projects": {
+    "default": "YOUR_GCP_PROJECT_ID"
+  }
+}