Faceting Objects in Typesense

import json

import typesense

COLLECTION = "example"
client = typesense.Client(
    {
        "api_key": "TYPESENSEDEV",
        "nodes": [{"host": "localhost", "port": "8108", "protocol": "http"}],
        "connection_timeout_seconds": 2,
    }
)

try:
    client.collections[COLLECTION].delete()
except:
    pass

fields = [
    {
        "name": "title",
        "type": "string",
    },
    {
        "name": "color",
        "type": "object",
        "facet": True,
    },
]
client.collections.create(
    {
        "name": COLLECTION,
        "fields": fields,
        "enable_nested_fields": True,
    }
)

products = [
    {
        "title": "foo",
        "color": {
            "name": "red",
            "h": 0,
            "s": 100,
            "l": 50,
        },
    },
    {
        "title": "bar",
        "color": {
            "name": "blue",
            "h": 240,
            "s": 100,
            "l": 50,
        },
    },
    {
        "title": "baz",
        "color": {"name": "Multi-colored", "special_type": "multi"},
    },
]

client.collections[COLLECTION].documents.import_(products, {"action": "create"})

facet_counts = client.collections[COLLECTION].documents.search(
    {
        "q": "*",
        "facet_by": "color",
    }
)["facet_counts"]
print(json.dumps(facet_counts, indent=4))

{
  "value": {"name": "blue", "rgb": "#123456"},
  "count": 3
},
{
  "value": {"name": "black", "rgb": "#000000"},
  "count": 2
}