@openora/core 0.4.1-canary.13 → 0.4.1-canary.130

package/dist/pam/identity/__tests__/username-backfill.int.test.js

@@ -0,0 +1,103 @@
+import { describe, it, expect, beforeAll, afterAll, beforeEach } from 'vitest';
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { randomUUID } from 'node:crypto';
+import { sql } from 'drizzle-orm';
+import { createTestDb } from '@openora/core/testing';
+import { user } from '@openora/core/pam/schema/identity';
+import { player } from '@openora/core/pam/schema/profile';
+import { migrate as migrateProfile } from '@openora/core/pam/migrate/profile';
+import { migrate } from '../migrate.js';
+// The shipped backfill statement, read from the migration itself so this test cannot
+// drift from what actually runs. Statement 2 of 3, between the ADD COLUMN and the index.
+const BACKFILL_SQL = readFileSync(fileURLToPath(new URL('../drizzle/migrations/0007_fuzzy_barracuda.sql', import.meta.url)), 'utf8').split('--> statement-breakpoint')[1];
+let db;
+async function seedLegacy(legacyName, name = 'Fallback Name') {
+    const userId = randomUUID();
+    await db.drizzle.db.insert(user).values({
+        id: userId,
+        name,
+        username: `seed_${userId.replaceAll('-', '').slice(0, 13)}`,
+        email: `${userId}@legacy.test`,
+        role: 'player',
+    });
+    if (legacyName !== null) {
+        await db.drizzle.db.insert(player).values({ userId });
+        await db.drizzle.db.execute(sql `UPDATE player SET display_name = ${legacyName} WHERE user_id = ${userId}`);
+    }
+    return userId;
+}
+/**
+ * Rewinds to the shape an existing installation has when 0007 runs: no usernames, and
+ * `player.display_name` still present (profile drops it in a later migration).
+ */
+async function runBackfill() {
+    await db.drizzle.db.execute(sql `ALTER TABLE "user" ALTER COLUMN username DROP NOT NULL`);
+    await db.drizzle.db.execute(sql `UPDATE "user" SET username = NULL`);
+    await db.drizzle.db.execute(sql.raw(BACKFILL_SQL));
+    await db.drizzle.db.execute(sql `ALTER TABLE "user" ALTER COLUMN username SET NOT NULL`);
+    const rows = await db.drizzle.db.select({ id: user.id, username: user.username }).from(user);
+    return new Map(rows.map((r) => [r.id, r.username]));
+}
+beforeAll(async () => {
+    db = await createTestDb([migrate, migrateProfile]);
+});
+afterAll(async () => {
+    await db.drop();
+});
+beforeEach(async () => {
+    await db.drizzle.db.execute(sql `TRUNCATE ${player}, ${user} RESTART IDENTITY CASCADE`);
+    await db.drizzle.db.execute(sql `ALTER TABLE player ADD COLUMN IF NOT EXISTS display_name text`);
+});
+describe('0007 username backfill', () => {
+    it('sanitises a legacy display name into a valid handle', async () => {
+        const id = await seedLegacy("Alice O'Hara!");
+        expect((await runBackfill()).get(id)).toBe('alice_o_hara_');
+    });
+    it('falls back to the user name, then to a generic handle', async () => {
+        const noPlayerRow = await seedLegacy(null, 'Bob Builder');
+        const tooShort = await seedLegacy('ab');
+        const byId = await runBackfill();
+        expect(byId.get(noPlayerRow)).toBe('bob_builder');
+        expect(byId.get(tooShort)).toBe('player');
+    });
+    it('gives colliding legacy names globally unique handles', async () => {
+        const ids = await Promise.all([
+            seedLegacy('Duplicate'),
+            seedLegacy('Duplicate'),
+            seedLegacy('Duplicate'),
+        ]);
+        const byId = await runBackfill();
+        const handles = ids.map((id) => byId.get(id));
+        expect(new Set(handles).size).toBe(3);
+        expect(handles).toContain('duplicate');
+    });
+    it('never exceeds the 20 character username limit', async () => {
+        const ids = await Promise.all([
+            seedLegacy('A Very Long Display Name Indeed'),
+            seedLegacy('A Very Long Display Name Indeed'),
+        ]);
+        const byId = await runBackfill();
+        for (const id of ids) {
+            const handle = byId.get(id);
+            expect(handle).toMatch(/^[a-z0-9_]{3,20}$/);
+        }
+    });
+    it('gives non-player accounts a username too, so the column can be NOT NULL', async () => {
+        const userId = randomUUID();
+        await db.drizzle.db.insert(user).values({
+            id: userId,
+            name: 'Admin',
+            username: `seed_${userId.replaceAll('-', '').slice(0, 13)}`,
+            email: `${userId}@legacy.test`,
+            role: 'admin',
+        });
+        expect((await runBackfill()).get(userId)).toBe('admin');
+    });
+    it('satisfies the unique index it runs before', async () => {
+        await Promise.all(Array.from({ length: 25 }, () => seedLegacy('Same Name')));
+        const handles = [...(await runBackfill()).values()];
+        expect(new Set(handles.map((h) => h?.toLowerCase())).size).toBe(handles.length);
+    });
+});
+//# sourceMappingURL=username-backfill.int.test.js.map

package/dist/pam/identity/__tests__/username-backfill.int.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"username-backfill.int.test.js","sourceRoot":"","sources":["../../../../src/pam/identity/__tests__/username-backfill.int.test.ts"],"names":[],"mappings":"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"}

package/dist/pam/identity/adapters/identity-reader.service.d.ts

@@ -1,10 +1,15 @@
 import { DrizzleService } from '@openora/core/server';
-import { Player, type IdentityReader } from '@openora/core/contracts';
+import type { IdentityReader, KycStatus, Player, User } from '@openora/core/contracts';
 export declare class IdentityReaderService implements IdentityReader {
     private readonly drizzle;
     constructor(drizzle: DrizzleService);
-    getLastLoginAt(userId: Player['id']): Promise<Date | null>;
-    getPlayerIdsInactiveSince(sinceDate: Date): Promise<string[]>;
-    getPlayerIdByUserId(userId: string): Promise<string | null>;
+    getLastLoginAt(userId: User['id']): Promise<Date | null>;
+    getPlayerIdsInactiveSince(sinceDate: Date): Promise<User['id'][]>;
+    getPlayerIdByUserId(userId: User['id']): Promise<Player['id'] | null>;
+    getPlayerIdByUserIdSafe(userId: User['id']): Promise<Player['id'] | null>;
+    getPlayerIdsByUserIdsSafe(userIds: User['id'][]): Promise<Map<User['id'], Player['id'] | null>>;
+    getPlayerKycStatusByUserId(userId: User['id']): Promise<KycStatus | null>;
+    getPlayerUserIdsSharingLoginIp(userId: User['id'], ipAddress: string): Promise<User['id'][]>;
+    canReceiveLoginWithdrawalAlerts(userId: User['id']): Promise<boolean>;
 }
 //# sourceMappingURL=identity-reader.service.d.ts.map

package/dist/pam/identity/adapters/identity-reader.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"identity-reader.service.d.ts","sourceRoot":"","sources":["../../../../src/pam/identity/adapters/identity-reader.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,KAAK,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAKtE,qBAAa,qBAAsB,YAAW,cAAc;IAC9C,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,cAAc;IAE9C,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;IAQ1D,yBAAyB,CAAC,SAAS,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAyB7D,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CAQlE"}
+{"version":3,"file":"identity-reader.service.d.ts","sourceRoot":"","sources":["../../../../src/pam/identity/adapters/identity-reader.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAOvF,qBAAa,qBAAsB,YAAW,cAAc;IAC9C,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,cAAc;IAE9C,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;IAQxD,yBAAyB,CAAC,SAAS,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;IA4BjE,mBAAmB,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IASrE,uBAAuB,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IASzE,yBAAyB,CAC7B,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,GACpB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;IAmB1C,0BAA0B,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IASzE,8BAA8B,CAClC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;IAWlB,+BAA+B,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;CAQ5E"}

package/dist/pam/identity/adapters/identity-reader.service.js

@@ -1,6 +1,8 @@
-import { and, eq, isNull, lt, max, or } from 'drizzle-orm';
+import { createLogger } from '@openora/core/server';
+import { and, eq, inArray, isNull, lt, max, ne, or, SQL } from 'drizzle-orm';
 import { session, user } from '../schema/index.js';
 import { player } from '@openora/core/pam/schema/profile';
+const logger = createLogger('identity-reader');
 export class IdentityReaderService {
     drizzle;
     constructor(drizzle) {
@@ -17,7 +19,10 @@ export class IdentityReaderService {
         // Join users to their most-recent session. Players with no session at all
         // (registered but never logged in) are included via the LEFT JOIN + isNull check.
         const lastSessionPerUser = this.drizzle.db
-            .select({ userId: session.userId, lastAt: max(session.createdAt).as('last_at') })
+            .select({
+            userId: session.userId,
+            lastAt: new SQL.Aliased(max(session.createdAt), 'last_at'),
+        })
             .from(session)
             .groupBy(session.userId)
             .as('s');
@@ -36,5 +41,59 @@ export class IdentityReaderService {
             .limit(1);
         return row?.id ?? null;
     }
+    async getPlayerIdByUserIdSafe(userId) {
+        try {
+            return await this.getPlayerIdByUserId(userId);
+        }
+        catch (err) {
+            logger.warn({ err, userId }, 'player id lookup failed for event enrichment');
+            return null;
+        }
+    }
+    async getPlayerIdsByUserIdsSafe(userIds) {
+        const result = new Map(userIds.map((id) => [id, null]));
+        if (userIds.length === 0) {
+            return result;
+        }
+        try {
+            const rows = await this.drizzle.db
+                .select({ userId: player.userId, id: player.id })
+                .from(player)
+                .where(inArray(player.userId, userIds));
+            for (const row of rows) {
+                result.set(row.userId, row.id);
+            }
+        }
+        catch (err) {
+            logger.warn({ err, userIds }, 'batched player id lookup failed for event enrichment');
+        }
+        return result;
+    }
+    async getPlayerKycStatusByUserId(userId) {
+        const [row] = await this.drizzle.db
+            .select({ kycStatus: player.kycStatus })
+            .from(player)
+            .where(eq(player.userId, userId))
+            .limit(1);
+        return row?.kycStatus ?? null;
+    }
+    async getPlayerUserIdsSharingLoginIp(userId, ipAddress) {
+        const rows = await this.drizzle.db
+            .select({ userId: user.id })
+            .from(session)
+            .innerJoin(user, eq(session.userId, user.id))
+            .innerJoin(player, eq(player.userId, user.id))
+            .where(and(eq(session.ipAddress, ipAddress), ne(user.id, userId), eq(user.role, 'player')))
+            .groupBy(user.id);
+        return rows.map((r) => r.userId);
+    }
+    async canReceiveLoginWithdrawalAlerts(userId) {
+        const [row] = await this.drizzle.db
+            .select({ enabled: user.loginWithdrawalAlertsEnabled, emailVerified: user.emailVerified })
+            .from(user)
+            .where(eq(user.id, userId))
+            .limit(1);
+        return row?.enabled === true && row.emailVerified === true;
+    }
 }
 //# sourceMappingURL=identity-reader.service.js.map

package/dist/pam/identity/adapters/identity-reader.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"identity-reader.service.js","sourceRoot":"","sources":["../../../../src/pam/identity/adapters/identity-reader.service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAC;AAE1D,MAAM,OAAO,qBAAqB;IACH;IAA7B,YAA6B,OAAuB;QAAvB,YAAO,GAAP,OAAO,CAAgB;IAAG,CAAC;IAExD,KAAK,CAAC,cAAc,CAAC,MAAoB;QACvC,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,EAAE;aAChC,MAAM,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;aAC1C,IAAI,CAAC,OAAO,CAAC;aACb,KAAK,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;QACrC,OAAO,GAAG,EAAE,MAAM,IAAI,IAAI,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,yBAAyB,CAAC,SAAe;QAC7C,0EAA0E;QAC1E,kFAAkF;QAClF,MAAM,kBAAkB,GAAG,IAAI,CAAC,OAAO,CAAC,EAAE;aACvC,MAAM,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC;aAChF,IAAI,CAAC,OAAO,CAAC;aACb,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC;aACvB,EAAE,CAAC,GAAG,CAAC,CAAC;QAEX,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,EAAE;aAC/B,MAAM,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC;aAC3B,IAAI,CAAC,IAAI,CAAC;aACV,QAAQ,CAAC,kBAAkB,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC;aACpE,KAAK,CACJ,GAAG,CACD,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,EACvB,EAAE,CACA,GAAG,CAAC,MAAM,CAAC,kBAAkB,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,EACrE,EAAE,CAAC,kBAAkB,CAAC,MAAM,EAAE,SAAS,CAAC,CACzC,CACF,CACF,CAAC;QACJ,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,mBAAmB,CAAC,MAAc;QACtC,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,EAAE;aAChC,MAAM,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC;aACzB,IAAI,CAAC,MAAM,CAAC;aACZ,KAAK,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;aAChC,KAAK,CAAC,CAAC,CAAC,CAAC;QACZ,OAAO,GAAG,EAAE,EAAE,IAAI,IAAI,CAAC;IACzB,CAAC;CACF"}
+{"version":3,"file":"identity-reader.service.js","sourceRoot":"","sources":["../../../../src/pam/identity/adapters/identity-reader.service.ts"],"names":[],"mappings":"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"}

package/dist/pam/identity/adapters/mock/mock-kyc-adapter.d.ts

@@ -1,7 +1,7 @@
-import type { KycAdapter, KycDocument, KycResult, KycVendorStatus } from '@openora/core/contracts';
+import type { KycAdapter, KycDocument, KycResult, KycTier, KycVendorStatus } from '@openora/core/contracts';
 export declare class MockKycAdapter implements KycAdapter {
     readonly autoApproves = true;
-    submit(userId: string, _docs: KycDocument[]): Promise<KycResult>;
-    getStatus(_userId: string): Promise<KycVendorStatus>;
+    submit(userId: string, _docs: KycDocument[], tier: KycTier): Promise<KycResult>;
+    getStatus(_userId: string, _tier: KycTier): Promise<KycVendorStatus>;
 }
 //# sourceMappingURL=mock-kyc-adapter.d.ts.map

package/dist/pam/identity/adapters/mock/mock-kyc-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mock-kyc-adapter.d.ts","sourceRoot":"","sources":["../../../../../src/pam/identity/adapters/mock/mock-kyc-adapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAEnG,qBAAa,cAAe,YAAW,UAAU;IAC/C,QAAQ,CAAC,YAAY,QAAQ;IAEvB,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC;IAIhE,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;CAG3D"}
+{"version":3,"file":"mock-kyc-adapter.d.ts","sourceRoot":"","sources":["../../../../../src/pam/identity/adapters/mock/mock-kyc-adapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,UAAU,EACV,WAAW,EACX,SAAS,EACT,OAAO,EACP,eAAe,EAChB,MAAM,yBAAyB,CAAC;AAEjC,qBAAa,cAAe,YAAW,UAAU;IAC/C,QAAQ,CAAC,YAAY,QAAQ;IAEvB,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC;IAI/E,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,eAAe,CAAC;CAG3E"}

package/dist/pam/identity/adapters/mock/mock-kyc-adapter.js

@@ -1,9 +1,9 @@
 export class MockKycAdapter {
     autoApproves = true;
-    async submit(userId, _docs) {
-        return { referenceId: `mock-${userId}`, status: 'approved' };
+    async submit(userId, _docs, tier) {
+        return { referenceId: `mock-${userId}-${tier}`, status: 'approved' };
     }
-    async getStatus(_userId) {
+    async getStatus(_userId, _tier) {
         return 'approved';
     }
 }

package/dist/pam/identity/adapters/mock/mock-kyc-adapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"mock-kyc-adapter.js","sourceRoot":"","sources":["../../../../../src/pam/identity/adapters/mock/mock-kyc-adapter.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,cAAc;IAChB,YAAY,GAAG,IAAI,CAAC;IAE7B,KAAK,CAAC,MAAM,CAAC,MAAc,EAAE,KAAoB;QAC/C,OAAO,EAAE,WAAW,EAAE,QAAQ,MAAM,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;IAC/D,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,OAAe;QAC7B,OAAO,UAAU,CAAC;IACpB,CAAC;CACF"}
+{"version":3,"file":"mock-kyc-adapter.js","sourceRoot":"","sources":["../../../../../src/pam/identity/adapters/mock/mock-kyc-adapter.ts"],"names":[],"mappings":"AASA,MAAM,OAAO,cAAc;IAChB,YAAY,GAAG,IAAI,CAAC;IAE7B,KAAK,CAAC,MAAM,CAAC,MAAc,EAAE,KAAoB,EAAE,IAAa;QAC9D,OAAO,EAAE,WAAW,EAAE,QAAQ,MAAM,IAAI,IAAI,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;IACvE,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,OAAe,EAAE,KAAc;QAC7C,OAAO,UAAU,CAAC;IACpB,CAAC;CACF"}

package/dist/pam/identity/adapters/mock/mock-sms-adapter.d.ts

@@ -0,0 +1,8 @@
+import type { SmsAdapter } from '@openora/core/contracts';
+export declare class MockSmsAdapter implements SmsAdapter {
+    sendOtp({ to, code }: {
+        to: string;
+        code: string;
+    }): Promise<void>;
+}
+//# sourceMappingURL=mock-sms-adapter.d.ts.map

package/dist/pam/identity/adapters/mock/mock-sms-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-sms-adapter.d.ts","sourceRoot":"","sources":["../../../../../src/pam/identity/adapters/mock/mock-sms-adapter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAE1D,qBAAa,cAAe,YAAW,UAAU;IACzC,OAAO,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAIzE"}

package/dist/pam/identity/adapters/mock/mock-sms-adapter.js

@@ -0,0 +1,7 @@
+export class MockSmsAdapter {
+    async sendOtp({ to, code }) {
+        // mock: log-to-stdout delivery until a real SMS vendor adapter is bound via overlay.
+        console.log(`[SMS OTP] ${to}: ${code}`); // oxlint-disable-line no-console
+    }
+}
+//# sourceMappingURL=mock-sms-adapter.js.map

package/dist/pam/identity/adapters/mock/mock-sms-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-sms-adapter.js","sourceRoot":"","sources":["../../../../../src/pam/identity/adapters/mock/mock-sms-adapter.ts"],"names":[],"mappings":"AAIA,MAAM,OAAO,cAAc;IACzB,KAAK,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,IAAI,EAAgC;QACtD,qFAAqF;QACrF,OAAO,CAAC,GAAG,CAAC,aAAa,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,iCAAiC;IAC5E,CAAC;CACF"}

package/dist/pam/identity/admin-user-directory.d.ts

@@ -1,4 +1,4 @@
-import type { AdminUserDirectory, AdminUserListOptions } from '@openora/core/contracts';
+import type { AdminUserDirectory, AdminUserListOptions, ClientMeta, PlayerIdSearchOptions } from '@openora/core/contracts';
 import { DrizzleService } from '@openora/core/server';
 import type { EventBus } from '@openora/core/server';
 export declare class DrizzleAdminUserDirectory implements AdminUserDirectory {
@@ -6,14 +6,15 @@ export declare class DrizzleAdminUserDirectory implements AdminUserDirectory {
     private readonly events;
     constructor(drizzle: DrizzleService, events: EventBus);
     count(): Promise<number>;
-    list({ page, limit, search }: AdminUserListOptions): Promise<{
+    list({ page, limit, search, sortBy, sortOrder }: AdminUserListOptions): Promise<{
         rows: {
             id: string;
             email: string;
             name: string;
             createdAt: Date;
             isActive: boolean;
-            role: "admin" | "player";
+            role: string;
+            language: string;
             failedLoginAttempts: number;
             lockoutUntil: Date | null;
         }[];
@@ -25,29 +26,60 @@ export declare class DrizzleAdminUserDirectory implements AdminUserDirectory {
         name: string;
         createdAt: Date;
         isActive: boolean;
-        role: "admin" | "player";
+        role: string;
+        language: string;
         failedLoginAttempts: number;
         lockoutUntil: Date | null;
     } | null>;
+    lookupUsers(userIds: readonly string[]): Promise<{
+        id: string;
+        email: string;
+        name: string;
+        createdAt: Date;
+        isActive: boolean;
+        role: string;
+        language: string;
+        failedLoginAttempts: number;
+        lockoutUntil: Date | null;
+    }[]>;
     update(id: string, patch: {
         isActive?: boolean;
         role?: string;
-    }, actorId: string): Promise<{
+    }, actorId: string, meta?: ClientMeta): Promise<{
         id: string;
         email: string;
         name: string;
         createdAt: Date;
         isActive: boolean;
-        role: "admin" | "player";
+        role: string;
+        language: string;
         failedLoginAttempts: number;
         lockoutUntil: Date | null;
     } | null>;
     lookupPlayers(userIds: readonly string[]): Promise<{
+        kycStatus: "pending" | "not_started" | "approved" | "verified" | "rejected" | "resubmission_requested" | "manually_overridden" | null;
+        playerId: string;
         userId: string;
         username: string;
         email: string;
-        kycStatus: "pending" | "not_started" | "verified" | "rejected" | "resubmission_requested" | "manually_overridden" | null;
+        language: string;
+        avatarUrl: string | null;
+        createdAt: Date;
+        level: number;
+        currency: string;
     }[]>;
-    findPlayerIds(query: string): Promise<string[]>;
+    getPlayerByUsername(username: string): Promise<{
+        kycStatus: "pending" | "not_started" | "approved" | "verified" | "rejected" | "resubmission_requested" | "manually_overridden" | null;
+        playerId: string;
+        userId: string;
+        username: string;
+        email: string;
+        language: string;
+        avatarUrl: string | null;
+        createdAt: Date;
+        level: number;
+        currency: string;
+    } | null>;
+    findPlayerIds(query: string, limit?: number, options?: PlayerIdSearchOptions): Promise<string[]>;
 }
 //# sourceMappingURL=admin-user-directory.d.ts.map

package/dist/pam/identity/admin-user-directory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"admin-user-directory.d.ts","sourceRoot":"","sources":["../../../src/pam/identity/admin-user-directory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAExF,OAAO,EAAE,cAAc,EAAgB,MAAM,sBAAsB,CAAC;AACpE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAuBrD,qBAAa,yBAA0B,YAAW,kBAAkB;IAEhE,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADN,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,QAAQ;IAG7B,KAAK;IAKL,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,oBAAoB;;;;;;;;;;;;;IAgBlD,GAAG,CAAC,EAAE,EAAE,MAAM;;;;;;;;;;IAKd,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,OAAO,EAAE,MAAM;;;;;;;;;;IA6BhF,aAAa,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE;;;;;;IA8BxC,aAAa,CAAC,KAAK,EAAE,MAAM;CAoBlC"}
+{"version":3,"file":"admin-user-directory.d.ts","sourceRoot":"","sources":["../../../src/pam/identity/admin-user-directory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,oBAAoB,EACpB,UAAU,EACV,qBAAqB,EACtB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,cAAc,EAAgB,MAAM,sBAAsB,CAAC;AACpE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAsCrD,qBAAa,yBAA0B,YAAW,kBAAkB;IAEhE,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADN,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,QAAQ;IAG7B,KAAK;IAKL,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,oBAAoB;;;;;;;;;;;;;;IAmCrE,GAAG,CAAC,EAAE,EAAE,MAAM;;;;;;;;;;;IAKd,WAAW,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE;;;;;;;;;;;IAWtC,MAAM,CACV,EAAE,EAAE,MAAM,EACV,KAAK,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,EAC5C,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,UAAU;;;;;;;;;;;IAgCb,aAAa,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE;;;;;;;;;;;;IAkCxC,mBAAmB,CAAC,QAAQ,EAAE,MAAM;;;;;;;;;;;;IA4BpC,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAO,EAAE,OAAO,CAAC,EAAE,qBAAqB;CAsBjF"}

package/dist/pam/identity/admin-user-directory.js

@@ -1,11 +1,12 @@
-import { KycStatusSchema, UserRoleSchema } from '@openora/core/contracts';
+import { KycStatusSchema, normalizeKycStatus, UuidSchema } from '@openora/core/contracts';
 import { pageToOffset } from '@openora/core/server';
-import { count, desc, eq, ilike, inArray } from 'drizzle-orm';
+import { asc, count, desc, eq, ilike, inArray, isNotNull, notInArray, or, sql, and, } from 'drizzle-orm';
 import { user } from './schema/index.js';
 // Read-only cross-domain read of the player/profile table via the public /schema
 // subpath (allowed per ADR-0020) so back-office lists can label players by
 // username + KYC without leaking the schema to the consumer module.
 import { player } from '@openora/core/pam/schema/profile';
+const escapeLikePattern = (value) => value.replaceAll(/[%_\\]/g, '\\$&');
 // Identity owns the `user` table, so it owns the admin directory port.
 // admin-console depends only on ADMIN_USER_DIRECTORY - never on this schema. See ADR-0017/0025.
 function toRow(r) {
@@ -15,7 +16,8 @@ function toRow(r) {
         name: r.name ?? null,
         createdAt: r.createdAt,
         isActive: r.isActive,
-        role: UserRoleSchema.parse(r.role),
+        role: r.role,
+        language: r.language ?? null,
         failedLoginAttempts: r.failedLoginAttempts,
         lockoutUntil: r.lockoutUntil,
     };
@@ -31,15 +33,31 @@ export class DrizzleAdminUserDirectory {
         const [r] = await this.drizzle.db.select({ n: count() }).from(user);
         return Number(r?.n ?? 0);
     }
-    async list({ page, limit, search }) {
+    async list({ page, limit, search, sortBy, sortOrder }) {
         const db = this.drizzle.db;
         const where = search ? ilike(user.email, `%${search}%`) : undefined;
+        const dir = (sortOrder ?? 'desc') === 'asc' ? asc : desc;
+        const USER_SORT_COLS = {
+            createdAt: user.createdAt,
+            email: user.email,
+            name: user.name,
+            role: user.role,
+            isActive: user.isActive,
+            lastLockoutAt: user.lastLockoutAt,
+        };
+        const col = USER_SORT_COLS[sortBy === 'email' ||
+            sortBy === 'name' ||
+            sortBy === 'role' ||
+            sortBy === 'isActive' ||
+            sortBy === 'lastLockoutAt'
+            ? sortBy
+            : 'createdAt'];
         const [rows, [{ n }]] = await Promise.all([
             db
                 .select()
                 .from(user)
                 .where(where)
-                .orderBy(desc(user.createdAt))
+                .orderBy(dir(col), desc(user.id))
                 .limit(limit)
                 .offset(pageToOffset(page, limit)),
             db.select({ n: count() }).from(user).where(where),
@@ -50,7 +68,17 @@ export class DrizzleAdminUserDirectory {
         const [r] = await this.drizzle.db.select().from(user).where(eq(user.id, id));
         return r ? toRow(r) : null;
     }
-    async update(id, patch, actorId) {
+    async lookupUsers(userIds) {
+        if (userIds.length === 0) {
+            return [];
+        }
+        const rows = await this.drizzle.db
+            .select()
+            .from(user)
+            .where(inArray(user.id, [...userIds]));
+        return rows.map(toRow);
+    }
+    async update(id, patch, actorId, meta) {
         const [existing] = await this.drizzle.db.select().from(user).where(eq(user.id, id));
         if (!existing) {
             return null;
@@ -69,11 +97,13 @@ export class DrizzleAdminUserDirectory {
         // Emit only on an actual active-status flip, after the commit. Literal topics
         // (not a ternary) so the catalog generator's emit-scanner picks them up.
         if (patch.isActive !== undefined && patch.isActive !== existing.isActive) {
+            const ip = meta?.ip ?? null;
+            const userAgent = meta?.userAgent ?? null;
             if (patch.isActive) {
-                this.events.emit('identity.user.reactivated', { userId: id, actorId });
+                this.events.emit('identity.user.reactivated', { userId: id, actorId, ip, userAgent });
             }
             else {
-                this.events.emit('identity.user.deactivated', { userId: id, actorId });
+                this.events.emit('identity.user.deactivated', { userId: id, actorId, ip, userAgent });
             }
         }
         return toRow(r);
@@ -84,48 +114,75 @@ export class DrizzleAdminUserDirectory {
         }
         const rows = await this.drizzle.db
             .select({
+            playerId: player.id,
             userId: player.userId,
-            username: player.displayName,
+            username: user.username,
             kycStatus: player.kycStatus,
             email: user.email,
+            language: user.language,
+            avatarUrl: user.image,
+            createdAt: player.createdAt,
+            level: player.level,
+            currency: player.currency,
         })
             .from(player)
             .innerJoin(user, eq(player.userId, user.id))
-            .where(inArray(player.userId, [...userIds]));
+            .where(and(inArray(player.userId, [...userIds]), eq(user.role, 'player')));
         return rows.map((r) => {
             // The player table stores kycStatus as free text; coerce unknown values to null
-            // so the port's KycStatus contract holds without a cast.
+            // so the port's KycStatus contract holds without a cast. Normalize the deprecated
+            // `verified` value to `approved` here - the single read boundary every admin
+            // consumer (wallet queue filter, tag evaluation, admin-console) goes through -
+            // so a legacy row is indistinguishable from a fresh one downstream.
             const kyc = KycStatusSchema.safeParse(r.kycStatus);
             return {
-                userId: r.userId,
-                username: r.username,
-                email: r.email,
-                kycStatus: kyc.success ? kyc.data : null,
+                ...r,
+                kycStatus: kyc.success ? normalizeKycStatus(kyc.data) : null,
             };
         });
     }
-    // Substring search is index-backed by the pg_trgm GIN indexes on user.email and
-    // player.display_name; the 1000 cap is a safety bound on the id set, not a perf
-    // crutch - it is effectively unreachable for a real admin search term.
-    async findPlayerIds(query) {
-        const term = `%${query}%`;
-        const cap = 1000;
-        const [byEmail, byName] = await Promise.all([
-            this.drizzle.db.select({ id: user.id }).from(user).where(ilike(user.email, term)).limit(cap),
-            this.drizzle.db
-                .select({ userId: player.userId })
-                .from(player)
-                .where(ilike(player.displayName, term))
-                .limit(cap),
-        ]);
-        const ids = new Set();
-        for (const r of byEmail) {
-            ids.add(r.id);
+    async getPlayerByUsername(username) {
+        const rows = await this.drizzle.db
+            .select({
+            playerId: player.id,
+            userId: player.userId,
+            username: user.username,
+            kycStatus: player.kycStatus,
+            email: user.email,
+            language: user.language,
+            avatarUrl: user.image,
+            createdAt: player.createdAt,
+            level: player.level,
+            currency: player.currency,
+        })
+            .from(player)
+            .innerJoin(user, eq(player.userId, user.id))
+            // Exact, case-insensitive match - ILIKE would let % and _ in `username` act as
+            // wildcards, letting a caller-supplied pattern select an arbitrary matching player.
+            .where(eq(sql `lower(${user.username})`, username.toLowerCase()))
+            .limit(1);
+        const [row] = rows;
+        if (!row) {
+            return null;
         }
-        for (const r of byName) {
-            ids.add(r.userId);
+        const kyc = KycStatusSchema.safeParse(row.kycStatus);
+        return { ...row, kycStatus: kyc.success ? normalizeKycStatus(kyc.data) : null };
+    }
+    async findPlayerIds(query, limit = 1000, options) {
+        const term = `%${escapeLikePattern(query)}%`;
+        const conditions = [ilike(user.email, term), ilike(user.username, term)];
+        if (UuidSchema.safeParse(query).success) {
+            conditions.push(eq(player.id, query), eq(player.userId, query));
         }
-        return [...ids].slice(0, cap);
+        const rows = await this.drizzle.db
+            .selectDistinct({ id: user.id })
+            .from(user)
+            .leftJoin(player, eq(player.userId, user.id))
+            .where(and(or(...conditions), options?.playerOnly ? and(eq(user.role, 'player'), isNotNull(player.id)) : undefined, options?.excludeUserIds?.length
+            ? notInArray(user.id, [...options.excludeUserIds])
+            : undefined))
+            .limit(limit);
+        return rows.map((r) => r.id);
     }
 }
 //# sourceMappingURL=admin-user-directory.js.map