@polar-sh/sdk 0.26.0 → 0.27.0

package/docs/sdks/polarorders/README.md

@@ -11,19 +11,21 @@
 
 ## list
 
-List orders of the authenticated customer or user.
+List orders of the authenticated customer.
+
+**Scopes**: `customer_portal:read` `customer_portal:write`
 
 ### Example Usage
 
 ```typescript
 import { Polar } from "@polar-sh/sdk";
 
-const polar = new Polar({
-  accessToken: process.env["POLAR_ACCESS_TOKEN"] ?? "",
-});
+const polar = new Polar();
 
 async function run() {
-  const result = await polar.customerPortal.orders.list({});
+  const result = await polar.customerPortal.orders.list({
+    customerSession: process.env["POLAR_CUSTOMER_SESSION"] ?? "",
+  }, {});
 
   for await (const page of result) {
     // Handle the page
@@ -44,12 +46,12 @@ import { customerPortalOrdersList } from "@polar-sh/sdk/funcs/customerPortalOrde
 
 // Use `PolarCore` for best tree-shaking performance.
 // You can create one instance of it to use across an application.
-const polar = new PolarCore({
-  accessToken: process.env["POLAR_ACCESS_TOKEN"] ?? "",
-});
+const polar = new PolarCore();
 
 async function run() {
-  const res = await customerPortalOrdersList(polar, {});
+  const res = await customerPortalOrdersList(polar, {
+    customerSession: process.env["POLAR_CUSTOMER_SESSION"] ?? "",
+  }, {});
 
   if (!res.ok) {
     throw res.error;
@@ -71,6 +73,7 @@ run();
 | Parameter                                                                                                                                                                      | Type                                                                                                                                                                           | Required                                                                                                                                                                       | Description                                                                                                                                                                    |
 | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
 | `request`                                                                                                                                                                      | [operations.CustomerPortalOrdersListRequest](../../models/operations/customerportalorderslistrequest.md)                                                                       | :heavy_check_mark:                                                                                                                                                             | The request object to use for the request.                                                                                                                                     |
+| `security`                                                                                                                                                                     | [operations.CustomerPortalOrdersListSecurity](../../models/operations/customerportalorderslistsecurity.md)                                                                     | :heavy_check_mark:                                                                                                                                                             | The security requirements to use for the request.                                                                                                                              |
 | `options`                                                                                                                                                                      | RequestOptions                                                                                                                                                                 | :heavy_minus_sign:                                                                                                                                                             | Used to set various options for making HTTP requests.                                                                                                                          |
 | `options.fetchOptions`                                                                                                                                                         | [RequestInit](https://developer.mozilla.org/en-US/docs/Web/API/Request/Request#options)                                                                                        | :heavy_minus_sign:                                                                                                                                                             | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All `Request` options, except `method` and `body`, are allowed. |
 | `options.retries`                                                                                                                                                              | [RetryConfig](../../lib/utils/retryconfig.md)                                                                                                                                  | :heavy_minus_sign:                                                                                                                                                             | Enables retrying HTTP requests under certain failure conditions.                                                                                                               |
@@ -88,19 +91,21 @@ run();
 
 ## get
 
-Get an order by ID for the authenticated customer or user.
+Get an order by ID for the authenticated customer.
+
+**Scopes**: `customer_portal:read` `customer_portal:write`
 
 ### Example Usage
 
 ```typescript
 import { Polar } from "@polar-sh/sdk";
 
-const polar = new Polar({
-  accessToken: process.env["POLAR_ACCESS_TOKEN"] ?? "",
-});
+const polar = new Polar();
 
 async function run() {
   const result = await polar.customerPortal.orders.get({
+    customerSession: process.env["POLAR_CUSTOMER_SESSION"] ?? "",
+  }, {
     id: "<value>",
   });
 
@@ -121,12 +126,12 @@ import { customerPortalOrdersGet } from "@polar-sh/sdk/funcs/customerPortalOrder
 
 // Use `PolarCore` for best tree-shaking performance.
 // You can create one instance of it to use across an application.
-const polar = new PolarCore({
-  accessToken: process.env["POLAR_ACCESS_TOKEN"] ?? "",
-});
+const polar = new PolarCore();
 
 async function run() {
   const res = await customerPortalOrdersGet(polar, {
+    customerSession: process.env["POLAR_CUSTOMER_SESSION"] ?? "",
+  }, {
     id: "<value>",
   });
 
@@ -148,6 +153,7 @@ run();
 | Parameter                                                                                                                                                                      | Type                                                                                                                                                                           | Required                                                                                                                                                                       | Description                                                                                                                                                                    |
 | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
 | `request`                                                                                                                                                                      | [operations.CustomerPortalOrdersGetRequest](../../models/operations/customerportalordersgetrequest.md)                                                                         | :heavy_check_mark:                                                                                                                                                             | The request object to use for the request.                                                                                                                                     |
+| `security`                                                                                                                                                                     | [operations.CustomerPortalOrdersGetSecurity](../../models/operations/customerportalordersgetsecurity.md)                                                                       | :heavy_check_mark:                                                                                                                                                             | The security requirements to use for the request.                                                                                                                              |
 | `options`                                                                                                                                                                      | RequestOptions                                                                                                                                                                 | :heavy_minus_sign:                                                                                                                                                             | Used to set various options for making HTTP requests.                                                                                                                          |
 | `options.fetchOptions`                                                                                                                                                         | [RequestInit](https://developer.mozilla.org/en-US/docs/Web/API/Request/Request#options)                                                                                        | :heavy_minus_sign:                                                                                                                                                             | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All `Request` options, except `method` and `body`, are allowed. |
 | `options.retries`                                                                                                                                                              | [RetryConfig](../../lib/utils/retryconfig.md)                                                                                                                                  | :heavy_minus_sign:                                                                                                                                                             | Enables retrying HTTP requests under certain failure conditions.                                                                                                               |
@@ -168,17 +174,19 @@ run();
 
 Get an order's invoice data.
 
+**Scopes**: `customer_portal:read` `customer_portal:write`
+
 ### Example Usage
 
 ```typescript
 import { Polar } from "@polar-sh/sdk";
 
-const polar = new Polar({
-  accessToken: process.env["POLAR_ACCESS_TOKEN"] ?? "",
-});
+const polar = new Polar();
 
 async function run() {
   const result = await polar.customerPortal.orders.invoice({
+    customerSession: process.env["POLAR_CUSTOMER_SESSION"] ?? "",
+  }, {
     id: "<value>",
   });
 
@@ -199,12 +207,12 @@ import { customerPortalOrdersInvoice } from "@polar-sh/sdk/funcs/customerPortalO
 
 // Use `PolarCore` for best tree-shaking performance.
 // You can create one instance of it to use across an application.
-const polar = new PolarCore({
-  accessToken: process.env["POLAR_ACCESS_TOKEN"] ?? "",
-});
+const polar = new PolarCore();
 
 async function run() {
   const res = await customerPortalOrdersInvoice(polar, {
+    customerSession: process.env["POLAR_CUSTOMER_SESSION"] ?? "",
+  }, {
     id: "<value>",
   });
 
@@ -226,6 +234,7 @@ run();
 | Parameter                                                                                                                                                                      | Type                                                                                                                                                                           | Required                                                                                                                                                                       | Description                                                                                                                                                                    |
 | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
 | `request`                                                                                                                                                                      | [operations.CustomerPortalOrdersInvoiceRequest](../../models/operations/customerportalordersinvoicerequest.md)                                                                 | :heavy_check_mark:                                                                                                                                                             | The request object to use for the request.                                                                                                                                     |
+| `security`                                                                                                                                                                     | [operations.CustomerPortalOrdersInvoiceSecurity](../../models/operations/customerportalordersinvoicesecurity.md)                                                               | :heavy_check_mark:                                                                                                                                                             | The security requirements to use for the request.                                                                                                                              |
 | `options`                                                                                                                                                                      | RequestOptions                                                                                                                                                                 | :heavy_minus_sign:                                                                                                                                                             | Used to set various options for making HTTP requests.                                                                                                                          |
 | `options.fetchOptions`                                                                                                                                                         | [RequestInit](https://developer.mozilla.org/en-US/docs/Web/API/Request/Request#options)                                                                                        | :heavy_minus_sign:                                                                                                                                                             | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All `Request` options, except `method` and `body`, are allowed. |
 | `options.retries`                                                                                                                                                              | [RetryConfig](../../lib/utils/retryconfig.md)                                                                                                                                  | :heavy_minus_sign:                                                                                                                                                             | Enables retrying HTTP requests under certain failure conditions.                                                                                                               |

package/docs/sdks/polarsubscriptions/README.md

@@ -12,19 +12,21 @@
 
 ## list
 
-List subscriptions of the authenticated customer or user.
+List subscriptions of the authenticated customer.
+
+**Scopes**: `customer_portal:read` `customer_portal:write`
 
 ### Example Usage
 
 ```typescript
 import { Polar } from "@polar-sh/sdk";
 
-const polar = new Polar({
-  accessToken: process.env["POLAR_ACCESS_TOKEN"] ?? "",
-});
+const polar = new Polar();
 
 async function run() {
-  const result = await polar.customerPortal.subscriptions.list({});
+  const result = await polar.customerPortal.subscriptions.list({
+    customerSession: process.env["POLAR_CUSTOMER_SESSION"] ?? "",
+  }, {});
 
   for await (const page of result) {
     // Handle the page
@@ -45,12 +47,12 @@ import { customerPortalSubscriptionsList } from "@polar-sh/sdk/funcs/customerPor
 
 // Use `PolarCore` for best tree-shaking performance.
 // You can create one instance of it to use across an application.
-const polar = new PolarCore({
-  accessToken: process.env["POLAR_ACCESS_TOKEN"] ?? "",
-});
+const polar = new PolarCore();
 
 async function run() {
-  const res = await customerPortalSubscriptionsList(polar, {});
+  const res = await customerPortalSubscriptionsList(polar, {
+    customerSession: process.env["POLAR_CUSTOMER_SESSION"] ?? "",
+  }, {});
 
   if (!res.ok) {
     throw res.error;
@@ -72,6 +74,7 @@ run();
 | Parameter                                                                                                                                                                      | Type                                                                                                                                                                           | Required                                                                                                                                                                       | Description                                                                                                                                                                    |
 | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
 | `request`                                                                                                                                                                      | [operations.CustomerPortalSubscriptionsListRequest](../../models/operations/customerportalsubscriptionslistrequest.md)                                                         | :heavy_check_mark:                                                                                                                                                             | The request object to use for the request.                                                                                                                                     |
+| `security`                                                                                                                                                                     | [operations.CustomerPortalSubscriptionsListSecurity](../../models/operations/customerportalsubscriptionslistsecurity.md)                                                       | :heavy_check_mark:                                                                                                                                                             | The security requirements to use for the request.                                                                                                                              |
 | `options`                                                                                                                                                                      | RequestOptions                                                                                                                                                                 | :heavy_minus_sign:                                                                                                                                                             | Used to set various options for making HTTP requests.                                                                                                                          |
 | `options.fetchOptions`                                                                                                                                                         | [RequestInit](https://developer.mozilla.org/en-US/docs/Web/API/Request/Request#options)                                                                                        | :heavy_minus_sign:                                                                                                                                                             | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All `Request` options, except `method` and `body`, are allowed. |
 | `options.retries`                                                                                                                                                              | [RetryConfig](../../lib/utils/retryconfig.md)                                                                                                                                  | :heavy_minus_sign:                                                                                                                                                             | Enables retrying HTTP requests under certain failure conditions.                                                                                                               |
@@ -89,19 +92,21 @@ run();
 
 ## get
 
-Get a subscription for the authenticated customer or user.
+Get a subscription for the authenticated customer.
+
+**Scopes**: `customer_portal:read` `customer_portal:write`
 
 ### Example Usage
 
 ```typescript
 import { Polar } from "@polar-sh/sdk";
 
-const polar = new Polar({
-  accessToken: process.env["POLAR_ACCESS_TOKEN"] ?? "",
-});
+const polar = new Polar();
 
 async function run() {
   const result = await polar.customerPortal.subscriptions.get({
+    customerSession: process.env["POLAR_CUSTOMER_SESSION"] ?? "",
+  }, {
     id: "<value>",
   });
 
@@ -122,12 +127,12 @@ import { customerPortalSubscriptionsGet } from "@polar-sh/sdk/funcs/customerPort
 
 // Use `PolarCore` for best tree-shaking performance.
 // You can create one instance of it to use across an application.
-const polar = new PolarCore({
-  accessToken: process.env["POLAR_ACCESS_TOKEN"] ?? "",
-});
+const polar = new PolarCore();
 
 async function run() {
   const res = await customerPortalSubscriptionsGet(polar, {
+    customerSession: process.env["POLAR_CUSTOMER_SESSION"] ?? "",
+  }, {
     id: "<value>",
   });
 
@@ -149,6 +154,7 @@ run();
 | Parameter                                                                                                                                                                      | Type                                                                                                                                                                           | Required                                                                                                                                                                       | Description                                                                                                                                                                    |
 | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
 | `request`                                                                                                                                                                      | [operations.CustomerPortalSubscriptionsGetRequest](../../models/operations/customerportalsubscriptionsgetrequest.md)                                                           | :heavy_check_mark:                                                                                                                                                             | The request object to use for the request.                                                                                                                                     |
+| `security`                                                                                                                                                                     | [operations.CustomerPortalSubscriptionsGetSecurity](../../models/operations/customerportalsubscriptionsgetsecurity.md)                                                         | :heavy_check_mark:                                                                                                                                                             | The security requirements to use for the request.                                                                                                                              |
 | `options`                                                                                                                                                                      | RequestOptions                                                                                                                                                                 | :heavy_minus_sign:                                                                                                                                                             | Used to set various options for making HTTP requests.                                                                                                                          |
 | `options.fetchOptions`                                                                                                                                                         | [RequestInit](https://developer.mozilla.org/en-US/docs/Web/API/Request/Request#options)                                                                                        | :heavy_minus_sign:                                                                                                                                                             | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All `Request` options, except `method` and `body`, are allowed. |
 | `options.retries`                                                                                                                                                              | [RetryConfig](../../lib/utils/retryconfig.md)                                                                                                                                  | :heavy_minus_sign:                                                                                                                                                             | Enables retrying HTTP requests under certain failure conditions.                                                                                                               |
@@ -167,19 +173,21 @@ run();
 
 ## update
 
-Update a subscription of the authenticated customer or user.
+Update a subscription of the authenticated customer.
+
+**Scopes**: `customer_portal:write`
 
 ### Example Usage
 
 ```typescript
 import { Polar } from "@polar-sh/sdk";
 
-const polar = new Polar({
-  accessToken: process.env["POLAR_ACCESS_TOKEN"] ?? "",
-});
+const polar = new Polar();
 
 async function run() {
   const result = await polar.customerPortal.subscriptions.update({
+    customerSession: process.env["POLAR_CUSTOMER_SESSION"] ?? "",
+  }, {
     id: "<value>",
     customerSubscriptionUpdate: {},
   });
@@ -201,12 +209,12 @@ import { customerPortalSubscriptionsUpdate } from "@polar-sh/sdk/funcs/customerP
 
 // Use `PolarCore` for best tree-shaking performance.
 // You can create one instance of it to use across an application.
-const polar = new PolarCore({
-  accessToken: process.env["POLAR_ACCESS_TOKEN"] ?? "",
-});
+const polar = new PolarCore();
 
 async function run() {
   const res = await customerPortalSubscriptionsUpdate(polar, {
+    customerSession: process.env["POLAR_CUSTOMER_SESSION"] ?? "",
+  }, {
     id: "<value>",
     customerSubscriptionUpdate: {},
   });
@@ -229,6 +237,7 @@ run();
 | Parameter                                                                                                                                                                      | Type                                                                                                                                                                           | Required                                                                                                                                                                       | Description                                                                                                                                                                    |
 | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
 | `request`                                                                                                                                                                      | [operations.CustomerPortalSubscriptionsUpdateRequest](../../models/operations/customerportalsubscriptionsupdaterequest.md)                                                     | :heavy_check_mark:                                                                                                                                                             | The request object to use for the request.                                                                                                                                     |
+| `security`                                                                                                                                                                     | [operations.CustomerPortalSubscriptionsUpdateSecurity](../../models/operations/customerportalsubscriptionsupdatesecurity.md)                                                   | :heavy_check_mark:                                                                                                                                                             | The security requirements to use for the request.                                                                                                                              |
 | `options`                                                                                                                                                                      | RequestOptions                                                                                                                                                                 | :heavy_minus_sign:                                                                                                                                                             | Used to set various options for making HTTP requests.                                                                                                                          |
 | `options.fetchOptions`                                                                                                                                                         | [RequestInit](https://developer.mozilla.org/en-US/docs/Web/API/Request/Request#options)                                                                                        | :heavy_minus_sign:                                                                                                                                                             | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All `Request` options, except `method` and `body`, are allowed. |
 | `options.retries`                                                                                                                                                              | [RetryConfig](../../lib/utils/retryconfig.md)                                                                                                                                  | :heavy_minus_sign:                                                                                                                                                             | Enables retrying HTTP requests under certain failure conditions.                                                                                                               |
@@ -248,19 +257,21 @@ run();
 
 ## cancel
 
-Cancel a subscription of the authenticated customer or user.
+Cancel a subscription of the authenticated customer.
+
+**Scopes**: `customer_portal:write`
 
 ### Example Usage
 
 ```typescript
 import { Polar } from "@polar-sh/sdk";
 
-const polar = new Polar({
-  accessToken: process.env["POLAR_ACCESS_TOKEN"] ?? "",
-});
+const polar = new Polar();
 
 async function run() {
   const result = await polar.customerPortal.subscriptions.cancel({
+    customerSession: process.env["POLAR_CUSTOMER_SESSION"] ?? "",
+  }, {
     id: "<value>",
   });
 
@@ -281,12 +292,12 @@ import { customerPortalSubscriptionsCancel } from "@polar-sh/sdk/funcs/customerP
 
 // Use `PolarCore` for best tree-shaking performance.
 // You can create one instance of it to use across an application.
-const polar = new PolarCore({
-  accessToken: process.env["POLAR_ACCESS_TOKEN"] ?? "",
-});
+const polar = new PolarCore();
 
 async function run() {
   const res = await customerPortalSubscriptionsCancel(polar, {
+    customerSession: process.env["POLAR_CUSTOMER_SESSION"] ?? "",
+  }, {
     id: "<value>",
   });
 
@@ -308,6 +319,7 @@ run();
 | Parameter                                                                                                                                                                      | Type                                                                                                                                                                           | Required                                                                                                                                                                       | Description                                                                                                                                                                    |
 | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
 | `request`                                                                                                                                                                      | [operations.CustomerPortalSubscriptionsCancelRequest](../../models/operations/customerportalsubscriptionscancelrequest.md)                                                     | :heavy_check_mark:                                                                                                                                                             | The request object to use for the request.                                                                                                                                     |
+| `security`                                                                                                                                                                     | [operations.CustomerPortalSubscriptionsCancelSecurity](../../models/operations/customerportalsubscriptionscancelsecurity.md)                                                   | :heavy_check_mark:                                                                                                                                                             | The security requirements to use for the request.                                                                                                                              |
 | `options`                                                                                                                                                                      | RequestOptions                                                                                                                                                                 | :heavy_minus_sign:                                                                                                                                                             | Used to set various options for making HTTP requests.                                                                                                                          |
 | `options.fetchOptions`                                                                                                                                                         | [RequestInit](https://developer.mozilla.org/en-US/docs/Web/API/Request/Request#options)                                                                                        | :heavy_minus_sign:                                                                                                                                                             | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All `Request` options, except `method` and `body`, are allowed. |
 | `options.retries`                                                                                                                                                              | [RetryConfig](../../lib/utils/retryconfig.md)                                                                                                                                  | :heavy_minus_sign:                                                                                                                                                             | Enables retrying HTTP requests under certain failure conditions.                                                                                                               |

package/docs/sdks/products/README.md

@@ -15,6 +15,8 @@
 
 List products.
 
+**Scopes**: `products:read` `products:write`
+
 ### Example Usage
 
 ```typescript
@@ -92,6 +94,8 @@ run();
 
 Create a product.
 
+**Scopes**: `products:write`
+
 ### Example Usage
 
 ```typescript
@@ -181,6 +185,8 @@ run();
 
 Get a product by ID.
 
+**Scopes**: `products:read` `products:write`
+
 ### Example Usage
 
 ```typescript
@@ -259,6 +265,8 @@ run();
 
 Update a product.
 
+**Scopes**: `products:write`
+
 ### Example Usage
 
 ```typescript
@@ -340,6 +348,8 @@ run();
 
 Update benefits granted by a product.
 
+**Scopes**: `products:write`
+
 ### Example Usage
 
 ```typescript

package/docs/sdks/refunds/README.md

@@ -12,6 +12,8 @@
 
 List products.
 
+**Scopes**: `refunds:read` `refunds:write`
+
 ### Example Usage
 
 ```typescript
@@ -89,6 +91,8 @@ run();
 
 Create a refund.
 
+**Scopes**: `refunds:write`
+
 ### Example Usage
 
 ```typescript

package/docs/sdks/repositories/README.md

@@ -13,6 +13,8 @@
 
 List repositories.
 
+**Scopes**: `repositories:read` `repositories:write`
+
 ### Example Usage
 
 ```typescript
@@ -90,6 +92,8 @@ run();
 
 Get a repository by ID.
 
+**Scopes**: `repositories:read` `repositories:write`
+
 ### Example Usage
 
 ```typescript
@@ -168,6 +172,8 @@ run();
 
 Update a repository.
 
+**Scopes**: `repositories:write`
+
 ### Example Usage
 
 ```typescript

package/docs/sdks/subscriptions/README.md

@@ -15,6 +15,8 @@
 
 List subscriptions.
 
+**Scopes**: `subscriptions:read` `subscriptions:write`
+
 ### Example Usage
 
 ```typescript
@@ -92,6 +94,8 @@ run();
 
 Export subscriptions as a CSV file.
 
+**Scopes**: `subscriptions:read` `subscriptions:write`
+
 ### Example Usage
 
 ```typescript
@@ -165,6 +169,8 @@ run();
 
 Get a subscription by ID.
 
+**Scopes**: `subscriptions:write`
+
 ### Example Usage
 
 ```typescript
@@ -243,6 +249,8 @@ run();
 
 Update a subscription.
 
+**Scopes**: `subscriptions:write`
+
 ### Example Usage
 
 ```typescript
@@ -324,6 +332,8 @@ run();
 
 Revoke a subscription, i.e cancel immediately.
 
+**Scopes**: `subscriptions:write`
+
 ### Example Usage
 
 ```typescript

package/jsr.json

@@ -2,7 +2,7 @@
 
 {
   "name": "@polar-sh/sdk",
-  "version": "0.26.0",
+  "version": "0.27.0",
   "exports": {
     ".": "./src/index.ts",    
     "./models/errors": "./src/models/errors/index.ts",    

package/package.json

@@ -1,8 +1,11 @@
 {
   "name": "@polar-sh/sdk",
-  "version": "0.26.0",
+  "version": "0.27.0",
   "author": "Speakeasy",
   "type": "module",
+  "bin": {
+    "mcp": "bin/mcp-server.js"
+  },
   "tshy": {
     "sourceDialects": [
       "@polar-sh/sdk/source"
@@ -21,17 +24,30 @@
   },
   "scripts": {
     "lint": "eslint --cache --max-warnings=0 src",
-    "build": "tshy",
+    "build:mcp": "bun src/mcp-server/build.mts",
+    "build": "npm run build:mcp && tshy",
     "prepublishOnly": "npm run build"
   },
   "peerDependencies": {
+    "@modelcontextprotocol/sdk": "^1.5.0",
     "zod": ">= 3"
   },
+  "peerDependenciesMeta": {
+    "@modelcontextprotocol/sdk": {
+      "optional": true
+    }
+  },
   "devDependencies": {
     "@eslint/js": "^9.19.0",
+    "@modelcontextprotocol/sdk": "^1.5.0",
+    "@stricli/core": "^1.1.1",
+    "@types/express": "^4.17.21",
     "@types/jest": "*",
     "@types/node": "*",
+    "bun": "^1.2.2",
+    "bun-types": "^1.2.2",
     "eslint": "^9.19.0",
+    "express": "^4.21.2",
     "globals": "^15.14.0",
     "jest": "*",
     "ts-jest": "*",

package/src/funcs/advertisementsGet.ts

@@ -119,7 +119,7 @@ async function $do(
   const requestSecurity = resolveGlobalSecurity(securityInput);
 
   const context = {
-    baseURL: options?.serverURL ?? "",
+    baseURL: options?.serverURL ?? client._baseURL ?? "",
     operationID: "advertisements:get",
     oAuth2Scopes: [],
 

package/src/funcs/advertisementsList.ts

@@ -124,7 +124,7 @@ async function $do(
   const requestSecurity = resolveGlobalSecurity(securityInput);
 
   const context = {
-    baseURL: options?.serverURL ?? "",
+    baseURL: options?.serverURL ?? client._baseURL ?? "",
     operationID: "advertisements:list",
     oAuth2Scopes: [],
 

package/src/funcs/benefitsCreate.ts

@@ -39,6 +39,8 @@ import { Result } from "../types/fp.js";
  *
  * @remarks
  * Create a benefit.
+ *
+ * **Scopes**: `benefits:write`
  */
 export function benefitsCreate(
   client: PolarCore,
@@ -107,7 +109,7 @@ async function $do(
   const requestSecurity = resolveGlobalSecurity(securityInput);
 
   const context = {
-    baseURL: options?.serverURL ?? "",
+    baseURL: options?.serverURL ?? client._baseURL ?? "",
     operationID: "benefits:create",
     oAuth2Scopes: [],
 

package/src/funcs/benefitsDelete.ts

@@ -48,6 +48,8 @@ import { Result } from "../types/fp.js";
  * > [!WARNING]
  * > Every grants associated with the benefit will be revoked.
  * > Users will lose access to the benefit.
+ *
+ * **Scopes**: `benefits:write`
  */
 export function benefitsDelete(
   client: PolarCore,
@@ -126,7 +128,7 @@ async function $do(
   const requestSecurity = resolveGlobalSecurity(securityInput);
 
   const context = {
-    baseURL: options?.serverURL ?? "",
+    baseURL: options?.serverURL ?? client._baseURL ?? "",
     operationID: "benefits:delete",
     oAuth2Scopes: [],
 

package/src/funcs/benefitsGet.ts

@@ -43,6 +43,8 @@ import { Result } from "../types/fp.js";
  *
  * @remarks
  * Get a benefit by ID.
+ *
+ * **Scopes**: `benefits:read` `benefits:write`
  */
 export function benefitsGet(
   client: PolarCore,
@@ -119,7 +121,7 @@ async function $do(
   const requestSecurity = resolveGlobalSecurity(securityInput);
 
   const context = {
-    baseURL: options?.serverURL ?? "",
+    baseURL: options?.serverURL ?? client._baseURL ?? "",
     operationID: "benefits:get",
     oAuth2Scopes: [],