test(fts): add integration tests for FTS control plane

[jhamon]

Summary

This PR adds comprehensive integration tests for the new Full-Text Search (FTS) control plane functionality. These tests verify the new schema-based API for creating Pinecone indexes with full-text search and vector capabilities.

Test Coverage

• Schema-based Index Creation

  • Creating indexes with schema parameter using dict format
  • Creating indexes using field type classes (TextField, DenseVectorField, etc.)
  • Creating indexes using SchemaBuilder fluent API
  • Creating indexes with deletion protection

• Deployment Configuration

  • Creating indexes with explicit ServerlessDeployment parameter
  • Verifying default deployment (aws/us-east-1) when deployment is omitted

• describe_index Compatibility

  • Verifying .spec.serverless.cloud access pattern works
  • Verifying .dimension, .metric, .vector_type properties work
  • Testing that FTS-only indexes return None for vector properties

• Error Handling

  • Testing mutual exclusion of spec and schema parameters
  • Validating error messages

• Legacy Compatibility

  • Testing that legacy spec-based creation still works
  • Testing ServerlessSpec and dict-based spec formats

Usage Examples

Schema-based Index Creation with Field Classes

from pinecone import Pinecone, TextField, DenseVectorField

pc = Pinecone()
pc.db.index.create(
    name="my-index",
    schema={
        "title": TextField(full_text_searchable=True),
        "embedding": DenseVectorField(dimension=1536, metric="cosine"),
    }
)

Using SchemaBuilder

from pinecone import Pinecone, SchemaBuilder

pc = Pinecone()
schema = (SchemaBuilder()
    .text("title", full_text_searchable=True)
    .integer("year", filterable=True)
    .dense_vector("embedding", dimension=1536, metric="cosine")
    .build())

pc.db.index.create(name="my-index", schema=schema)

FTS-only Index

from pinecone import Pinecone, TextField

pc = Pinecone()
pc.db.index.create(
    name="fts-only-index",
    schema={
        "content": TextField(full_text_searchable=True),
    }
)

Related Issues

• Relates to: SDK-113

---

Note

Low Risk
Low risk since changes are test-only, but they create/cleanup real indexes and could impact CI stability/cost if cleanup or timeouts fail.

Overview
Adds a new tests/integration/rest_sync/db/control/fts integration test suite for the FTS control-plane.

Covers schema-based index creation via raw dicts, typed field classes, and SchemaBuilder, plus deletion protection and deployment defaults/overrides.

Verifies describe backward-compatibility shims (desc.spec.serverless.*, pod/byoc as None) and correct reporting of dimension/metric/vector_type, including FTS-only indexes returning None for vector properties. Also adds error/legacy coverage for spec vs schema mutual exclusion and older spec-based creation paths, with session-level cleanup of all indexes tagged to the test run.

^{Written by Cursor Bugbot for commit 18bbfc7. This will update automatically on new commits. Configure here.}

[cursor]

Cursor Bugbot has reviewed your changes and found 2 potential issues.

^{Bugbot Autofix is OFF. To automatically fix reported issues with Cloud Agents, enable Autofix in the Cursor dashboard.}