add initial versions of createCentraProductsCache*Helpers + cacheAside

[adamsoderstrom]

• feat(utils): add initial version of cacheAside
• feat(next-centra-checkout): create initial version of createCentraProductsCache*Helpers

[changeset-bot]

🦋 Changeset detected

Latest commit: 595fd1b

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 5 packages

Name	Type
@noaignite/utils	Minor
@noaignite/next-centra-checkout	Patch
@noaignite/react-centra-checkout	Patch
@noaignite/react-utils	Patch
@noaignite/tailwind-typography	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Preview	Comments	Updated (UTC)
docs	Ready	Preview	Comment	Sep 24, 2025 7:39pm

[adamsoderstrom]

todo: pass missingKeys, instead of entries

The fallback callback shouldn't have to filter out the missingKeys based on the entries.

---

I do feel that this function does too much now.
The passed fallback callback is expected to verify that entries are the ones retrieved and fetch additional data if needed. Looking on how the function is used shows that there's really no requirements applied on fallback which i think we should strive for.

[adamsoderstrom]

thought: can we reuse the adapter from createGetCentraWebhookEvents?
todo: add a appRouterApiAdapter

[Copilot]

Pull Request Overview

This PR introduces initial versions of cacheAside utility and Centra products cache helpers for Next.js applications. The changes enable cache-aside pattern implementation and provide server/client helpers for managing Centra product caching in Next.js environments.

• Adds cacheAside utility function with cache-aside pattern implementation
• Creates Centra product cache server and client helpers for Next.js
• Includes comprehensive test coverage for all new functionality

Reviewed Changes

Copilot reviewed 17 out of 18 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
packages/utils/src/cacheAside.ts	Implements cache-aside pattern utility with type-safe interfaces
packages/utils/src/cacheAside.test.ts	Comprehensive test coverage for cacheAside functionality
packages/next-centra-checkout/src/createGetCentraWebhookEvents.ts	Webhook event handler with signature verification
packages/next-centra-checkout/src/createCentraProductsCacheServerHelpers.ts	Server-side helpers for Centra product caching with Next.js adapters
packages/next-centra-checkout/src/createCentraProductsCacheClientHelpers.ts	Client-side helper for fetching cached Centra products
packages/next-centra-checkout/package.json	New package configuration with dependencies and build setup

Files not reviewed (1)

• pnpm-lock.yaml: Language not supported

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

[Copilot]

Type assertion p is TParam is incorrect when param is an array. The filter should cast to the element type, not the entire parameter type. This should be p is TParam extends unknown[] ? TParam[number] : never.

Suggested change

	const missedArgs = param.filter((p): p is TParam => !isHit(p, cacheResults))
	const missedArgs = param.filter((p): p is TParam extends unknown[] ? TParam[number] : never => !isHit(p, cacheResults))