@uniforge/testing 0.1.0-alpha.2

package/dist/database/index.d.ts

@@ -0,0 +1,399 @@
+import * as vitest from 'vitest';
+import { vi } from 'vitest';
+
+/**
+ * Mock PrismaClient for unit testing.
+ *
+ * Provides vi.fn() stubs for all Prisma model methods used in the codebase.
+ */
+declare function createMockPrismaClient(): {
+    shop: {
+        findUnique: vitest.Mock<(...args: any[]) => any>;
+        findFirst: vitest.Mock<(...args: any[]) => any>;
+        findMany: vitest.Mock<(...args: any[]) => any>;
+        create: vitest.Mock<(...args: any[]) => any>;
+        update: vitest.Mock<(...args: any[]) => any>;
+        upsert: vitest.Mock<(...args: any[]) => any>;
+        delete: vitest.Mock<(...args: any[]) => any>;
+        deleteMany: vitest.Mock<(...args: any[]) => any>;
+        count: vitest.Mock<(...args: any[]) => any>;
+    };
+    session: {
+        findUnique: vitest.Mock<(...args: any[]) => any>;
+        findFirst: vitest.Mock<(...args: any[]) => any>;
+        findMany: vitest.Mock<(...args: any[]) => any>;
+        create: vitest.Mock<(...args: any[]) => any>;
+        update: vitest.Mock<(...args: any[]) => any>;
+        upsert: vitest.Mock<(...args: any[]) => any>;
+        delete: vitest.Mock<(...args: any[]) => any>;
+        deleteMany: vitest.Mock<(...args: any[]) => any>;
+        count: vitest.Mock<(...args: any[]) => any>;
+    };
+    account: {
+        findUnique: vitest.Mock<(...args: any[]) => any>;
+        findFirst: vitest.Mock<(...args: any[]) => any>;
+        findMany: vitest.Mock<(...args: any[]) => any>;
+        create: vitest.Mock<(...args: any[]) => any>;
+        update: vitest.Mock<(...args: any[]) => any>;
+        upsert: vitest.Mock<(...args: any[]) => any>;
+        delete: vitest.Mock<(...args: any[]) => any>;
+        deleteMany: vitest.Mock<(...args: any[]) => any>;
+        count: vitest.Mock<(...args: any[]) => any>;
+    };
+    accountStore: {
+        findUnique: vitest.Mock<(...args: any[]) => any>;
+        findFirst: vitest.Mock<(...args: any[]) => any>;
+        findMany: vitest.Mock<(...args: any[]) => any>;
+        create: vitest.Mock<(...args: any[]) => any>;
+        update: vitest.Mock<(...args: any[]) => any>;
+        upsert: vitest.Mock<(...args: any[]) => any>;
+        delete: vitest.Mock<(...args: any[]) => any>;
+        deleteMany: vitest.Mock<(...args: any[]) => any>;
+        count: vitest.Mock<(...args: any[]) => any>;
+    };
+    accountMember: {
+        findUnique: vitest.Mock<(...args: any[]) => any>;
+        findFirst: vitest.Mock<(...args: any[]) => any>;
+        findMany: vitest.Mock<(...args: any[]) => any>;
+        create: vitest.Mock<(...args: any[]) => any>;
+        update: vitest.Mock<(...args: any[]) => any>;
+        upsert: vitest.Mock<(...args: any[]) => any>;
+        delete: vitest.Mock<(...args: any[]) => any>;
+        deleteMany: vitest.Mock<(...args: any[]) => any>;
+        count: vitest.Mock<(...args: any[]) => any>;
+    };
+    accountSharedSetting: {
+        findUnique: vitest.Mock<(...args: any[]) => any>;
+        findFirst: vitest.Mock<(...args: any[]) => any>;
+        findMany: vitest.Mock<(...args: any[]) => any>;
+        create: vitest.Mock<(...args: any[]) => any>;
+        update: vitest.Mock<(...args: any[]) => any>;
+        upsert: vitest.Mock<(...args: any[]) => any>;
+        delete: vitest.Mock<(...args: any[]) => any>;
+        deleteMany: vitest.Mock<(...args: any[]) => any>;
+        count: vitest.Mock<(...args: any[]) => any>;
+    };
+    $connect: vitest.Mock<(...args: any[]) => any>;
+    $disconnect: vitest.Mock<(...args: any[]) => any>;
+    $transaction: vitest.Mock<(...args: any[]) => any>;
+};
+type MockPrismaClient = ReturnType<typeof createMockPrismaClient>;
+
+/**
+ * Enhanced Mock PrismaClient with query recording.
+ *
+ * Wraps vi.fn() stubs with recording to track all queries made during tests.
+ */
+
+interface RecordedQuery {
+    model: string;
+    operation: string;
+    args: unknown;
+    timestamp: Date;
+}
+declare const MODEL_OPERATIONS: readonly ["findUnique", "findFirst", "findMany", "create", "update", "upsert", "delete", "deleteMany", "count"];
+type ModelOperation = (typeof MODEL_OPERATIONS)[number];
+type MockModel = Record<ModelOperation, ReturnType<typeof vi.fn>>;
+interface EnhancedMockPrismaClient {
+    shop: MockModel;
+    session: MockModel;
+    account: MockModel;
+    accountStore: MockModel;
+    accountMember: MockModel;
+    accountSharedSetting: MockModel;
+    $connect: ReturnType<typeof vi.fn>;
+    $disconnect: ReturnType<typeof vi.fn>;
+    $transaction: ReturnType<typeof vi.fn>;
+    _getQueries(): RecordedQuery[];
+    _getLastQuery(): RecordedQuery | undefined;
+    _getQueriesByModel(model: string): RecordedQuery[];
+    _getQueriesByOperation(operation: string): RecordedQuery[];
+    _clearQueries(): void;
+    _whenShopFindUnique(result: unknown): void;
+    _whenSessionFindUnique(result: unknown): void;
+    _whenAccountFindUnique(result: unknown): void;
+    _reset(): void;
+}
+declare function createEnhancedMockPrismaClient(): EnhancedMockPrismaClient;
+
+/**
+ * Data seeder for generating complete test data patterns.
+ *
+ * All data is generated in-memory with no database calls.
+ */
+interface ShopSeedOptions {
+    shopDomain?: string;
+    isInstalled?: boolean;
+    scopes?: string;
+    includeOfflineSession?: boolean;
+    includeOnlineSession?: boolean;
+    onlineUserId?: number;
+    accessToken?: string;
+}
+interface ShopSeedResult {
+    shop: {
+        shopDomain: string;
+        isInstalled: boolean;
+        installedAt: Date | null;
+        uninstalledAt: Date | null;
+        scopes: string;
+        shopifyPlan: string | null;
+        createdAt: Date;
+        updatedAt: Date;
+    };
+    offlineSession?: {
+        id: string;
+        shop: string;
+        state: string;
+        isOnline: boolean;
+        scope: string;
+        expires: Date | null;
+        accessToken: string;
+        createdAt: Date;
+        updatedAt: Date;
+    };
+    onlineSession?: {
+        id: string;
+        shop: string;
+        state: string;
+        isOnline: boolean;
+        scope: string;
+        expires: Date;
+        accessToken: string;
+        onlineAccessInfo: {
+            expiresIn: number;
+            associatedUserScope: string;
+            associatedUser: {
+                id: number;
+                firstName: string;
+                lastName: string;
+                email: string;
+                emailVerified: boolean;
+                accountOwner: boolean;
+                locale: string;
+                collaborator: boolean;
+            };
+        };
+        createdAt: Date;
+        updatedAt: Date;
+    };
+}
+interface BillingSeedOptions extends ShopSeedOptions {
+    planName?: string;
+    subscriptionStatus?: string;
+    trialDays?: number;
+}
+interface BillingSeedResult extends ShopSeedResult {
+    subscription: {
+        id: string;
+        shopDomain: string;
+        shopifySubscriptionId: string | null;
+        planName: string;
+        status: string;
+        currentPeriodEnd: Date | null;
+        trialEndsAt: Date | null;
+        confirmationUrl: string | null;
+        createdAt: Date;
+        updatedAt: Date;
+    };
+}
+interface MemberSeedOptions extends ShopSeedOptions {
+    members?: Array<{
+        userId?: number;
+        email?: string;
+        role?: string;
+    }>;
+}
+interface MemberSeedResult extends ShopSeedResult {
+    members: Array<{
+        id: string;
+        shopDomain: string;
+        userId: number;
+        email: string;
+        role: string;
+        customPermissions: string[] | null;
+        createdAt: Date;
+        updatedAt: Date;
+    }>;
+}
+interface AccountSeedOptions {
+    accountName?: string;
+    accountType?: string;
+    stores?: Array<{
+        shopDomain?: string;
+        storeName?: string;
+    }>;
+    members?: Array<{
+        email?: string;
+        role?: string;
+    }>;
+}
+interface AccountSeedResult {
+    account: {
+        id: string;
+        name: string;
+        type: string;
+        isActive: boolean;
+        createdAt: Date;
+        updatedAt: Date;
+    };
+    stores: Array<{
+        id: string;
+        accountId: string;
+        shopDomain: string;
+        storeName: string;
+        isActive: boolean;
+        isPrimary: boolean;
+        createdAt: Date;
+        updatedAt: Date;
+    }>;
+    members: Array<{
+        id: string;
+        accountId: string;
+        userEmail: string;
+        role: string;
+        allStoresAccess: boolean;
+        permissions: string[];
+        createdAt: Date;
+        updatedAt: Date;
+    }>;
+}
+declare class DataSeeder {
+    private shopResults;
+    private accountResults;
+    private shopCounter;
+    private userCounter;
+    seedShop(options?: ShopSeedOptions): ShopSeedResult;
+    seedShopWithBilling(options?: BillingSeedOptions): BillingSeedResult;
+    seedShopWithMembers(options?: MemberSeedOptions): MemberSeedResult;
+    seedAccount(options?: AccountSeedOptions): AccountSeedResult;
+    getAllShops(): ShopSeedResult['shop'][];
+    getAllSessions(): Array<NonNullable<ShopSeedResult['offlineSession']> | NonNullable<ShopSeedResult['onlineSession']>>;
+    reset(): void;
+}
+
+/**
+ * Fluent API for building complex test scenarios.
+ *
+ * Builds complete, interconnected test data with a chainable interface.
+ */
+interface TestScenario {
+    shops: Array<{
+        shopDomain: string;
+        isInstalled: boolean;
+        installedAt: Date | null;
+        uninstalledAt: Date | null;
+        scopes: string;
+        shopifyPlan: string | null;
+        createdAt: Date;
+        updatedAt: Date;
+    }>;
+    sessions: Array<{
+        id: string;
+        shop: string;
+        isOnline: boolean;
+        scope: string;
+        accessToken: string;
+        expires: Date | null;
+        createdAt: Date;
+        updatedAt: Date;
+    }>;
+    subscriptions: Array<{
+        id: string;
+        shopDomain: string;
+        planName: string;
+        status: string;
+        createdAt: Date;
+        updatedAt: Date;
+    }>;
+    members: Array<{
+        id: string;
+        shopDomain: string;
+        userId: number;
+        email: string;
+        role: string;
+        createdAt: Date;
+        updatedAt: Date;
+    }>;
+    accounts: Array<{
+        id: string;
+        name: string;
+        type: string;
+        isActive: boolean;
+        createdAt: Date;
+        updatedAt: Date;
+    }>;
+    stores: Array<{
+        id: string;
+        accountId: string;
+        shopDomain: string;
+        storeName: string;
+        createdAt: Date;
+        updatedAt: Date;
+    }>;
+    accountMembers: Array<{
+        id: string;
+        accountId: string;
+        userEmail: string;
+        role: string;
+        allStoresAccess: boolean;
+        permissions: string[];
+        createdAt: Date;
+        updatedAt: Date;
+    }>;
+    getShop(domain: string): TestScenario['shops'][0] | undefined;
+    getSessionsForShop(domain: string): TestScenario['sessions'];
+    getSubscription(shopDomain: string): TestScenario['subscriptions'][0] | undefined;
+    getMembersForShop(domain: string): TestScenario['members'];
+    getAccount(id: string): TestScenario['accounts'][0] | undefined;
+    getStoresForAccount(accountId: string): TestScenario['stores'];
+    getAccountMembers(accountId: string): TestScenario['accountMembers'];
+}
+declare class ScenarioBuilder {
+    private shops;
+    private sessions;
+    private subscriptions;
+    private scenarioMembers;
+    private scenarioAccounts;
+    private scenarioStores;
+    private scenarioAccountMembers;
+    private currentShopDomain;
+    private currentAccountId;
+    private shopCounter;
+    private userCounter;
+    static create(): ScenarioBuilder;
+    withShop(shopDomain?: string): this;
+    withOfflineSession(accessToken?: string): this;
+    withOnlineSession(userId?: number, accessToken?: string): this;
+    withSubscription(planName?: string, status?: string): this;
+    withMember(role?: string, email?: string, userId?: number): this;
+    withAccount(name?: string, type?: string): this;
+    withAccountStore(shopDomain?: string, storeName?: string): this;
+    withAccountMember(email?: string, role?: string): this;
+    build(): TestScenario;
+}
+
+/**
+ * Test database lifecycle manager.
+ *
+ * Manages setup/teardown of mock database state for test suites.
+ */
+
+interface TestDatabaseConfig {
+    databaseUrl?: string;
+    tables?: string[];
+}
+declare class TestDatabaseManager {
+    private client;
+    private ready;
+    private tables;
+    constructor(config?: TestDatabaseConfig);
+    setup(): Promise<void>;
+    teardown(): Promise<void>;
+    getClient(): EnhancedMockPrismaClient;
+    resetAll(): Promise<void>;
+    isReady(): boolean;
+    getTableNames(): string[];
+}
+
+export { type AccountSeedOptions, type AccountSeedResult, type BillingSeedOptions, type BillingSeedResult, DataSeeder, type EnhancedMockPrismaClient, type MemberSeedOptions, type MemberSeedResult, type MockPrismaClient, type RecordedQuery, ScenarioBuilder, type ShopSeedOptions, type ShopSeedResult, type TestDatabaseConfig, TestDatabaseManager, type TestScenario, createEnhancedMockPrismaClient, createMockPrismaClient };