Skip to main content
Version: 0.5.0 (Previous)

Changelog

2025-08-22​

✨ Added​

Blocks​

2025-08-21​

✨ Added​

Utilities​

2025-08-20​

✨ Added​

Validators​

2025-08-14​

🔄 Changed​

Routes​

Features​

2025-08-13​

✨ Added​

Blocks​

🔄 Changed​

Handlers (Deprecated)​

  • Authentication:
    • Marked as deprecated with replacement notes in docs: loginWithCredentials, createAccessToken, createRefreshToken, setResponseCookie, refreshToken, logout, checkToken, loginWithOnetimeToken, generateOnetimeToken, registerCredentials, confirmEmail, loginTerminator, logoutTerminator, registerTerminator, sendVerificationEmailTerminator, sendVerificationEmail
    • Replacement: use Authentication Blocks
  • User:
    • Marked as deprecated with replacement notes in docs: createUser, getUserById, findUsers, updateUser, deleteUser, lockUser, unlockUser, normalizeUserTerminator, normalizeUsersListTerminator, deleteUserTerminator, lockUserTerminator, unlockUserTerminator
    • Replacement: use User Blocks

Validators (Deprecated)​

  • Authentication:
    • verifyAuthentication — Replacement: isAuthenticated
  • User:
    • validateUserProfileAccess — Replacement: ownsProfile
  • Organization:
    • validateOrganizationAccess — Replacement: hasOrgRole
  • Order:
    • validateOrderAccess — Replacement: ownsOrder
  • Chat:
    • validateChannelAccess — Replacement: ownsChannel
    • validateMessageAccess — Replacement: ownsMessage
  • Common:
    • validateResourceAccess — Replacement: isSelf, checkIdentityType

Authentication Docs​

Services​

2025-08-12​

✨ Added​

Schemas​

Blocks​

Routes​

Features​

Drivers​

🔄 Changed​

Services​

  • Authentication Service: Quickstart uses SDK drivers and correct stores/args
    • Import drivers from @nodeblocks/backend-sdk
    • Use getMongoClient('mongodb://localhost:27017', 'dev')
    • Provide third argument as { mailService, googleOAuthDriver }
    • Datastore keys corrected to identities, onetimetokens, invitations
    • Endpoint summary: added OAuth endpoints — GET /auth/oauth/google, GET /auth/oauth/google/callback

2025-08-08​

✨ Added​

Blocks​

2025-08-07​

✨ Added​

Blocks​

Schemas​

Routes​

Features​

⚠️ Deprecated​

  • requireParam, isUUID, and isNumber validators now use a legacy interface and are deprecated.
    • Prefer standard validators or custom validators using the normal payload signature.
    • Details: see requireParam, isUUID, isNumber.

🧩 Versioning​

  • Introduced SDK versioning for the backend documentation release.
  • You can now select the Nodeblocks Backend SDK version from the right side of the navbar, next to the documentation version selector.

2025-08-06​

✨ Added​

Blocks​

Schemas​

Routes​

Features​

Combinators​

2025-07-29​

✨ Added​

  • Database Drivers: Comprehensive documentation for database connection and configuration
    • MongoDB driver documentation with connection examples
    • Custom database driver interface requirements
  • Mail Service Drivers: Complete documentation for email service configuration
    • SendGrid driver documentation with API key configuration
    • Mail data interface with HTML/text content requirements
    • Mail service interface with status-based success handling
  • File Storage Drivers: Detailed documentation for cloud storage operations
    • Google Cloud Storage driver with signed URL generation
    • File upload, download, and deletion URL examples
    • cURL examples for testing signed URLs
    • Content type validation and file size limits
  • Driver Architecture: New drivers subdirectory under components
    • Organized driver documentation in docs/v2/backend/components/drivers/
    • Separate documentation for database, mail service, and file storage drivers
    • Consistent interface patterns across all driver types
  • Identity Service Documentation: Complete API documentation with live testing validation
    • Full CRUD operations for identity management (GET, PATCH, DELETE)
    • Real API response examples validated through cURL testing
    • Admin-only access requirements with proper authorization documentation
    • Schema-based request validation with actual response format documentation
    • Error handling with HTTP status codes (401, 403, 404, 500)
    • Integration examples using NodeBlocks database drivers

2025-07-28​

✨ Added​

  • Organization blocks: pure business logic functions for organization management
  • applyPayloadArgs utility for mapping payload data to block parameters
  • File storage blocks: pure business logic functions for secure file management
  • generateSignedUploadUrl block for creating secure upload URLs
  • generateSignedDownloadUrl block for creating secure download URLs
  • generateSignedDeleteUrl block for creating secure delete URLs
  • generateSignedAvatarUploadUrl block for avatar uploads with UUID generation
  • File storage schemas for image upload validation
  • Authentication blocks: pure business logic functions for secure authentication
  • Identity management blocks for user validation and email operations
  • Token management blocks for secure token lifecycle management
  • Email authentication blocks for verification and communication
  • Security validation blocks for fingerprint tracking and request validation
  • New authentication schemas for enhanced functionality:
  • New authentication features for complete workflows:
  • New authentication routes using blocks:

🔄 Changed​

🐞 Breaking Changes​

  • Organization handlers removed - can no longer import them directly
  • To use previous handler logic in custom routes, compose blocks using applyPayloadArgs