@nestledjs/api 0.0.1

package/CHANGELOG.md

@@ -0,0 +1,5 @@
+## 0.0.1 (2025-06-17)
+
+### 🧱 Updated Dependencies
+
+- Updated utils to 0.0.1

package/README.md

@@ -0,0 +1,11 @@
+# api
+
+This library was generated with [Nx](https://nx.dev).
+
+## Building
+
+Run `nx build api` to build the library.
+
+## Running unit tests
+
+Run `nx test api` to execute the unit tests via [Vitest](https://vitest.dev/).

package/eslint.config.cjs

@@ -0,0 +1,28 @@
+const baseConfig = require('../../eslint.config.js')
+
+module.exports = [
+  ...baseConfig,
+  {
+    files: ['**/*.json'],
+    rules: {
+      '@nx/dependency-checks': [
+        'error',
+        {
+          ignoredFiles: ['{projectRoot}/eslint.config.{js,cjs,mjs}', '{projectRoot}/vite.config.{js,ts,mjs,mts}'],
+        },
+      ],
+    },
+    languageOptions: {
+      parser: require('jsonc-eslint-parser'),
+    },
+  },
+  {
+    files: ['**/package.json'],
+    rules: {
+      '@nx/nx-plugin-checks': 'error',
+    },
+    languageOptions: {
+      parser: require('jsonc-eslint-parser'),
+    },
+  },
+]

package/generators.json

@@ -0,0 +1,69 @@
+{
+  "generators": {
+    "setup": {
+      "factory": "./src/setup/generator.js",
+      "schema": "./src/setup/schema.json",
+      "description": "Set up all dependencies for the API"
+    },
+    "app": {
+      "factory": "./src/app/generator.js",
+      "schema": "./src/app/schema.json",
+      "description": "Set up main Nest.js application"
+    },
+    "prisma": {
+      "factory": "./src/prisma/generator.js",
+      "schema": "./src/prisma/schema.json",
+      "description": "Create the API Prisma library"
+    },
+    "config": {
+      "factory": "./src/config/generator.js",
+      "schema": "./src/config/schema.json",
+      "description": "Create the API Config library"
+    },
+    "account": {
+      "factory": "./src/account/generator.js",
+      "schema": "./src/account/schema.json",
+      "description": "Create an API Account Library"
+    },
+    "core": {
+      "factory": "./src/core/generator.js",
+      "schema": "./src/core/schema.json",
+      "description": "Create the API Core library"
+    },
+    "custom": {
+      "factory": "./src/custom/generator.js",
+      "schema": "./src/custom/schema.json",
+      "description": "Generate custom API libraries based on Prisma models"
+    },
+    "generate-crud": {
+      "factory": "./src/generate-crud/generator.js",
+      "schema": "./src/generate-crud/schema.json",
+      "description": "Generate CRUD libraries based on Prisma models"
+    },
+    "smtp-mailer": {
+      "factory": "./src/smtp-mailer/generator.js",
+      "schema": "./src/smtp-mailer/schema.json",
+      "description": "Create an API Mailer Library"
+    },
+    "user": {
+      "factory": "./src/user/generator.js",
+      "schema": "./src/user/schema.json",
+      "description": "Create an API User Library"
+    },
+    "workspace-setup": {
+      "factory": "./src/workspace-setup/generator.js",
+      "schema": "./src/workspace-setup/schema.json",
+      "description": "Set up the workspace environment"
+    },
+    "plugin": {
+      "factory": "./src/plugin/generator.js",
+      "schema": "./src/plugin/schema.json",
+      "description": "Generate a blank plugin (module, service, resolver) in the custom library's plugins folder."
+    },
+    "utils": {
+      "factory": "./src/utils/generator.js",
+      "schema": "./src/utils/schema.json",
+      "description": "Generate a utility plugin with auth utils."
+    }
+  }
+}

package/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "@nestledjs/api",
+  "version": "0.0.1",
+  "generators": "./generators.json",
+  "type": "commonjs",
+  "main": "./src/index.js",
+  "types": "./src/index.d.ts",
+  "description": "API generators for Nestled projects",
+  "author": "Nestled Contributors",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nestledjs/nestled"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "tslib": "^2.3.0"
+  }
+}

package/project.json

@@ -0,0 +1,47 @@
+{
+  "name": "api",
+  "$schema": "../../node_modules/nx/schemas/project-schema.json",
+  "sourceRoot": "generators/api/src",
+  "projectType": "library",
+  "tags": [],
+  "publishable": true,
+  "targets": {
+    "build": {
+      "executor": "@nx/js:tsc",
+      "outputs": ["{options.outputPath}"],
+      "options": {
+        "outputPath": "dist/generators/api",
+        "main": "generators/api/src/index.ts",
+        "tsConfig": "generators/api/tsconfig.lib.json",
+        "assets": [
+          "generators/api/*.md",
+          {
+            "input": "./generators/api/src",
+            "glob": "**/!(*.ts)",
+            "output": "./src"
+          },
+          {
+            "input": "./generators/api/src",
+            "glob": "**/*.d.ts",
+            "output": "./src"
+          },
+          {
+            "input": "./generators/api",
+            "glob": "generators.json",
+            "output": "."
+          },
+          {
+            "input": "./generators/api",
+            "glob": "executors.json",
+            "output": "."
+          },
+          {
+            "input": "./generators/api/src",
+            "glob": "*/files/**/*",
+            "output": "./src"
+          }
+        ]
+      }
+    }
+  }
+}

package/src/account/files/data-access/src/index.ts__tmpl__

@@ -0,0 +1,5 @@
+export * from './lib/api-account-data-access.module'
+export * from './lib/api-account-data-access.service'
+export * from './lib/dto/account-create-email.input'
+export * from './lib/dto/account-update-password.input'
+export * from './lib/dto/account-update-profile.input'

package/src/account/files/data-access/src/lib/api-account-data-access.module.ts__tmpl__

@@ -0,0 +1,10 @@
+import { Module } from '@nestjs/common'
+import { ApiCoreDataAccessModule } from '@<%= npmScope %>/api/core/data-access'
+import { ApiAccountDataAccessService } from './api-account-data-access.service'
+
+@Module({
+  imports: [ApiCoreDataAccessModule],
+  providers: [ApiAccountDataAccessService],
+  exports: [ApiAccountDataAccessService],
+})
+export class ApiAccountDataAccessModule {}

package/src/account/files/data-access/src/lib/api-account-data-access.service.ts__tmpl__

@@ -0,0 +1,152 @@
+import {
+  BadRequestException,
+  Injectable,
+  Logger,
+  UnauthorizedException,
+} from '@nestjs/common'
+import { ApiCoreDataAccessService, Prisma } from '@<%= npmScope %>/api/core/data-access'
+import {
+  hashPassword,
+  validatePassword,
+} from '@<%= npmScope %>/api/auth/data-access'
+import { AccountCreateEmailInput } from './dto/account-create-email.input'
+import { AccountUpdatePasswordInput } from './dto/account-update-password.input'
+import { AccountUpdateProfileInput } from './dto/account-update-profile.input'
+
+@Injectable()
+export class ApiAccountDataAccessService {
+  constructor(private readonly data: ApiCoreDataAccessService) {}
+
+  accountEmails(userId: string) {
+    return this.data.email.findMany({
+      where: { userId },
+      orderBy: { primary: 'desc' },
+    })
+  }
+
+  accountProfile(userId: string) {
+    return this.data.findUserById(userId)
+  }
+
+  async accountCreateEmail(userId: string, input: AccountCreateEmailInput) {
+    const exists = await this.data.findUserByEmail(input.email)
+    if (exists) {
+      throw new BadRequestException(`Can't add email address ${input.email}`)
+    }
+    return this.data.email.create({
+      data: { userId, email: input.email, primary: false },
+    })
+  }
+
+  async accountDeleteEmail(userId: string, userEmailId: string) {
+    const email = await this.data.email.findUnique({
+      where: { id: userEmailId },
+      include: { user: true },
+    })
+    if (!email || !email.user) {
+      throw new BadRequestException(`Email not found`)
+    }
+    if (email.user.id !== userId) {
+      throw new UnauthorizedException()
+    }
+    if (email.primary) {
+      throw new BadRequestException(`You can't delete your primary email`)
+    }
+    return this.data.email.delete({ where: { id: userEmailId } })
+  }
+
+  accountUpdateProfile(userId: string, input: AccountUpdateProfileInput) {
+    return this.data.user.update({
+      where: { id: userId },
+      data: {
+        firstName: input.firstName,
+        lastName: input.lastName,
+        bio: input.bio,
+      },
+    })
+  }
+
+  async accountUpdateDisplayName(userId: string, displayName: string) {
+    const available = await this.accountDisplayNameAvailable(userId, displayName)
+
+    if (!available) {
+      throw new BadRequestException(`Display name ${displayName} is not available`)
+    }
+
+    return this.data.user.update({ where: { id: userId }, data: { displayName } })
+  }
+
+  async accountDisplayNameAvailable(userId: string, displayName: string): Promise<boolean> {
+    const denied = await this.data.displayNameDenyList(displayName)
+
+    if (denied) {
+      throw new BadRequestException(`Display name ${displayName} is not available`)
+    }
+
+    const count = await this.data.user.count({
+      where: { displayName },
+    })
+    return count === 0
+  }
+
+  async userEmailOwner(userId: string, userEmailId: string) {
+    const email = await this.data.email.findUnique({
+      where: { id: userEmailId },
+      include: { user: true }
+    })
+    if (!email || !email.user) {
+      throw new BadRequestException(`Email not found`)
+    }
+    if (email.user.id !== userId) {
+      throw new UnauthorizedException()
+    }
+    return email.user
+  }
+
+  async updateUserEmail(userId: string, userEmailId: string, input: Prisma.EmailUpdateInput) {
+    await this.userEmailOwner(userId, userEmailId)
+    return this.data.email.update({ where: { id: userEmailId }, data: { ...input } })
+  }
+
+  async accountMarkEmailPrivate(userId: string, userEmailId: string) {
+    return this.updateUserEmail(userId, userEmailId, { public: false })
+  }
+
+  async accountMarkEmailPublic(userId: string, userEmailId: string) {
+    return this.updateUserEmail(userId, userEmailId, { public: true })
+  }
+
+  async accountMarkEmailPrimary(userId: string, userEmailId: string) {
+    await this.userEmailOwner(userId, userEmailId)
+    await this.data.email.updateMany({
+      where: { userId },
+      data: { primary: false },
+    })
+    return this.updateUserEmail(userId, userEmailId, { primary: true })
+  }
+
+  async accountResetPassword(userId: string) {
+    const emails = await this.accountEmails(userId)
+    const primary = emails.find((email) => email.primary)
+
+    if (!primary) {
+      throw new BadRequestException(`Could not find primary email for user with id ${userId}`)
+    }
+    Logger.verbose(`TODO: Implement Account Reset Password`)
+    return true
+  }
+
+  async accountUpdatePassword(userId: string, input: AccountUpdatePasswordInput) {
+    const user = await this.data.findUserById(userId)
+    if (!user || !user.password) {
+      throw new BadRequestException(`User not found or password not set`)
+    }
+    await validatePassword(input.currentPassword, user.password)
+
+    if (input.password !== input.verified) {
+      throw new BadRequestException(`Passwords do not match!`)
+    }
+    await this.data.user.update({ where: { id: userId }, data: { password: hashPassword(input.password) } })
+    return true
+  }
+}

package/src/account/files/data-access/src/lib/dto/account-create-email.input.ts__tmpl__

@@ -0,0 +1,9 @@
+import { Field, InputType } from '@nestjs/graphql'
+import { IsEmail } from 'class-validator'
+
+@InputType()
+export class AccountCreateEmailInput {
+  @Field()
+  @IsEmail()
+  email: string
+}

package/src/account/files/data-access/src/lib/dto/account-update-password.input.ts__tmpl__

@@ -0,0 +1,16 @@
+import { Field, InputType } from '@nestjs/graphql'
+import { MinLength } from 'class-validator'
+
+@InputType()
+export class AccountUpdatePasswordInput {
+  @Field()
+  currentPassword?: string
+
+  @Field()
+  @MinLength(10)
+  password?: string
+
+  @Field()
+  @MinLength(10)
+  verified?: string
+}

package/src/account/files/data-access/src/lib/dto/account-update-profile.input.ts__tmpl__

@@ -0,0 +1,25 @@
+import { Field, InputType } from '@nestjs/graphql'
+
+@InputType()
+export class AccountUpdateProfileInput {
+  @Field({ nullable: true })
+  firstName?: string
+
+  @Field({ nullable: true })
+  lastName?: string
+
+  @Field({ nullable: true })
+  avatarUrl?: string
+
+  @Field({ nullable: true })
+  bio?: string
+
+  @Field({ nullable: true })
+  location?: string
+
+  @Field({ nullable: true })
+  phone?: string
+
+  @Field({ nullable: true })
+  dob?: Date
+}

package/src/account/files/feature/src/index.ts__tmpl__

@@ -0,0 +1 @@
+export * from './lib/api-account-feature.module'

package/src/account/files/feature/src/lib/api-account-feature.module.ts__tmpl__

@@ -0,0 +1,9 @@
+import { Module } from '@nestjs/common'
+import { ApiAccountDataAccessModule } from '@<%= npmScope %>/api/account/data-access'
+import { ApiAccountFeatureResolver } from './api-account-feature.resolver'
+
+@Module({
+  imports: [ApiAccountDataAccessModule],
+  providers: [ApiAccountFeatureResolver],
+})
+export class ApiAccountFeatureModule {}

package/src/account/files/feature/src/lib/api-account-feature.resolver.ts__tmpl__

@@ -0,0 +1,83 @@
+import { UseGuards, ValidationPipe } from '@nestjs/common'
+import { Args, Mutation, Query, Resolver } from '@nestjs/graphql'
+import {
+  AccountCreateEmailInput,
+  AccountUpdatePasswordInput,
+  AccountUpdateProfileInput,
+  ApiAccountDataAccessService,
+} from '@<%= npmScope %>/api/account/data-access'
+import { CtxUser } from '@<%= npmScope %>/api/custom'
+import { GqlAuthGuard} from '@<%= npmScope %>/api/core/data-access'
+import { User, Email } from '@<%= npmScope %>/api/core/models'
+
+@Resolver()
+@UseGuards(GqlAuthGuard)
+export class ApiAccountFeatureResolver {
+  constructor(private readonly service: ApiAccountDataAccessService) {}
+
+  @Query(() => [Email], { nullable: true })
+  accountEmails(@CtxUser() user: User) {
+    return this.service.accountEmails(user.id)
+  }
+
+  @Query(() => User, { nullable: true })
+  accountProfile(@CtxUser() user: User) {
+    return this.service.accountProfile(user.id)
+  }
+
+  @Query(() => Boolean)
+  accountDisplayNameAvailable(
+    @CtxUser() user: User,
+    @Args('displayName') displayName: string
+  ) {
+    return this.service.accountDisplayNameAvailable(user.id, displayName)
+  }
+
+  @Mutation(() => Email, { nullable: true })
+  accountCreateEmail(@CtxUser() user: User, @Args('input', new ValidationPipe()) input: AccountCreateEmailInput) {
+    return this.service.accountCreateEmail(user.id, input)
+  }
+
+  @Mutation(() => Email, { nullable: true })
+  accountDeleteEmail(@CtxUser() user: User, @Args('emailId') emailId: string) {
+    return this.service.accountDeleteEmail(user.id, emailId)
+  }
+
+  @Mutation(() => Email, { nullable: true })
+  accountMarkEmailPrimary(@CtxUser() user: User, @Args('emailId') emailId: string) {
+    return this.service.accountMarkEmailPrimary(user.id, emailId)
+  }
+
+  @Mutation(() => Email, { nullable: true })
+  accountMarkEmailPrivate(@CtxUser() user: User, @Args('emailId') emailId: string) {
+    return this.service.accountMarkEmailPrivate(user.id, emailId)
+  }
+
+  @Mutation(() => Email, { nullable: true })
+  accountMarkEmailPublic(@CtxUser() user: User, @Args('emailId') emailId: string) {
+    return this.service.accountMarkEmailPublic(user.id, emailId)
+  }
+
+  @Mutation(() => User, { nullable: true })
+  accountUpdateProfile(@CtxUser() user: User, @Args('input', new ValidationPipe()) input: AccountUpdateProfileInput) {
+    return this.service.accountUpdateProfile(user.id, input)
+  }
+
+  @Mutation(() => User)
+  accountUpdateDisplayName(
+    @CtxUser() user: User,
+    @Args('displayName') displayName: string
+  ) {
+    return this.service.accountUpdateDisplayName(user.id, displayName)
+  }
+
+  @Mutation(() => Boolean, { nullable: true })
+  accountResetPassword(@CtxUser() user: User) {
+    return this.service.accountResetPassword(user.id)
+  }
+
+  @Mutation(() => Boolean, { nullable: true })
+  accountUpdatePassword(@CtxUser() user: User, @Args('input', new ValidationPipe()) input: AccountUpdatePasswordInput) {
+    return this.service.accountUpdatePassword(user.id, input)
+  }
+}

package/src/account/generator.spec.ts

@@ -0,0 +1,71 @@
+import { formatFiles, installPackagesTask, Tree } from '@nx/devkit'
+import { createTreeWithEmptyWorkspace } from '@nx/devkit/testing'
+import { describe, expect, it, vi } from 'vitest'
+import { apiLibraryGenerator } from '@nestledjs/utils'
+
+import generator from './generator'
+
+vi.mock('@nestledjs/utils', async () => {
+  const actual = await vi.importActual('@nestledjs/utils')
+  return {
+    ...actual,
+    apiLibraryGenerator: vi.fn(),
+  }
+})
+
+vi.mock('@nx/devkit', async () => {
+  const actual = await vi.importActual('@nx/devkit')
+  return {
+    ...actual,
+    formatFiles: vi.fn(),
+    installPackagesTask: vi.fn(),
+  }
+})
+
+describe('account generator', () => {
+  let tree: Tree
+
+  beforeEach(() => {
+    tree = createTreeWithEmptyWorkspace()
+  })
+
+  it('should run successfully', async () => {
+    const callback = await generator(tree)
+    callback()
+
+    expect(apiLibraryGenerator).toHaveBeenCalledWith(
+      tree,
+      { name: 'account', overwrite: false },
+      expect.any(String),
+      'data-access',
+    )
+    expect(apiLibraryGenerator).toHaveBeenCalledWith(
+      tree,
+      { name: 'account', overwrite: false },
+      expect.any(String),
+      'feature',
+      true,
+    )
+    expect(formatFiles).toHaveBeenCalledWith(tree)
+    expect(installPackagesTask).toHaveBeenCalledWith(tree)
+  })
+
+  it('should pass overwrite flag to apiLibraryGenerator when overwrite is true', async () => {
+    const callback = await generator(tree, { overwrite: true })
+    callback()
+
+    expect(apiLibraryGenerator).toHaveBeenCalledWith(
+      tree,
+      { name: 'account', overwrite: true },
+      expect.any(String),
+      'data-access',
+    )
+    expect(apiLibraryGenerator).toHaveBeenCalledWith(
+      tree,
+      { name: 'account', overwrite: true },
+      expect.any(String),
+      'feature',
+      true,
+    )
+  })
+})

package/src/account/generator.ts

@@ -0,0 +1,20 @@
+import { formatFiles, GeneratorCallback, installPackagesTask, joinPathFragments, Tree } from '@nx/devkit'
+import { apiLibraryGenerator } from '@nestledjs/utils'
+import { ApiAccountGeneratorSchema } from './schema'
+
+export default async function generateLibraries(
+  tree: Tree,
+  options: ApiAccountGeneratorSchema = {},
+): Promise<GeneratorCallback> {
+  const templateRootPath = joinPathFragments(__dirname, './files')
+  const overwrite = options.overwrite === true
+
+  await apiLibraryGenerator(tree, { name: 'account', overwrite }, templateRootPath, 'data-access')
+  await apiLibraryGenerator(tree, { name: 'account', overwrite }, templateRootPath, 'feature', true)
+
+  await formatFiles(tree)
+
+  return () => {
+    installPackagesTask(tree)
+  }
+}

package/src/account/schema.d.ts

@@ -0,0 +1,3 @@
+export interface ApiAccountGeneratorSchema {
+  overwrite?: boolean
+}

package/src/account/schema.json

@@ -0,0 +1,13 @@
+{
+  "$schema": "https://json-schema.org/schema",
+  "$id": "ApiAccount",
+  "title": "Create an API Account Library",
+  "type": "object",
+  "properties": {
+    "overwrite": {
+      "type": "boolean",
+      "description": "Whether to overwrite existing libraries if they exist.",
+      "default": false
+    }
+  }
+}