@slingr/cli 0.0.1

package/oclif.manifest.json

@@ -0,0 +1,435 @@
+{
+  "commands": {
+    "cli-build": {
+      "aliases": [
+        "cli-build"
+      ],
+      "args": {},
+      "description": "Rebuild the Slingr CLI tool itself. This command is used for CLI development and maintenance, not for building Slingr applications.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "Description: Use this command when you need to rebuild the Slingr CLI after making changes to the CLI codebase."
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "cli-build",
+      "pluginAlias": "@slingr/cli",
+      "pluginName": "@slingr/cli",
+      "pluginType": "core",
+      "strict": false,
+      "enableJsonFlag": false,
+      "isESM": false,
+      "relativePath": [
+        "dist",
+        "commands",
+        "cli-build.js"
+      ]
+    },
+    "create-app": {
+      "aliases": [],
+      "args": {
+        "name": {
+          "description": "Name of the app to create",
+          "name": "name",
+          "required": false
+        }
+      },
+      "description": "Create a new Slingr app",
+      "examples": [
+        "<%= 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"
+      ],
+      "flags": {
+        "backend": {
+          "char": "b",
+          "description": "Include backend for the app (default: true)",
+          "hidden": true,
+          "name": "backend",
+          "allowNo": true,
+          "type": "boolean"
+        },
+        "database": {
+          "char": "d",
+          "description": "Database to use (postgres or mysql)",
+          "name": "database",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "postgres",
+            "mysql"
+          ],
+          "type": "option"
+        },
+        "description": {
+          "char": "D",
+          "description": "Description of what the app needs to do",
+          "name": "description",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "frontend": {
+          "char": "f",
+          "description": "Include frontend for the app (default: true)",
+          "hidden": true,
+          "name": "frontend",
+          "allowNo": true,
+          "type": "boolean"
+        },
+        "help": {
+          "char": "h",
+          "description": "Show CLI help.",
+          "name": "help",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "skip-setup": {
+          "description": "Skip the final setup prompt for non-interactive usage",
+          "name": "skip-setup",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "templates": {
+          "char": "T",
+          "description": "Include template models and tests in the project",
+          "name": "templates",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "type": {
+          "char": "t",
+          "description": "Type of app (e.g., CRM, task manager, ERP)",
+          "name": "type",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "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"
+      ]
+    },
+    "ds": {
+      "aliases": [],
+      "args": {
+        "datasource": {
+          "description": "Name of the datasource to manage",
+          "name": "datasource",
+          "required": true
+        },
+        "action": {
+          "description": "Action to perform (load or reset)",
+          "name": "action",
+          "options": [
+            "load",
+            "reset"
+          ],
+          "required": true
+        },
+        "dataset": {
+          "default": "default",
+          "description": "Name of the dataset to load (defaults to \"default\")",
+          "name": "dataset",
+          "required": false
+        }
+      },
+      "description": "Manage datasets for datasources",
+      "examples": [
+        "slingr ds postgres load",
+        "slingr ds postgres load custom-dataset",
+        "slingr ds mysql load default",
+        "slingr ds postgres reset"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "ds",
+      "pluginAlias": "@slingr/cli",
+      "pluginName": "@slingr/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": false,
+      "relativePath": [
+        "dist",
+        "commands",
+        "ds.js"
+      ]
+    },
+    "gql": {
+      "aliases": [],
+      "args": {
+        "action": {
+          "description": "Action to perform (generate-schema or generate-sdk)",
+          "name": "action",
+          "options": [
+            "generate-schema",
+            "generate-sdk"
+          ],
+          "required": true
+        }
+      },
+      "description": "Generate GraphQL schema and SDK for your Slingr application",
+      "examples": [
+        "slingr gql generate-schema",
+        "slingr gql generate-schema --no-exit",
+        "slingr gql generate-sdk"
+      ],
+      "flags": {
+        "no-exit": {
+          "description": "Keep Apollo Server running after generating schema (for generate-schema only)",
+          "name": "no-exit",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "gql",
+      "pluginAlias": "@slingr/cli",
+      "pluginName": "@slingr/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": false,
+      "relativePath": [
+        "dist",
+        "commands",
+        "gql.js"
+      ]
+    },
+    "run": {
+      "aliases": [],
+      "args": {},
+      "description": "Run a Slingr application locally",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --skip-infra"
+      ],
+      "flags": {
+        "help": {
+          "char": "h",
+          "description": "Show CLI help.",
+          "name": "help",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "skip-infra": {
+          "char": "i",
+          "description": "Skip infrastructure setup and checks",
+          "name": "skip-infra",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "run",
+      "pluginAlias": "@slingr/cli",
+      "pluginName": "@slingr/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": false,
+      "relativePath": [
+        "dist",
+        "commands",
+        "run.js"
+      ]
+    },
+    "setup": {
+      "aliases": [],
+      "args": {},
+      "description": "Complete setup of a Slingr application with framework, schema, and SDK generation",
+      "examples": [
+        "slingr setup",
+        "slingr setup --skip-install",
+        "slingr setup --skip-schema"
+      ],
+      "flags": {
+        "skip-install": {
+          "description": "Skip npm install step",
+          "name": "skip-install",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "skip-schema": {
+          "description": "Skip schema generation step",
+          "name": "skip-schema",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "skip-sdk": {
+          "description": "Skip SDK generation step",
+          "name": "skip-sdk",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "help": {
+          "char": "h",
+          "description": "Show CLI help.",
+          "name": "help",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "setup",
+      "pluginAlias": "@slingr/cli",
+      "pluginName": "@slingr/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": false,
+      "relativePath": [
+        "dist",
+        "commands",
+        "setup.js"
+      ]
+    },
+    "infra:down": {
+      "aliases": [],
+      "args": {},
+      "description": "Stop infrastructure services using Docker Compose (data is preserved by default)",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> # Stop services, preserve data",
+        "<%= config.bin %> <%= command.id %> --volumes # Stop services and delete all data"
+      ],
+      "flags": {
+        "help": {
+          "char": "h",
+          "description": "Show CLI help.",
+          "name": "help",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "volumes": {
+          "char": "v",
+          "description": "Remove volumes as well (WARNING: This will delete all data)",
+          "name": "volumes",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "infra:down",
+      "pluginAlias": "@slingr/cli",
+      "pluginName": "@slingr/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": false,
+      "relativePath": [
+        "dist",
+        "commands",
+        "infra",
+        "down.js"
+      ]
+    },
+    "infra:up": {
+      "aliases": [],
+      "args": {},
+      "description": "Start infrastructure services using Docker Compose",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --detach"
+      ],
+      "flags": {
+        "detach": {
+          "char": "d",
+          "description": "Run services in detached mode (background)",
+          "name": "detach",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "help": {
+          "char": "h",
+          "description": "Show CLI help.",
+          "name": "help",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "infra:up",
+      "pluginAlias": "@slingr/cli",
+      "pluginName": "@slingr/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": false,
+      "relativePath": [
+        "dist",
+        "commands",
+        "infra",
+        "up.js"
+      ]
+    },
+    "infra:update": {
+      "aliases": [],
+      "args": {},
+      "description": "Update infrastructure configuration based on metadata",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --file postgres.ts",
+        "<%= config.bin %> <%= command.id %> -f mysql.ts",
+        "<%= config.bin %> <%= command.id %> --all",
+        "<%= config.bin %> <%= command.id %> -a"
+      ],
+      "flags": {
+        "all": {
+          "char": "a",
+          "description": "Update all available data sources",
+          "name": "all",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "file": {
+          "char": "f",
+          "description": "Optional: Specific data source file to update",
+          "name": "file",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "infra:update",
+      "pluginAlias": "@slingr/cli",
+      "pluginName": "@slingr/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": false,
+      "relativePath": [
+        "dist",
+        "commands",
+        "infra",
+        "update.js"
+      ]
+    }
+  },
+  "version": "0.0.1"
+}

package/package.json

@@ -0,0 +1,118 @@
+{
+  "name": "@slingr/cli",
+  "description": "Slingr CLI tool for creating and managing Slingr applications",
+  "version": "0.0.1",
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "slingr": "./bin/run.js"
+  },
+  "dependencies": {
+    "@faker-js/faker": "^8.4.1",
+    "@oclif/core": "^4",
+    "@oclif/plugin-help": "^6",
+    "@types/fs-extra": "^11.0.4",
+    "@types/inquirer": "^8.2.12",
+    "@types/js-yaml": "^4.0.9",
+    "fs-extra": "^11.3.1",
+    "glob": "^11.0.0",
+    "graphql": "^16.11.0",
+    "inquirer": "^8.2.7",
+    "js-yaml": "^4.1.0",
+    "mocha": "^11.7.4",
+    "reflect-metadata": "^0.2.2",
+    "slingr-framework": "file:../framework"
+  },
+  "devDependencies": {
+    "@eslint/compat": "^1",
+    "@oclif/prettier-config": "^0.2.1",
+    "@oclif/test": "^4",
+    "@types/chai": "^4",
+    "@types/mocha": "^10.0.6",
+    "@types/node": "^18",
+    "chai": "^4",
+    "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"
+  },
+  "overrides": {
+    "glob": "^11.0.0",
+    "inflight": "npm:@lukekarrys/inflight@^1.0.6",
+    "nyc": {
+      "rimraf": "^5.0.0"
+    }
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "./bin",
+    "./dist",
+    "./src/templates",
+    "./oclif.manifest.json"
+  ],
+  "author": "Slingr",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/slingr-stack/framework.git"
+  },
+  "homepage": "https://github.com/slingr-stack/framework",
+  "readme": "https://github.com/slingr-stack/framework#readme",
+  "bugs": {
+    "url": "https://github.com/slingr-stack/framework/issues"
+  },
+  "keywords": [
+    "slingr",
+    "cli",
+    "scaffolding",
+    "project-generator"
+  ],
+  "main": "dist/index.js",
+  "oclif": {
+    "bin": "slingr",
+    "dirname": "slingr",
+    "commands": "./dist/commands",
+    "plugins": [
+      "@oclif/plugin-help"
+    ],
+    "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": "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": {
+    "include": [
+      "src/**/*.ts"
+    ],
+    "extension": [
+      ".ts"
+    ],
+    "require": [
+      "ts-node/register/transpile-only"
+    ],
+    "reporter": [
+      "text",
+      "text-summary",
+      "json-summary"
+    ],
+    "sourceMap": true,
+    "instrument": true,
+    "all": true,
+    "cache": false
+  }
+}

package/src/templates/.github/copilot-instructions.md.template

@@ -0,0 +1,17 @@
+# GitHub Copilot Instructions for {{APP_NAME}}
+
+This is a {{APP_TYPE}} application built with Slingr.
+
+## Project Description
+{{DESCRIPTION}}
+
+## Architecture
+- Backend: {{HAS_BACKEND}}
+- Frontend: {{HAS_FRONTEND}}
+- Database: {{DB_TYPE}}
+
+## Development Guidelines
+- Use TypeScript for all code
+- Follow Slingr conventions and patterns
+- Maintain clean, readable code with proper documentation
+- Use the provided data models as starting points

package/src/templates/config/datasource.ts.template

@@ -0,0 +1,9 @@
+import { TypeOrmSqlDataSource } from 'slingr-framework'
+
+export const mainDataSource = new TypeOrmSqlDataSource({
+  type: '{{DB_TYPE}}', 
+  managed: true,
+  filename: ':memory:',
+  logging: false,
+  synchronize: true,
+})

package/src/templates/config/jest.config.ts

@@ -0,0 +1,30 @@
+import type { Config } from 'jest';
+
+const config: Config = {
+  coverageProvider: 'v8',
+  moduleDirectories: ['node_modules', '<rootDir>'],
+  moduleNameMapper: {
+    '#(.*)': '<rootDir>/node_modules/$1',
+    'slingr-framework': '<rootDir>/node_modules/slingr-framework',
+  },
+  modulePaths: ['<rootDir>'],
+  preset: 'ts-jest',
+  setupFilesAfterEnv: ['<rootDir>/jest.setup.ts'],
+  testEnvironment: 'node',
+  testMatch: ['<rootDir>/src/**/*.test.ts'],
+  transform: {
+    '^.+\\.(ts|tsx|js|jsx)$': [
+      'ts-jest',
+      {
+        tsconfig: {
+          module: 'commonjs',
+          allowJs: true,
+        },
+      },
+    ],
+    '^.+\\.[j]sx?$': 'babel-jest',
+  },
+  transformIgnorePatterns: ['/node_modules/(?!slingr-framework)'],
+};
+
+module.exports = config;

package/src/templates/config/jest.setup.ts

@@ -0,0 +1 @@
+import 'reflect-metadata';

package/src/templates/config/tsconfig.json.template

@@ -0,0 +1,30 @@
+{
+  "compilerOptions": {
+    "module": "NodeNext",
+    "moduleResolution": "nodenext",
+    "target": "es2020",
+    "types": ["node", "jest"],
+    "sourceMap": true,
+    "declaration": true,
+    "declarationMap": true,
+    "noUncheckedIndexedAccess": false,
+    "exactOptionalPropertyTypes": false,
+    "strict": true,
+    "jsx": "react-jsx",
+    "verbatimModuleSyntax": false,
+    "isolatedModules": true,
+    "noUncheckedSideEffectImports": true,
+    "moduleDetection": "force",
+    "skipLibCheck": true,
+    "experimentalDecorators": true,
+    "emitDecoratorMetadata": true,
+    "esModuleInterop": true,
+    "outDir": "./dist",
+    "paths": {
+      "@gql": ["./generated/gql/index.ts"],
+      "@gql/*": ["./generated/gql/*"]
+    }
+  },
+  "include": ["src/**/*", "test/**/*", "jest.config.js", "index.ts"],
+  "exclude": ["node_modules", "dist"]
+}

package/src/templates/dataSources/mysql.ts.template

@@ -0,0 +1,13 @@
+import { TypeOrmSqlDataSource } from 'slingr-framework';
+
+export const mainDs = new TypeOrmSqlDataSource({
+    type: 'mysql',
+    host: 'localhost',
+    port:  3306,
+    username: 'root',
+    password: 'root',
+    database: '{{APP_NAME}}',
+    synchronize: true,
+    logging: true,
+    managed: true
+});

package/src/templates/dataSources/postgres.ts.template

@@ -0,0 +1,13 @@
+import { TypeOrmSqlDataSource } from 'slingr-framework';
+
+export const mainDs = new TypeOrmSqlDataSource({
+    type: 'postgres',
+    host: 'localhost',
+    port:  5433,
+    username: 'postgres',
+    password: 'postgres',
+    database: '{{APP_NAME}}',
+    synchronize: true,
+    logging: true,
+    managed: true
+});