@geekmidas/testkit 0.0.3 → 0.0.5

package/src/__tests__/integration.spec.ts

@@ -0,0 +1,442 @@
+import { beforeAll, describe, expect } from 'vitest';
+import { TEST_DATABASE_CONFIG } from '../../test/globalSetup';
+import { type TestDatabase, createTestTables } from '../../test/helpers';
+import { KyselyFactory } from '../KyselyFactory';
+import { createKyselyDb, wrapVitestKyselyTransaction } from '../helpers';
+
+const db = createKyselyDb<TestDatabase>(TEST_DATABASE_CONFIG);
+const it = wrapVitestKyselyTransaction<TestDatabase>(db, createTestTables);
+describe('Testkit Integration Tests', () => {
+  beforeAll(async () => {});
+  describe('Complex Factory Scenarios', () => {
+    it('should handle complex multi-table data creation', async ({ trx }) => {
+      // Create builders for all entities
+      const userBuilder = KyselyFactory.createBuilder<TestDatabase, 'users'>(
+        'users',
+        async (attrs) => ({
+          name: 'John Doe',
+          email: `user${Date.now()}-${Math.random()}@example.com`,
+          role: 'user' as const,
+          createdAt: new Date(),
+          updatedAt: new Date(),
+        }),
+      );
+
+      const postBuilder = KyselyFactory.createBuilder<TestDatabase, 'posts'>(
+        'posts',
+        async (attrs, factory) => {
+          // Create a user if no userId provided
+          if (!attrs.userId) {
+            const user = await factory.insert('user');
+            return {
+              title: 'Default Post Title',
+              content: 'Default post content...',
+              userId: user.id,
+              published: false,
+              createdAt: new Date(),
+              updatedAt: new Date(),
+            };
+          }
+          return {
+            title: 'Default Post Title',
+            content: 'Default post content...',
+            published: false,
+            createdAt: new Date(),
+            updatedAt: new Date(),
+          };
+        },
+      );
+
+      const commentBuilder = KyselyFactory.createBuilder<
+        TestDatabase,
+        'comments'
+      >('comments', async (attrs, factory) => {
+        let postId = attrs.postId;
+        let userId = attrs.userId;
+
+        // Create post if not provided
+        if (!postId) {
+          const post = await factory.insert('post');
+          postId = post.id;
+        }
+
+        // Create user if not provided
+        if (!userId) {
+          const user = await factory.insert('user');
+          userId = user.id;
+        }
+
+        return {
+          content: 'Default comment content',
+          postId,
+          userId,
+          createdAt: new Date(),
+        };
+      });
+
+      const builders = {
+        user: userBuilder,
+        post: postBuilder,
+        comment: commentBuilder,
+      };
+
+      const factory = new KyselyFactory<TestDatabase, typeof builders, {}>(
+        builders,
+        {},
+        trx,
+      );
+
+      // Create a complete blog structure
+      const author = await factory.insert('user', {
+        name: 'Jane Author',
+        email: 'jane@author.com',
+        role: 'admin',
+      });
+
+      const posts = await factory.insertMany(3, 'post', (idx) => ({
+        title: `Post ${idx + 1}`,
+        content: `Content for post ${idx + 1}`,
+        userId: author.id,
+        published: idx < 2, // First two posts are published
+      }));
+
+      // Create comments on the first post
+      const comments = await factory.insertMany(5, 'comment', (idx) => ({
+        content: `Comment ${idx + 1} on first post`,
+        postId: posts[0].id,
+      }));
+
+      // Verify the data structure
+      expect(author.name).toBe('Jane Author');
+      expect(author.role).toBe('admin');
+
+      expect(posts).toHaveLength(3);
+      expect(posts[0].title).toBe('Post 1');
+      expect(posts[0].published).toBe(true);
+      expect(posts[2].published).toBe(false);
+
+      expect(comments).toHaveLength(5);
+      comments.forEach((comment, idx) => {
+        expect(comment.content).toBe(`Comment ${idx + 1} on first post`);
+        expect(comment.postId).toBe(posts[0].id);
+      });
+
+      // Verify relationships in database
+      const authorPosts = await trx
+        .selectFrom('posts')
+        .selectAll()
+        .where('userId', '=', author.id)
+        .execute();
+
+      expect(authorPosts).toHaveLength(3);
+
+      const firstPostComments = await trx
+        .selectFrom('comments')
+        .selectAll()
+        .where('postId', '=', posts[0].id)
+        .execute();
+
+      expect(firstPostComments).toHaveLength(5);
+    });
+
+    it('should handle seeds for complex scenarios', async ({ trx }) => {
+      const c = await trx
+        .selectFrom('users')
+        .select(trx.fn.count('id').as('count'))
+        .executeTakeFirst();
+
+      const userBuilder = KyselyFactory.createBuilder<TestDatabase, 'users'>(
+        'users',
+        async (attrs) => ({
+          name: 'Default User',
+          email: `user${Date.now()}-${Math.random()}@example.com`,
+          role: 'user' as const,
+          createdAt: new Date(),
+          updatedAt: new Date(),
+        }),
+      );
+
+      const postBuilder = KyselyFactory.createBuilder<TestDatabase, 'posts'>(
+        'posts',
+        async (attrs, factory) => {
+          if (!attrs.userId) {
+            const user = await factory.insert('user');
+            return {
+              title: 'Default Post',
+              content: 'Default content',
+              userId: user.id,
+              published: false,
+              createdAt: new Date(),
+              updatedAt: new Date(),
+            };
+          }
+          return {
+            title: 'Default Post',
+            content: 'Default content',
+            published: false,
+            createdAt: new Date(),
+            updatedAt: new Date(),
+          };
+        },
+      );
+
+      const builders = {
+        user: userBuilder,
+        post: postBuilder,
+      };
+
+      // Create complex seeds
+      const seeds = {
+        blogWithAdminAndPosts: KyselyFactory.createSeed(
+          async (attrs: { postCount?: number }, factory: any, db: any) => {
+            // Create admin user
+            const admin = await factory.insert('user', {
+              name: 'Blog Admin',
+              email: 'admin@blog.com',
+              role: 'admin',
+            });
+
+            // Create multiple posts
+            const postCount = attrs.postCount || 3;
+            const posts = await factory.insertMany(
+              postCount,
+              'post',
+              (idx) => ({
+                title: `Admin Post ${idx + 1}`,
+                content: `Content for admin post ${idx + 1}`,
+                userId: admin.id,
+                published: true,
+              }),
+            );
+
+            return {
+              admin,
+              posts,
+              summary: {
+                adminId: admin.id,
+                postIds: posts.map((p) => p.id),
+                totalPosts: posts.length,
+              },
+            };
+          },
+        ),
+
+        usersWithPosts: KyselyFactory.createSeed(
+          async (
+            attrs: { userCount?: number; postsPerUser?: number },
+            factory: any,
+            db: any,
+          ) => {
+            const userCount = attrs.userCount || 2;
+            const postsPerUser = attrs.postsPerUser || 2;
+
+            const results: Array<{ user: any; posts: any[] }> = [];
+
+            for (let i = 0; i < userCount; i++) {
+              const user = await factory.insert('user', {
+                name: `User ${i + 1}`,
+                email: `user${i + 1}@example.com`,
+              });
+
+              const posts = await factory.insertMany(
+                postsPerUser,
+                'post',
+                (postIdx) => ({
+                  title: `User ${i + 1} Post ${postIdx + 1}`,
+                  content: `Content from user ${i + 1}, post ${postIdx + 1}`,
+                  userId: user.id,
+                  published: postIdx === 0, // Only first post is published
+                }),
+              );
+
+              results.push({ user, posts });
+            }
+
+            return results;
+          },
+        ),
+      };
+
+      const factory = new KyselyFactory<
+        TestDatabase,
+        typeof builders,
+        typeof seeds
+      >(builders, seeds, trx);
+
+      // Test first seed
+      const blogData = await factory.seed('blogWithAdminAndPosts', {
+        postCount: 5,
+      });
+
+      expect(blogData.admin.name).toBe('Blog Admin');
+      expect(blogData.admin.role).toBe('admin');
+      expect(blogData.posts).toHaveLength(5);
+      expect(blogData.summary.totalPosts).toBe(5);
+
+      // Test second seed
+      const userData = await factory.seed('usersWithPosts', {
+        userCount: 3,
+        postsPerUser: 4,
+      });
+
+      expect(userData).toHaveLength(3);
+
+      // Verify total counts in database
+      const totalUsers = await trx
+        .selectFrom('users')
+        .select(trx.fn.count('id').as('count'))
+        .executeTakeFirst();
+
+      const totalPosts = await trx
+        .selectFrom('posts')
+        .select(trx.fn.count('id').as('count'))
+        .executeTakeFirst();
+
+      // 1 admin + 3 users = 4 total users
+      expect(Number(totalUsers?.count)).toBe(4);
+      // 5 admin posts + (3 users * 4 posts) = 17 total posts
+      expect(Number(totalPosts?.count)).toBe(17);
+    });
+
+    it('should handle transaction isolation properly', async ({ trx }) => {
+      const userBuilder = KyselyFactory.createBuilder<TestDatabase, 'users'>(
+        'users',
+        async (attrs, factory, db, faker) => ({
+          name: 'Test User',
+          email: faker.internet.email(),
+          role: 'user' as const,
+          createdAt: new Date(),
+          updatedAt: new Date(),
+        }),
+      );
+
+      const builders = { user: userBuilder };
+
+      const factory1 = new KyselyFactory<TestDatabase, typeof builders, {}>(
+        builders,
+        {},
+        trx,
+      );
+
+      // Create user in transaction
+      const user = await factory1.insert('user', {
+        name: 'Transaction User',
+        email: 'transaction@test.com',
+      });
+
+      // Verify user exists in transaction
+      const userInTrx = await trx
+        .selectFrom('users')
+        .selectAll()
+        .where('id', '=', user.id)
+        .executeTakeFirst();
+
+      expect(userInTrx).toBeDefined();
+      expect(userInTrx?.name).toBe('Transaction User');
+    });
+  });
+
+  describe('Performance and Edge Cases', () => {
+    it('should handle creating many records efficiently', async ({ trx }) => {
+      const userBuilder = KyselyFactory.createBuilder<TestDatabase, 'users'>(
+        'users',
+        async (attrs, factory, db, faker) => ({
+          name: `User ${Math.random()}`,
+          email: faker.internet.email().toLowerCase(),
+          role: 'user' as const,
+          createdAt: new Date(),
+          updatedAt: new Date(),
+        }),
+      );
+
+      const builders = { user: userBuilder };
+      const factory = new KyselyFactory<TestDatabase, typeof builders, {}>(
+        builders,
+        {},
+        trx,
+      );
+
+      const startTime = Date.now();
+
+      // Create 100 users
+      const users = await factory.insertMany(100, 'user');
+
+      const endTime = Date.now();
+      const duration = endTime - startTime;
+
+      expect(users).toHaveLength(100);
+      expect(duration).toBeLessThan(5000); // Should complete in under 5 seconds
+
+      // Verify all users are unique
+      const emails = users.map((u) => u.email);
+      const uniqueEmails = new Set(emails);
+      expect(uniqueEmails.size).toBe(100);
+    });
+
+    it('should handle complex attribute generation', async ({ trx }) => {
+      const userBuilder = KyselyFactory.createBuilder<TestDatabase, 'users'>(
+        'users',
+        async (attrs, factory, db, faker) => {
+          return {
+            name: `Generated User ${attrs.id}`,
+            email: faker.internet.email().toLowerCase(),
+            role: 'user',
+          };
+        },
+      );
+
+      const postBuilder = KyselyFactory.createBuilder<TestDatabase, 'posts'>(
+        'posts',
+        async (attrs, factory) => {
+          let userId = attrs.userId;
+          if (!userId) {
+            const user = await factory.insert('user');
+            userId = user.id;
+          }
+
+          return {
+            title: `Auto-generated Post`,
+            content: `This is auto-generated content for post. Lorem ipsum dolor sit amet.`,
+            published: true,
+            userId,
+            createdAt: new Date(),
+            updatedAt: new Date(),
+          };
+        },
+      );
+
+      const builders = {
+        user: userBuilder,
+        post: postBuilder,
+      };
+
+      const factory = new KyselyFactory<TestDatabase, typeof builders, {}>(
+        builders,
+        {},
+        trx,
+      );
+
+      // Create posts which will auto-create users
+      const posts = await factory.insertMany(10, 'post', (i) => ({
+        published: i % 2 === 0,
+      }));
+
+      expect(posts).toHaveLength(10);
+
+      // Check email normalization
+      const users = await trx.selectFrom('users').selectAll().execute();
+
+      users.forEach((user) => {
+        expect(user.email).toBe(user.email.toLowerCase());
+        expect(user.name).not.toMatch(/^\s|\s$/); // No leading/trailing spaces
+      });
+
+      // Check published pattern
+      const publishedPosts = posts.filter((p) => p.published);
+      const unpublishedPosts = posts.filter((p) => !p.published);
+
+      expect(publishedPosts).toHaveLength(5); // Every other post
+      expect(unpublishedPosts).toHaveLength(5);
+    });
+  });
+});

package/src/faker.ts

@@ -0,0 +1,112 @@
+import { faker as baseFaker } from '@faker-js/faker';
+
+// NOTE: This is a simple way to extend `faker` with additional methods
+
+/**
+ * Atomic counter implementation for thread-safe sequence generation
+ */
+class AtomicCounter {
+  private value: number;
+
+  constructor(initialValue = 0) {
+    this.value = initialValue;
+  }
+
+  increment(): number {
+    // In Node.js, JavaScript is single-threaded within the event loop,
+    // so this operation is already atomic. However, this class provides
+    // a cleaner abstraction and makes the intent explicit.
+    return ++this.value;
+  }
+
+  get(): number {
+    return this.value;
+  }
+
+  reset(value = 0): void {
+    this.value = value;
+  }
+}
+
+/**
+ * Sets the `insertedAt` and `updatedAt` to a random date in the past.
+ */
+export function timestamps(): Timestamps {
+  const createdAt = faker.date.past();
+  const updatedAt = faker.date.between({
+    from: createdAt,
+    to: new Date(),
+  });
+
+  createdAt.setMilliseconds(0);
+  updatedAt.setMilliseconds(0);
+
+  return { createdAt, updatedAt };
+}
+
+/**
+ * Returns a reverse domain name identifier.
+ */
+export function identifier(suffix?: string): string {
+  return [
+    faker.internet.domainSuffix(),
+    faker.internet.domainWord(),
+    suffix ? suffix : faker.internet.domainWord() + sequence('identifier'),
+  ].join('.');
+}
+
+// Atomic sequences for thread-safe counter generation
+const sequences = new Map<string, AtomicCounter>();
+
+export function sequence(name = 'default'): number {
+  if (!sequences.has(name)) {
+    sequences.set(name, new AtomicCounter());
+  }
+
+  const counter = sequences.get(name) as AtomicCounter;
+  return counter.increment();
+}
+
+/**
+ * Resets a sequence counter to a specific value (default: 0)
+ */
+export function resetSequence(name = 'default', value = 0): void {
+  if (sequences.has(name)) {
+    const counter = sequences.get(name) as AtomicCounter;
+    counter.reset(value);
+  } else {
+    sequences.set(name, new AtomicCounter(value));
+  }
+}
+
+/**
+ * Resets all sequence counters
+ */
+export function resetAllSequences(): void {
+  sequences.clear();
+}
+
+/**
+ * Returns a random price number.
+ */
+function price(): number {
+  return +faker.commerce.price();
+}
+
+export const faker = Object.freeze(
+  Object.assign({}, baseFaker, {
+    timestamps,
+    identifier,
+    sequence,
+    resetSequence,
+    resetAllSequences,
+    price,
+  }),
+);
+
+export type Timestamps = {
+  createdAt: Date;
+  updatedAt: Date;
+};
+
+export type FakerFactory = typeof faker;

package/src/helpers.ts

@@ -0,0 +1,28 @@
+import {
+  CamelCasePlugin,
+  Kysely,
+  PostgresDialect,
+  type Transaction,
+} from 'kysely';
+import pg from 'pg';
+import { VitestKyselyTransactionIsolator } from './VitestKyselyTransactionIsolator';
+import { IsolationLevel } from './VitestTransactionIsolator';
+
+export function wrapVitestKyselyTransaction<Database>(
+  db: Kysely<Database>,
+  setup?: (trx: Transaction<Database>) => Promise<void>,
+  level: IsolationLevel = IsolationLevel.REPEATABLE_READ,
+) {
+  const wrapper = new VitestKyselyTransactionIsolator<Database>();
+
+  return wrapper.wrapVitestWithTransaction(db, setup, level);
+}
+
+export function createKyselyDb<Database>(config: any): Kysely<Database> {
+  return new Kysely({
+    dialect: new PostgresDialect({
+      pool: new pg.Pool(config),
+    }),
+    plugins: [new CamelCasePlugin()],
+  });
+}

package/src/kysely.ts

@@ -1,2 +1,16 @@
+import type { Kysely, Transaction } from 'kysely';
+import { VitestKyselyTransactionIsolator } from './VitestKyselyTransactionIsolator';
+import { IsolationLevel } from './VitestTransactionIsolator';
+
 export { KyselyFactory } from './KyselyFactory';
 export { PostgresKyselyMigrator } from './PostgresKyselyMigrator';
+
+export function wrapVitestKyselyTransaction<Database>(
+  db: Kysely<Database>,
+  setup?: (trx: Transaction<Database>) => Promise<void>,
+  level: IsolationLevel = IsolationLevel.REPEATABLE_READ,
+) {
+  const wrapper = new VitestKyselyTransactionIsolator<Database>();
+
+  return wrapper.wrapVitestWithTransaction(db, setup, level);
+}

package/test/globalSetup.ts

@@ -1,20 +1,7 @@
-import fs from 'node:fs/promises';
-import path from 'node:path';
-import pg from 'pg';
-
-import {
-  CamelCasePlugin,
-  FileMigrationProvider,
-  Kysely,
-  PostgresDialect,
-} from 'kysely';
-
-import { PostgresKyselyMigrator } from '../src/PostgresKyselyMigrator';
+import { Client } from 'pg';
 
 const TEST_DATABASE_NAME = 'geekmidas_test';
 
-const logger = console;
-
 export const TEST_DATABASE_CONFIG = {
   host: 'localhost',
   port: 5432,
@@ -23,31 +10,45 @@ export const TEST_DATABASE_CONFIG = {
   database: TEST_DATABASE_NAME,
 };
 
-// password: get('Database.password').string(),
-//       user: get('Database.username').string(),
-//       database: get('Database.database').string(),
-//       host: get('Database.host').string(),
-//       port: get('Database.port').number().default(5432),
-
 export default async function globalSetup() {
-  const uri = `postgres://${TEST_DATABASE_CONFIG.user}:${TEST_DATABASE_CONFIG.password}@${TEST_DATABASE_CONFIG.host}:${TEST_DATABASE_CONFIG.port}/${TEST_DATABASE_CONFIG.database}`;
-
-  const migrationFolder = path.resolve(__dirname, './migrations');
-
-  const migrationProcessor = new PostgresKyselyMigrator({
-    uri,
-    db: new Kysely({
-      dialect: new PostgresDialect({
-        pool: new pg.Pool(TEST_DATABASE_CONFIG),
-      }),
-      plugins: [new CamelCasePlugin()],
-    }),
-    provider: new FileMigrationProvider({
-      fs,
-      path,
-      migrationFolder,
-    }),
-  });
-
-  return migrationProcessor.start();
+  const adminConfig = {
+    host: TEST_DATABASE_CONFIG.host,
+    port: TEST_DATABASE_CONFIG.port,
+    user: TEST_DATABASE_CONFIG.user,
+    password: TEST_DATABASE_CONFIG.password,
+    database: 'postgres', // Connect to default postgres database
+  };
+
+  const client = new Client(adminConfig);
+
+  try {
+    await client.connect();
+
+    // Check if test database exists
+    const result = await client.query(
+      `SELECT * FROM pg_catalog.pg_database WHERE datname = $1`,
+      [TEST_DATABASE_NAME],
+    );
+
+    // Create test database if it doesn't exist
+    if (result.rowCount === 0) {
+      await client.query(`CREATE DATABASE "${TEST_DATABASE_NAME}"`);
+    } else {
+    }
+  } finally {
+    await client.end();
+  }
+
+  // Return cleanup function that drops the database
+  return async () => {
+    const cleanupClient = new Client(adminConfig);
+    try {
+      await cleanupClient.connect();
+      await cleanupClient.query(
+        `DROP DATABASE IF EXISTS "${TEST_DATABASE_NAME}"`,
+      );
+    } finally {
+      await cleanupClient.end();
+    }
+  };
 }