@polar-sh/sdk 1.0.0 → 1.0.2

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

package/README.md

@@ -64,6 +64,22 @@ 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

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-h8gRquR8.cjs");
+const require_base = require("../base-elZHdyac.cjs");
+const require_errors = require("../errors-CpcxXUUY.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-Da8LWSE5.cjs");
 //#region src/2026-04/client.ts
 const SERVERS = {
 	production: "https://api.polar.sh",