@polar-sh/sdk 0.32.13 → 0.32.15

package/docs/sdks/files/README.md

@@ -114,15 +114,9 @@ async function run() {
     organizationId: "1dbfc517-0bbf-4301-9ba8-555ca42b9737",
     name: "<value>",
     mimeType: "<value>",
-    size: 638424,
+    size: 612128,
     upload: {
-      parts: [
-        {
-          number: 417458,
-          chunkStart: 134365,
-          chunkEnd: 69025,
-        },
-      ],
+      parts: [],
     },
   });
 
@@ -152,15 +146,9 @@ async function run() {
     organizationId: "1dbfc517-0bbf-4301-9ba8-555ca42b9737",
     name: "<value>",
     mimeType: "<value>",
-    size: 816588,
+    size: 612128,
     upload: {
-      parts: [
-        {
-          number: 586220,
-          chunkStart: 752438,
-          chunkEnd: 957409,
-        },
-      ],
+      parts: [],
     },
   });
 
@@ -217,20 +205,20 @@ async function run() {
     id: "<value>",
     fileUploadCompleted: {
       id: "<id>",
-      path: "/sys",
+      path: "/boot",
       parts: [
         {
-          number: 173116,
+          number: 979613,
           checksumEtag: "<value>",
           checksumSha256Base64: "<value>",
         },
         {
-          number: 894030,
+          number: 979613,
           checksumEtag: "<value>",
           checksumSha256Base64: "<value>",
         },
         {
-          number: 673715,
+          number: 979613,
           checksumEtag: "<value>",
           checksumSha256Base64: "<value>",
         },
@@ -264,20 +252,20 @@ async function run() {
     id: "<value>",
     fileUploadCompleted: {
       id: "<id>",
-      path: "/sys",
+      path: "/boot",
       parts: [
         {
-          number: 173116,
+          number: 979613,
           checksumEtag: "<value>",
           checksumSha256Base64: "<value>",
         },
         {
-          number: 894030,
+          number: 979613,
           checksumEtag: "<value>",
           checksumSha256Base64: "<value>",
         },
         {
-          number: 673715,
+          number: 979613,
           checksumEtag: "<value>",
           checksumSha256Base64: "<value>",
         },

package/docs/sdks/licensekeys/README.md

@@ -27,9 +27,7 @@ const polar = new Polar({
 
 async function run() {
   const result = await polar.licenseKeys.list({
-    organizationId: [
-      "1dbfc517-0bbf-4301-9ba8-555ca42b9737",
-    ],
+    organizationId: "1dbfc517-0bbf-4301-9ba8-555ca42b9737",
   });
 
   for await (const page of result) {
@@ -57,9 +55,7 @@ const polar = new PolarCore({
 
 async function run() {
   const res = await licenseKeysList(polar, {
-    organizationId: [
-      "1dbfc517-0bbf-4301-9ba8-555ca42b9737",
-    ],
+    organizationId: "1dbfc517-0bbf-4301-9ba8-555ca42b9737",
   });
 
   if (!res.ok) {

package/docs/sdks/meters/README.md

@@ -28,9 +28,7 @@ const polar = new Polar({
 
 async function run() {
   const result = await polar.meters.list({
-    organizationId: [
-      "1dbfc517-0bbf-4301-9ba8-555ca42b9737",
-    ],
+    organizationId: "1dbfc517-0bbf-4301-9ba8-555ca42b9737",
   });
 
   for await (const page of result) {
@@ -58,9 +56,7 @@ const polar = new PolarCore({
 
 async function run() {
   const res = await metersList(polar, {
-    organizationId: [
-      "1dbfc517-0bbf-4301-9ba8-555ca42b9737",
-    ],
+    organizationId: "1dbfc517-0bbf-4301-9ba8-555ca42b9737",
   });
 
   if (!res.ok) {
@@ -117,11 +113,17 @@ async function run() {
   const result = await polar.meters.create({
     name: "<value>",
     filter: {
-      conjunction: "and",
-      clauses: [],
+      conjunction: "or",
+      clauses: [
+        {
+          property: "<value>",
+          operator: "ne",
+          value: "<value>",
+        },
+      ],
     },
     aggregation: {
-      func: "sum",
+      func: "max",
       property: "<value>",
     },
     organizationId: "1dbfc517-0bbf-4301-9ba8-555ca42b9737",
@@ -152,11 +154,17 @@ async function run() {
   const res = await metersCreate(polar, {
     name: "<value>",
     filter: {
-      conjunction: "and",
-      clauses: [],
+      conjunction: "or",
+      clauses: [
+        {
+          property: "<value>",
+          operator: "ne",
+          value: "<value>",
+        },
+      ],
     },
     aggregation: {
-      func: "sum",
+      func: "max",
       property: "<value>",
     },
     organizationId: "1dbfc517-0bbf-4301-9ba8-555ca42b9737",
@@ -375,9 +383,9 @@ const polar = new Polar({
 async function run() {
   const result = await polar.meters.quantities({
     id: "<value>",
-    startTimestamp: new Date("2023-09-17T00:45:34.608Z"),
-    endTimestamp: new Date("2023-07-21T18:11:39.069Z"),
-    interval: "hour",
+    startTimestamp: new Date("2025-11-25T04:37:16.823Z"),
+    endTimestamp: new Date("2025-11-26T17:06:00.727Z"),
+    interval: "day",
   });
 
   // Handle the result
@@ -404,9 +412,9 @@ const polar = new PolarCore({
 async function run() {
   const res = await metersQuantities(polar, {
     id: "<value>",
-    startTimestamp: new Date("2023-09-17T00:45:34.608Z"),
-    endTimestamp: new Date("2023-07-21T18:11:39.069Z"),
-    interval: "hour",
+    startTimestamp: new Date("2025-11-25T04:37:16.823Z"),
+    endTimestamp: new Date("2025-11-26T17:06:00.727Z"),
+    interval: "day",
   });
 
   if (!res.ok) {

package/docs/sdks/metrics/README.md

@@ -28,12 +28,10 @@ const polar = new Polar({
 
 async function run() {
   const result = await polar.metrics.get({
-    startDate: new RFCDate("2025-02-06"),
-    endDate: new RFCDate("2024-09-04"),
-    interval: "week",
-    organizationId: [
-      "1dbfc517-0bbf-4301-9ba8-555ca42b9737",
-    ],
+    startDate: new RFCDate("2025-03-14"),
+    endDate: new RFCDate("2025-03-18"),
+    interval: "hour",
+    organizationId: "1dbfc517-0bbf-4301-9ba8-555ca42b9737",
   });
 
   // Handle the result
@@ -60,12 +58,10 @@ const polar = new PolarCore({
 
 async function run() {
   const res = await metricsGet(polar, {
-    startDate: new RFCDate("2025-02-06"),
-    endDate: new RFCDate("2024-09-04"),
-    interval: "week",
-    organizationId: [
-      "1dbfc517-0bbf-4301-9ba8-555ca42b9737",
-    ],
+    startDate: new RFCDate("2025-03-14"),
+    endDate: new RFCDate("2025-03-18"),
+    interval: "hour",
+    organizationId: "1dbfc517-0bbf-4301-9ba8-555ca42b9737",
   });
 
   if (!res.ok) {

package/docs/sdks/oauth2/README.md

@@ -98,7 +98,7 @@ async function run() {
     clientId: "<id>",
     clientSecret: "<value>",
     code: "<value>",
-    redirectUri: "https://old-fort.name",
+    redirectUri: "https://memorable-season.name",
   });
 
   // Handle the result
@@ -125,7 +125,7 @@ async function run() {
     clientId: "<id>",
     clientSecret: "<value>",
     code: "<value>",
-    redirectUri: "https://ajar-comparison.name",
+    redirectUri: "https://memorable-season.name",
   });
 
   if (!res.ok) {

package/docs/sdks/payments/README.md

@@ -0,0 +1,172 @@
+# Payments
+(*payments*)
+
+## Overview
+
+### Available Operations
+
+* [list](#list) - List Payments
+* [get](#get) - Get Payment
+
+## list
+
+List payments.
+
+**Scopes**: `payments:read`
+
+### Example Usage
+
+```typescript
+import { Polar } from "@polar-sh/sdk";
+
+const polar = new Polar({
+  accessToken: process.env["POLAR_ACCESS_TOKEN"] ?? "",
+});
+
+async function run() {
+  const result = await polar.payments.list({
+    organizationId: "1dbfc517-0bbf-4301-9ba8-555ca42b9737",
+  });
+
+  for await (const page of result) {
+    // Handle the page
+    console.log(page);
+  }
+}
+
+run();
+```
+
+### Standalone function
+
+The standalone function version of this method:
+
+```typescript
+import { PolarCore } from "@polar-sh/sdk/core.js";
+import { paymentsList } from "@polar-sh/sdk/funcs/paymentsList.js";
+
+// 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"] ?? "",
+});
+
+async function run() {
+  const res = await paymentsList(polar, {
+    organizationId: "1dbfc517-0bbf-4301-9ba8-555ca42b9737",
+  });
+
+  if (!res.ok) {
+    throw res.error;
+  }
+
+  const { value: result } = res;
+
+  for await (const page of result) {
+    // Handle the page
+    console.log(page);
+  }
+}
+
+run();
+```
+
+### Parameters
+
+| Parameter                                                                                                                                                                      | Type                                                                                                                                                                           | Required                                                                                                                                                                       | Description                                                                                                                                                                    |
+| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `request`                                                                                                                                                                      | [operations.PaymentsListRequest](../../models/operations/paymentslistrequest.md)                                                                                               | :heavy_check_mark:                                                                                                                                                             | The request object 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.                                                                                                               |
+
+### Response
+
+**Promise\<[operations.PaymentsListResponse](../../models/operations/paymentslistresponse.md)\>**
+
+### Errors
+
+| Error Type                 | Status Code                | Content Type               |
+| -------------------------- | -------------------------- | -------------------------- |
+| errors.HTTPValidationError | 422                        | application/json           |
+| errors.SDKError            | 4XX, 5XX                   | \*/\*                      |
+
+## get
+
+Get a payment by ID.
+
+**Scopes**: `payments:read`
+
+### Example Usage
+
+```typescript
+import { Polar } from "@polar-sh/sdk";
+
+const polar = new Polar({
+  accessToken: process.env["POLAR_ACCESS_TOKEN"] ?? "",
+});
+
+async function run() {
+  const result = await polar.payments.get({
+    id: "<value>",
+  });
+
+  // Handle the result
+  console.log(result);
+}
+
+run();
+```
+
+### Standalone function
+
+The standalone function version of this method:
+
+```typescript
+import { PolarCore } from "@polar-sh/sdk/core.js";
+import { paymentsGet } from "@polar-sh/sdk/funcs/paymentsGet.js";
+
+// 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"] ?? "",
+});
+
+async function run() {
+  const res = await paymentsGet(polar, {
+    id: "<value>",
+  });
+
+  if (!res.ok) {
+    throw res.error;
+  }
+
+  const { value: result } = res;
+
+  // Handle the result
+  console.log(result);
+}
+
+run();
+```
+
+### Parameters
+
+| Parameter                                                                                                                                                                      | Type                                                                                                                                                                           | Required                                                                                                                                                                       | Description                                                                                                                                                                    |
+| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `request`                                                                                                                                                                      | [operations.PaymentsGetRequest](../../models/operations/paymentsgetrequest.md)                                                                                                 | :heavy_check_mark:                                                                                                                                                             | The request object 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.                                                                                                               |
+
+### Response
+
+**Promise\<[components.Payment](../../models/components/payment.md)\>**
+
+### Errors
+
+| Error Type                 | Status Code                | Content Type               |
+| -------------------------- | -------------------------- | -------------------------- |
+| errors.ResourceNotFound    | 404                        | application/json           |
+| errors.HTTPValidationError | 422                        | application/json           |
+| errors.SDKError            | 4XX, 5XX                   | \*/\*                      |

package/docs/sdks/polarcustomers/README.md

@@ -103,7 +103,7 @@ async function run() {
     customerSession: process.env["POLAR_CUSTOMER_SESSION"] ?? "",
   }, {
     billingAddress: {
-      country: "FR",
+      country: "US",
     },
   });
 
@@ -131,7 +131,7 @@ async function run() {
     customerSession: process.env["POLAR_CUSTOMER_SESSION"] ?? "",
   }, {
     billingAddress: {
-      country: "FR",
+      country: "US",
     },
   });
 
@@ -268,7 +268,7 @@ async function run() {
   }, {
     confirmationTokenId: "<id>",
     setDefault: false,
-    returnUrl: "https://slight-digestive.info",
+    returnUrl: "https://yearly-custom.net/",
   });
 
   // Handle the result
@@ -296,7 +296,7 @@ async function run() {
   }, {
     confirmationTokenId: "<id>",
     setDefault: false,
-    returnUrl: "https://slight-digestive.info",
+    returnUrl: "https://yearly-custom.net/",
   });
 
   if (!res.ok) {

package/docs/sdks/polarorders/README.md

@@ -26,9 +26,7 @@ async function run() {
   const result = await polar.customerPortal.orders.list({
     customerSession: process.env["POLAR_CUSTOMER_SESSION"] ?? "",
   }, {
-    organizationId: [
-      "1dbfc517-0bbf-4301-9ba8-555ca42b9737",
-    ],
+    organizationId: "1dbfc517-0bbf-4301-9ba8-555ca42b9737",
   });
 
   for await (const page of result) {
@@ -56,9 +54,7 @@ async function run() {
   const res = await customerPortalOrdersList(polar, {
     customerSession: process.env["POLAR_CUSTOMER_SESSION"] ?? "",
   }, {
-    organizationId: [
-      "1dbfc517-0bbf-4301-9ba8-555ca42b9737",
-    ],
+    organizationId: "1dbfc517-0bbf-4301-9ba8-555ca42b9737",
   });
 
   if (!res.ok) {

package/docs/sdks/polarsubscriptions/README.md

@@ -27,9 +27,7 @@ async function run() {
   const result = await polar.customerPortal.subscriptions.list({
     customerSession: process.env["POLAR_CUSTOMER_SESSION"] ?? "",
   }, {
-    organizationId: [
-      "1dbfc517-0bbf-4301-9ba8-555ca42b9737",
-    ],
+    organizationId: "1dbfc517-0bbf-4301-9ba8-555ca42b9737",
   });
 
   for await (const page of result) {
@@ -57,9 +55,7 @@ async function run() {
   const res = await customerPortalSubscriptionsList(polar, {
     customerSession: process.env["POLAR_CUSTOMER_SESSION"] ?? "",
   }, {
-    organizationId: [
-      "1dbfc517-0bbf-4301-9ba8-555ca42b9737",
-    ],
+    organizationId: "1dbfc517-0bbf-4301-9ba8-555ca42b9737",
   });
 
   if (!res.ok) {

package/docs/sdks/products/README.md

@@ -28,9 +28,7 @@ const polar = new Polar({
 
 async function run() {
   const result = await polar.products.list({
-    organizationId: [
-      "1dbfc517-0bbf-4301-9ba8-555ca42b9737",
-    ],
+    organizationId: "1dbfc517-0bbf-4301-9ba8-555ca42b9737",
   });
 
   for await (const page of result) {
@@ -58,9 +56,7 @@ const polar = new PolarCore({
 
 async function run() {
   const res = await productsList(polar, {
-    organizationId: [
-      "1dbfc517-0bbf-4301-9ba8-555ca42b9737",
-    ],
+    organizationId: "1dbfc517-0bbf-4301-9ba8-555ca42b9737",
   });
 
   if (!res.ok) {
@@ -116,12 +112,15 @@ const polar = new Polar({
 async function run() {
   const result = await polar.products.create({
     name: "<value>",
-    recurringInterval: "month",
+    recurringInterval: "year",
     prices: [
+      {
+        priceAmount: 677078,
+        priceCurrency: "usd",
+      },
       {
         priceCurrency: "usd",
       },
-      {},
     ],
     organizationId: "1dbfc517-0bbf-4301-9ba8-555ca42b9737",
   });
@@ -150,15 +149,13 @@ const polar = new PolarCore({
 async function run() {
   const res = await productsCreate(polar, {
     name: "<value>",
-    recurringInterval: "month",
+    recurringInterval: "year",
     prices: [
       {
-        meterId: "<value>",
+        priceAmount: 677078,
         priceCurrency: "usd",
-        unitAmount: "<value>",
       },
       {
-        priceAmount: 169727,
         priceCurrency: "usd",
       },
     ],
@@ -381,7 +378,9 @@ async function run() {
     id: "<value>",
     productBenefitsUpdate: {
       benefits: [
-        "<value>",
+        "<value 1>",
+        "<value 2>",
+        "<value 3>",
       ],
     },
   });
@@ -412,7 +411,9 @@ async function run() {
     id: "<value>",
     productBenefitsUpdate: {
       benefits: [
-        "<value>",
+        "<value 1>",
+        "<value 2>",
+        "<value 3>",
       ],
     },
   });

package/docs/sdks/refunds/README.md

@@ -25,9 +25,7 @@ const polar = new Polar({
 
 async function run() {
   const result = await polar.refunds.list({
-    organizationId: [
-      "1dbfc517-0bbf-4301-9ba8-555ca42b9737",
-    ],
+    organizationId: "1dbfc517-0bbf-4301-9ba8-555ca42b9737",
   });
 
   for await (const page of result) {
@@ -55,9 +53,7 @@ const polar = new PolarCore({
 
 async function run() {
   const res = await refundsList(polar, {
-    organizationId: [
-      "1dbfc517-0bbf-4301-9ba8-555ca42b9737",
-    ],
+    organizationId: "1dbfc517-0bbf-4301-9ba8-555ca42b9737",
   });
 
   if (!res.ok) {
@@ -114,7 +110,7 @@ async function run() {
   const result = await polar.refunds.create({
     orderId: "<value>",
     reason: "customer_request",
-    amount: 638424,
+    amount: 90,
   });
 
   // Handle the result
@@ -142,7 +138,7 @@ async function run() {
   const res = await refundsCreate(polar, {
     orderId: "<value>",
     reason: "customer_request",
-    amount: 638424,
+    amount: 90,
   });
 
   if (!res.ok) {

package/docs/sdks/subscriptions/README.md

@@ -279,7 +279,9 @@ const polar = new Polar({
 async function run() {
   const result = await polar.subscriptions.update({
     id: "<value>",
-    subscriptionUpdate: {},
+    subscriptionUpdate: {
+      productId: "<value>",
+    },
   });
 
   // Handle the result
@@ -307,7 +309,7 @@ async function run() {
   const res = await subscriptionsUpdate(polar, {
     id: "<value>",
     subscriptionUpdate: {
-      cancelAtPeriodEnd: false,
+      productId: "<value>",
     },
   });
 

package/jsr.json

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@polar-sh/sdk",
-  "version": "0.32.13",
+  "version": "0.32.15",
   "author": "Speakeasy",
   "type": "module",
   "bin": {