@aiquants/auth-directory-drizzle 0.2.0 → 0.2.1

package/dist/index.d.mts

@@ -1113,8 +1113,12 @@ type LedgerIdentityTables = {
  * Finds every ledger row that belongs to the identity, within one tenant.
  * 1 テナント内で、その identity に属する台帳行をすべて探す処理。
  *
- * 突合順は上流 ID が第一キー、アドレスが第二キー。両方を `OR` で混ぜると優先順位が消え、
- * 退職者のアドレスを再利用した新入社員が前任者の所属をそのまま継承する。
+ * 上流 ID の一致は無条件に本人。アドレスの一致は、その行が **別の** 上流 ID に紐付いていない
+ * ときだけ本人である。単純な `OR` にすると後者の条件が消え、退職者のアドレスを再利用した
+ * 新入社員が前任者の所属をそのまま継承する。
+ *
+ * ⚠️ この優先順位は **行ごと** に適用する。「ID で当たったらアドレスは見ない」という打ち切りは
+ * 誤りで、同じ人物の行が ID 付きと ID 無しに混在すると ID 無しの行が丸ごと落ちる。
  *
  * @param db - Connected database surface. 接続済みの DB 面。
  * @param tables - The ledger and its parent group table. 台帳と親グループ表。
@@ -1437,6 +1441,16 @@ type PromotionRepositoryOptions = {
     /** Injected clock — tests must not depend on wall time. 注入時計 (実時刻に依存させない)。 */
     now?: () => Date;
 };
+/**
+ * Builds the promotion repository over the directory ledger and the authz membership table.
+ * ディレクトリ台帳と認可の所属表に対して、昇格リポジトリを構築する処理。
+ *
+ * @param dbUnknown - Drizzle database instance. drizzle のデータベースインスタンス。
+ * @param tables - Directory tables (owns the ledger). ディレクトリ表 (台帳の所有者)。
+ * @param authzTables - Authorization tables (owns groups and membership). 認可表 (グループと所属の所有者)。
+ * @param opts - Connection, actor and clock. 接続・実行者・時計。
+ * @returns A repository consumable by `promoteLedgerForUser`. `promoteLedgerForUser` が使うリポジトリ。
+ */
 declare function createPromotionRepository(dbUnknown: unknown, tables: AuthDirectoryTables, authzTables: AuthzTables, opts: PromotionRepositoryOptions): PromotionRepository;
 
 /**

package/dist/index.d.ts

@@ -1113,8 +1113,12 @@ type LedgerIdentityTables = {
  * Finds every ledger row that belongs to the identity, within one tenant.
  * 1 テナント内で、その identity に属する台帳行をすべて探す処理。
  *
- * 突合順は上流 ID が第一キー、アドレスが第二キー。両方を `OR` で混ぜると優先順位が消え、
- * 退職者のアドレスを再利用した新入社員が前任者の所属をそのまま継承する。
+ * 上流 ID の一致は無条件に本人。アドレスの一致は、その行が **別の** 上流 ID に紐付いていない
+ * ときだけ本人である。単純な `OR` にすると後者の条件が消え、退職者のアドレスを再利用した
+ * 新入社員が前任者の所属をそのまま継承する。
+ *
+ * ⚠️ この優先順位は **行ごと** に適用する。「ID で当たったらアドレスは見ない」という打ち切りは
+ * 誤りで、同じ人物の行が ID 付きと ID 無しに混在すると ID 無しの行が丸ごと落ちる。
  *
  * @param db - Connected database surface. 接続済みの DB 面。
  * @param tables - The ledger and its parent group table. 台帳と親グループ表。
@@ -1437,6 +1441,16 @@ type PromotionRepositoryOptions = {
     /** Injected clock — tests must not depend on wall time. 注入時計 (実時刻に依存させない)。 */
     now?: () => Date;
 };
+/**
+ * Builds the promotion repository over the directory ledger and the authz membership table.
+ * ディレクトリ台帳と認可の所属表に対して、昇格リポジトリを構築する処理。
+ *
+ * @param dbUnknown - Drizzle database instance. drizzle のデータベースインスタンス。
+ * @param tables - Directory tables (owns the ledger). ディレクトリ表 (台帳の所有者)。
+ * @param authzTables - Authorization tables (owns groups and membership). 認可表 (グループと所属の所有者)。
+ * @param opts - Connection, actor and clock. 接続・実行者・時計。
+ * @returns A repository consumable by `promoteLedgerForUser`. `promoteLedgerForUser` が使うリポジトリ。
+ */
 declare function createPromotionRepository(dbUnknown: unknown, tables: AuthDirectoryTables, authzTables: AuthzTables, opts: PromotionRepositoryOptions): PromotionRepository;
 
 /**