improvement: create a snippet resolver that caches the api definition…

[armandobelardo]

… across

Short description of the changes made

This PR introduces a definition holder wrapping the snippet template resolver, allowing us to only request the api definition once per-api definition ID

Essentially just:

• construct SnippetTemplateResolutionHolder with a definition or definition ID
• call resolve as you would have instantiated a SnippetTemplateResolver before

ex:

const holder = new SnippetTemplateResolutionHolder({ maybeApiDefinitionId: 1 });
const snippet = await holder.resolve({ payload, endpointSnippetTemplate });

// If you still want the template resolver object, you can get that as well

const resolver = await holder.getTemplateResolver({ payload, endpointSnippetTemplate });

What was the motivation & context behind this PR?

Limit calls to FDR for getting the API definition, necessary to resolve Union templates

[vercel]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Comments	Updated (UTC)
fern-dashboard-dev	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Aug 1, 2024 6:30pm
fern-dev	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Aug 1, 2024 6:30pm
fern-prod	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Aug 1, 2024 6:30pm

3 Skipped Deployments

Name	Status	Preview	Comments	Updated (UTC)
fern-dashboard	⬜️ Ignored (Inspect)			Aug 1, 2024 6:30pm
fontawesome-cdn	⬜️ Ignored (Inspect)	Visit Preview		Aug 1, 2024 6:30pm
private-docs	⬜️ Ignored (Inspect)			Aug 1, 2024 6:30pm

[github-actions]

PR Preview

• docs.cable.tech
• docs.givechariot.com
• developers.awork.com
• secure.docs.propexo.com
• www.intern.mavenagi.com
• docs.schematichq.com
• plantstore.dev
• www.plantstore.dev
• docs.boundaryml.com
• docs.qlty.ai
• docs.rightbrain.ai
• docs.getkard.com
• docs.syndicate.io
• docs.qlty.us
• hume.ferndocs.com
• docs.stack-auth.com
• gemini2.ferndocs.com
• docs.darwincloud.xyz
• docs.kota.io
• mongodb.ferndocs.com
• gemini.ferndocs.com
• api.labelstud.io
• docs.fluidstack.io
• docs.fileforge.com
• docs.instabase.com
• docs.reka.ai
• docs.aiaplatform.com.au
• fern.ssoready.com
• docs.anterior.com
• developers.beehiiv.com
• docs.scorecard.io
• fern.humanloop.com
• docs.goldenbasis.com
• developers.mavenagi.com
• docs.subconscious.ai
• docs.mavenagi.com
• docs.sphinxbio.com
• help.getzep.com
• api.qdrant.tech
• developers.upwardli.com
• docs.darwinbio.io
• dev.documentation.sayari.com
• fern.assemblyai.com
• docs.usebridge.com
• fern.uploadcare.com
• docs.impiloplatform.com
• docs.multion.ai
• developer.projectmanager.com
• dev.hume.ai
• docs.predictionguard.com