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

変更履歴

2025-08-22​

✨ 追加​

ブロック​

2025-08-21​

✨ 追加​

ユーティリティ​

2025-08-20​

✨ 追加​

バリデータ​

  • Authentication:
    • isAuthenticated: Bearerトークンを使用してリクエストを認証します
  • Identity:
    • isSelf: 認証されたアイデンティティがターゲットアイデンティティと一致することを確認します
  • Organization:
    • hasOrgRole: 組織メンバーシップロールを検証します
  • Chat:
    • hasSubscription: チャンネルサブスクリプションを必須とします
    • ownsSubscription: サブスクリプションの所有権を検証します
    • ownsChannel: チャンネルの所有権を検証します
    • ownsMessage: メッセージの所有権を検証します
  • Order:
    • ownsOrder: 注文の所有権を検証します
  • User:
    • ownsProfile: プロフィールの所有権を検証します
  • Common:
    • checkIdentityType: アイデンティティタイプによるアクセスをゲートします
    • ownsResource: 汎用所有権バリデータ
    • some: ORセマンティクスでバリデータを構成します
    • レガシーパラメータバリデータ（文書化済み）: requireParam, isUUID, isNumber
  • Category:

2025-08-14​

🔄 変更​

ルート​

機能​

  • emailVerificationFeature: /auth/:identityId/send-verification-emailエンドポイントを使用します
  • lockUserFeatures: APIエンドポイントが/identities/:identityId/lockを使用します
  • unlockUserFeatures: APIエンドポイントが/identities/:identityId/unlockを使用します

2025-08-13​

✨ 追加​

ブロック​

  • User:
    • getUserById: 存在検証付きでIDでユーザーを取得します
    • normalizeUser: ユーザーオブジェクトからMongoDB _idフィールドを削除します
    • normalizeUsers: ユーザー配列からMongoDB _idフィールドを削除します
  • Avatar:

🔄 変更​

ハンドラー（非推奨）​

  • Authentication:
    • 文書内の置換に関する注意付きで非推奨としてマークされました: loginWithCredentials, createAccessToken, createRefreshToken, setResponseCookie, refreshToken, logout, checkToken, loginWithOnetimeToken, generateOnetimeToken, registerCredentials, confirmEmail, loginTerminator, logoutTerminator, registerTerminator, sendVerificationEmailTerminator, sendVerificationEmail
    • 置換: Authentication Blocksを使用
  • User:
    • 文書内の置換に関する注意付きで非推奨としてマークされました: createUser, getUserById, findUsers, updateUser, deleteUser, lockUser, unlockUser, normalizeUserTerminator, normalizeUsersListTerminator, deleteUserTerminator, lockUserTerminator, unlockUserTerminator
    • 置換: User Blocksを使用

バリデータ（非推奨）​

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

認証ドキュメント​

サービス​

  • Authentication Service:
    • トークンチェックレスポンスフィールドがuserIdからidentityIdに修正されました

2025-08-12​

✨ 追加​

スキーマ​

ブロック​

ルート​

機能​

ドライバー​

🔄 変更​

サービス​

  • Authentication Service: クイックスタートでSDKドライバーと正しいストア/引数を使用
    • @nodeblocks/backend-sdkからdriversをインポート
    • getMongoClient('mongodb://localhost:27017', 'dev')を使用
    • 第3引数を{ mailService, googleOAuthDriver }として提供
    • データストアキーがidentities, onetimetokens, invitationsに修正されました
    • エンドポイント要約: OAuthエンドポイントが追加されました — GET /auth/oauth/google, GET /auth/oauth/google/callback

2025-08-08​

✨ 追加​

ブロック​

  • getAvatarUploadUrlRoute: GET /user-profiles/:profileId/avatar-upload-url 安全なアバターアップロードURL生成用
  • getAvatarUploadUrlFeature: スキーマ検証付きのアバターアップロードURL生成のための構成されたワークフロー

2025-08-07​

✨ 追加​

ブロック​

スキーマ​

ルート​

  • deactivateRoute: POST /auth/deactivate アカウントを無効化しトークンを無効化します
  • completePasswordResetRoute: POST /auth/reset-password パスワードリセットを最終化します

機能​

⚠️ 非推奨​

  • requireParam, isUUID, isNumberバリデータがレガシーインターフェースを使用し非推奨になりました。
    • 標準バリデータまたは通常のペイロード署名を使用するカスタムバリデータを推奨します。
    • 詳細: requireParam, isUUID, isNumberを参照してください。

🧩 バージョン管理​

  • バックエンドドキュメントリリースのためにSDKバージョン管理が導入されました。
  • ドキュメントバージョンセレクタの隣のナビゲーションバーの右側からNodeBlocks Backend SDKバージョンを選択できるようになりました。

2025-08-06​

✨ 追加​

ブロック​

  • hash: bcryptを使用して文字列（パスワード）をハッシュ化します
  • normalizeIdentityWithoutPassword: アイデンティティオブジェクトからpasswordと_idを削除します
  • sendEmail: オプションのワンタイムトークン付きでメールを送信します
  • updateIdentity: データストア内のアイデンティティフィールドを更新します
  • buildUpdateIdentityActivatedPayload: 非アクティブ化をクリアしアイデンティティをロック解除するためのアクティベーションペイロードを構築します
  • isEmailVerified: メールが検証されていることを確認するか禁止を返します
  • checkOneTimeToken: ワンタイムトークンを検証および復号化します
  • checkToken: セキュリティチェック付きでアクセス/ワンタイムトークンを検証します

スキーマ​

  • changePasswordSchema: 現在のパスワードと新しいパスワードを検証します
  • activateSchema: アクティベーションリクエストを検証します

ルート​

  • changePasswordRoute: PATCH /auth/:identityId/change-password パスワードを変更します
  • activateRoute: POST /auth/activate アカウントをアクティブ化します

機能​

コンビネータ​

  • applyPayloadArgs: ペイロードデータをブロックパラメータにマッピングします
  • orThrow: マッピングされたエラーをスローするか値を通過させます

2025-07-29​

✨ 追加​

  • データベースドライバー: データベース接続と設定の包括的なドキュメント
    • 接続例付きのMongoDBドライバードキュメント
    • カスタムデータベースドライバーのインターフェース要件
  • メールサービスドライバー: メールサービス設定の完全なドキュメント
    • APIキー設定付きのSendGridドライバードキュメント
    • HTML/テキストコンテンツ要件付きのメールデータインターフェース
    • ステータスベースの成功処理付きのメールサービスインターフェース
  • ファイルストレージドライバー: クラウドストレージ操作の詳細なドキュメント
    • 署名付きURL生成付きのGoogle Cloud Storageドライバー
    • ファイルアップロード、ダウンロード、削除URLの例
    • 署名付きURLテストのためのcURL例
    • コンテンツタイプ検証とファイルサイズ制限
  • ドライバーアーキテクチャ: components下の新しいdriversサブディレクトリ
    • docs/v2/backend/components/drivers/での整理されたドライバードキュメント
    • データベース、メールサービス、ファイルストレージドライバーの個別ドキュメント
    • すべてのドライバータイプ間の統一されたインターフェースパターン
  • Identity Service Documentation: ライブテスト検証付きの完全なAPIドキュメント
    • アイデンティティ管理のための完全なCRUD操作（GET, PATCH, DELETE）
    • cURLテストを通じて検証された実際のAPIレスポンス例
    • 適切な認証ドキュメント付きの管理者専用アクセス要件
    • 実際のレスポンス形式ドキュメント付きのスキーマベースのリクエスト検証
    • HTTPステータスコード（401, 403, 404, 500）付きのエラーハンドリング
    • NodeBlocksデータベースドライバーを使用した統合例

2025-07-28​

✨ 追加​

  • 組織ブロック: 組織管理のための純粋なビジネスロジック関数
  • ペイロードデータをブロックパラメータにマッピングするためのapplyPayloadArgsユーティリティ
  • ファイルストレージブロック: 安全なファイル管理のための純粋なビジネスロジック関数
  • 安全なアップロードURLを作成するためのgenerateSignedUploadUrlブロック
  • 安全なダウンロードURLを作成するためのgenerateSignedDownloadUrlブロック
  • 安全な削除URLを作成するためのgenerateSignedDeleteUrlブロック
  • UUID生成付きのアバターアップロードのためのgenerateSignedAvatarUploadUrlブロック
  • 画像アップロード検証のためのファイルストレージスキーマ
  • 認証ブロック: 安全な認証のための純粋なビジネスロジック関数
  • ユーザー検証とメール操作のためのアイデンティティ管理ブロック
  • 安全なトークンライフサイクル管理のためのトークン管理ブロック
  • 検証と通信のためのメール認証ブロック
  • フィンガープリント追跡とリクエスト検証のためのセキュリティ検証ブロック
  • 強化された機能のための新しい認証スキーマ:
  • 完全なワークフローのための新しい認証機能:
  • ブロックを使用した新しい認証ルート:

🔄 変更​

🐞 破壊的変更​

  • 組織ハンドラーが削除されました - 直接インポートできなくなりました
  • カスタムルートで以前のハンドラーロジックを使用するには、applyPayloadArgsを使用してブロックを構成します