Countries-States-Cities Package Test

This is a test project for the countries-states-cities package. It demonstrates how to use the optimized package implementation that uses split data mode internally:

Optimized Mode: Only the specific data needed is loaded, optimizing memory usage while maintaining a simple and familiar API

Setup

First, make sure the countries-states-cities package is built and linked:

# From the parent package directory
npm run build:all
npm link

# From this test directory
npm link countries-states-cities

Running the Tests

To test the optimized implementation:

npm run test:optimized

To generate a test report:

npm run report

Memory Usage Analysis

The test will output memory usage statistics. This helps verify that the optimized implementation is efficient with memory usage, typically showing very low memory consumption compared to loading all data at once.

The optimized implementation uses a split-data architecture internally, which only loads the specific data files needed for each operation. This approach combines the best of both worlds:

• Simple API: Familiar and easy-to-use API like the standard implementation
• Efficient Memory Usage: Only loads what's needed, when it's needed
• Good Performance: Avoids loading unnecessary data