feat: fetch feed based on embed types

[valerierose]

Overview

This adds the option to retrieve a feed based on the content type of the embedding. The content type can be a broad category such as image or a specific file type such as image/gif.

The full list of options are defined in src/neynar-api/v2/openapi-farcaster/models/embed-type.ts.

Example

# index.js
const result = await client.fetchFeed("filter", {limit: 3, filterType: "embed_types", embedTypes: ["image"]});
console.log(JSON.stringify(result));

$ node index.js | jq '{casts: [.casts[] | {text: .text, timestamp: .timestamp, embed_url: .embeds[0].url, embed_type: .embeds[0].metadata.content_type}]}'

{
  "casts": [
    {
      "text": "Hav nice day RARE fams 💎\n\n",
      "timestamp": "2024-08-29T18:00:15.000Z",
      "embed_url": "https://media.tenor.com/hzrZb_3tie4AAAAM/karen.gif",
      "embed_type": "image/gif"
    },
    {
      "text": "What’s the biggest threat for a creator?\nDeplatforming  https://ik.imagekit.io/lens/media-snapshot/769e76d012e77c2b84158f8964a58f7a5abf892d228f83649eb1f201d500f993.jpg",
      "timestamp": "2024-08-29T18:00:15.000Z",
      "embed_url": "https://ik.imagekit.io/lens/media-snapshot/769e76d012e77c2b84158f8964a58f7a5abf892d228f83649eb1f201d500f993.jpg",
      "embed_type": "image/jpeg"
    },
    {
      "text": "Hav nice day 💎💎💎",
      "timestamp": "2024-08-29T18:00:14.000Z",
      "embed_url": "https://media.tenor.com/tOldnV-a_3IAAAAM/have-a-good-day-have-a-nice-day.gif",
      "embed_type": "image/gif"
    }
  ]
}

[manan19]

talked with @valerierose about this

• we can keep using an array of enums since explode = false is supported at the OAS level https://swagger.io/docs/specification/serialization/
• defining a type for the [] of embed types is optional