Add types for highlight object directly in search response

[mkurczewski]

Describe the bug

The xata object for records returned using search API has still a standard XataRecordMetadata type:

type XataRecordMetadata = {
    /**
     * Number that is increased every time the record is updated.
     */
    version: number;
    /**
     * Timestamp when the record was created.
     */
    createdAt: Date;
    /**
     * Timestamp when the record was last updated.
     */
    updatedAt: Date;
};

There's no highlight or score options like in SearchExtraProperties type, although they are normally available in the code.

The only way to get it properly typed is to use the getMetadata() function on given record, however I can't see any reason why the xata object couldn't be typed directly.

To Reproduce

1. Call a search function on any table, e.g.:

const results = await xataClient.db.someTable.search(phrase, {
    target: [
      { column: "someColumn" },
    ],
    fuzziness: 2,
    prefix: "phrase",
    highlight: {
      enabled: true,
      encodeHTML: true,
    },
  })

2. Try to use highlight option later in the code:

console.log(results.records[0].xata.highlight)

3. Observe a TS error:

TS2339: Property highlight does not exist on type XataRecordMetadata

Expected behavior

TypeScript knows that xata object for records returned by search function contains the same properties as defined in SearchExtraProperties type:

type SearchExtraProperties = {
    table: string;
    highlight?: {
        [key: string]: string[] | {
            [key: string]: any;
        };
    };
    score?: number;
};

Software version

"@xata.io/client": "^0.29.0"

Additional context