@appxdigital/appx-core-cli 1.0.11 → 1.0.13

package/scaffold/prisma/schema.prisma.template

@@ -0,0 +1,47 @@
+datasource db {
+  provider = "{{DB_PROVIDER}}"
+  url      = env("DB_URL")
+}
+
+generator client {
+  provider = "prisma-client-js"
+}
+
+generator nestgraphql {
+  provider = "node node_modules/prisma-nestjs-graphql"
+  output   = "../src/generated/"
+}
+
+model User {
+  id             Int                 @id @default(autoincrement())
+  email          String              @unique
+  name           String?
+  password       String?             /// @Role(none)
+  role           Role                @default(GUEST)
+  refreshTokens  UserRefreshToken[]
+}
+
+model Session {
+  id        String   @id
+  sid       String   @unique
+  data      String   @db.Text
+  expiresAt DateTime
+  userId    Int?
+}
+
+model UserRefreshToken {
+  id        String    @id @default(cuid())
+  token     String    @unique @db.VarChar(255)
+  userId    Int
+  user      User      @relation(fields: [userId], references: [id], onDelete: Cascade)
+  expiresAt DateTime
+  createdAt DateTime  @default(now())
+  revokedAt DateTime?
+
+  @@index([userId])
+}
+
+enum Role {
+  ADMIN
+  GUEST
+}

package/scaffold/src/app.controller.ts

@@ -0,0 +1,13 @@
+import {Controller, Get} from '@nestjs/common';
+import {AppService} from './app.service';
+
+@Controller()
+export class AppController {
+    constructor(private readonly appService: AppService) {
+    }
+
+    @Get()
+    getHello(): string {
+        return this.appService.getHello();
+    }
+}

package/{templates/app.module.template.js → scaffold/src/app.module.ts}

@@ -2,9 +2,9 @@ import {MiddlewareConsumer, Module, NestModule, RequestMethod} from '@nestjs/com
 import {AppController} from './app.controller';
 import {AppService} from './app.service';
 import {ConfigModule} from '@nestjs/config';
-import {AuthModule, PrismaInterceptor, AppxCoreModule, AppxCoreAdminModule} from '@appxdigital/appx-core';
-import {APP_INTERCEPTOR} from '@nestjs/core';
-import {RequestContextModule, RequestContextMiddleware} from 'nestjs-request-context'
+import {AppxCoreAdminModule, AppxCoreModule, AuthModule, PrismaInterceptor, UserPopulationGuard} from '@appxdigital/appx-core';
+import {APP_GUARD, APP_INTERCEPTOR} from '@nestjs/core';
+import {RequestContextMiddleware, RequestContextModule} from 'nestjs-request-context'
 import {PermissionsConfig} from './config/permissions.config';
 import {AdminConfig} from './config/admin.config';
 
@@ -28,10 +28,14 @@ import {AdminConfig} from './config/admin.config';
             provide: APP_INTERCEPTOR,
             useClass: PrismaInterceptor,
         },
+        {
+            provide: APP_GUARD,
+            useClass: UserPopulationGuard,
+        },
     ],
 })
 export class AppModule implements NestModule {
-    configure (consumer: MiddlewareConsumer) {
+    configure(consumer: MiddlewareConsumer) {
         consumer
             .apply(RequestContextMiddleware)
             .forRoutes({path: '*', method: RequestMethod.ALL});

package/scaffold/src/app.service.ts

@@ -0,0 +1,8 @@
+import {Injectable} from '@nestjs/common';
+
+@Injectable()
+export class AppService {
+    getHello(): string {
+        return 'Hello World!';
+    }
+}

package/{templates/adminjs/dashboard.template.js → scaffold/src/backoffice/components/dashboard.js}

@@ -1,5 +1,3 @@
-import React from 'react';
-
 export const Dashboard = () => {
     // Redirect to Users resource
     window.location.href = window.location.href + '/resources/User';

package/{templates/permissions.config.template.js → scaffold/src/config/permissions.config.ts}

@@ -1,7 +1,4 @@
-import {
-    PermissionsConfigType,
-    PermissionPlaceholder,
-} from '@appxdigital/appx-core';
+import {PermissionPlaceholder, PermissionsConfigType,} from '@appxdigital/appx-core';
 
 export const PermissionsConfig: PermissionsConfigType = {
     User: {

package/{templates/bootstrap.template.js → scaffold/src/main.ts}

@@ -1,12 +1,11 @@
-import { NestFactory } from '@nestjs/core';
-import { AppModule } from './app.module';
-import { ConfigService } from '@nestjs/config';
-import * as session from 'express-session';
-import * as passport from 'passport';
-import {PrismaService} from '@appxdigital/appx-core';
-import { ValidationPipe } from '@nestjs/common';
-import {CorePrismaSessionStore} from '@appxdigital/appx-core';
-import * as morgan from 'morgan';
+import {NestFactory} from '@nestjs/core';
+import {AppModule} from './app.module';
+import {ConfigService} from '@nestjs/config';
+import session from 'express-session';
+import passport from 'passport';
+import {CorePrismaSessionStore, PrismaService} from '@appxdigital/appx-core';
+import {ValidationPipe} from '@nestjs/common';
+import morgan from 'morgan';
 
 async function bootstrap() {
     const app = await NestFactory.create(AppModule);
@@ -41,7 +40,7 @@ async function bootstrap() {
         origin: 'http://localhost:3000',
         credentials: true,
     });
-    app.useGlobalPipes(new ValidationPipe({ transform: true }));
+    app.useGlobalPipes(new ValidationPipe({transform: true}));
     await app.listen(port);
     console.log(`Your application is successfully running on: http://www.localhost:${port} 🚀`);
 }

package/{templates/prisma.module.template.js → scaffold/src/prisma/prisma.module.ts}

@@ -1,7 +1,7 @@
-import { Global, Module } from '@nestjs/common';
-import { PrismaClient } from '@prisma/client';
+import {Global, Module} from '@nestjs/common';
+import {PrismaClient} from '@prisma/client';
 import {PERMISSIONS_CONFIG_TOKEN, PermissionsConfigType, PrismaService} from '@appxdigital/appx-core';
-import { PermissionsConfig } from '../config/permissions.config';
+import {PermissionsConfig} from '../config/permissions.config';
 
 @Global()
 @Module({

package/utils/fileUploadConfig.js

@@ -35,7 +35,7 @@ function getEnvVariables(provider, providerOptions) {
 export async function gatherFileUploadSettings() {
     const config = {};
 
-    const { provider } = await inquirer.prompt([
+    const {provider} = await inquirer.prompt([
         {
             type: 'list',
             name: 'provider',
@@ -47,20 +47,20 @@ export async function gatherFileUploadSettings() {
 
     if (provider === 'aws') {
         config.providerOptions = await inquirer.prompt([
-            { type: 'input', name: 'bucket', message: 'Enter AWS S3 bucket name:' },
-            { type: 'input', name: 'region', message: 'Enter AWS region:' },
-            { type: 'input', name: 'accessKeyId', message: 'Enter AWS access key ID:' },
-            { type: 'input', name: 'secretAccessKey', message: 'Enter AWS secret access key:' },
+            {type: 'input', name: 'bucket', message: 'Enter AWS S3 bucket name:'},
+            {type: 'input', name: 'region', message: 'Enter AWS region:'},
+            {type: 'input', name: 'accessKeyId', message: 'Enter AWS access key ID:'},
+            {type: 'input', name: 'secretAccessKey', message: 'Enter AWS secret access key:'},
         ]);
     } else if (provider === 'gcp') {
         config.providerOptions = await inquirer.prompt([
-            { type: 'input', name: 'bucket', message: 'Enter GCP bucket name:' },
-            { type: 'input', name: 'projectId', message: 'Enter GCP project ID:' },
-            { type: 'input', name: 'keyFilePath', message: 'Enter the path to the GCP service account key file:' },
+            {type: 'input', name: 'bucket', message: 'Enter GCP bucket name:'},
+            {type: 'input', name: 'projectId', message: 'Enter GCP project ID:'},
+            {type: 'input', name: 'keyFilePath', message: 'Enter the path to the GCP service account key file:'},
         ]);
     }
 
-    const { endpoint, maxSize, fileType, multiple } = await inquirer.prompt([
+    const {endpoint, maxSize, fileType, multiple} = await inquirer.prompt([
         {
             type: 'input',
             name: 'endpoint',
@@ -96,7 +96,7 @@ export async function gatherFileUploadSettings() {
     config.multiple = multiple;
 
     if (fileType in MimeTypes) {
-        const { selectedMimeTypes } = await inquirer.prompt([
+        const {selectedMimeTypes} = await inquirer.prompt([
             {
                 type: 'checkbox',
                 name: 'selectedMimeTypes',
@@ -108,7 +108,7 @@ export async function gatherFileUploadSettings() {
         config.allowedTypes = selectedMimeTypes;
     }
 
-    const { roles } = await inquirer.prompt([
+    const {roles} = await inquirer.prompt([
         {
             type: 'input',
             name: 'roles',

package/README.md

@@ -1,159 +0,0 @@
-<p align="center">
-  <a href="https://appx-digital.com/" target="_blank">
-    <img src="./assets/logo_appx.svg" width="300" alt="Appx Logo" />
-  </a>
-</p>
-
-## Description
-
-<p style="text-align: left;">
-This project is a foundational Node.js boilerplate built with  <a href="https://nestjs.com/" target="_blank">NestJS</a>, <a href="https://www.prisma.io/" target="_blank">Prisma ORM</a>, and <a href="https://graphql.org/" target="_blank">GraphQL</a>. It simplifies the development process by using Prisma ORM as the single source of truth, automatically generating and managing all essential components of your application.
-</p>
-
-## Installation
-
-1. Open your terminal and run the following command:
-   ```bash
-   npm install @appxdigital/appx-core-cli -g
-   appx-core create
-   ```
-2. Follow the prompts provided by the setup wizard. This will scaffold a new NestJS project with `appx-core` pre-integrated.
-3. Open created project in your favorite IDE.
-
-## Configure Database Schema
-
-1. Open the `prisma/schema.prisma` file.
-2. Modify this file to define your application's specific data models. You can add new models, fields, and relations as needed.
-
-Note: If you already have a database created and want to import the structure, use the following command:
-
-```
-npx prisma db pull
-```
-
-**This command will override the schema.prisma file, please ensure that the original configurations and models are kept (you can adapt User and Session model, but it's advised to keep all default attributes)**
-
-## Generate Modules and Prisma Client
-
-1. After editing your schema, generate the modules for each model by running:
-   ```bash
-   appx-core generate
-   ```
-2. This command also updates the `@prisma/client` library within your `node_modules` to match your defined schema, providing type-safe database access. This command should be run everytime you make a change to your prisma schema.
-
-## Apply Database Migrations
-
-1. To create the necessary database tables and apply your schema changes, run:
-   ```bash
-   npx prisma migrate dev
-   ```
-2. This will:
-    * Create a new SQL migration file reflecting the changes between your current schema and the last migration.
-    * Apply the migration to your database.
-
-## Run the Application
-
-1. Start your application in development mode using:
-   ```bash
-   npm run start:dev
-   ```
-2. The application will start on `http://localhost:3000` or the port specified during your setup, you can change this in the `.env` file.
-
-## Register Your First User
-
-1. To create a user account, send an HTTP `POST` request to the `/auth/register` endpoint.
-2. The request body must be JSON and include the `email` and `password`:
-   ```json
-   {
-     "email": "email@example.com",
-     "password": "password"
-   }
-   ```
-3. On success, you'll receive a JSON response confirming registration and containing the new user's details.
-
-## Log In
-
-1. To log in with the registered user, send an HTTP `POST` request to the `/auth/login` endpoint.
-2. The request body must be JSON and include the same fields used for registration:
-   ```json
-   {
-     "email": "email@example.com",
-     "password": "password"
-   }
-   ```
-3. On success, you'll receive a JSON response confirming login and containing the user's details.
-
-## Permissions
-
-This project uses RBAC to control user access. Permissions are defined in a configuration file and checked automatically before controller actions and during database queries.
-
-### Configuration
-
-* Permissions are defined in the `src/config/permissions.config.ts` file.
-* The configuration structure is hierarchical: `ModelName` -> `RoleName` -> `ActionName` -> `Rule`.
-
-    ```typescript
-    export const PermissionsConfig: PermissionsConfigType = {
-      ModelName: { // e.g., 'User'; links to controller's entityName
-        RoleName: { // e.g., 'ADMIN', 'CLIENT'; matches user roles
-          ActionName: Rule, // e.g., 'findUnique', 'update'
-          // ... other actions for this role/model
-        },
-         // ... other roles for this model
-      },
-      // ... other models
-    };
-    ```
-
-### Permission Rules & Effects
-
-The `Rule` assigned to an action determines if a user with that role can perform the action:
-
-* **`'ALL'`:** Grants unrestricted access for the specific action.
-* **Object `{ conditions: { ... } }`:** Grants access *only if* the specified conditions match the data being accessed.
-    * These `conditions` (e.g., `{ id: '$USER_ID' }`) are automatically added as `WHERE` clauses to the underlying database query by the `PrismaService`.
-    * Placeholders like `$USER_ID` are replaced with the current user's actual data (e.g., `req.user.id`).
-* **Missing Rule:** If no rule (`'ALL'` or an object) is defined for an action under the user's role, access is **denied**.
-
-### Applying Permissions
-
-* Protect controller methods by decorating them with `@Permission('actionName')`. This links the method to an `ActionName` in your `permissions.config.ts`.
-    * Methods *without* the `@Permission` decorator are not subject to specific action checks by the `RbacGuard` and are allowed access.
-
-        ```typescript
-        @Controller('users')
-        export class UserController extends CoreController<User>  {  
-  
-          @Get(':id')
-          @Permission('findUnique') // Checks config for User -> Role -> findUnique
-          async findOne(@Param('id') id: string) {
-            /* ... */
-          }
-  
-          @Get('/public/info')
-          // No @Permission decorator - RbacGuard allows by default access for this route
-          async getPublicInfo() { 
-            /* ... */ 
-          }
-        
-           static get entityName(): string {
-            return 'User';
-          }
-        }
-        ```
-
-### Adding Permissions for a New Action
-
-1. **Decorate Method & Choose Name:** Add the `@Permission('yourActionName')` decorator to the relevant controller method, choosing a unique string for `'yourActionName'` (e.g., `'publishItem'`, `'resetPassword'`).
-
-2. **Update Config:** Edit `permissions.config.ts`. Add the `actionName` under the appropriate `ModelName` -> `RoleName`(s). Set the rule:
-    * Use `'ALL'` for full access.
-    * Use an object like `{ conditions: { field: '$USER_ID' } }` for conditional access (enforced by the database query).
-
-    ```typescript
-    // Example: Adding 'publishItem' rule to Article model config
-      Article: {
-        ADMIN: { /*...,*/ publishItem: 'ALL' },
-        EDITOR: { /*...,*/ publishItem: { conditions: { authorId: '$USER_ID' } } },
-      },
-    ```

package/utils/dependency-versions.json

@@ -1,28 +0,0 @@
-{
-    "dependencies": {
-        "@prisma/client": "^6.5.0",
-        "prisma-nestjs-graphql": "20.0.3",
-        "prisma-case-format": "2.2.1",
-        "class-validator": "0.14.1",
-        "class-transformer": "0.5.1",
-        "nestjs-request-context": "4.0.0",
-        "passport": "0.7.0",
-        "passport-local": "1.0.0",
-        "express-session": "1.18.1",
-        "express": "4.21.1",
-        "argon2": "0.41.1",
-        "rxjs": "7.8.1",
-        "reflect-metadata": "0.2.0",
-        "morgan": "^1.10.1"
-    },
-    "devDependencies": {
-        "@types/express": "5.0.0",
-        "prisma": "5.22.0",
-        "@types/express-formidable": "1.2.3",
-        "@types/inquirer": "9.0.7",
-        "@types/multer": "1.4.12",
-        "@types/passport-local": "1.0.38",
-        "typescript": "5.1.3",
-        "@types/morgan": "^1.9.10"
-    }
-}