@fjell/registry 4.4.51 → 4.4.53

package/examples/registry-statistics-example.ts

@@ -1,264 +0,0 @@
-import { createRegistry, Instance } from '../src';
-import { ServiceClient } from '../src/RegistryStats';
-
-export async function runRegistryStatisticsExample() {
-  // Example demonstrating Registry statistics tracking with scopes
-  console.log('=== Registry Statistics Tracking with Scopes Example ===\n');
-
-  // Create a registry
-  const registry = createRegistry('services');
-
-  // Create some mock instances for different environments
-  const authProdService: Instance<'auth'> = {
-    coordinate: { kta: ['auth'], scopes: ['production'] } as any,
-    registry: registry as any,
-  } as any;
-
-  const authDevService: Instance<'auth'> = {
-    coordinate: { kta: ['auth'], scopes: ['development'] } as any,
-    registry: registry as any,
-  } as any;
-
-  const userProdService: Instance<'user'> = {
-    coordinate: { kta: ['user'], scopes: ['production', 'sql'] } as any,
-    registry: registry as any,
-  } as any;
-
-  const userDevService: Instance<'user'> = {
-    coordinate: { kta: ['user'], scopes: ['development', 'nosql'] } as any,
-    registry: registry as any,
-  } as any;
-
-  const cacheService: Instance<'cache', 'redis'> = {
-    coordinate: { kta: ['cache', 'redis'], scopes: [] } as any,
-    registry: registry as any,
-  } as any;
-
-  // Register the services with different scopes
-  registry.register(['auth'], authProdService, { scopes: ['production'] });
-  registry.register(['auth'], authDevService, { scopes: ['development'] });
-  registry.register(['user'], userProdService, { scopes: ['production', 'sql'] });
-  registry.register(['user'], userDevService, { scopes: ['development', 'nosql'] });
-  registry.register(['cache', 'redis'], cacheService); // No scopes
-
-  // Check initial statistics
-  let stats = registry.getStatistics();
-  console.log('Initial statistics:');
-  console.log(`Total get calls: ${stats.totalGetCalls}`);
-  console.log(`Coordinate call records: ${stats.coordinateCallRecords.length} entries`);
-  console.log('');
-
-  // Use the services with different scope combinations and clients
-  console.log('Making service calls with different scopes and clients...');
-
-  // Application calls (direct calls from the application)
-  registry.get(['auth'], { scopes: ['production'], client: 'MyWebApp' });
-  registry.get(['auth'], { scopes: ['development'], client: 'MyWebApp' });
-  registry.get(['auth'], { scopes: ['production'], client: 'MyWebApp' }); // Same app, second call
-
-  // Service-to-service calls (simulated by specifying service clients)
-  const orderServiceClient: ServiceClient = {
-    registryType: 'services',
-    coordinate: { kta: ['order'], scopes: ['business'] }
-  };
-
-  const paymentServiceClient: ServiceClient = {
-    registryType: 'services',
-    coordinate: { kta: ['payment'], scopes: ['stripe'] }
-  };
-
-  registry.get(['user'], { scopes: ['production', 'sql'], client: orderServiceClient });
-  registry.get(['user'], { scopes: ['sql', 'production'], client: orderServiceClient }); // Same service, scope order normalized
-  registry.get(['user'], { scopes: ['development', 'nosql'], client: paymentServiceClient });
-
-  // Mixed calls - some with no client specified
-  registry.get(['cache', 'redis']); // No client specified
-  registry.get(['cache', 'redis'], { client: 'CacheUtility' }); // Application client
-
-  // More service-to-service calls
-  registry.get(['auth'], { scopes: ['production'], client: orderServiceClient });
-  registry.get(['cache', 'redis'], { client: paymentServiceClient });
-
-  // Check updated statistics
-  stats = registry.getStatistics();
-  console.log('\nStatistics after service calls:');
-  console.log(`Total get calls: ${stats.totalGetCalls}`);
-  console.log('\nClient Summary:');
-  console.log(`  Service-to-service calls: ${stats.clientSummary.serviceCalls}`);
-  console.log(`  Application calls: ${stats.clientSummary.applicationCalls}`);
-  console.log(`  Unidentified calls: ${stats.clientSummary.unidentifiedCalls}`);
-  console.log('\nDetailed coordinate call records:');
-
-  // Display statistics for each coordinate/scope combination with client breakdown
-  stats.coordinateCallRecords.forEach((record, index) => {
-    const ktaDisplay = record.kta.join(' → ');
-    const scopesDisplay = record.scopes.length > 0 ? record.scopes.join(', ') : 'no scopes';
-    console.log(`  ${index + 1}. ${ktaDisplay} [${scopesDisplay}]: ${record.count} calls`);
-
-    // Show client breakdown
-    record.clientCalls.forEach((clientCall, clientIndex) => {
-      if (typeof clientCall.client === 'string') {
-        console.log(`    ${clientIndex + 1}a. App "${clientCall.client}": ${clientCall.count} calls`);
-      } else if (clientCall.client) {
-        const serviceDisplay = clientCall.client.coordinate.kta.join('.');
-        const serviceScopeDisplay = clientCall.client.coordinate.scopes.join(', ');
-        console.log(`    ${clientIndex + 1}b. Service ${clientCall.client.registryType}/${serviceDisplay}[${serviceScopeDisplay}]: ${clientCall.count} calls`);
-      } else {
-        console.log(`    ${clientIndex + 1}c. Unidentified client: ${clientCall.count} calls`);
-      }
-    });
-  });
-
-  // Analysis by coordinate (aggregating across scopes)
-  console.log('\nAggregated analysis by coordinate:');
-  const coordinateMap = new Map<string, number>();
-
-  stats.coordinateCallRecords.forEach(record => {
-    const ktaKey = record.kta.join('.');
-    coordinateMap.set(ktaKey, (coordinateMap.get(ktaKey) || 0) + record.count);
-  });
-
-  for (const [coordinate, totalCalls] of coordinateMap) {
-    console.log(`  ${coordinate}: ${totalCalls} total calls`);
-  }
-
-  // Find the most accessed coordinate/scope combination
-  let mostAccessedRecord = stats.coordinateCallRecords[0];
-  for (const record of stats.coordinateCallRecords) {
-    if (record.count > mostAccessedRecord.count) {
-      mostAccessedRecord = record;
-    }
-  }
-
-  if (mostAccessedRecord) {
-    const ktaDisplay = mostAccessedRecord.kta.join(' → ');
-    const scopesDisplay = mostAccessedRecord.scopes.length > 0
-      ? mostAccessedRecord.scopes.join(', ')
-      : 'no scopes';
-    console.log(`\nMost accessed: ${ktaDisplay} [${scopesDisplay}] (${mostAccessedRecord.count} calls)`);
-  }
-
-  // Environment-based analysis with client types
-  console.log('\nEnvironment-based analysis:');
-  let prodCalls = 0;
-  let devCalls = 0;
-  let noScopeCalls = 0;
-  let prodAppCalls = 0;
-  let prodServiceCalls = 0;
-  let devAppCalls = 0;
-  let devServiceCalls = 0;
-
-  stats.coordinateCallRecords.forEach(record => {
-    if (record.scopes.includes('production')) {
-      prodCalls += record.count;
-      record.clientCalls.forEach(clientCall => {
-        if (typeof clientCall.client === 'string') {
-          prodAppCalls += clientCall.count;
-        } else if (clientCall.client) {
-          prodServiceCalls += clientCall.count;
-        }
-      });
-    } else if (record.scopes.includes('development')) {
-      devCalls += record.count;
-      record.clientCalls.forEach(clientCall => {
-        if (typeof clientCall.client === 'string') {
-          devAppCalls += clientCall.count;
-        } else if (clientCall.client) {
-          devServiceCalls += clientCall.count;
-        }
-      });
-    } else if (record.scopes.length === 0) {
-      noScopeCalls += record.count;
-    }
-  });
-
-  console.log(`  Production services: ${prodCalls} calls (${prodAppCalls} from apps, ${prodServiceCalls} from services)`);
-  console.log(`  Development services: ${devCalls} calls (${devAppCalls} from apps, ${devServiceCalls} from services)`);
-  console.log(`  Unscoped services: ${noScopeCalls} calls`);
-
-  // Demonstrate immutability
-  console.log('\nTesting immutability of returned statistics...');
-  const stats1 = registry.getStatistics();
-  const stats2 = registry.getStatistics();
-
-  console.log(`Are record arrays the same object? ${stats1.coordinateCallRecords === stats2.coordinateCallRecords}`);
-  console.log('(Should be false - each call returns a new array to prevent external mutation)');
-
-  // Try to modify the returned records (this won't affect the internal tracking)
-  if (stats1.coordinateCallRecords.length > 0) {
-    const originalCount = stats1.coordinateCallRecords[0].count;
-    stats1.coordinateCallRecords[0].count = 999;
-
-    const stats3 = registry.getStatistics();
-    console.log(`After trying to modify returned data, original count preserved? ${stats3.coordinateCallRecords[0].count === originalCount}`);
-    console.log('(Should be true - internal tracking is protected from external mutation)');
-  }
-
-  console.log('\n=== Advanced Statistics Example Complete ===');
-
-  // Demonstration of automatic service-to-service tracking via factory Registry
-  console.log('\n=== Automatic Service-to-Service Tracking Demo ===');
-
-  // Create a service that uses other services through the Registry passed to its factory
-  // eslint-disable-next-line @typescript-eslint/no-unused-vars
-  const orderProcessorService = registry.createInstance(['order', 'processor'], ['business'], (coordinate, context) => {
-    // The registry passed here is proxied to automatically track this service as the client
-
-    // When this service calls get() on the registry, it will automatically be tracked
-    // eslint-disable-next-line @typescript-eslint/no-unused-vars
-    const authService = context.registry.get(['auth'], { scopes: ['production'] });
-    // eslint-disable-next-line @typescript-eslint/no-unused-vars
-    const userService = context.registry.get(['user'], { scopes: ['production', 'sql'] });
-    // eslint-disable-next-line @typescript-eslint/no-unused-vars
-    const cacheService = context.registry.get(['cache', 'redis']);
-
-    console.log('Order processor created and retrieved dependencies automatically tracked!');
-
-    return {
-      coordinate,
-      registry: context.registry,
-      processOrder: (orderId: string) => {
-        console.log(`Processing order ${orderId} with dependencies`);
-        return { success: true, orderId };
-      }
-    };
-  });
-
-  // Get final statistics to show the automatic tracking
-  const finalStats = registry.getStatistics();
-  console.log(`\nAfter service creation with automatic tracking:`);
-  console.log(`Total get calls: ${finalStats.totalGetCalls}`);
-  console.log(`Service-to-service calls: ${finalStats.clientSummary.serviceCalls}`);
-
-  // Show the new automatically tracked calls
-  console.log('\nNew automatically tracked service calls:');
-  finalStats.coordinateCallRecords.forEach(record => {
-    record.clientCalls.forEach(clientCall => {
-      if (clientCall.client && typeof clientCall.client !== 'string' &&
-        clientCall.client.coordinate.kta.includes('order') &&
-        clientCall.client.coordinate.kta.includes('processor')) {
-        const ktaDisplay = record.kta.join(' → ');
-        const scopesDisplay = record.scopes.length > 0 ? record.scopes.join(', ') : 'no scopes';
-        console.log(`  ${ktaDisplay} [${scopesDisplay}] called by order.processor service: ${clientCall.count} calls`);
-      }
-    });
-  });
-
-  console.log('\n=== Automatic Tracking Demo Complete ===');
-
-  // Return key statistics for testing
-  return {
-    totalGetCalls: finalStats.totalGetCalls,
-    coordinateCallRecords: finalStats.coordinateCallRecords.length,
-    mostAccessedCount: mostAccessedRecord ? mostAccessedRecord.count : 0,
-    prodCalls,
-    devCalls,
-    noScopeCalls,
-    clientSummary: finalStats.clientSummary
-  };
-}
-
-// Run the example if this file is executed directly
-if (import.meta.url === `file://${process.argv[1]}`) {
-  runRegistryStatisticsExample().catch(console.error);
-}

package/examples/simple-example.ts

@@ -1,250 +0,0 @@
-/**
- * Simple Registry Example - No RegistryHub, No Scopes
- *
- * This example demonstrates the simplest possible way to use the Registry library:
- * - Create a registry without a RegistryHub
- * - Register instances without any scopes
- * - Retrieve instances without any scopes
- * - Perfect for simple applications that just need basic dependency injection
- *
- * Run this example with: npx tsx examples/simple-example.ts
- *
- * Note: In a real application, import from the built package:
- * import { createRegistry, createInstance } from '@fjell/registry';
- */
-
-// Import the actual registry functionality
-import { createRegistry } from '../src/Registry';
-import { createInstance } from '../src/Instance';
-
-// ===== Simple Service Examples =====
-
-// Example 1: A simple logger service
-class SimpleLogger {
-  log(message: string) {
-    console.log(`[LOG] ${new Date().toISOString()}: ${message}`);
-  }
-
-  error(message: string) {
-    console.error(`[ERROR] ${new Date().toISOString()}: ${message}`);
-  }
-}
-
-// Example 2: A simple configuration service
-class SimpleConfig {
-  private config = {
-    appName: 'My Simple App',
-    version: '1.0.0',
-    debugMode: true
-  };
-
-  get(key: string): any {
-    return this.config[key as keyof typeof this.config];
-  }
-
-  set(key: string, value: any): void {
-    (this.config as any)[key] = value;
-  }
-}
-
-// Example 3: A simple data service
-class SimpleDataService {
-  private data: string[] = [];
-
-  add(item: string): void {
-    this.data.push(item);
-  }
-
-  getAll(): string[] {
-    return [...this.data];
-  }
-
-  count(): number {
-    return this.data.length;
-  }
-}
-
-// ===== Main Example =====
-
-async function runSimpleExample() {
-  console.log('🚀 Simple Registry Example - No RegistryHub, No Scopes\n');
-
-  // Step 1: Create a simple registry (no RegistryHub needed!)
-  console.log('1. Creating a simple registry...');
-  const registry = createRegistry('app');
-  console.log('   ✅ Registry created with type: "app"\n');
-
-  // Step 2: Create instances using factories (no scopes needed!)
-  console.log('2. Creating and registering instances...');
-
-  // Logger instance
-  registry.createInstance(
-    ['logger'],
-    [], // Empty scopes array - we don't need scopes!
-    (coordinate, context) => {
-      // Create the actual service
-      const service = new SimpleLogger();
-
-      // Create and return an instance that wraps the service
-      const instance = createInstance(context.registry, coordinate);
-      // Attach service methods to the instance for easy access
-      (instance as any).log = service.log.bind(service);
-      (instance as any).error = service.error.bind(service);
-      return instance;
-    }
-  );
-  console.log('   ✅ Logger instance created and registered');
-
-  // Config instance
-  registry.createInstance(
-    ['config'],
-    [], // No scopes needed
-    (coordinate, context) => {
-      const service = new SimpleConfig();
-      const instance = createInstance(context.registry, coordinate);
-      (instance as any).get = service.get.bind(service);
-      (instance as any).set = service.set.bind(service);
-      return instance;
-    }
-  );
-  console.log('   ✅ Config instance created and registered');
-
-  // Data service instance
-  registry.createInstance(
-    ['data'],
-    [], // No scopes needed
-    (coordinate, context) => {
-      const service = new SimpleDataService();
-      const instance = createInstance(context.registry, coordinate);
-      (instance as any).add = service.add.bind(service);
-      (instance as any).getAll = service.getAll.bind(service);
-      (instance as any).count = service.count.bind(service);
-      return instance;
-    }
-  );
-  console.log('   ✅ Data service instance created and registered\n');
-
-  // Step 3: Retrieve instances (no scopes needed!)
-  console.log('3. Retrieving instances from registry...');
-
-  const retrievedLogger = registry.get(['logger']); // No scopes parameter needed!
-  const retrievedConfig = registry.get(['config']); // No scopes parameter needed!
-  const retrievedData = registry.get(['data']); // No scopes parameter needed!
-
-  console.log('   ✅ All instances retrieved successfully\n');
-
-  // Step 4: Verify everything works
-  console.log('4. Verifying the registry works...');
-
-  if (retrievedLogger && retrievedConfig && retrievedData) {
-    console.log('   ✅ All instances found in registry');
-    console.log(`   📋 Logger coordinate: ${JSON.stringify(retrievedLogger.coordinate)}`);
-    console.log(`   📋 Config coordinate: ${JSON.stringify(retrievedConfig.coordinate)}`);
-    console.log(`   📋 Data coordinate: ${JSON.stringify(retrievedData.coordinate)}\n`);
-  } else {
-    console.log('   ❌ Some instances were not found');
-    return;
-  }
-
-  // Step 5: Show practical usage
-  console.log('5. Practical usage example...');
-  console.log('   In a real app, you would extend the instances with your actual services:');
-  console.log('   - Attach your service methods to the instance');
-  console.log('   - Use the registry to get dependencies between services');
-  console.log('   - Access instances from anywhere in your app\n');
-
-  // Step 6: Demonstrate the services actually work!
-  console.log('6. Testing the services...');
-
-  // Test the logger
-  const logger = registry.get(['logger']);
-  if (logger) {
-    (logger as any).log('This is a test log message from the registry!');
-  }
-
-  // Test the config
-  const config = registry.get(['config']);
-  if (config) {
-    console.log(`   📋 App name from config: ${(config as any).get('appName')}`);
-    (config as any).set('newProperty', 'This was set dynamically!');
-    console.log(`   📋 New property: ${(config as any).get('newProperty')}`);
-  }
-
-  // Test the data service
-  const dataService = registry.get(['data']);
-  if (dataService) {
-    (dataService as any).add('Item 1');
-    (dataService as any).add('Item 2');
-    (dataService as any).add('Item 3');
-    console.log(`   📋 Data service has ${(dataService as any).count()} items`);
-    console.log(`   📋 All items: ${JSON.stringify((dataService as any).getAll())}`);
-  }
-
-  console.log('   ✅ All services working correctly!\n');
-
-  console.log('✨ Simple Registry Example Complete!');
-  console.log('\n📝 Key Takeaways:');
-  console.log('   • No RegistryHub required - just call createRegistry()');
-  console.log('   • No scopes required - pass empty array [] or omit entirely');
-  console.log('   • Perfect for simple dependency injection needs');
-  console.log('   • You can always add RegistryHub and scopes later as your app grows');
-}
-
-// ===== Advanced Simple Example =====
-
-async function runAdvancedSimpleExample() {
-  console.log('\n' + '='.repeat(60));
-  console.log('🔥 Advanced Simple Example - Service Dependencies');
-  console.log('='.repeat(60) + '\n');
-
-  const registry = createRegistry('advanced-app');
-
-  // Create a notification service that depends on the logger
-  class NotificationService {
-    constructor(private logger: any) { }
-
-    sendNotification(message: string) {
-      this.logger.log(`Sending notification: ${message}`);
-      // In a real app, this would send actual notifications
-      console.log(`📢 Notification sent: ${message}`);
-    }
-  }
-
-  // Register logger first
-  registry.createInstance(['logger'], [], (coordinate, context) => {
-    const service = new SimpleLogger();
-    const instance = createInstance(context.registry, coordinate);
-    // Attach service methods to instance for easy access
-    (instance as any).log = service.log.bind(service);
-    (instance as any).error = service.error.bind(service);
-    return instance;
-  });
-
-  // Register notification service that uses the logger
-  registry.createInstance(['notification'], [], (coordinate, context) => {
-    // Get the logger dependency from the registry
-    const logger = context.registry.get(['logger']);
-    const service = new NotificationService(logger);
-    const instance = createInstance(context.registry, coordinate);
-    (instance as any).sendNotification = service.sendNotification.bind(service);
-    return instance;
-  });
-
-  // Use the services
-  const notificationService = registry.get(['notification']);
-  if (notificationService) {
-    (notificationService as any).sendNotification('Welcome to the simple registry!');
-  }
-
-  console.log('\n✨ This shows how services can depend on each other');
-  console.log('   even in the simple, no-scopes approach!');
-}
-
-// Run the examples
-// Note: In ES modules, we can't use require.main === module
-// So we'll just run the examples directly when this file is executed
-runSimpleExample()
-  .then(() => runAdvancedSimpleExample())
-  .catch(console.error);
-
-export { runSimpleExample, runAdvancedSimpleExample };

package/tsconfig.docs.json

@@ -1,28 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2020",
-    "useDefineForClassFields": true,
-    "lib": [
-      "ES2020",
-      "DOM",
-      "DOM.Iterable"
-    ],
-    "types": [
-      "vitest/globals"
-    ],
-    "module": "ESNext",
-    "skipLibCheck": true,
-    /* Bundler mode */
-    "moduleResolution": "bundler",
-    "allowImportingTsExtensions": true,
-    "resolveJsonModule": true,
-    "isolatedModules": true,
-    "noEmit": true,
-    "jsx": "react-jsx",
-    /* Linting */
-    "strict": true,
-    "noUnusedLocals": true,
-    "noUnusedParameters": true,
-    "noFallthroughCasesInSwitch": true
-  }
-}

package/vitest.config.ts

@@ -1,22 +0,0 @@
-/// <reference types="vitest" />
-import { defineConfig } from 'vitest/config'
-
-export default defineConfig({
-  test: {
-    environment: 'jsdom',
-    setupFiles: ['./tests/setup.ts'],
-    globals: true,
-    testTimeout: 30000,
-    coverage: {
-      exclude: [
-        'build.js',
-        'docs/**',
-        'coverage/**',
-        'output/**',
-        '**/*.config.*',
-        '**/*.d.ts',
-        'dist/**',
-      ]
-    }
-  },
-})