fastify.xplaid.items.searchInstitutions(
  query: string,
  options?: {
    countryCodes?: string[]   // default: ["US"]
    products?: string[]
    count?: number
    offset?: number
  }
): Promise<{ institutions: Institution[]; requestId: string }>

{ institutions: Institution[]; requestId: string }

const { institutions } = await fastify.xplaid.items.searchInstitutions("chase");
console.log(institutions.map((i) => i.name)); // ["Chase", ...]

fastify.get("/institutions/search", async (request, reply) => {
  const { q, products } = request.query;
  if (!q || q.length < 2) return reply.status(400).send({ error: "Query too short" });

  try {
    const { institutions } = await fastify.xplaid.items.searchInstitutions(q, {
      products: products ? products.split(",") : ["transactions"],
      count: 10,
    });

    return institutions.map((inst) => ({
      id: inst.institution_id,
      name: inst.name,
      logo: inst.logo,
      color: inst.primary_color,
      oauth: inst.oauth,
    }));
  } catch (error) {
    if (error.plaidError) {
      return reply.status(error.statusCode ?? 500).send({ error: error.message });
    }
    throw error;
  }
});

package: "@xenterprises/fastify-xplaid"
method: fastify.xplaid.items.searchInstitutions(query, options?)
use-when: Find financial institutions by name for UI search, Link customization, or filtering by supported products
returns: { institutions: Institution[], requestId }