@polar-sh/sdk 1.0.0-alpha.22 → 1.0.1

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

@@ -12,7 +12,7 @@ Use the generated, versioned Polar SDK without inventing methods or parameters.
 1. Identify the installed `@polar-sh/sdk` version and preserve the API version already selected by the application.
 2. Inspect generated service signatures, model interfaces, response types, and endpoint-specific errors before writing calls.
 3. Use `createPolar` for the full service client. Use `createPolarCore` with individual service functions when bundle size or tree-shaking matters.
-4. Identify whether the access token is scoped to an organization. Pass `organization_id` when the selected token does not imply one, and confirm the required endpoint scopes.
+4. Identify whether the access token is scoped to an organization. When the selected token does not imply one, create the client with `createPolar({ ..., organizationId })` or pass `organization_id`, and confirm the required endpoint scopes.
 5. Keep client, webhook, and environment configuration in trusted server-side code.
 
 ## Migrate from the old SDK
@@ -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",
@@ -66,14 +64,30 @@ const customerState = await polar.customers.getStateExternal("customer_external_
 });
 ```
 
+## Organizations
+
+OAuth access tokens and personal access tokens can reach every organization the user belongs to.
+Pass `organizationId` to get a client that acts on a single organization. It sends the
+`Polar-Organization` header, so the API only returns and changes that organization's data:
+
+```typescript
+const acme = createPolar({
+    accessToken: "polar_at_u_xxx",
+    organizationId: "acme_organization_id",
+});
+const customers = await acme.customers.list();
+```
+
+Organization access tokens already act on their own organization and don't need it.
+
 ## Individual API Functions
 
 To import individual API functions for tree-shaking, create a core client and pass it to the
 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 +105,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_base = require("../base-Cg2wDLWs.cjs");
+const require_errors = require("../errors-o_AM61cd.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");
@@ -28,7 +28,7 @@ const require_2026_04_services_products = require("./services/products.cjs");
 const require_2026_04_services_refunds = require("./services/refunds.cjs");
 const require_2026_04_services_subscriptions = require("./services/subscriptions.cjs");
 const require_2026_04_services_webhooks = require("./services/webhooks.cjs");
-const require_webhooks = require("../webhooks-CJ5fgGEO.cjs");
+const require_webhooks = require("../webhooks-CoBpD12U.cjs");
 //#region src/2026-04/client.ts
 const SERVERS = {
 	production: "https://api.polar.sh",
@@ -119,6 +119,7 @@ const knownEventTypes = /* @__PURE__ */ new Set([
 	"subscription.canceled",
 	"subscription.created",
 	"subscription.cycled",
+	"subscription.migrated",
 	"subscription.past_due",
 	"subscription.paused",
 	"subscription.resumed",