メインコンテンツまでスキップ
バージョン: 🚧 Canary

👤 User Blocks

User blocks provide comprehensive functionality for user management in Nodeblocks applications. These blocks handle user lifecycle operations including creation, authentication, profile management, and account administration.

🎯 Overview​

User blocks are designed to:

  • Manage user accounts with full CRUD operations
  • Handle authentication and authorization flows
  • Provide profile management with validation
  • Enable user administration with role-based access

📦 Block Types​

🔍 Schemas​

JSON Schema definitions for user data validation:

  • userSchema: Base user entity structure
  • createUserSchema: User registration validation
  • updateUserSchema: Profile update validation
  • getUserSchema: User retrieval validation
  • deleteUserSchema: User deletion validation
  • findUsersSchema: User search with filtering and pagination

View User Schemas →

🔧 Blocks​

Pure business logic functions for user profile operations:

  • getUserById: Profile retrieval from datastore
  • findProfiles: Profile search with filtering and pagination
  • normalizeUser: Normalize single user object
  • normalizeUsers: Normalize array of user objects
  • deleteAvatar: Delete user avatar files from storage

View User Blocks →

⚙️ Handlers​

Core business logic for user operations:

  • createUser: User account creation
  • getUserById: User data retrieval
  • findUsers: User search with optional filtering
  • updateUser: Profile updates
  • deleteUser: Account deletion

Terminator Handlers:

  • normalizeUserTerminator: Normalizes user data by removing database-specific fields
  • normalizeUsersListTerminator: Normalizes users list by removing database-specific fields from each item
  • deleteUserTerminator: Formats successful deletion response with 204 status

View User Handlers →

🛣️ Routes​

HTTP endpoint definitions for user operations:

  • createUserRoute: POST /users with user creation handler
  • getUserRoute: GET /users/:profileId with user retrieval handler
  • findUsersRoute: GET /users with user search and pagination
  • findProfilesByIdentityIdRoute: GET /profiles/identities/:identityId with profile retrieval and avatar processing
  • updateUserRoute: PATCH /users/:profileId with user update handler
  • deleteUserRoute: DELETE /users/:profileId with user deletion handler
  • getAvatarUploadUrlRoute: GET /user-profiles/:profileId/avatar-upload-url with signed URL generation

View User Routes →

🚀 Features​

Complete user management features combining schemas, routes, and handlers:

  • createUserFeature: User registration with validation
  • getUserFeatures: User profile retrieval with access control
  • findUsersFeatures: User search and listing with pagination
  • findProfilesByIdentityIdFeature: User profile retrieval by identity ID with avatar processing
  • editUserFeatures: User profile updates with authorization
  • deleteUserFeatures: User account deletion with access control
  • getAvatarUploadUrlFeature: Avatar upload URL generation

View User Features →

✅ Validators​

Validation functions for user operations:

  • ownsProfile: Validates profile ownership by the authenticated identity
  • validateUserProfileAccess (deprecated): Legacy access validator; replaced by ownsProfile

View User Validators →

🔗 Related Documentation​