@polar-sh/sdk 1.0.0-alpha.21 → 1.0.0

package/.agents/skills/polar-typescript-sdk/SKILL.md

@@ -24,7 +24,7 @@ Read [Migration from the `<1.0.0` SDK](references/migration-from-v0.md) before c
 Keep production and sandbox access tokens separate. Never expose an organization access token in browser, mobile, or other public client code. Pass `environment: "sandbox"` while testing; omit it or pass `environment: "production"` in production.
 
 ```typescript
-import { createPolar } from "@polar-sh/sdk/2026-04";
+import { createPolar } from "@polar-sh/sdk/2026-10";
 
 const accessToken = process.env.POLAR_ACCESS_TOKEN;
 if (!accessToken) {
@@ -44,8 +44,8 @@ Create the client once for a long-running server and reuse it. The TypeScript cl
 For tree-shakable individual functions, create a core client and bind only the operations the application uses:
 
 ```typescript
-import { createPolarCore } from "@polar-sh/sdk/2026-04";
-import { getStateExternalCustomers } from "@polar-sh/sdk/2026-04/services/customers";
+import { createPolarCore } from "@polar-sh/sdk/2026-10";
+import { getStateExternalCustomers } from "@polar-sh/sdk/2026-10/services/customers";
 
 const polarCore = createPolarCore({ accessToken });
 const getCustomerState = getStateExternalCustomers(polarCore);

package/.agents/skills/polar-typescript-sdk/references/migration-from-v0.md

@@ -65,7 +65,7 @@ const polar = new Polar({ accessToken });
 
 ```typescript
 // After
-import { createPolar } from "@polar-sh/sdk/2026-04";
+import { createPolar } from "@polar-sh/sdk/2026-10";
 
 const polar = createPolar({ accessToken });
 ```

package/.agents/skills/polar-typescript-sdk/references/usage-events.md

@@ -7,7 +7,7 @@ Use these instructions whenever implementing metered usage or sending events use
 Send events from trusted server-side code. Use the application's customer ID as `external_customer_id` when the Polar customer has the same `external_id`.
 
 ```typescript
-import { createPolar } from "@polar-sh/sdk/2026-04";
+import { createPolar } from "@polar-sh/sdk/2026-10";
 
 const accessToken = process.env.POLAR_ACCESS_TOKEN;
 if (!accessToken) {

package/.agents/skills/polar-typescript-sdk/references/webhooks.md

@@ -21,7 +21,7 @@ Replace `enqueueVerifiedWebhook` with a durable, idempotent application operatio
 
 ```typescript
 import express from "express";
-import { webhooks } from "@polar-sh/sdk/2026-04";
+import { webhooks } from "@polar-sh/sdk/2026-10";
 
 const webhookSecret = process.env.POLAR_WEBHOOK_SECRET;
 if (!webhookSecret) {

package/README.md

@@ -4,16 +4,14 @@ The official TypeScript client for the [Polar API](https://polar.sh/docs/api-ref
 
 ## Installation
 
-The SDK is currently available under the `next` pre-release tag.
-
 ```bash
-pnpm add @polar-sh/sdk@next
+pnpm add @polar-sh/sdk
 ```
 
 or, with `npm`:
 
 ```bash
-npm install @polar-sh/sdk@next
+npm install @polar-sh/sdk
 ```
 
 ## Quick Start
@@ -22,7 +20,7 @@ Create an [organization access token](https://polar.sh/docs/integrate/oat) and u
 the current API version:
 
 ```typescript
-import { createPolar } from "@polar-sh/sdk/2026-04";
+import { createPolar } from "@polar-sh/sdk/2026-10";
 
 const polar = createPolar({
     accessToken: "polar_oat_xxx",
@@ -72,8 +70,8 @@ To import individual API functions for tree-shaking, create a core client and pa
 function:
 
 ```typescript
-import { createPolarCore } from "@polar-sh/sdk/2026-04";
-import { getStateExternalCustomers } from "@polar-sh/sdk/2026-04/services/customers";
+import { createPolarCore } from "@polar-sh/sdk/2026-10";
+import { getStateExternalCustomers } from "@polar-sh/sdk/2026-10/services/customers";
 
 const polar = createPolarCore({
     accessToken: "polar_oat_xxx",
@@ -91,7 +89,7 @@ webhook signing secret:
 
 ```typescript
 import express from "express";
-import { webhooks } from "@polar-sh/sdk/2026-04";
+import { webhooks } from "@polar-sh/sdk/2026-10";
 
 const app = express();
 const webhookSecret = process.env.POLAR_WEBHOOK_SECRET;

package/dist/2026-04/index.cjs

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_rolldown_runtime = require("../rolldown-runtime-ak5kbic3.cjs");
 const require_base = require("../base-D83CMR-Q.cjs");
-const require_errors = require("../errors-CPJ329AT.cjs");
+const require_errors = require("../errors-h8gRquR8.cjs");
 const require_2026_04_services_benefit_grants = require("./services/benefit_grants.cjs");
 const require_2026_04_services_benefits = require("./services/benefits.cjs");
 const require_2026_04_services_checkout_links = require("./services/checkout_links.cjs");
@@ -119,6 +119,7 @@ const knownEventTypes = /* @__PURE__ */ new Set([
 	"subscription.canceled",
 	"subscription.created",
 	"subscription.cycled",
+	"subscription.migrated",
 	"subscription.past_due",
 	"subscription.paused",
 	"subscription.resumed",