Add V2List and V2ListPromise types for v2 list endpoints

[jar-stripe]

Why?

V2 list API responses have a different shape than v1 lists — they return {data, next_page_url, previous_page_url} instead of {object, data, has_more, url}. The SDK was using ApiList<T> (the v1 type) for both, meaning users couldn't access next_page_url or previous_page_url without type assertions.

What?

• Adds V2List<T> interface with data, next_page_url, and previous_page_url fields
• Adds V2ListPromise<T> promise wrapper with auto-pagination methods, parallel to ApiListPromise<T>
• Exports both types from the Stripe namespace
• Regenerates V2 resource files to return V2ListPromise instead of ApiListPromise
• Adds tests verifying the v2 list response shape

Note to the reviewer

To avoid introducing a breaking change, V2List temporarily includes the deprecated properties from ApiList (object, has_more, url). This means existing code that expects an ApiList from v2 list endpoints will continue to compile without errors. These properties are not populated at runtime for v2 lists (this was already the case before this PR) and should be removed at the next major release.

See Also

N/A

Changelog

• Adds V2List and V2ListPromise types to represent API v2 list responses. These types include deprecated fields from the previously returned list shapes. These fields will be removed in the next major release.

[Copilot]

Pull request overview

Adds dedicated TypeScript types (V2List<T> and V2ListPromise<T>) modeling the v2 list response shape (data, next_page_url, previous_page_url) so consumers can access pagination URLs without type assertions. Existing v1 ApiList/ApiListPromise are unchanged. Generated v2 resource files are left on ApiListPromise pending a follow-up codegen update.

Changes:

• Define V2List<T> and V2ListPromise<T> in src/lib.ts parallel to the v1 equivalents.
• Re-export both types from the Stripe namespace in src/stripe.core.ts.
• Add tests in test/resources/V2/Core/Events.spec.js asserting the new response shape (including null pagination URLs).

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated no comments.

File	Description
src/lib.ts	Adds V2List<T> interface and V2ListPromise<T> async iterator/promise type.
src/stripe.core.ts	Imports and re-exports the new types from the Stripe namespace.
test/resources/V2/Core/Events.spec.js	Adds two tests verifying v2 list shape and null pagination URLs.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[mbroshi-stripe]

Looks good to me, but adding @prathmesh-stripe in case there is some export edge case I'm not aware of (I know we've seen issues with, e.g., Stripe.Decimal recently).

[xavdid]

I'll leave to prathmesh for final approval since he has the most context. Approach looks good though.

One thing to add: a block in typescriptTest that verifies the types are correct. I believe these runtime tests would pass today, since the API shape hasn't changed.

Lastly, this is definitely a breaking change (and the PR title should reflect that). If we're settled on doing an out-of-band major release for it, we should write the migration docs and things.

[xavdid]

approving to unblock- I think the shim will work.

Still should add the typescript test mentioned above- we rely on those for regression checking!