@qwickapps/server 1.4.0 → 1.5.1

package/dist/plugins/usage/usage-plugin.js

@@ -0,0 +1,412 @@
+/**
+ * Usage Plugin
+ *
+ * Usage tracking plugin for @qwickapps/server.
+ * Tracks daily/monthly feature usage and enforces limits.
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+// Import subscription helpers if available
+let getFeatureLimitFn = null;
+// Store instance for helper access
+let currentStore = null;
+let currentConfig = null;
+let cleanupIntervalId = null;
+/**
+ * Get current date in YYYY-MM-DD format
+ */
+function getCurrentDate() {
+    return new Date().toISOString().split('T')[0];
+}
+/**
+ * Get tomorrow's date at midnight (for reset time)
+ */
+function getTomorrowMidnight() {
+    const tomorrow = new Date();
+    tomorrow.setDate(tomorrow.getDate() + 1);
+    tomorrow.setHours(0, 0, 0, 0);
+    return tomorrow;
+}
+/**
+ * Create the Usage plugin
+ */
+export function createUsagePlugin(config) {
+    const debug = config.debug || false;
+    const apiPrefix = config.api?.prefix || '/usage';
+    function log(message, data) {
+        if (debug) {
+            console.log(`[UsagePlugin] ${message}`, data || '');
+        }
+    }
+    return {
+        id: 'usage',
+        name: 'Usage',
+        version: '1.0.0',
+        async onStart(_pluginConfig, registry) {
+            log('Starting usage plugin');
+            // Initialize the store (creates tables if needed)
+            await config.store.initialize();
+            log('Usage plugin migrations complete');
+            // Store references for helper access
+            currentStore = config.store;
+            currentConfig = config;
+            // Try to get the feature limit function from subscriptions plugin
+            try {
+                const subscriptions = await import('../subscriptions/index.js');
+                getFeatureLimitFn = subscriptions.getFeatureLimit;
+                log('Subscriptions plugin integration enabled');
+            }
+            catch {
+                log('Subscriptions plugin not available, limits will not be enforced');
+            }
+            // Register health check
+            registry.registerHealthCheck({
+                name: 'usage-store',
+                type: 'custom',
+                check: async () => {
+                    try {
+                        // Simple health check
+                        return { healthy: true };
+                    }
+                    catch {
+                        return { healthy: false };
+                    }
+                },
+            });
+            // Run cleanup on startup if configured
+            if (config.cleanup?.runOnStartup) {
+                const dailyDays = config.cleanup.dailyRetentionDays || 90;
+                const monthlyMonths = config.cleanup.monthlyRetentionMonths || 24;
+                const dailyDeleted = await config.store.cleanupOldDaily(dailyDays);
+                const monthlyDeleted = await config.store.cleanupOldMonthly(monthlyMonths);
+                log('Startup cleanup complete', { dailyDeleted, monthlyDeleted });
+            }
+            // Set up periodic cleanup if configured
+            if (config.cleanup?.cleanupIntervalHours && config.cleanup.cleanupIntervalHours > 0) {
+                const intervalMs = config.cleanup.cleanupIntervalHours * 60 * 60 * 1000;
+                cleanupIntervalId = setInterval(async () => {
+                    try {
+                        const dailyDays = config.cleanup?.dailyRetentionDays || 90;
+                        const monthlyMonths = config.cleanup?.monthlyRetentionMonths || 24;
+                        const dailyDeleted = await config.store.cleanupOldDaily(dailyDays);
+                        const monthlyDeleted = await config.store.cleanupOldMonthly(monthlyMonths);
+                        log('Periodic cleanup complete', { dailyDeleted, monthlyDeleted });
+                    }
+                    catch (error) {
+                        console.error('[UsagePlugin] Cleanup error:', error);
+                    }
+                }, intervalMs);
+            }
+            // Add API routes if enabled
+            if (config.api?.enabled !== false) {
+                // Get daily usage summary
+                registry.addRoute({
+                    method: 'get',
+                    path: `${apiPrefix}/user/:userId/daily`,
+                    pluginId: 'usage',
+                    handler: async (req, res) => {
+                        try {
+                            const { userId } = req.params;
+                            const date = req.query.date || getCurrentDate();
+                            const summary = await getDailyUsageSummary(userId, date);
+                            res.json(summary);
+                        }
+                        catch (error) {
+                            console.error('[UsagePlugin] Get daily usage error:', error);
+                            res.status(500).json({ error: 'Failed to get daily usage' });
+                        }
+                    },
+                });
+                // Get usage for a specific feature
+                registry.addRoute({
+                    method: 'get',
+                    path: `${apiPrefix}/user/:userId/feature/:featureCode`,
+                    pluginId: 'usage',
+                    handler: async (req, res) => {
+                        try {
+                            const { userId, featureCode } = req.params;
+                            const status = await getFeatureUsageStatus(userId, featureCode);
+                            res.json(status);
+                        }
+                        catch (error) {
+                            console.error('[UsagePlugin] Get feature usage error:', error);
+                            res.status(500).json({ error: 'Failed to get feature usage' });
+                        }
+                    },
+                });
+                // Increment usage (with limit check)
+                registry.addRoute({
+                    method: 'post',
+                    path: `${apiPrefix}/user/:userId/feature/:featureCode/increment`,
+                    pluginId: 'usage',
+                    handler: async (req, res) => {
+                        try {
+                            const { userId, featureCode } = req.params;
+                            const amount = parseInt(req.body.amount) || 1;
+                            const result = await incrementUsage(userId, featureCode, amount);
+                            res.json(result);
+                        }
+                        catch (error) {
+                            console.error('[UsagePlugin] Increment usage error:', error);
+                            res.status(500).json({ error: 'Failed to increment usage' });
+                        }
+                    },
+                });
+                // Check if usage is within limit (without incrementing)
+                registry.addRoute({
+                    method: 'get',
+                    path: `${apiPrefix}/user/:userId/feature/:featureCode/check`,
+                    pluginId: 'usage',
+                    handler: async (req, res) => {
+                        try {
+                            const { userId, featureCode } = req.params;
+                            const amount = parseInt(req.query.amount) || 1;
+                            const result = await checkUsageLimit(userId, featureCode, amount);
+                            res.json(result);
+                        }
+                        catch (error) {
+                            console.error('[UsagePlugin] Check usage error:', error);
+                            res.status(500).json({ error: 'Failed to check usage' });
+                        }
+                    },
+                });
+            }
+            log('Usage plugin started');
+        },
+        async onStop() {
+            log('Stopping usage plugin');
+            // Clear cleanup interval
+            if (cleanupIntervalId) {
+                clearInterval(cleanupIntervalId);
+                cleanupIntervalId = null;
+            }
+            await config.store.shutdown();
+            currentStore = null;
+            currentConfig = null;
+            log('Usage plugin stopped');
+        },
+    };
+}
+// ═══════════════════════════════════════════════════════════════════════════
+// Helper Functions
+// ═══════════════════════════════════════════════════════════════════════════
+/**
+ * Get the current usage store instance
+ */
+export function getUsageStore() {
+    return currentStore;
+}
+/**
+ * Get current daily usage for a feature
+ */
+export async function getDailyUsage(userId, featureCode) {
+    if (!currentStore) {
+        throw new Error('Usage plugin not initialized');
+    }
+    const usage = await currentStore.getDailyUsage(userId, featureCode);
+    return usage?.count || 0;
+}
+/**
+ * Increment usage and check limit
+ */
+export async function incrementUsage(userId, featureCode, amount = 1) {
+    if (!currentStore) {
+        throw new Error('Usage plugin not initialized');
+    }
+    // Get current usage
+    const currentUsage = await getDailyUsage(userId, featureCode);
+    // Get limit from subscriptions plugin
+    let limit = null;
+    if (getFeatureLimitFn) {
+        limit = await getFeatureLimitFn(userId, featureCode);
+    }
+    // Check if increment is allowed
+    // limit = -1 means unlimited, null means no subscription/feature disabled
+    if (limit === null) {
+        return {
+            allowed: false,
+            current_count: currentUsage,
+            limit: null,
+            remaining: null,
+            reason: 'Feature not available in your subscription',
+        };
+    }
+    if (limit === 0) {
+        return {
+            allowed: false,
+            current_count: currentUsage,
+            limit: 0,
+            remaining: 0,
+            reason: 'Feature is disabled',
+        };
+    }
+    // Check if within limit (-1 = unlimited)
+    if (limit !== -1 && currentUsage + amount > limit) {
+        return {
+            allowed: false,
+            current_count: currentUsage,
+            limit,
+            remaining: Math.max(0, limit - currentUsage),
+            resets_at: getTomorrowMidnight(),
+            reason: 'Daily limit reached',
+        };
+    }
+    // Increment usage
+    const newCount = await currentStore.incrementDaily(userId, featureCode, amount);
+    return {
+        allowed: true,
+        current_count: newCount,
+        limit,
+        remaining: limit === -1 ? -1 : Math.max(0, limit - newCount),
+        resets_at: getTomorrowMidnight(),
+    };
+}
+/**
+ * Check if usage is within limit (without incrementing)
+ */
+export async function checkUsageLimit(userId, featureCode, amount = 1) {
+    if (!currentStore) {
+        throw new Error('Usage plugin not initialized');
+    }
+    const currentUsage = await getDailyUsage(userId, featureCode);
+    // Get limit from subscriptions plugin
+    let limit = null;
+    if (getFeatureLimitFn) {
+        limit = await getFeatureLimitFn(userId, featureCode);
+    }
+    if (limit === null) {
+        return {
+            allowed: false,
+            current_count: currentUsage,
+            limit: null,
+            remaining: null,
+            reason: 'Feature not available in your subscription',
+        };
+    }
+    if (limit === 0) {
+        return {
+            allowed: false,
+            current_count: currentUsage,
+            limit: 0,
+            remaining: 0,
+            reason: 'Feature is disabled',
+        };
+    }
+    // Check if within limit
+    const wouldExceed = limit !== -1 && currentUsage + amount > limit;
+    return {
+        allowed: !wouldExceed,
+        current_count: currentUsage,
+        limit,
+        remaining: limit === -1 ? -1 : Math.max(0, limit - currentUsage),
+        resets_at: getTomorrowMidnight(),
+        reason: wouldExceed ? 'Would exceed daily limit' : undefined,
+    };
+}
+/**
+ * Get usage status for a specific feature
+ */
+export async function getFeatureUsageStatus(userId, featureCode) {
+    if (!currentStore) {
+        throw new Error('Usage plugin not initialized');
+    }
+    const currentUsage = await getDailyUsage(userId, featureCode);
+    // Get limit from subscriptions plugin
+    let limit = null;
+    if (getFeatureLimitFn) {
+        limit = await getFeatureLimitFn(userId, featureCode);
+    }
+    let remaining = null;
+    let percentageUsed = null;
+    if (limit !== null) {
+        if (limit === -1) {
+            remaining = -1; // Unlimited
+        }
+        else if (limit > 0) {
+            remaining = Math.max(0, limit - currentUsage);
+            percentageUsed = Math.min(100, Math.round((currentUsage / limit) * 100));
+        }
+        else {
+            remaining = 0;
+            percentageUsed = 100;
+        }
+    }
+    return {
+        feature_code: featureCode,
+        current: currentUsage,
+        limit,
+        remaining,
+        resets_at: getTomorrowMidnight(),
+        percentage_used: percentageUsed,
+    };
+}
+/**
+ * Get daily usage summary for all features
+ */
+export async function getDailyUsageSummary(userId, date) {
+    if (!currentStore) {
+        throw new Error('Usage plugin not initialized');
+    }
+    const targetDate = date || getCurrentDate();
+    const dailyUsages = await currentStore.getAllDailyUsage(userId, targetDate);
+    // Get status for each feature
+    const features = await Promise.all(dailyUsages.map(async (usage) => {
+        let limit = null;
+        if (getFeatureLimitFn) {
+            limit = await getFeatureLimitFn(userId, usage.feature_code);
+        }
+        let remaining = null;
+        let percentageUsed = null;
+        if (limit !== null) {
+            if (limit === -1) {
+                remaining = -1;
+            }
+            else if (limit > 0) {
+                remaining = Math.max(0, limit - usage.count);
+                percentageUsed = Math.min(100, Math.round((usage.count / limit) * 100));
+            }
+            else {
+                remaining = 0;
+                percentageUsed = 100;
+            }
+        }
+        return {
+            feature_code: usage.feature_code,
+            current: usage.count,
+            limit,
+            remaining,
+            resets_at: getTomorrowMidnight(),
+            percentage_used: percentageUsed,
+        };
+    }));
+    return {
+        user_id: userId,
+        period: 'daily',
+        period_value: targetDate,
+        features,
+    };
+}
+/**
+ * Reset usage for a feature (admin function)
+ */
+export async function resetUsage(userId, featureCode) {
+    if (!currentStore) {
+        throw new Error('Usage plugin not initialized');
+    }
+    await currentStore.resetDailyUsage(userId, featureCode);
+}
+/**
+ * Get remaining quota for a feature
+ */
+export async function getRemainingQuota(userId, featureCode) {
+    const status = await getFeatureUsageStatus(userId, featureCode);
+    return status.remaining;
+}
+/**
+ * Check if user can use a feature (has remaining quota)
+ */
+export async function canUseFeature(userId, featureCode, amount = 1) {
+    const result = await checkUsageLimit(userId, featureCode, amount);
+    return result.allowed;
+}
+//# sourceMappingURL=usage-plugin.js.map

package/dist/plugins/usage/usage-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-plugin.js","sourceRoot":"","sources":["../../../src/plugins/usage/usage-plugin.ts"],"names":[],"mappings":"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"}

package/dist/plugins/users/__tests__/postgres-store.test.d.ts

@@ -0,0 +1,10 @@
+/**
+ * PostgreSQL User Store Tests
+ *
+ * Unit tests for the PostgreSQL user store implementation,
+ * focusing on getByIdentifier() and linkIdentifiers() methods.
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+export {};
+//# sourceMappingURL=postgres-store.test.d.ts.map

package/dist/plugins/users/__tests__/postgres-store.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-store.test.d.ts","sourceRoot":"","sources":["../../../../src/plugins/users/__tests__/postgres-store.test.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/plugins/users/__tests__/postgres-store.test.js

@@ -0,0 +1,229 @@
+/**
+ * PostgreSQL User Store Tests
+ *
+ * Unit tests for the PostgreSQL user store implementation,
+ * focusing on getByIdentifier() and linkIdentifiers() methods.
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { postgresUserStore } from '../stores/postgres-store.js';
+// Mock user data
+const mockUser = {
+    id: 'test-user-id-123',
+    email: 'test@example.com',
+    name: 'Test User',
+    external_id: 'auth0|abc123',
+    provider: 'auth0',
+    picture: 'https://example.com/avatar.jpg',
+    metadata: {
+        identifiers: {
+            auth0_user_id: 'auth0|abc123',
+            wp_user_id: 42,
+            keap_contact_id: 12345,
+        },
+    },
+    created_at: new Date('2025-01-01'),
+    updated_at: new Date('2025-01-01'),
+    last_login_at: new Date('2025-12-13'),
+};
+// Mock pg pool
+const createMockPool = () => {
+    const mockQuery = vi.fn();
+    return {
+        query: mockQuery,
+        _mockQuery: mockQuery, // Expose for test assertions
+    };
+};
+describe('PostgreSQL User Store', () => {
+    let mockPool;
+    let store;
+    beforeEach(() => {
+        mockPool = createMockPool();
+        store = postgresUserStore({
+            pool: mockPool,
+            autoCreateTables: false, // Skip table creation in tests
+        });
+    });
+    describe('getByIdentifier()', () => {
+        it('should throw error when no identifier is provided (UT-001)', async () => {
+            const emptyIdentifiers = {};
+            await expect(store.getByIdentifier(emptyIdentifiers)).rejects.toThrow('At least one identifier must be provided');
+            // Should not make any DB queries
+            expect(mockPool._mockQuery).not.toHaveBeenCalled();
+        });
+        it('should find user by email first (priority 1) (UT-002)', async () => {
+            mockPool._mockQuery.mockResolvedValueOnce({ rows: [mockUser] });
+            const identifiers = {
+                email: 'test@example.com',
+                auth0_user_id: 'auth0|abc123',
+                wp_user_id: 42,
+            };
+            const result = await store.getByIdentifier(identifiers);
+            expect(result).toEqual(mockUser);
+            expect(mockPool._mockQuery).toHaveBeenCalledTimes(1);
+            expect(mockPool._mockQuery).toHaveBeenCalledWith(expect.stringContaining('LOWER(email) = LOWER($1)'), ['test@example.com']);
+        });
+        it('should find user by auth0_user_id if email not found (priority 2) (UT-003)', async () => {
+            // Email query returns no results
+            mockPool._mockQuery.mockResolvedValueOnce({ rows: [] });
+            // auth0_user_id query in metadata returns user
+            mockPool._mockQuery.mockResolvedValueOnce({ rows: [mockUser] });
+            const identifiers = {
+                email: 'nonexistent@example.com',
+                auth0_user_id: 'auth0|abc123',
+            };
+            const result = await store.getByIdentifier(identifiers);
+            expect(result).toEqual(mockUser);
+            expect(mockPool._mockQuery).toHaveBeenCalledTimes(2);
+            expect(mockPool._mockQuery).toHaveBeenNthCalledWith(2, expect.stringContaining("metadata->'identifiers'->>'auth0_user_id'"), ['auth0|abc123']);
+        });
+        it('should check legacy external_id for auth0 users (UT-004)', async () => {
+            // No email provided, so skip email check
+            // auth0_user_id in metadata returns no results
+            mockPool._mockQuery.mockResolvedValueOnce({ rows: [] });
+            // Legacy external_id query returns user
+            mockPool._mockQuery.mockResolvedValueOnce({ rows: [mockUser] });
+            const identifiers = {
+                auth0_user_id: 'auth0|abc123',
+            };
+            const result = await store.getByIdentifier(identifiers);
+            expect(result).toEqual(mockUser);
+            expect(mockPool._mockQuery).toHaveBeenCalledTimes(2);
+            expect(mockPool._mockQuery).toHaveBeenNthCalledWith(2, expect.stringContaining('external_id = $1'), ['auth0|abc123']);
+        });
+        it('should find user by wp_user_id (priority 3) (UT-005)', async () => {
+            // All higher priority queries return no results
+            mockPool._mockQuery.mockResolvedValueOnce({ rows: [] }); // email
+            mockPool._mockQuery.mockResolvedValueOnce({ rows: [] }); // auth0 metadata
+            mockPool._mockQuery.mockResolvedValueOnce({ rows: [] }); // auth0 external_id
+            mockPool._mockQuery.mockResolvedValueOnce({ rows: [mockUser] }); // wp_user_id
+            const identifiers = {
+                email: 'nonexistent@example.com',
+                auth0_user_id: 'auth0|xyz',
+                wp_user_id: 42,
+            };
+            const result = await store.getByIdentifier(identifiers);
+            expect(result).toEqual(mockUser);
+            expect(mockPool._mockQuery).toHaveBeenNthCalledWith(4, expect.stringContaining("(metadata->'identifiers'->>'wp_user_id')::int"), [42]);
+        });
+        it('should find user by keap_contact_id (priority 4) (UT-006)', async () => {
+            // All higher priority queries return no results
+            mockPool._mockQuery.mockResolvedValueOnce({ rows: [] }); // wp_user_id
+            mockPool._mockQuery.mockResolvedValueOnce({ rows: [mockUser] }); // keap_contact_id
+            const identifiers = {
+                wp_user_id: 999,
+                keap_contact_id: 12345,
+            };
+            const result = await store.getByIdentifier(identifiers);
+            expect(result).toEqual(mockUser);
+            expect(mockPool._mockQuery).toHaveBeenNthCalledWith(2, expect.stringContaining("(metadata->'identifiers'->>'keap_contact_id')::int"), [12345]);
+        });
+        it('should return null if no user found by any identifier (UT-007)', async () => {
+            // All queries return no results
+            mockPool._mockQuery.mockResolvedValue({ rows: [] });
+            const identifiers = {
+                email: 'nonexistent@example.com',
+                auth0_user_id: 'auth0|nonexistent',
+                wp_user_id: 99999,
+                keap_contact_id: 99999,
+            };
+            const result = await store.getByIdentifier(identifiers);
+            expect(result).toBeNull();
+        });
+        it('should handle wp_user_id of 0 as valid identifier (UT-008)', async () => {
+            // Only wp_user_id provided (no email or auth0_user_id)
+            // So only 1 query for wp_user_id should be made
+            mockPool._mockQuery.mockResolvedValueOnce({ rows: [mockUser] });
+            const identifiers = {
+                wp_user_id: 0,
+            };
+            const result = await store.getByIdentifier(identifiers);
+            expect(result).toEqual(mockUser);
+            expect(mockPool._mockQuery).toHaveBeenCalledTimes(1);
+            expect(mockPool._mockQuery).toHaveBeenCalledWith(expect.stringContaining("(metadata->'identifiers'->>'wp_user_id')::int"), [0]);
+        });
+        it('should handle keap_contact_id of 0 as valid identifier (UT-009)', async () => {
+            // Only keap_contact_id provided (no email, auth0_user_id, or wp_user_id)
+            // So only 1 query for keap_contact_id should be made
+            mockPool._mockQuery.mockResolvedValueOnce({ rows: [mockUser] });
+            const identifiers = {
+                keap_contact_id: 0,
+            };
+            const result = await store.getByIdentifier(identifiers);
+            expect(result).toEqual(mockUser);
+            expect(mockPool._mockQuery).toHaveBeenCalledTimes(1);
+            expect(mockPool._mockQuery).toHaveBeenCalledWith(expect.stringContaining("(metadata->'identifiers'->>'keap_contact_id')::int"), [0]);
+        });
+    });
+    describe('linkIdentifiers()', () => {
+        it('should not make DB query when no identifiers provided (UT-010)', async () => {
+            await store.linkIdentifiers('user-123', {});
+            expect(mockPool._mockQuery).not.toHaveBeenCalled();
+        });
+        it('should update metadata with single identifier (UT-011)', async () => {
+            mockPool._mockQuery.mockResolvedValueOnce({ rows: [], rowCount: 1 });
+            await store.linkIdentifiers('user-123', {
+                wp_user_id: 42,
+            });
+            expect(mockPool._mockQuery).toHaveBeenCalledTimes(1);
+            expect(mockPool._mockQuery).toHaveBeenCalledWith(expect.stringContaining('jsonb_set'), [JSON.stringify({ wp_user_id: 42 }), 'user-123']);
+        });
+        it('should update metadata with multiple identifiers (UT-012)', async () => {
+            mockPool._mockQuery.mockResolvedValueOnce({ rows: [], rowCount: 1 });
+            await store.linkIdentifiers('user-123', {
+                wp_user_id: 42,
+                auth0_user_id: 'auth0|abc123',
+                keap_contact_id: 12345,
+            });
+            expect(mockPool._mockQuery).toHaveBeenCalledTimes(1);
+            const [, args] = mockPool._mockQuery.mock.calls[0];
+            const identifiersJson = JSON.parse(args[0]);
+            expect(identifiersJson).toEqual({
+                wp_user_id: 42,
+                auth0_user_id: 'auth0|abc123',
+                keap_contact_id: 12345,
+            });
+            expect(args[1]).toBe('user-123');
+        });
+        it('should preserve existing identifiers (uses COALESCE) (UT-013)', async () => {
+            mockPool._mockQuery.mockResolvedValueOnce({ rows: [], rowCount: 1 });
+            await store.linkIdentifiers('user-123', {
+                wp_user_id: 42,
+            });
+            // Verify the query uses COALESCE to preserve existing values
+            expect(mockPool._mockQuery).toHaveBeenCalledWith(expect.stringContaining("COALESCE(metadata->'identifiers', '{}'::jsonb)"), expect.any(Array));
+        });
+        it('should handle undefined values correctly (UT-014)', async () => {
+            mockPool._mockQuery.mockResolvedValueOnce({ rows: [], rowCount: 1 });
+            await store.linkIdentifiers('user-123', {
+                wp_user_id: undefined,
+                auth0_user_id: 'auth0|abc123',
+                keap_contact_id: undefined,
+            });
+            expect(mockPool._mockQuery).toHaveBeenCalledTimes(1);
+            const [, args] = mockPool._mockQuery.mock.calls[0];
+            const identifiersJson = JSON.parse(args[0]);
+            // Should only include defined values
+            expect(identifiersJson).toEqual({
+                auth0_user_id: 'auth0|abc123',
+            });
+        });
+    });
+    describe('getByIds()', () => {
+        it('should return empty array for empty input (UT-015)', async () => {
+            const result = await store.getByIds([]);
+            expect(result).toEqual([]);
+            expect(mockPool._mockQuery).not.toHaveBeenCalled();
+        });
+        it('should batch query multiple users (UT-016)', async () => {
+            const mockUsers = [mockUser, { ...mockUser, id: 'user-2' }];
+            mockPool._mockQuery.mockResolvedValueOnce({ rows: mockUsers });
+            const result = await store.getByIds(['user-1', 'user-2']);
+            expect(result).toEqual(mockUsers);
+            expect(mockPool._mockQuery).toHaveBeenCalledTimes(1);
+            expect(mockPool._mockQuery).toHaveBeenCalledWith(expect.stringContaining('id = ANY($1)'), [['user-1', 'user-2']]);
+        });
+    });
+});
+//# sourceMappingURL=postgres-store.test.js.map