queen-mq 0.1.5 → 0.2.0

package/examples/test-dashboard-api.js

@@ -1,200 +0,0 @@
-/**
- * Test script for the new Dashboard Status API endpoints
- * 
- * This script demonstrates all 5 new endpoints:
- * 1. GET /api/v1/status - Dashboard overview
- * 2. GET /api/v1/status/queues - List queues with stats
- * 3. GET /api/v1/status/queues/:queue - Queue detail
- * 4. GET /api/v1/status/queues/:queue/messages - Queue messages
- * 5. GET /api/v1/status/analytics - Advanced analytics
- */
-
-import { createQueenClient } from '../src/client/queenClient.js';
-
-const BASE_URL = process.env.QUEEN_URL || 'http://localhost:3000';
-
-// Create client
-const client = createQueenClient({ baseUrl: BASE_URL });
-
-// Helper to make GET requests
-async function get(path) {
-  const response = await fetch(`${BASE_URL}${path}`, {
-    method: 'GET',
-    headers: {
-      'Content-Type': 'application/json'
-    }
-  });
-  
-  if (!response.ok) {
-    const error = await response.text();
-    throw new Error(`HTTP ${response.status}: ${error}`);
-  }
-  
-  return await response.json();
-}
-
-// Helper to format JSON output
-function printJson(label, data) {
-  console.log(`\n${'='.repeat(80)}`);
-  console.log(`📊 ${label}`);
-  console.log('='.repeat(80));
-  console.log(JSON.stringify(data, null, 2));
-}
-
-async function runTests() {
-  console.log('🚀 Testing Queen Dashboard Status API\n');
-  
-  try {
-    // First, let's create some test data
-    console.log('📝 Setting up test data...');
-    
-    // Configure a test queue
-    await client.configure({
-      queue: 'dashboard-test-queue',
-      namespace: 'test-namespace',
-      task: 'test-task',
-      partitions: 3
-    });
-    
-    // Push some test messages
-    const messages = [];
-    for (let i = 0; i < 20; i++) {
-      messages.push({
-        queue: 'dashboard-test-queue',
-        partition: `partition-${i % 3}`,
-        payload: {
-          messageNumber: i,
-          timestamp: new Date().toISOString(),
-          data: `Test message ${i}`
-        }
-      });
-    }
-    
-    await client.pushBatch(messages);
-    console.log('✅ Created test queue with 20 messages\n');
-    
-    // Wait a bit for messages to be processed
-    await new Promise(resolve => setTimeout(resolve, 1000));
-    
-    // Test 1: Dashboard Status
-    console.log('🧪 Test 1: Dashboard Status (GET /api/v1/status)');
-    const status = await get('/api/v1/status');
-    printJson('Dashboard Status', {
-      timeRange: status.timeRange,
-      queuesCount: status.queues.length,
-      messages: status.messages,
-      leases: status.leases,
-      throughputSamples: status.throughput.length,
-      dlqTotal: status.deadLetterQueue.totalMessages
-    });
-    
-    // Test 2: Queues List
-    console.log('\n🧪 Test 2: List Queues (GET /api/v1/status/queues)');
-    const queues = await get('/api/v1/status/queues?limit=10');
-    printJson('Queues List', {
-      total: queues.pagination.total,
-      queues: queues.queues.map(q => ({
-        name: q.name,
-        namespace: q.namespace,
-        partitions: q.partitions,
-        pending: q.messages.pending,
-        completed: q.messages.completed
-      }))
-    });
-    
-    // Test 3: Queue Detail
-    console.log('\n🧪 Test 3: Queue Detail (GET /api/v1/status/queues/:queue)');
-    const queueDetail = await get('/api/v1/status/queues/dashboard-test-queue');
-    printJson('Queue Detail', {
-      queue: queueDetail.queue,
-      totals: queueDetail.totals,
-      partitionCount: queueDetail.partitions.length,
-      partitions: queueDetail.partitions.map(p => ({
-        name: p.name,
-        messages: p.messages,
-        cursor: p.cursor
-      }))
-    });
-    
-    // Test 4: Queue Messages
-    console.log('\n🧪 Test 4: Queue Messages (GET /api/v1/status/queues/:queue/messages)');
-    const messages_result = await get('/api/v1/status/queues/dashboard-test-queue/messages?limit=5');
-    printJson('Queue Messages', {
-      total: messages_result.pagination.total,
-      showing: messages_result.messages.length,
-      messages: messages_result.messages.map(m => ({
-        transactionId: m.transactionId,
-        partition: m.partition,
-        status: m.status,
-        createdAt: m.createdAt
-      }))
-    });
-    
-    // Test 5: Filter by status
-    console.log('\n🧪 Test 5: Filter Messages by Status (GET /api/v1/status/queues/:queue/messages?status=pending)');
-    const pendingMessages = await get('/api/v1/status/queues/dashboard-test-queue/messages?status=pending&limit=5');
-    printJson('Pending Messages', {
-      total: pendingMessages.pagination.total,
-      messages: pendingMessages.messages.map(m => ({
-        transactionId: m.transactionId,
-        status: m.status,
-        age: m.age
-      }))
-    });
-    
-    // Test 6: Analytics (last hour with minute interval)
-    console.log('\n🧪 Test 6: Analytics (GET /api/v1/status/analytics?interval=minute)');
-    const analytics = await get('/api/v1/status/analytics?interval=minute');
-    printJson('Analytics Overview', {
-      timeRange: analytics.timeRange,
-      throughput: {
-        totals: analytics.throughput.totals,
-        recentSamples: analytics.throughput.timeSeries.slice(0, 3)
-      },
-      latency: analytics.latency.overall,
-      errorRates: analytics.errorRates.overall,
-      currentDepth: analytics.queueDepths.current,
-      topQueues: analytics.topQueues.slice(0, 3),
-      dlqTotal: analytics.deadLetterQueue.total
-    });
-    
-    // Test 7: Filter by namespace
-    console.log('\n🧪 Test 7: Dashboard Status filtered by namespace (GET /api/v1/status?namespace=test-namespace)');
-    const statusFiltered = await get('/api/v1/status?namespace=test-namespace');
-    printJson('Filtered Status', {
-      queuesCount: statusFiltered.queues.length,
-      queues: statusFiltered.queues.map(q => q.name),
-      messages: statusFiltered.messages
-    });
-    
-    // Test 8: Analytics with time range
-    console.log('\n🧪 Test 8: Analytics with custom time range (last 30 minutes)');
-    const thirtyMinutesAgo = new Date(Date.now() - 30 * 60 * 1000).toISOString();
-    const now = new Date().toISOString();
-    const analyticsTimeRange = await get(`/api/v1/status/analytics?from=${thirtyMinutesAgo}&to=${now}&interval=minute`);
-    printJson('Analytics (Last 30 min)', {
-      timeRange: analyticsTimeRange.timeRange,
-      throughputSamples: analyticsTimeRange.throughput.timeSeries.length,
-      totals: analyticsTimeRange.throughput.totals
-    });
-    
-    console.log('\n' + '='.repeat(80));
-    console.log('✅ All tests completed successfully!');
-    console.log('='.repeat(80));
-    
-  } catch (error) {
-    console.error('\n❌ Test failed:', error.message);
-    console.error(error.stack);
-    process.exit(1);
-  }
-}
-
-// Run tests
-runTests().then(() => {
-  console.log('\n✨ Dashboard API test complete!');
-  process.exit(0);
-}).catch(error => {
-  console.error('Fatal error:', error);
-  process.exit(1);
-});
-

package/examples/test-minimal-client.js

@@ -1,112 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * Test the minimalist Queen client interface
- */
-
-import { Queen } from '../src/client/client.js';
-
-async function main() {
-  console.log('🧪 Testing Minimalist Queen Client\n');
-  
-  // Create client instance
-  const client = new Queen({
-    baseUrls: ['http://localhost:6632'],
-    timeout: 30000,
-    retryAttempts: 3,
-    retryDelay: 1000
-  });
-  
-  const testQueue = 'test-minimal-' + Date.now();
-  
-  try {
-    // 1. Configure queue
-    console.log('1️⃣ Configuring queue...');
-    await client.queue(testQueue, {
-      leaseTime: 300,
-      retryLimit: 3,
-      retryDelay: 1000
-    });
-    console.log('✅ Queue configured:', testQueue);
-    
-    // 2. Push single message
-    console.log('\n2️⃣ Pushing single message...');
-    await client.push(testQueue, {
-      id: 1,
-      message: 'Hello, Queen!',
-      timestamp: new Date().toISOString()
-    });
-    console.log('✅ Single message pushed');
-    
-    // 3. Push batch of messages
-    console.log('\n3️⃣ Pushing batch of messages...');
-    const batch = [
-      { id: 2, message: 'Message 2' },
-      { id: 3, message: 'Message 3' },
-      { id: 4, message: 'Message 4' }
-    ];
-    await client.push(testQueue, batch);
-    console.log('✅ Batch of 3 messages pushed');
-    
-    // 4. Push to specific partition
-    console.log('\n4️⃣ Pushing to urgent partition...');
-    await client.push(`${testQueue}/urgent`, {
-      id: 5,
-      message: 'Urgent message!',
-      priority: 'high'
-    });
-    console.log('✅ Message pushed to urgent partition');
-    
-    // 5. Take messages with limit
-    console.log('\n5️⃣ Taking 3 messages...');
-    let count = 0;
-    for await (const message of client.take(testQueue, { limit: 3 })) {
-      count++;
-      console.log(`  📩 Message ${count}:`, message.data);
-      await client.ack(message);
-    }
-    console.log('✅ Took and acknowledged 3 messages');
-    
-    // 6. Take from specific partition
-    console.log('\n6️⃣ Taking from urgent partition...');
-    for await (const message of client.take(`${testQueue}/urgent`, { limit: 1 })) {
-      console.log('  🚨 Urgent message:', message.data);
-      await client.ack(message, true);
-    }
-    console.log('✅ Processed urgent message');
-    
-    // 7. Test failure acknowledgment
-    console.log('\n7️⃣ Testing failure acknowledgment...');
-    await client.push(testQueue, { id: 6, message: 'Will fail' });
-    
-    for await (const message of client.take(testQueue, { limit: 1 })) {
-      console.log('  ❌ Simulating failure for:', message.data);
-      await client.ack(message, false, { error: 'Simulated error' });
-    }
-    console.log('✅ Failed acknowledgment sent');
-    
-    // 8. Test consumer groups (if needed)
-    console.log('\n8️⃣ Testing consumer groups...');
-    await client.push(testQueue, { id: 7, message: 'For consumer group' });
-    
-    for await (const message of client.take(`${testQueue}@test-group`, { limit: 1 })) {
-      console.log('  👥 Message via consumer group:', message.data);
-      await client.ack(message, true, { group: 'test-group' });
-    }
-    console.log('✅ Consumer group test complete');
-    
-    console.log('\n🎉 All tests passed!');
-    
-  } catch (error) {
-    console.error('\n❌ Test failed:', error.message);
-    process.exit(1);
-  } finally {
-    await client.close();
-  }
-}
-
-// Run tests
-main().catch(error => {
-  console.error('Fatal error:', error);
-  process.exit(1);
-});

package/examples/test-queue-creation-policy.js

@@ -1,137 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * Test script to verify the new queue creation policy:
- * - Queues must be created via configure endpoint
- * - Push to non-existent queue should fail
- * - Partitions can still be created on-demand
- */
-
-import { createQueenClient } from '../src/client/index.js';
-
-const TEST_QUEUE = 'test-creation-policy';
-const NON_EXISTENT_QUEUE = 'queue-that-does-not-exist';
-
-// Helper to log with timestamp
-const log = (message, type = 'info') => {
-  const timestamp = new Date().toISOString().split('T')[1].slice(0, -1);
-  const prefix = type === 'error' ? '❌' : type === 'success' ? '✅' : 'ℹ️';
-  console.log(`${timestamp} | ${prefix} ${message}`);
-};
-
-async function runTests() {
-  console.log('=' .repeat(80));
-  console.log('Testing Queue Creation Policy');
-  console.log('=' .repeat(80));
-  
-  const client = createQueenClient({
-    baseUrl: 'http://localhost:6632'
-  });
-  
-  try {
-    // Test 1: Push to non-existent queue should fail
-    log('\nTest 1: Pushing to non-existent queue (should fail)...');
-    try {
-      await client.push({
-        items: [{
-          queue: NON_EXISTENT_QUEUE,
-          partition: 'Default',
-          payload: { test: 'should fail' }
-        }]
-      });
-      log('Push succeeded unexpectedly!', 'error');
-      process.exit(1);
-    } catch (error) {
-      if (error.message.includes('does not exist')) {
-        log(`Push failed as expected: ${error.message}`, 'success');
-      } else {
-        log(`Push failed with unexpected error: ${error.message}`, 'error');
-        throw error;
-      }
-    }
-    
-    // Test 2: Create queue via configure
-    log('\nTest 2: Creating queue via configure endpoint...');
-    const configResult = await client.configure({
-      queue: TEST_QUEUE,
-      namespace: 'test',
-      task: 'creation-policy',
-      options: {
-        retryLimit: 3,
-        priority: 5
-      }
-    });
-    log(`Queue configured: ${JSON.stringify(configResult)}`, 'success');
-    
-    // Test 3: Push to configured queue should succeed
-    log('\nTest 3: Pushing to configured queue (should succeed)...');
-    const pushResult1 = await client.push({
-      items: [{
-        queue: TEST_QUEUE,
-        partition: 'Default',
-        payload: { test: 'message 1' }
-      }]
-    });
-    log('Push to Default partition succeeded', 'success');
-    
-    // Test 4: Push to new partition (should create partition on-demand)
-    log('\nTest 4: Pushing to new partition (should create on-demand)...');
-    const pushResult2 = await client.push({
-      items: [{
-        queue: TEST_QUEUE,
-        partition: 'NewPartition',
-        payload: { test: 'message 2' }
-      }]
-    });
-    log('Push to NewPartition succeeded (partition created on-demand)', 'success');
-    
-    // Test 5: Verify messages can be popped
-    log('\nTest 5: Verifying messages can be popped...');
-    const popResult = await client.pop({
-      queue: TEST_QUEUE,
-      batch: 10,
-      wait: false
-    });
-    
-    if (popResult.messages && popResult.messages.length === 2) {
-      log(`Successfully retrieved ${popResult.messages.length} messages`, 'success');
-      
-      // Check partitions
-      const partitions = new Set(popResult.messages.map(m => m.partition));
-      if (partitions.has('Default') && partitions.has('NewPartition')) {
-        log('Both partitions (Default and NewPartition) confirmed', 'success');
-      }
-      
-      // Acknowledge messages
-      for (const msg of popResult.messages) {
-        await client.ack(msg.transactionId, 'completed');
-      }
-      log('Messages acknowledged', 'success');
-    } else {
-      log(`Expected 2 messages, got ${popResult.messages?.length || 0}`, 'error');
-    }
-    
-    // Test 6: Clean up
-    log('\nTest 6: Cleaning up...');
-    await client.queues.clear(TEST_QUEUE);
-    log('Test queue cleared', 'success');
-    
-    console.log('\n' + '=' .repeat(80));
-    log('All tests passed! Queue creation policy working correctly', 'success');
-    console.log('=' .repeat(80));
-    
-    console.log('\nSummary:');
-    console.log('✅ Queues must be created via configure endpoint');
-    console.log('✅ Push to non-existent queue fails with clear error');
-    console.log('✅ Partitions can still be created on-demand');
-    console.log('✅ No implicit queue creation during push operations');
-    
-  } catch (error) {
-    log(`Test failed: ${error.message}`, 'error');
-    console.error(error);
-    process.exit(1);
-  }
-}
-
-// Run the tests
-runTests().catch(console.error);

package/examples/test-traceid.js

@@ -1,147 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * Test client-provided traceId functionality
- */
-
-import { Queen } from '../src/client/client.js';
-import crypto from 'crypto';
-
-// Helper to generate a valid UUID v4
-function generateUUID() {
-  return crypto.randomUUID();
-}
-
-async function main() {
-  console.log('🧪 Testing Client-Provided TraceId\n');
-  
-  const client = new Queen({
-    baseUrls: ['http://localhost:6632'],
-    timeout: 30000
-  });
-  
-  try {
-    // Configure test queue
-    await client.queue('trace-test', {
-      leaseTime: 300,
-      retryLimit: 3
-    });
-    
-    // Test 1: Push with valid UUID traceId
-    console.log('1️⃣ Testing valid UUID traceId...');
-    const validTraceId = generateUUID();
-    console.log(`   Generated UUID: ${validTraceId}`);
-    
-    await client.push('trace-test', {
-      message: 'Test with valid traceId'
-    }, {
-      transactionId: 'txn-001',
-      traceId: validTraceId
-    });
-    console.log('✅ Message pushed with valid traceId\n');
-    
-    // Test 2: Push with invalid traceId (should be ignored)
-    console.log('2️⃣ Testing invalid traceId (should be ignored)...');
-    const invalidTraceId = 'not-a-valid-uuid';
-    console.log(`   Invalid traceId: ${invalidTraceId}`);
-    
-    await client.push('trace-test', {
-      message: 'Test with invalid traceId'
-    }, {
-      transactionId: 'txn-002',
-      traceId: invalidTraceId  // Will be ignored, server will generate one
-    });
-    console.log('✅ Message pushed (invalid traceId ignored)\n');
-    
-    // Test 3: Push without traceId (server generates)
-    console.log('3️⃣ Testing without traceId (server generates)...');
-    await client.push('trace-test', {
-      message: 'Test without traceId'
-    }, {
-      transactionId: 'txn-003'
-    });
-    console.log('✅ Message pushed (server generated traceId)\n');
-    
-    // Test 4: Using special properties format
-    console.log('4️⃣ Testing special properties format...');
-    const anotherValidTraceId = generateUUID();
-    
-    await client.push('trace-test', {
-      _payload: { message: 'Special format test' },
-      _transactionId: 'txn-004',
-      _traceId: anotherValidTraceId
-    });
-    console.log('✅ Message pushed with special format\n');
-    
-    // Test 5: Batch with mixed traceIds
-    console.log('5️⃣ Testing batch with mixed traceIds...');
-    const batchTraceId1 = generateUUID();
-    const batchTraceId2 = generateUUID();
-    
-    await client.push('trace-test', [
-      {
-        message: 'Batch message 1',
-        transactionId: 'batch-001',
-        traceId: batchTraceId1  // Valid UUID
-      },
-      {
-        message: 'Batch message 2',
-        transactionId: 'batch-002',
-        traceId: 'invalid-trace'  // Invalid, will be ignored
-      },
-      {
-        message: 'Batch message 3',
-        transactionId: 'batch-003'
-        // No traceId, server will generate
-      }
-    ]);
-    console.log('✅ Batch pushed with mixed traceId scenarios\n');
-    
-    // Retrieve and display messages
-    console.log('📥 Retrieving messages to verify traceIds...\n');
-    let count = 0;
-    for await (const msg of client.take('trace-test', { limit: 7 })) {
-      count++;
-      console.log(`Message ${count}:`);
-      console.log(`  Transaction ID: ${msg.transactionId}`);
-      console.log(`  Trace ID: ${msg.traceId}`);
-      console.log(`  Data: ${JSON.stringify(msg.data)}`);
-      
-      // Check if our valid traceIds were preserved
-      if (msg.transactionId === 'txn-001') {
-        if (msg.traceId === validTraceId) {
-          console.log('  ✅ Client-provided traceId was preserved!');
-        } else {
-          console.log('  ❌ Client-provided traceId was not preserved');
-        }
-      }
-      
-      if (msg.transactionId === 'txn-002') {
-        if (msg.traceId !== invalidTraceId) {
-          console.log('  ✅ Invalid traceId was correctly replaced');
-        }
-      }
-      
-      await client.ack(msg);
-      console.log('');
-    }
-    
-    console.log('🎉 TraceId test completed successfully!');
-    console.log('\nSummary:');
-    console.log('- Valid UUID traceIds are accepted and preserved');
-    console.log('- Invalid traceIds are ignored (server generates new ones)');
-    console.log('- Missing traceIds are auto-generated by server');
-    
-  } catch (error) {
-    console.error('❌ Test failed:', error.message);
-    process.exit(1);
-  } finally {
-    await client.close();
-  }
-}
-
-// Run test
-main().catch(error => {
-  console.error('Fatal error:', error);
-  process.exit(1);
-});

package/server.log

@@ -1 +0,0 @@
-zsh: command not found: node

package/test-keepalive-v2.sh

@@ -1,22 +0,0 @@
-#!/bin/bash
-
-# Better connection monitoring for macOS
-echo "Monitoring HTTP connections to Queen servers..."
-echo "Press Ctrl+C to stop"
-echo ""
-
-while true; do
-  # Use lsof instead of netstat for more reliable results on macOS
-  CONN_6632=$(lsof -nP -iTCP:6632 -sTCP:ESTABLISHED 2>/dev/null | grep -v COMMAND | wc -l | tr -d ' ')
-  CONN_6633=$(lsof -nP -iTCP:6633 -sTCP:ESTABLISHED 2>/dev/null | grep -v COMMAND | wc -l | tr -d ' ')
-  
-  # Also check all states to see if connections exist at all
-  ALL_6632=$(lsof -nP -iTCP:6632 2>/dev/null | grep -v COMMAND | wc -l | tr -d ' ')
-  ALL_6633=$(lsof -nP -iTCP:6633 2>/dev/null | grep -v COMMAND | wc -l | tr -d ' ')
-  
-  # Clear line and print
-  echo -ne "\r[6632] EST: $CONN_6632 (Total: $ALL_6632) | [6633] EST: $CONN_6633 (Total: $ALL_6633)    "
-  
-  sleep 0.5  # Check twice per second
-done
-