@nestledjs/api 0.0.1

package/src/generate-crud/schema.json

@@ -0,0 +1,32 @@
+{
+  "$schema": "../../node_modules/@nx/devkit/schema.d.json",
+  "extends": "../../node_modules/@nx/devkit/generators.json",
+  "properties": {
+    "name": {
+      "description": "Name of the library to generate",
+      "type": "string"
+    },
+    "directory": {
+      "description": "Optional directory to place the library",
+      "type": "string"
+    },
+    "model": {
+      "description": "Name of the model",
+      "type": "string"
+    },
+    "plural": {
+      "description": "Plural form of the model name",
+      "type": "string"
+    },
+    "description": {
+      "description": "Description of the model",
+      "type": "string"
+    },
+    "overwrite": {
+      "description": "Whether to overwrite existing files in the public libraries",
+      "type": "boolean",
+      "default": false
+    }
+  },
+  "required": []
+}

package/src/generate-crud/schema.ts

@@ -0,0 +1,8 @@
+export interface GenerateCrudGeneratorSchema {
+  name: string;
+  directory: string;
+  model: string;
+  plural: string;
+  description?: string;
+  overwrite?: boolean;
+}

package/src/index.ts

@@ -0,0 +1,13 @@
+export * from './account/generator'
+export * from './app/generator'
+export * from './config/generator'
+export * from './core/generator'
+export * from './custom/generator'
+export * from './generate-crud/generator'
+export * from './smtp-mailer/generator'
+export * from './prisma/generator'
+export * from './setup/generator'
+export * from './user/generator'
+export * from './workspace-setup/generator'
+export * from './plugin/generator'
+export * from './utils/generator'

package/src/plugin/generator.spec.ts

@@ -0,0 +1,18 @@
+import { Tree } from '@nx/devkit'
+import { createTreeWithEmptyWorkspace } from '@nx/devkit/testing'
+import generator from './generator'
+
+describe('plugin-generator', () => {
+  let tree: Tree
+
+  beforeEach(() => {
+    tree = createTreeWithEmptyWorkspace()
+  })
+
+  it('should generate plugin files in the plugins folder', async () => {
+    await generator(tree, { name: 'TestPlugin' })
+    expect(tree.exists('libs/api/custom/src/lib/plugins/test-plugin/test-plugin.service.ts')).toBe(true)
+    expect(tree.exists('libs/api/custom/src/lib/plugins/test-plugin/test-plugin.resolver.ts')).toBe(true)
+    expect(tree.exists('libs/api/custom/src/lib/plugins/test-plugin/test-plugin.module.ts')).toBe(true)
+  })
+}) 

package/src/plugin/generator.ts

@@ -0,0 +1,74 @@
+import { formatFiles, installPackagesTask, Tree } from '@nx/devkit'
+import { join } from 'path'
+import { GeneratePluginGeneratorSchema } from './schema'
+
+function toKebabCase(str: string): string {
+  return str
+    .replace(/([a-z])([A-Z])/g, '$1-$2')
+    .replace(/([A-Z])([A-Z][a-z])/g, '$1-$2')
+    .toLowerCase()
+}
+
+function toPascalCase(str: string): string {
+  return str
+    .replace(/(^\w|[-_\s]\w)/g, (match) => match.replace(/[-_\s]/, '').toUpperCase())
+}
+
+async function ensureDirExists(tree: Tree, path: string) {
+  if (!tree.exists(path)) {
+    // Directory will be created when a file is written into it
+  }
+}
+
+export default async function (tree: Tree, schema: GeneratePluginGeneratorSchema) {
+  const name = schema.name
+  if (!name) throw new Error('Name is required')
+  const kebabName = toKebabCase(name)
+  const className = toPascalCase(name)
+  const customLibraryRoot = schema.directory ? `libs/api/${schema.directory}/custom` : `libs/api/custom`
+  const pluginsDir = join(customLibraryRoot, 'src/lib/plugins')
+  const pluginFolder = join(pluginsDir, kebabName)
+
+  await ensureDirExists(tree, pluginsDir)
+  await ensureDirExists(tree, pluginFolder)
+
+  // Service
+  const serviceContent = `import { Injectable } from '@nestjs/common'
+
+@Injectable()
+export class ${className}Service {
+  // Add your service logic here
+}
+`
+  tree.write(join(pluginFolder, `${kebabName}.service.ts`), serviceContent)
+
+  // Resolver
+  const resolverContent = `import { Resolver } from '@nestjs/graphql'
+import { Injectable } from '@nestjs/common'
+
+@Resolver()
+@Injectable()
+export class ${className}Resolver {
+  // Add your resolver logic here
+}
+`
+  tree.write(join(pluginFolder, `${kebabName}.resolver.ts`), resolverContent)
+
+  // Module
+  const moduleContent = `import { Module } from '@nestjs/common'
+import { ${className}Service } from './${kebabName}.service'
+import { ${className}Resolver } from './${kebabName}.resolver'
+
+@Module({
+  providers: [${className}Service, ${className}Resolver],
+  exports: [${className}Service, ${className}Resolver],
+})
+export class ${className}Module {}
+`
+  tree.write(join(pluginFolder, `${kebabName}.module.ts`), moduleContent)
+
+  await formatFiles(tree)
+  return () => {
+    installPackagesTask(tree)
+  }
+} 

package/src/plugin/schema.json

@@ -0,0 +1,14 @@
+{
+  "$schema": "../../node_modules/@nx/devkit/schema.d.json",
+  "properties": {
+    "name": {
+      "description": "Name of the plugin to generate",
+      "type": "string"
+    },
+    "directory": {
+      "description": "Optional directory to place the custom library",
+      "type": "string"
+    }
+  },
+  "required": ["name"]
+} 

package/src/plugin/schema.ts

@@ -0,0 +1,4 @@
+export interface GeneratePluginGeneratorSchema {
+  name: string;
+  directory?: string;
+} 

package/src/prisma/files/src/index.ts__tmpl__

@@ -0,0 +1 @@
+export * from './lib/prisma-generated'

package/src/prisma/files/src/lib/.gitkeep

@@ -0,0 +1 @@
+ 

package/src/prisma/files/src/lib/schemas/schema.prisma__tmpl__

@@ -0,0 +1,402 @@
+generator client {
+  provider        = "prisma-client-js"
+  previewFeatures = []
+  binaryTargets   = ["native"]
+  output          = "../prisma-generated"
+}
+
+datasource db {
+  provider = "postgresql"
+  url      = env("DATABASE_URL")
+}
+
+// Models (Alphabetical Order)
+
+model Address {
+  id            String         @id @default(cuid())
+  createdAt     DateTime       @default(now())
+  updatedAt     DateTime       @updatedAt
+  address1      String?
+  address2      String?
+  city          String?
+  region        String?
+  postalCode    String?
+  addressType   AddressType    @default(WORK)
+  countryId     String?
+  country       Country?       @relation("Country_belongsTo_Address", fields: [countryId], references: [id])
+  users         User[]         @relation("Address_belongsTo_User")
+  organizations Organization[] @relation("Address_belongsTo_Organization")
+}
+
+model Country {
+  id                     String    @id @default(cuid())
+  createdAt              DateTime  @default(now())
+  updatedAt              DateTime  @updatedAt
+  name                   String
+  alpha2                 String    @unique
+  alpha3                 String    @unique
+  countryCode            String
+  iso3166_2              String
+  region                 String
+  subRegion              String
+  intermediateRegion     String
+  regionCode             String
+  subRegionCode          String
+  intermediateRegionCode String
+  addresses              Address[] @relation("Country_belongsTo_Address")
+}
+
+model Email {
+  id             String        @id @default(cuid())
+  createdAt      DateTime      @default(now())
+  updatedAt      DateTime      @default(now()) @updatedAt
+  email          String        @unique // enforce lowercase logic at app level
+  public         Boolean       @default(false)
+  primary        Boolean       @default(false)
+  verified       Boolean       @default(false)
+  verifyToken    String?
+  verifyExpires  DateTime?
+  userId         String?
+  emailType      EmailType     @default(WORK)
+  organizationId String?
+  user           User?         @relation("Email_belongsTo_User", fields: [userId], references: [id])
+  organization   Organization? @relation("Email_belongsTo_Organization", fields: [organizationId], references: [id])
+}
+
+model Link {
+  id             String        @id @default(cuid())
+  createdAt      DateTime      @default(now())
+  updatedAt      DateTime      @updatedAt
+  name           String
+  url            String
+  userId         String?
+  organizationId String?
+  user           User?         @relation("Link_belongsTo_User", fields: [userId], references: [id])
+  organization   Organization? @relation("Link_belongsTo_Organization", fields: [organizationId], references: [id])
+}
+
+model PhoneNumber {
+  id             String        @id @default(cuid())
+  createdAt      DateTime      @default(now())
+  updatedAt      DateTime      @default(now()) @updatedAt
+  phone          String        @unique
+  phoneType      PhoneType     @default(MOBILE)
+  userId         String?
+  primary        Boolean       @default(false)
+  organizationId String?
+  user           User?         @relation("PhoneNumber_belongsTo_User", fields: [userId], references: [id])
+  organization   Organization? @relation("PhoneNumber_belongsTo_Organization", fields: [organizationId], references: [id])
+}
+
+model Upload {
+  id             String        @id @default(cuid())
+  createdAt      DateTime      @default(now())
+  updatedAt      DateTime      @default(now()) @updatedAt
+  type           ImageType?
+  fileId         String?
+  filePath       String?
+  fileType       String?
+  height         Int?
+  name           String?
+  size           Int?
+  thumbnailUrl   String?
+  orientation    Int?
+  url            String?
+  versionInfo    Json?
+  width          Int?
+  userId         String?
+  organizationId String?
+  user           User?         @relation("Upload_belongsTo_User", fields: [userId], references: [id])
+  organization   Organization? @relation("Upload_belongsTo_Organization", fields: [organizationId], references: [id])
+}
+
+model User {
+  id                        String               @id @default(cuid())
+  createdAt                 DateTime             @default(now())
+  updatedAt                 DateTime             @default(now()) @updatedAt
+  firstName                 String?
+  lastName                  String?
+  role                      UserRole
+  bio                       String?
+  displayName               String?              @unique
+  password                  String?
+  passwordResetToken        String?
+  passwordResetExpires      DateTime?
+  emailValidated            Boolean              @default(value: false)
+  validateEmailToken        String?              @unique
+  validateEmailTokenExpires DateTime?
+  emails                    Email[]              @relation("Email_belongsTo_User")
+  links                     Link[]               @relation("Link_belongsTo_User")
+  phoneNumbers              PhoneNumber[]        @relation("PhoneNumber_belongsTo_User")
+  images                    Upload[]             @relation("Upload_belongsTo_User")
+  organizations             OrganizationMember[] @relation("OrganizationMember_belongsTo_User")
+  activeOrganizationId      String?
+  addresses                 Address[]            @relation("Address_belongsTo_User")
+  invitesSent               Invite[]             @relation("Invite_sentBy_User")
+
+  // 2FA fields
+  twoFactorEnabled       Boolean  @default(false)
+  twoFactorSecret        String? // Stores the TOTP secret
+  twoFactorRecoveryCodes String[] // Backup codes for 2FA recovery
+
+  // Optional: If you want to support multiple 2FA methods
+  twoFactorMethod TwoFactorMethod @default(NONE)
+
+  // If you want to track 2FA verification status per session
+  activeSessions      UserSession[]
+  loginAttempts       LoginAttempt[]
+  lastSuccessfulLogin DateTime?
+  lastFailedLogin     DateTime?
+  failedLoginCount    Int              @default(0)
+  lockedUntil         DateTime? // For temporary account lockouts
+  AuditLog            AuditLog[]
+  UserPreference      UserPreference[]
+  TeamMember          TeamMember[]
+  SecurityEvent       SecurityEvent[]
+
+  // Account lifecycle
+  isActive      Boolean   @default(true)
+  deactivatedAt DateTime?
+
+  // Legal compliance
+  termsAcceptedAt         DateTime?
+  privacyPolicyAcceptedAt DateTime?
+  apiTokens               ApiToken[]     @relation("User_hasMany_APITokens")
+  oAuthAccounts           OAuthAccount[] @relation("User_hasMany_OAuthAccounts")
+}
+
+model Organization {
+  id           String               @id @default(cuid())
+  createdAt    DateTime             @default(now())
+  updatedAt    DateTime             @updatedAt
+  name         String
+  emails       Email[]              @relation("Email_belongsTo_Organization")
+  links        Link[]               @relation("Link_belongsTo_Organization")
+  phoneNumbers PhoneNumber[]        @relation("PhoneNumber_belongsTo_Organization")
+  images       Upload[]             @relation("Upload_belongsTo_Organization")
+  members      OrganizationMember[] @relation("OrganizationMember_belongsTo_Organization")
+  addresses    Address[]            @relation("Address_belongsTo_Organization")
+  invites      Invite[]             @relation("Invite_belongsTo_Organization")
+  AuditLog     AuditLog[]
+  Team         Team[]
+}
+
+model Invite {
+  id             String       @id @default(cuid())
+  createdAt      DateTime     @default(now())
+  updatedAt      DateTime     @updatedAt
+  expiresAt      DateTime
+  email          String
+  token          String       @unique
+  inviterId      String
+  inviter        User         @relation("Invite_sentBy_User", fields: [inviterId], references: [id])
+  organizationId String
+  organization   Organization @relation("Invite_belongsTo_Organization", fields: [organizationId], references: [id])
+  accepted       Boolean      @default(false)
+  used           Boolean      @default(false)
+  issuedAt       DateTime?
+}
+
+model OrganizationMember {
+  id             String           @id @default(cuid())
+  createdAt      DateTime         @default(now())
+  updatedAt      DateTime         @updatedAt
+  role           OrganizationRole @default(ORGANIZATION_MEMBER)
+  userId         String?
+  user           User?            @relation("OrganizationMember_belongsTo_User", fields: [userId], references: [id])
+  organizationId String?
+  organization   Organization?    @relation("OrganizationMember_belongsTo_Organization", fields: [organizationId], references: [id])
+}
+
+model UserSession {
+  id           String   @id @default(cuid())
+  createdAt    DateTime @default(now())
+  updatedAt    DateTime @updatedAt
+  lastActiveAt DateTime @default(now())
+  userId       String
+  user         User     @relation(fields: [userId], references: [id])
+  deviceInfo   String?
+  ipAddress    String?
+  isValid      Boolean  @default(true)
+
+  // Add this field to track 2FA verification status
+  twoFactorVerified Boolean @default(false)
+}
+
+model AuditLog {
+  id             String        @id @default(cuid())
+  createdAt      DateTime      @default(now())
+  updatedAt      DateTime      @updatedAt
+  entityId       String // ID of the entity being modified
+  entityType     String // Name of the model being modified
+  action         String // CREATE, UPDATE, DELETE
+  userId         String
+  user           User          @relation(fields: [userId], references: [id])
+  organizationId String?
+  organization   Organization? @relation(fields: [organizationId], references: [id])
+  changes        Json? // Store what was changed
+}
+
+model UserPreference {
+  id        String   @id @default(cuid())
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+  userId    String
+  user      User   @relation(fields: [userId], references: [id])
+  key       String
+  value     String
+
+  @@unique([userId, key])
+}
+
+// Optional if you need team functionality
+model Team {
+  id        String   @id @default(cuid())
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+  name           String
+  description    String?
+  organizationId String
+  organization   Organization @relation(fields: [organizationId], references: [id])
+  members        TeamMember[]
+}
+
+model TeamMember {
+  id        String   @id @default(cuid())
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+  teamId    String
+  team      Team     @relation(fields: [teamId], references: [id])
+  userId    String
+  user      User     @relation(fields: [userId], references: [id])
+  role      TeamRole @default(MEMBER)
+}
+
+// Enums (Alphabetical Order)
+
+enum AddressType {
+  HOME
+  WORK
+  VENUE
+  EVENT
+  OTHER
+}
+
+enum EmailType {
+  PERSONAL
+  WORK
+  OTHER
+}
+
+enum ImageType {
+  AVATAR
+  BACKGROUND
+  OTHER
+}
+
+enum PhoneType {
+  HOME
+  WORK
+  MOBILE
+  OTHER
+}
+
+enum UserRole {
+  DEVELOPER
+  SUPER_ADMIN
+  ADMIN
+  USER
+}
+
+enum OrganizationRole {
+  ORGANIZATION_ADMIN
+  ORGANIZATION_MEMBER
+}
+
+enum TeamRole {
+  LEADER
+  MEMBER
+}
+
+// Add this enum
+enum TwoFactorMethod {
+  NONE
+  AUTHENTICATOR
+  SMS
+  EMAIL
+}
+
+model LoginAttempt {
+  id        String   @id @default(cuid())
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+  userId    String? // Optional because login attempts might be for non-existent users
+  user      User?   @relation(fields: [userId], references: [id])
+  email     String // The email used in the attempt
+  success   Boolean        @default(false)
+  ipAddress String?
+  userAgent String? // Browser/client info
+  location  String? // Geo location if you want to track it
+  reason    FailureReason? // Why the login failed
+}
+
+enum FailureReason {
+  INVALID_PASSWORD
+  INVALID_EMAIL
+  ACCOUNT_LOCKED
+  ACCOUNT_DISABLED
+  INVALID_2FA
+  EXPIRED_TOKEN
+  TOO_MANY_ATTEMPTS
+}
+
+model SecurityEvent {
+  id        String   @id @default(cuid())
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+  userId    String
+  user      User              @relation(fields: [userId], references: [id])
+  eventType SecurityEventType
+  ipAddress String?
+  userAgent String?
+  metadata  Json? // Additional event-specific data
+}
+
+enum SecurityEventType {
+  PASSWORD_CHANGED
+  EMAIL_CHANGED
+  TWO_FACTOR_ENABLED
+  TWO_FACTOR_DISABLED
+  RECOVERY_CODES_GENERATED
+  ACCOUNT_LOCKED
+  ACCOUNT_UNLOCKED
+  SUSPICIOUS_LOGIN_ATTEMPT
+  PASSWORD_RESET_REQUESTED
+  LOGIN_LOCATION_CHANGE
+}
+
+// Add ApiToken model for API token support
+model ApiToken {
+  id        String   @id @default(cuid())
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+  userId    String
+  user      User      @relation("User_hasMany_APITokens", fields: [userId], references: [id])
+  token     String    @unique
+  name      String?
+  expiresAt DateTime?
+  revoked   Boolean   @default(false)
+}
+
+// Add OAuthAccount model for social login support
+model OAuthAccount {
+  id             String   @id @default(cuid())
+  createdAt      DateTime @default(now())
+  updatedAt      DateTime @updatedAt
+  provider       String
+  providerUserId String
+  userId         String
+  user           User     @relation("User_hasMany_OAuthAccounts", fields: [userId], references: [id])
+
+  @@unique([provider, providerUserId])
+}