Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

landing: bump pinned Polar API version to 2027-01 before 2026-10 is removed (April 2027)

Đang mở
#3,555 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 3 ngày

Chưa có ai nhận issue này.

Đánh giá

Độ khó
3/5
Thời gian dự kiến
1-2 ngày
Mức phù hợp với người mới
68/100
Loại issue
Lỗi
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
typescript
Lĩnh vực
api, payments

Hướng nghiên cứu

Start by reading the Polar API changelog for the target version and checking whether changes affect POST /v1/checkouts/, especially products and success_url. Then inspect landing/src/pages/api/checkout.ts, landing/test/checkout.test.ts, and landing/package.json; run the checkout tests after updating the SDK version and assertion. Done means the updated version is supported and a Vercel preview redirects the checkout route to Polar.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

Context

The landing site's checkout route pins the Polar API version by importing the versioned SDK client (@polar-sh/sdk/2026-10) in landing/src/pages/api/checkout.ts. That import makes the SDK send Polar-Version: 2026-10 on every request. Added in #3554.

Polar supports each API version for about nine months: three as Next, three as Current, three as Deprecated. New versions ship in the first week of January, April, July and October (versioning docs).

  • 2026-10 is Current now. It becomes Deprecated in the first week of January 2027 (when 2027-01 becomes Current).
  • 2026-10 is removed in the first week of April 2027, and requests to a removed version return 404. That would break the pricing page's buy button.

To do (before the April 2027 release)

  • Read the Polar API changelog for the new version and check for anything that affects POST /v1/checkouts/ (products, success_url).
  • In landing/src/pages/api/checkout.ts, change the import to @polar-sh/sdk/2027-01 (or the then-current version) and update the comment if needed.
  • Update the Polar-Version assertion in landing/test/checkout.test.ts.
  • Make sure @polar-sh/sdk in landing/package.json ships that version subpath (^1.0.2 ships 2026-04, 2026-10 and 2027-01).
  • Verify on a Vercel preview that /api/checkout?products=<id> redirects to a Polar checkout.

The same bump is needed each quarter or two, so it is worth repeating this check whenever a new Polar API version ships.

Ngôn ngữ chính
JavaScript
Star
13.8k
Fork
656
Merge trung bình
2 ngày 6 giờ
Pull request đã merge (30 ngày)
17

Chuẩn bị môi trường

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của shipshapecode/shepherd

Tất cả issue của shipshapecode/shepherd

Issue tương tự

Thêm issue về JavaScript

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.