bunsane 0.3.1 → 0.4.0

package/tests/stress/cursor-perf-test.ts

@@ -1,171 +0,0 @@
-/**
- * Quick cursor pagination performance test
- * Run with: bun tests/stress/cursor-perf-test.ts
- */
-
-// Load env first
-import { file } from 'bun';
-const envTestPath = new URL('../../.env.test', import.meta.url).pathname.replace(/^\/([A-Z]:)/, '$1');
-const envFile = file(envTestPath);
-if (await envFile.exists()) {
-    const envContent = await envFile.text();
-    for (const line of envContent.split('\n')) {
-        const trimmed = line.trim();
-        if (trimmed && !trimmed.startsWith('#')) {
-            const [key, ...valueParts] = trimmed.split('=');
-            if (key) {
-                const value = valueParts.join('=');
-                process.env[key.trim()] = value.trim();
-            }
-        }
-    }
-}
-process.env.LOG_LEVEL = 'warn';
-
-import { Query } from '../../query/Query';
-import db from '../../database';
-import { PrepareDatabase, HasValidBaseTable } from '../../database/DatabaseHelper';
-import ApplicationLifecycle, { ApplicationPhase } from '../../core/ApplicationLifecycle';
-import EntityManager from '../../core/EntityManager';
-import { CacheManager } from '../../core/cache';
-import { StressUser } from './fixtures/StressTestComponents';
-import { ensureComponentsRegistered } from '../utils';
-
-async function init() {
-    // Verify database
-    await db`SELECT 1`;
-
-    // Ensure tables
-    if (!(await HasValidBaseTable())) {
-        await PrepareDatabase();
-    }
-
-    // Set app ready
-    ApplicationLifecycle.setPhase(ApplicationPhase.DATABASE_READY);
-    (EntityManager as any).dbReady = true;
-
-    // Init cache
-    await CacheManager.getInstance().initialize({
-        enabled: true,
-        provider: 'memory',
-        strategy: 'write-through',
-        defaultTTL: 3600000,
-        entity: { enabled: true, ttl: 3600000 },
-        component: { enabled: true, ttl: 1800000 },
-        query: { enabled: false, ttl: 300000, maxSize: 10000 }
-    });
-
-    // Ensure StressUser component is registered
-    await ensureComponentsRegistered(StressUser);
-}
-
-async function main() {
-    console.log('Initializing...');
-    await init();
-
-    // Get total count
-    const count = await new Query().with(StressUser).count();
-    console.log(`Total StressUser records: ${count}`);
-
-    if (count < 100) {
-        console.log('\nNot enough records for test.');
-        console.log('Run: STRESS_RECORD_COUNT=100000 bun test tests/stress --test-name-pattern "indexed"');
-        console.log('Then run this script again.');
-        process.exit(0);
-    }
-
-    const iterations = 10;
-
-    // Test 1: First page with offset 0
-    console.log('\n=== Offset-based pagination ===');
-    let times: number[] = [];
-    for (let i = 0; i < iterations; i++) {
-        const start = performance.now();
-        await new Query().with(StressUser).take(100).offset(0).exec();
-        times.push(performance.now() - start);
-    }
-    console.log(`Offset 0:       p50=${percentile(times, 50).toFixed(2)}ms, p95=${percentile(times, 95).toFixed(2)}ms`);
-
-    // Test 2: Offset at 50%
-    const midOffset = Math.floor(count / 2);
-    times = [];
-    for (let i = 0; i < iterations; i++) {
-        const start = performance.now();
-        await new Query().with(StressUser).take(100).offset(midOffset).exec();
-        times.push(performance.now() - start);
-    }
-    console.log(`Offset ${midOffset.toLocaleString().padStart(7)}:  p50=${percentile(times, 50).toFixed(2)}ms, p95=${percentile(times, 95).toFixed(2)}ms`);
-
-    // Test 3: Offset at 90%
-    const deepOffset = Math.floor(count * 0.9);
-    times = [];
-    for (let i = 0; i < iterations; i++) {
-        const start = performance.now();
-        await new Query().with(StressUser).take(100).offset(deepOffset).exec();
-        times.push(performance.now() - start);
-    }
-    console.log(`Offset ${deepOffset.toLocaleString().padStart(7)}:  p50=${percentile(times, 50).toFixed(2)}ms, p95=${percentile(times, 95).toFixed(2)}ms`);
-
-    // Get cursor IDs
-    const midResults = await new Query().with(StressUser).take(1).offset(midOffset).exec();
-    const midId = midResults[0]?.id;
-    const deepResults = await new Query().with(StressUser).take(1).offset(deepOffset).exec();
-    const deepId = deepResults[0]?.id;
-
-    if (!midId || !deepId) {
-        console.log('Could not get cursor IDs');
-        process.exit(1);
-    }
-
-    // Cursor tests
-    console.log('\n=== Cursor-based pagination ===');
-
-    // First page cursor (page 2)
-    const firstPage = await new Query().with(StressUser).take(100).exec();
-    const page1LastId = firstPage[firstPage.length - 1]?.id;
-
-    if (page1LastId) {
-        times = [];
-        for (let i = 0; i < iterations; i++) {
-            const start = performance.now();
-            await new Query().with(StressUser).cursor(page1LastId).take(100).exec();
-            times.push(performance.now() - start);
-        }
-        console.log(`Cursor page 2:  p50=${percentile(times, 50).toFixed(2)}ms, p95=${percentile(times, 95).toFixed(2)}ms`);
-    }
-
-    // Cursor from middle
-    times = [];
-    for (let i = 0; i < iterations; i++) {
-        const start = performance.now();
-        await new Query().with(StressUser).cursor(midId).take(100).exec();
-        times.push(performance.now() - start);
-    }
-    console.log(`Cursor @ 50%:   p50=${percentile(times, 50).toFixed(2)}ms, p95=${percentile(times, 95).toFixed(2)}ms`);
-
-    // Cursor from 90%
-    times = [];
-    for (let i = 0; i < iterations; i++) {
-        const start = performance.now();
-        await new Query().with(StressUser).cursor(deepId).take(100).exec();
-        times.push(performance.now() - start);
-    }
-    console.log(`Cursor @ 90%:   p50=${percentile(times, 50).toFixed(2)}ms, p95=${percentile(times, 95).toFixed(2)}ms`);
-
-    console.log('\n=== Summary ===');
-    console.log('Offset: O(offset) - gets slower as position increases');
-    console.log('Cursor: O(1) - consistent speed at any position');
-
-    process.exit(0);
-}
-
-function percentile(arr: number[], p: number): number {
-    const sorted = [...arr].sort((a, b) => a - b);
-    const idx = Math.ceil((p / 100) * sorted.length) - 1;
-    return sorted[Math.max(0, idx)] ?? 0;
-}
-
-main().catch(e => {
-    console.error(e);
-    process.exit(1);
-});

package/tests/stress/fixtures/RealisticComponents.ts

@@ -1,235 +0,0 @@
-/**
- * Realistic E-commerce Components for Stress Testing
- *
- * These components simulate a real-world e-commerce scenario with:
- * - Products with metadata
- * - Inventory tracking
- * - Pricing with discounts
- * - Vendor relationships
- * - Analytics/metrics
- */
-import { BaseComponent } from '../../../core/components/BaseComponent';
-import { Component, CompData } from '../../../core/components/Decorators';
-import { IndexedField } from '../../../core/decorators/IndexedField';
-
-/**
- * Product component - core product information
- */
-@Component
-export class Product extends BaseComponent {
-    @CompData({ indexed: true })
-    @IndexedField('btree')
-    name!: string;
-
-    @CompData({ indexed: true })
-    @IndexedField('btree')
-    sku!: string;
-
-    @CompData()
-    description!: string;
-
-    @CompData({ indexed: true })
-    @IndexedField('btree')
-    category!: string;
-
-    @CompData()
-    @IndexedField('btree')
-    subcategory!: string;
-
-    @CompData()
-    tags!: string[];
-
-    @CompData({ indexed: true })
-    @IndexedField('btree')
-    status!: 'active' | 'inactive' | 'discontinued' | 'pending';
-
-    @CompData()
-    @IndexedField('numeric')
-    rating!: number;
-
-    @CompData()
-    @IndexedField('numeric')
-    reviewCount!: number;
-
-    @CompData()
-    @IndexedField('btree', true)
-    createdAt!: Date;
-
-    @CompData()
-    @IndexedField('btree', true)
-    updatedAt!: Date;
-}
-
-/**
- * Inventory component - stock tracking
- */
-@Component
-export class Inventory extends BaseComponent {
-    @CompData()
-    @IndexedField('numeric')
-    quantity!: number;
-
-    @CompData()
-    @IndexedField('numeric')
-    reservedQuantity!: number;
-
-    @CompData()
-    @IndexedField('btree')
-    warehouseId!: string;
-
-    @CompData()
-    @IndexedField('numeric')
-    reorderPoint!: number;
-
-    @CompData()
-    @IndexedField('numeric')
-    maxStock!: number;
-
-    @CompData({ indexed: true })
-    @IndexedField('btree')
-    stockStatus!: 'in_stock' | 'low_stock' | 'out_of_stock' | 'backordered';
-
-    @CompData()
-    @IndexedField('btree', true)
-    lastRestocked!: Date;
-}
-
-/**
- * Pricing component - price and discount information
- */
-@Component
-export class Pricing extends BaseComponent {
-    @CompData()
-    @IndexedField('numeric')
-    basePrice!: number;
-
-    @CompData()
-    @IndexedField('numeric')
-    salePrice!: number;
-
-    @CompData()
-    @IndexedField('numeric')
-    costPrice!: number;
-
-    @CompData()
-    @IndexedField('btree')
-    currency!: string;
-
-    @CompData()
-    @IndexedField('numeric')
-    discountPercent!: number;
-
-    @CompData({ indexed: true })
-    @IndexedField('gin')
-    isOnSale!: boolean;
-
-    @CompData()
-    @IndexedField('btree', true)
-    saleStartDate!: Date | null;
-
-    @CompData()
-    @IndexedField('btree', true)
-    saleEndDate!: Date | null;
-
-    @CompData()
-    @IndexedField('numeric')
-    profit!: number;
-}
-
-/**
- * Vendor component - supplier/seller information
- */
-@Component
-export class Vendor extends BaseComponent {
-    @CompData({ indexed: true })
-    @IndexedField('btree')
-    vendorId!: string;
-
-    @CompData({ indexed: true })
-    @IndexedField('btree')
-    vendorName!: string;
-
-    @CompData()
-    @IndexedField('btree')
-    region!: string;
-
-    @CompData()
-    @IndexedField('numeric')
-    vendorRating!: number;
-
-    @CompData({ indexed: true })
-    @IndexedField('gin')
-    isVerified!: boolean;
-
-    @CompData()
-    @IndexedField('numeric')
-    totalSales!: number;
-
-    @CompData()
-    @IndexedField('btree')
-    tier!: 'bronze' | 'silver' | 'gold' | 'platinum';
-}
-
-/**
- * ProductMetrics component - analytics data
- */
-@Component
-export class ProductMetrics extends BaseComponent {
-    @CompData()
-    @IndexedField('numeric')
-    viewCount!: number;
-
-    @CompData()
-    @IndexedField('numeric')
-    purchaseCount!: number;
-
-    @CompData()
-    @IndexedField('numeric')
-    cartAddCount!: number;
-
-    @CompData()
-    @IndexedField('numeric')
-    wishlistCount!: number;
-
-    @CompData()
-    @IndexedField('numeric')
-    returnCount!: number;
-
-    @CompData()
-    @IndexedField('numeric')
-    conversionRate!: number;
-
-    @CompData()
-    @IndexedField('btree', true)
-    lastPurchased!: Date | null;
-
-    @CompData()
-    @IndexedField('btree')
-    popularityScore!: string;
-}
-
-// Categories for realistic data generation
-export const CATEGORIES = [
-    'Electronics', 'Clothing', 'Home & Garden', 'Sports', 'Books',
-    'Toys', 'Beauty', 'Automotive', 'Food', 'Health'
-] as const;
-
-export const SUBCATEGORIES: Record<string, string[]> = {
-    'Electronics': ['Smartphones', 'Laptops', 'Tablets', 'Accessories', 'Audio'],
-    'Clothing': ['Men', 'Women', 'Kids', 'Shoes', 'Accessories'],
-    'Home & Garden': ['Furniture', 'Decor', 'Kitchen', 'Garden', 'Bedding'],
-    'Sports': ['Fitness', 'Outdoor', 'Team Sports', 'Water Sports', 'Winter'],
-    'Books': ['Fiction', 'Non-Fiction', 'Technical', 'Children', 'Comics'],
-    'Toys': ['Action Figures', 'Board Games', 'Educational', 'Outdoor', 'Puzzles'],
-    'Beauty': ['Skincare', 'Makeup', 'Haircare', 'Fragrance', 'Tools'],
-    'Automotive': ['Parts', 'Accessories', 'Tools', 'Care', 'Electronics'],
-    'Food': ['Snacks', 'Beverages', 'Organic', 'International', 'Specialty'],
-    'Health': ['Vitamins', 'Supplements', 'Personal Care', 'Medical', 'Fitness']
-};
-
-export const REGIONS = ['North', 'South', 'East', 'West', 'Central', 'International'];
-export const WAREHOUSES = ['WH-001', 'WH-002', 'WH-003', 'WH-004', 'WH-005'];
-export const CURRENCIES = ['USD', 'EUR', 'GBP', 'JPY', 'CAD'];
-export const VENDOR_TIERS = ['bronze', 'silver', 'gold', 'platinum'] as const;
-export const PRODUCT_STATUSES = ['active', 'inactive', 'discontinued', 'pending'] as const;
-export const STOCK_STATUSES = ['in_stock', 'low_stock', 'out_of_stock', 'backordered'] as const;

package/tests/stress/fixtures/StressTestComponents.ts

@@ -1,58 +0,0 @@
-/**
- * Stress test components with indexed fields for benchmarking
- */
-import { BaseComponent } from '../../../core/components/BaseComponent';
-import { Component, CompData } from '../../../core/components/Decorators';
-import { IndexedField } from '../../../core/decorators/IndexedField';
-
-@Component
-export class StressUser extends BaseComponent {
-    @CompData({ indexed: true })
-    @IndexedField('btree')
-    name!: string;
-
-    @CompData({ indexed: true })
-    @IndexedField('btree')
-    email!: string;
-
-    @CompData()
-    @IndexedField('numeric')
-    age!: number;
-
-    @CompData()
-    @IndexedField('btree')
-    status!: string;
-
-    @CompData()
-    @IndexedField('numeric')
-    score!: number;
-
-    @CompData()
-    @IndexedField('btree', true)
-    createdAt!: Date;
-}
-
-@Component
-export class StressProfile extends BaseComponent {
-    @CompData()
-    bio!: string;
-
-    @CompData()
-    avatarUrl!: string;
-
-    @CompData()
-    @IndexedField('gin')
-    verified!: boolean;
-}
-
-@Component
-export class StressSettings extends BaseComponent {
-    @CompData()
-    theme!: string;
-
-    @CompData()
-    notifications!: boolean;
-
-    @CompData()
-    language!: string;
-}

package/tests/stress/index.ts

@@ -1,7 +0,0 @@
-/**
- * Stress testing module exports
- */
-export { DataSeeder, type SeederOptions, type SeederResult } from './DataSeeder';
-export { BenchmarkRunner, type BenchmarkResult, type BenchmarkOptions, type ConcurrentResult } from './BenchmarkRunner';
-export { StressTestReporter, type ReportMetadata } from './StressTestReporter';
-export { StressUser, StressProfile, StressSettings } from './fixtures/StressTestComponents';