public void test_urlParsing_hyphenatedBucket() throws Exception {
        URL url = new URL("gcs://my-bucket-name/object.txt");
        Handler handler = new Handler();
        URLConnection conn = handler.openConnection(url);

        Handler.GcsURLConnection gcsConn = (Handler.GcsURLConnection) conn;

        assertEquals("my-bucket-name", getField(gcsConn, "bucketName"));

    public void test_urlParsing_hyphenatedBucket() throws Exception {
        URL url = new URL("storage://my-bucket-name/object.txt");
        Handler handler = new Handler();
        URLConnection conn = handler.openConnection(url);

        Handler.StorageURLConnection storageConn = (Handler.StorageURLConnection) conn;

        assertEquals("my-bucket-name", getField(storageConn, "bucketName"));

    }

    @Test
    public void test_getIndex() throws Exception {
        List<String> words = new ArrayList<>();
        SuggestResponse response = new SuggestResponse("my-index", 50, words, 5, new ArrayList<>());

        assertEquals("my-index", response.getIndex());
    }

    @Test
    public void test_getTookMs() throws Exception {
        List<String> words = new ArrayList<>();

- **Deferred/Promise**: Async operations

### Index Alias Strategy

Zero-downtime index updates using dual aliases:

```
Index Naming: {baseIndex}.{timestamp}
Example:      my-suggest.20250123120000

Aliases:
├── Search Alias: {baseIndex}          (read operations)
└── Update Alias: {baseIndex}.update   (write operations)
```

### Text Processing Pipeline

```
Input Text
    ↓