@polar-sh/sdk 0.40.3 → 0.41.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (244) hide show
  1. package/README.md +1 -1
  2. package/dist/commonjs/funcs/eventsList.js +1 -0
  3. package/dist/commonjs/funcs/eventsList.js.map +1 -1
  4. package/dist/commonjs/lib/config.d.ts +3 -3
  5. package/dist/commonjs/lib/config.js +3 -3
  6. package/dist/commonjs/models/components/benefitcycledevent.d.ts +5 -0
  7. package/dist/commonjs/models/components/benefitcycledevent.d.ts.map +1 -1
  8. package/dist/commonjs/models/components/benefitcycledevent.js +4 -0
  9. package/dist/commonjs/models/components/benefitcycledevent.js.map +1 -1
  10. package/dist/commonjs/models/components/benefitgrantedevent.d.ts +5 -0
  11. package/dist/commonjs/models/components/benefitgrantedevent.d.ts.map +1 -1
  12. package/dist/commonjs/models/components/benefitgrantedevent.js +4 -0
  13. package/dist/commonjs/models/components/benefitgrantedevent.js.map +1 -1
  14. package/dist/commonjs/models/components/benefitrevokedevent.d.ts +5 -0
  15. package/dist/commonjs/models/components/benefitrevokedevent.d.ts.map +1 -1
  16. package/dist/commonjs/models/components/benefitrevokedevent.js +4 -0
  17. package/dist/commonjs/models/components/benefitrevokedevent.js.map +1 -1
  18. package/dist/commonjs/models/components/benefitupdatedevent.d.ts +5 -0
  19. package/dist/commonjs/models/components/benefitupdatedevent.d.ts.map +1 -1
  20. package/dist/commonjs/models/components/benefitupdatedevent.js +4 -0
  21. package/dist/commonjs/models/components/benefitupdatedevent.js.map +1 -1
  22. package/dist/commonjs/models/components/customercreate.d.ts +0 -3
  23. package/dist/commonjs/models/components/customercreate.d.ts.map +1 -1
  24. package/dist/commonjs/models/components/customercreate.js.map +1 -1
  25. package/dist/commonjs/models/components/customercreatedevent.d.ts +5 -0
  26. package/dist/commonjs/models/components/customercreatedevent.d.ts.map +1 -1
  27. package/dist/commonjs/models/components/customercreatedevent.js +4 -0
  28. package/dist/commonjs/models/components/customercreatedevent.js.map +1 -1
  29. package/dist/commonjs/models/components/customerdeletedevent.d.ts +5 -0
  30. package/dist/commonjs/models/components/customerdeletedevent.d.ts.map +1 -1
  31. package/dist/commonjs/models/components/customerdeletedevent.js +4 -0
  32. package/dist/commonjs/models/components/customerdeletedevent.js.map +1 -1
  33. package/dist/commonjs/models/components/customerupdate.d.ts +0 -3
  34. package/dist/commonjs/models/components/customerupdate.d.ts.map +1 -1
  35. package/dist/commonjs/models/components/customerupdate.js.map +1 -1
  36. package/dist/commonjs/models/components/customerupdatedevent.d.ts +5 -0
  37. package/dist/commonjs/models/components/customerupdatedevent.d.ts.map +1 -1
  38. package/dist/commonjs/models/components/customerupdatedevent.js +4 -0
  39. package/dist/commonjs/models/components/customerupdatedevent.js.map +1 -1
  40. package/dist/commonjs/models/components/customerupdateexternalid.d.ts +0 -3
  41. package/dist/commonjs/models/components/customerupdateexternalid.d.ts.map +1 -1
  42. package/dist/commonjs/models/components/customerupdateexternalid.js.map +1 -1
  43. package/dist/commonjs/models/components/eventcreatecustomer.d.ts +10 -0
  44. package/dist/commonjs/models/components/eventcreatecustomer.d.ts.map +1 -1
  45. package/dist/commonjs/models/components/eventcreatecustomer.js +8 -0
  46. package/dist/commonjs/models/components/eventcreatecustomer.js.map +1 -1
  47. package/dist/commonjs/models/components/eventcreateexternalcustomer.d.ts +10 -0
  48. package/dist/commonjs/models/components/eventcreateexternalcustomer.d.ts.map +1 -1
  49. package/dist/commonjs/models/components/eventcreateexternalcustomer.js +8 -0
  50. package/dist/commonjs/models/components/eventcreateexternalcustomer.js.map +1 -1
  51. package/dist/commonjs/models/components/eventsingestresponse.d.ts +5 -0
  52. package/dist/commonjs/models/components/eventsingestresponse.d.ts.map +1 -1
  53. package/dist/commonjs/models/components/eventsingestresponse.js +2 -0
  54. package/dist/commonjs/models/components/eventsingestresponse.js.map +1 -1
  55. package/dist/commonjs/models/components/metercreditevent.d.ts +5 -0
  56. package/dist/commonjs/models/components/metercreditevent.d.ts.map +1 -1
  57. package/dist/commonjs/models/components/metercreditevent.js +4 -0
  58. package/dist/commonjs/models/components/metercreditevent.js.map +1 -1
  59. package/dist/commonjs/models/components/meterresetevent.d.ts +5 -0
  60. package/dist/commonjs/models/components/meterresetevent.d.ts.map +1 -1
  61. package/dist/commonjs/models/components/meterresetevent.js +4 -0
  62. package/dist/commonjs/models/components/meterresetevent.js.map +1 -1
  63. package/dist/commonjs/models/components/orderpaidevent.d.ts +5 -0
  64. package/dist/commonjs/models/components/orderpaidevent.d.ts.map +1 -1
  65. package/dist/commonjs/models/components/orderpaidevent.js +4 -0
  66. package/dist/commonjs/models/components/orderpaidevent.js.map +1 -1
  67. package/dist/commonjs/models/components/orderrefundedevent.d.ts +5 -0
  68. package/dist/commonjs/models/components/orderrefundedevent.d.ts.map +1 -1
  69. package/dist/commonjs/models/components/orderrefundedevent.js +4 -0
  70. package/dist/commonjs/models/components/orderrefundedevent.js.map +1 -1
  71. package/dist/commonjs/models/components/subscriptioncycledevent.d.ts +5 -0
  72. package/dist/commonjs/models/components/subscriptioncycledevent.d.ts.map +1 -1
  73. package/dist/commonjs/models/components/subscriptioncycledevent.js +4 -0
  74. package/dist/commonjs/models/components/subscriptioncycledevent.js.map +1 -1
  75. package/dist/commonjs/models/components/subscriptionproductupdatedevent.d.ts +5 -0
  76. package/dist/commonjs/models/components/subscriptionproductupdatedevent.d.ts.map +1 -1
  77. package/dist/commonjs/models/components/subscriptionproductupdatedevent.js +4 -0
  78. package/dist/commonjs/models/components/subscriptionproductupdatedevent.js.map +1 -1
  79. package/dist/commonjs/models/components/subscriptionrevokedevent.d.ts +5 -0
  80. package/dist/commonjs/models/components/subscriptionrevokedevent.d.ts.map +1 -1
  81. package/dist/commonjs/models/components/subscriptionrevokedevent.js +4 -0
  82. package/dist/commonjs/models/components/subscriptionrevokedevent.js.map +1 -1
  83. package/dist/commonjs/models/components/userevent.d.ts +5 -0
  84. package/dist/commonjs/models/components/userevent.d.ts.map +1 -1
  85. package/dist/commonjs/models/components/userevent.js +4 -0
  86. package/dist/commonjs/models/components/userevent.js.map +1 -1
  87. package/dist/commonjs/models/operations/eventslist.d.ts +5 -0
  88. package/dist/commonjs/models/operations/eventslist.d.ts.map +1 -1
  89. package/dist/commonjs/models/operations/eventslist.js +4 -0
  90. package/dist/commonjs/models/operations/eventslist.js.map +1 -1
  91. package/dist/esm/funcs/eventsList.js +1 -0
  92. package/dist/esm/funcs/eventsList.js.map +1 -1
  93. package/dist/esm/lib/config.d.ts +3 -3
  94. package/dist/esm/lib/config.js +3 -3
  95. package/dist/esm/models/components/benefitcycledevent.d.ts +5 -0
  96. package/dist/esm/models/components/benefitcycledevent.d.ts.map +1 -1
  97. package/dist/esm/models/components/benefitcycledevent.js +4 -0
  98. package/dist/esm/models/components/benefitcycledevent.js.map +1 -1
  99. package/dist/esm/models/components/benefitgrantedevent.d.ts +5 -0
  100. package/dist/esm/models/components/benefitgrantedevent.d.ts.map +1 -1
  101. package/dist/esm/models/components/benefitgrantedevent.js +4 -0
  102. package/dist/esm/models/components/benefitgrantedevent.js.map +1 -1
  103. package/dist/esm/models/components/benefitrevokedevent.d.ts +5 -0
  104. package/dist/esm/models/components/benefitrevokedevent.d.ts.map +1 -1
  105. package/dist/esm/models/components/benefitrevokedevent.js +4 -0
  106. package/dist/esm/models/components/benefitrevokedevent.js.map +1 -1
  107. package/dist/esm/models/components/benefitupdatedevent.d.ts +5 -0
  108. package/dist/esm/models/components/benefitupdatedevent.d.ts.map +1 -1
  109. package/dist/esm/models/components/benefitupdatedevent.js +4 -0
  110. package/dist/esm/models/components/benefitupdatedevent.js.map +1 -1
  111. package/dist/esm/models/components/customercreate.d.ts +0 -3
  112. package/dist/esm/models/components/customercreate.d.ts.map +1 -1
  113. package/dist/esm/models/components/customercreate.js.map +1 -1
  114. package/dist/esm/models/components/customercreatedevent.d.ts +5 -0
  115. package/dist/esm/models/components/customercreatedevent.d.ts.map +1 -1
  116. package/dist/esm/models/components/customercreatedevent.js +4 -0
  117. package/dist/esm/models/components/customercreatedevent.js.map +1 -1
  118. package/dist/esm/models/components/customerdeletedevent.d.ts +5 -0
  119. package/dist/esm/models/components/customerdeletedevent.d.ts.map +1 -1
  120. package/dist/esm/models/components/customerdeletedevent.js +4 -0
  121. package/dist/esm/models/components/customerdeletedevent.js.map +1 -1
  122. package/dist/esm/models/components/customerupdate.d.ts +0 -3
  123. package/dist/esm/models/components/customerupdate.d.ts.map +1 -1
  124. package/dist/esm/models/components/customerupdate.js.map +1 -1
  125. package/dist/esm/models/components/customerupdatedevent.d.ts +5 -0
  126. package/dist/esm/models/components/customerupdatedevent.d.ts.map +1 -1
  127. package/dist/esm/models/components/customerupdatedevent.js +4 -0
  128. package/dist/esm/models/components/customerupdatedevent.js.map +1 -1
  129. package/dist/esm/models/components/customerupdateexternalid.d.ts +0 -3
  130. package/dist/esm/models/components/customerupdateexternalid.d.ts.map +1 -1
  131. package/dist/esm/models/components/customerupdateexternalid.js.map +1 -1
  132. package/dist/esm/models/components/eventcreatecustomer.d.ts +10 -0
  133. package/dist/esm/models/components/eventcreatecustomer.d.ts.map +1 -1
  134. package/dist/esm/models/components/eventcreatecustomer.js +8 -0
  135. package/dist/esm/models/components/eventcreatecustomer.js.map +1 -1
  136. package/dist/esm/models/components/eventcreateexternalcustomer.d.ts +10 -0
  137. package/dist/esm/models/components/eventcreateexternalcustomer.d.ts.map +1 -1
  138. package/dist/esm/models/components/eventcreateexternalcustomer.js +8 -0
  139. package/dist/esm/models/components/eventcreateexternalcustomer.js.map +1 -1
  140. package/dist/esm/models/components/eventsingestresponse.d.ts +5 -0
  141. package/dist/esm/models/components/eventsingestresponse.d.ts.map +1 -1
  142. package/dist/esm/models/components/eventsingestresponse.js +2 -0
  143. package/dist/esm/models/components/eventsingestresponse.js.map +1 -1
  144. package/dist/esm/models/components/metercreditevent.d.ts +5 -0
  145. package/dist/esm/models/components/metercreditevent.d.ts.map +1 -1
  146. package/dist/esm/models/components/metercreditevent.js +4 -0
  147. package/dist/esm/models/components/metercreditevent.js.map +1 -1
  148. package/dist/esm/models/components/meterresetevent.d.ts +5 -0
  149. package/dist/esm/models/components/meterresetevent.d.ts.map +1 -1
  150. package/dist/esm/models/components/meterresetevent.js +4 -0
  151. package/dist/esm/models/components/meterresetevent.js.map +1 -1
  152. package/dist/esm/models/components/orderpaidevent.d.ts +5 -0
  153. package/dist/esm/models/components/orderpaidevent.d.ts.map +1 -1
  154. package/dist/esm/models/components/orderpaidevent.js +4 -0
  155. package/dist/esm/models/components/orderpaidevent.js.map +1 -1
  156. package/dist/esm/models/components/orderrefundedevent.d.ts +5 -0
  157. package/dist/esm/models/components/orderrefundedevent.d.ts.map +1 -1
  158. package/dist/esm/models/components/orderrefundedevent.js +4 -0
  159. package/dist/esm/models/components/orderrefundedevent.js.map +1 -1
  160. package/dist/esm/models/components/subscriptioncycledevent.d.ts +5 -0
  161. package/dist/esm/models/components/subscriptioncycledevent.d.ts.map +1 -1
  162. package/dist/esm/models/components/subscriptioncycledevent.js +4 -0
  163. package/dist/esm/models/components/subscriptioncycledevent.js.map +1 -1
  164. package/dist/esm/models/components/subscriptionproductupdatedevent.d.ts +5 -0
  165. package/dist/esm/models/components/subscriptionproductupdatedevent.d.ts.map +1 -1
  166. package/dist/esm/models/components/subscriptionproductupdatedevent.js +4 -0
  167. package/dist/esm/models/components/subscriptionproductupdatedevent.js.map +1 -1
  168. package/dist/esm/models/components/subscriptionrevokedevent.d.ts +5 -0
  169. package/dist/esm/models/components/subscriptionrevokedevent.d.ts.map +1 -1
  170. package/dist/esm/models/components/subscriptionrevokedevent.js +4 -0
  171. package/dist/esm/models/components/subscriptionrevokedevent.js.map +1 -1
  172. package/dist/esm/models/components/userevent.d.ts +5 -0
  173. package/dist/esm/models/components/userevent.d.ts.map +1 -1
  174. package/dist/esm/models/components/userevent.js +4 -0
  175. package/dist/esm/models/components/userevent.js.map +1 -1
  176. package/dist/esm/models/operations/eventslist.d.ts +5 -0
  177. package/dist/esm/models/operations/eventslist.d.ts.map +1 -1
  178. package/dist/esm/models/operations/eventslist.js +4 -0
  179. package/dist/esm/models/operations/eventslist.js.map +1 -1
  180. package/examples/package-lock.json +1 -1
  181. package/jsr.json +1 -1
  182. package/package.json +1 -1
  183. package/src/funcs/eventsList.ts +1 -0
  184. package/src/lib/config.ts +3 -3
  185. package/src/models/components/benefitcycledevent.ts +9 -0
  186. package/src/models/components/benefitgrantedevent.ts +9 -0
  187. package/src/models/components/benefitrevokedevent.ts +9 -0
  188. package/src/models/components/benefitupdatedevent.ts +9 -0
  189. package/src/models/components/customercreate.ts +0 -3
  190. package/src/models/components/customercreatedevent.ts +9 -0
  191. package/src/models/components/customerdeletedevent.ts +9 -0
  192. package/src/models/components/customerupdate.ts +0 -3
  193. package/src/models/components/customerupdatedevent.ts +9 -0
  194. package/src/models/components/customerupdateexternalid.ts +0 -3
  195. package/src/models/components/eventcreatecustomer.ts +18 -0
  196. package/src/models/components/eventcreateexternalcustomer.ts +18 -0
  197. package/src/models/components/eventsingestresponse.ts +7 -0
  198. package/src/models/components/metercreditevent.ts +9 -0
  199. package/src/models/components/meterresetevent.ts +9 -0
  200. package/src/models/components/orderpaidevent.ts +9 -0
  201. package/src/models/components/orderrefundedevent.ts +9 -0
  202. package/src/models/components/subscriptioncycledevent.ts +9 -0
  203. package/src/models/components/subscriptionproductupdatedevent.ts +9 -0
  204. package/src/models/components/subscriptionrevokedevent.ts +9 -0
  205. package/src/models/components/userevent.ts +9 -0
  206. package/src/models/operations/eventslist.ts +9 -0
  207. package/.devcontainer/README.md +0 -35
  208. package/docs/sdks/benefitgrants/README.md +0 -88
  209. package/docs/sdks/benefits/README.md +0 -500
  210. package/docs/sdks/checkoutlinks/README.md +0 -407
  211. package/docs/sdks/checkouts/README.md +0 -600
  212. package/docs/sdks/clients/README.md +0 -331
  213. package/docs/sdks/customermeters/README.md +0 -166
  214. package/docs/sdks/customers/README.md +0 -1036
  215. package/docs/sdks/customerseats/README.md +0 -441
  216. package/docs/sdks/customersession/README.md +0 -79
  217. package/docs/sdks/customersessions/README.md +0 -84
  218. package/docs/sdks/customfields/README.md +0 -417
  219. package/docs/sdks/discounts/README.md +0 -409
  220. package/docs/sdks/downloadables/README.md +0 -83
  221. package/docs/sdks/events/README.md +0 -324
  222. package/docs/sdks/files/README.md +0 -460
  223. package/docs/sdks/licensekeys/README.md +0 -576
  224. package/docs/sdks/meters/README.md +0 -437
  225. package/docs/sdks/metrics/README.md +0 -165
  226. package/docs/sdks/oauth2/README.md +0 -371
  227. package/docs/sdks/orders/README.md +0 -489
  228. package/docs/sdks/organizations/README.md +0 -322
  229. package/docs/sdks/payments/README.md +0 -166
  230. package/docs/sdks/polarbenefitgrants/README.md +0 -250
  231. package/docs/sdks/polarcustomermeters/README.md +0 -164
  232. package/docs/sdks/polarcustomers/README.md +0 -482
  233. package/docs/sdks/polarlicensekeys/README.md +0 -406
  234. package/docs/sdks/polarorders/README.md +0 -574
  235. package/docs/sdks/polarorganizations/README.md +0 -79
  236. package/docs/sdks/polarsubscriptions/README.md +0 -326
  237. package/docs/sdks/polarwallets/README.md +0 -164
  238. package/docs/sdks/products/README.md +0 -441
  239. package/docs/sdks/refunds/README.md +0 -171
  240. package/docs/sdks/seats/README.md +0 -379
  241. package/docs/sdks/subscriptions/README.md +0 -493
  242. package/docs/sdks/wallets/README.md +0 -256
  243. package/docs/sdks/webhooks/README.md +0 -650
  244. package/examples/README.md +0 -31
@@ -1,441 +0,0 @@
1
- # Products
2
- (*products*)
3
-
4
- ## Overview
5
-
6
- ### Available Operations
7
-
8
- * [list](#list) - List Products
9
- * [create](#create) - Create Product
10
- * [get](#get) - Get Product
11
- * [update](#update) - Update Product
12
- * [updateBenefits](#updatebenefits) - Update Product Benefits
13
-
14
- ## list
15
-
16
- List products.
17
-
18
- **Scopes**: `products:read` `products:write`
19
-
20
- ### Example Usage
21
-
22
- <!-- UsageSnippet language="typescript" operationID="products:list" method="get" path="/v1/products/" -->
23
- ```typescript
24
- import { Polar } from "@polar-sh/sdk";
25
-
26
- const polar = new Polar({
27
- accessToken: process.env["POLAR_ACCESS_TOKEN"] ?? "",
28
- });
29
-
30
- async function run() {
31
- const result = await polar.products.list({
32
- organizationId: "1dbfc517-0bbf-4301-9ba8-555ca42b9737",
33
- });
34
-
35
- for await (const page of result) {
36
- console.log(page);
37
- }
38
- }
39
-
40
- run();
41
- ```
42
-
43
- ### Standalone function
44
-
45
- The standalone function version of this method:
46
-
47
- ```typescript
48
- import { PolarCore } from "@polar-sh/sdk/core.js";
49
- import { productsList } from "@polar-sh/sdk/funcs/productsList.js";
50
-
51
- // Use `PolarCore` for best tree-shaking performance.
52
- // You can create one instance of it to use across an application.
53
- const polar = new PolarCore({
54
- accessToken: process.env["POLAR_ACCESS_TOKEN"] ?? "",
55
- });
56
-
57
- async function run() {
58
- const res = await productsList(polar, {
59
- organizationId: "1dbfc517-0bbf-4301-9ba8-555ca42b9737",
60
- });
61
- if (res.ok) {
62
- const { value: result } = res;
63
- for await (const page of result) {
64
- console.log(page);
65
- }
66
- } else {
67
- console.log("productsList failed:", res.error);
68
- }
69
- }
70
-
71
- run();
72
- ```
73
-
74
- ### Parameters
75
-
76
- | Parameter | Type | Required | Description |
77
- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
78
- | `request` | [operations.ProductsListRequest](../../models/operations/productslistrequest.md) | :heavy_check_mark: | The request object to use for the request. |
79
- | `options` | RequestOptions | :heavy_minus_sign: | Used to set various options for making HTTP requests. |
80
- | `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. |
81
- | `options.retries` | [RetryConfig](../../lib/utils/retryconfig.md) | :heavy_minus_sign: | Enables retrying HTTP requests under certain failure conditions. |
82
-
83
- ### Response
84
-
85
- **Promise\<[operations.ProductsListResponse](../../models/operations/productslistresponse.md)\>**
86
-
87
- ### Errors
88
-
89
- | Error Type | Status Code | Content Type |
90
- | -------------------------- | -------------------------- | -------------------------- |
91
- | errors.HTTPValidationError | 422 | application/json |
92
- | errors.SDKError | 4XX, 5XX | \*/\* |
93
-
94
- ## create
95
-
96
- Create a product.
97
-
98
- **Scopes**: `products:write`
99
-
100
- ### Example Usage
101
-
102
- <!-- UsageSnippet language="typescript" operationID="products:create" method="post" path="/v1/products/" -->
103
- ```typescript
104
- import { Polar } from "@polar-sh/sdk";
105
-
106
- const polar = new Polar({
107
- accessToken: process.env["POLAR_ACCESS_TOKEN"] ?? "",
108
- });
109
-
110
- async function run() {
111
- const result = await polar.products.create({
112
- name: "<value>",
113
- prices: [
114
- {
115
- amountType: "fixed",
116
- priceAmount: 677078,
117
- priceCurrency: "usd",
118
- },
119
- {
120
- amountType: "free",
121
- },
122
- ],
123
- organizationId: "1dbfc517-0bbf-4301-9ba8-555ca42b9737",
124
- recurringInterval: "year",
125
- });
126
-
127
- console.log(result);
128
- }
129
-
130
- run();
131
- ```
132
-
133
- ### Standalone function
134
-
135
- The standalone function version of this method:
136
-
137
- ```typescript
138
- import { PolarCore } from "@polar-sh/sdk/core.js";
139
- import { productsCreate } from "@polar-sh/sdk/funcs/productsCreate.js";
140
-
141
- // Use `PolarCore` for best tree-shaking performance.
142
- // You can create one instance of it to use across an application.
143
- const polar = new PolarCore({
144
- accessToken: process.env["POLAR_ACCESS_TOKEN"] ?? "",
145
- });
146
-
147
- async function run() {
148
- const res = await productsCreate(polar, {
149
- name: "<value>",
150
- prices: [
151
- {
152
- amountType: "fixed",
153
- priceAmount: 677078,
154
- priceCurrency: "usd",
155
- },
156
- {
157
- amountType: "free",
158
- },
159
- ],
160
- organizationId: "1dbfc517-0bbf-4301-9ba8-555ca42b9737",
161
- recurringInterval: "year",
162
- });
163
- if (res.ok) {
164
- const { value: result } = res;
165
- console.log(result);
166
- } else {
167
- console.log("productsCreate failed:", res.error);
168
- }
169
- }
170
-
171
- run();
172
- ```
173
-
174
- ### Parameters
175
-
176
- | Parameter | Type | Required | Description |
177
- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
178
- | `request` | [components.ProductCreate](../../models/components/productcreate.md) | :heavy_check_mark: | The request object to use for the request. |
179
- | `options` | RequestOptions | :heavy_minus_sign: | Used to set various options for making HTTP requests. |
180
- | `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. |
181
- | `options.retries` | [RetryConfig](../../lib/utils/retryconfig.md) | :heavy_minus_sign: | Enables retrying HTTP requests under certain failure conditions. |
182
-
183
- ### Response
184
-
185
- **Promise\<[components.Product](../../models/components/product.md)\>**
186
-
187
- ### Errors
188
-
189
- | Error Type | Status Code | Content Type |
190
- | -------------------------- | -------------------------- | -------------------------- |
191
- | errors.HTTPValidationError | 422 | application/json |
192
- | errors.SDKError | 4XX, 5XX | \*/\* |
193
-
194
- ## get
195
-
196
- Get a product by ID.
197
-
198
- **Scopes**: `products:read` `products:write`
199
-
200
- ### Example Usage
201
-
202
- <!-- UsageSnippet language="typescript" operationID="products:get" method="get" path="/v1/products/{id}" -->
203
- ```typescript
204
- import { Polar } from "@polar-sh/sdk";
205
-
206
- const polar = new Polar({
207
- accessToken: process.env["POLAR_ACCESS_TOKEN"] ?? "",
208
- });
209
-
210
- async function run() {
211
- const result = await polar.products.get({
212
- id: "<value>",
213
- });
214
-
215
- console.log(result);
216
- }
217
-
218
- run();
219
- ```
220
-
221
- ### Standalone function
222
-
223
- The standalone function version of this method:
224
-
225
- ```typescript
226
- import { PolarCore } from "@polar-sh/sdk/core.js";
227
- import { productsGet } from "@polar-sh/sdk/funcs/productsGet.js";
228
-
229
- // Use `PolarCore` for best tree-shaking performance.
230
- // You can create one instance of it to use across an application.
231
- const polar = new PolarCore({
232
- accessToken: process.env["POLAR_ACCESS_TOKEN"] ?? "",
233
- });
234
-
235
- async function run() {
236
- const res = await productsGet(polar, {
237
- id: "<value>",
238
- });
239
- if (res.ok) {
240
- const { value: result } = res;
241
- console.log(result);
242
- } else {
243
- console.log("productsGet failed:", res.error);
244
- }
245
- }
246
-
247
- run();
248
- ```
249
-
250
- ### Parameters
251
-
252
- | Parameter | Type | Required | Description |
253
- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
254
- | `request` | [operations.ProductsGetRequest](../../models/operations/productsgetrequest.md) | :heavy_check_mark: | The request object to use for the request. |
255
- | `options` | RequestOptions | :heavy_minus_sign: | Used to set various options for making HTTP requests. |
256
- | `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. |
257
- | `options.retries` | [RetryConfig](../../lib/utils/retryconfig.md) | :heavy_minus_sign: | Enables retrying HTTP requests under certain failure conditions. |
258
-
259
- ### Response
260
-
261
- **Promise\<[components.Product](../../models/components/product.md)\>**
262
-
263
- ### Errors
264
-
265
- | Error Type | Status Code | Content Type |
266
- | -------------------------- | -------------------------- | -------------------------- |
267
- | errors.ResourceNotFound | 404 | application/json |
268
- | errors.HTTPValidationError | 422 | application/json |
269
- | errors.SDKError | 4XX, 5XX | \*/\* |
270
-
271
- ## update
272
-
273
- Update a product.
274
-
275
- **Scopes**: `products:write`
276
-
277
- ### Example Usage
278
-
279
- <!-- UsageSnippet language="typescript" operationID="products:update" method="patch" path="/v1/products/{id}" -->
280
- ```typescript
281
- import { Polar } from "@polar-sh/sdk";
282
-
283
- const polar = new Polar({
284
- accessToken: process.env["POLAR_ACCESS_TOKEN"] ?? "",
285
- });
286
-
287
- async function run() {
288
- const result = await polar.products.update({
289
- id: "<value>",
290
- productUpdate: {},
291
- });
292
-
293
- console.log(result);
294
- }
295
-
296
- run();
297
- ```
298
-
299
- ### Standalone function
300
-
301
- The standalone function version of this method:
302
-
303
- ```typescript
304
- import { PolarCore } from "@polar-sh/sdk/core.js";
305
- import { productsUpdate } from "@polar-sh/sdk/funcs/productsUpdate.js";
306
-
307
- // Use `PolarCore` for best tree-shaking performance.
308
- // You can create one instance of it to use across an application.
309
- const polar = new PolarCore({
310
- accessToken: process.env["POLAR_ACCESS_TOKEN"] ?? "",
311
- });
312
-
313
- async function run() {
314
- const res = await productsUpdate(polar, {
315
- id: "<value>",
316
- productUpdate: {},
317
- });
318
- if (res.ok) {
319
- const { value: result } = res;
320
- console.log(result);
321
- } else {
322
- console.log("productsUpdate failed:", res.error);
323
- }
324
- }
325
-
326
- run();
327
- ```
328
-
329
- ### Parameters
330
-
331
- | Parameter | Type | Required | Description |
332
- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
333
- | `request` | [operations.ProductsUpdateRequest](../../models/operations/productsupdaterequest.md) | :heavy_check_mark: | The request object to use for the request. |
334
- | `options` | RequestOptions | :heavy_minus_sign: | Used to set various options for making HTTP requests. |
335
- | `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. |
336
- | `options.retries` | [RetryConfig](../../lib/utils/retryconfig.md) | :heavy_minus_sign: | Enables retrying HTTP requests under certain failure conditions. |
337
-
338
- ### Response
339
-
340
- **Promise\<[components.Product](../../models/components/product.md)\>**
341
-
342
- ### Errors
343
-
344
- | Error Type | Status Code | Content Type |
345
- | -------------------------- | -------------------------- | -------------------------- |
346
- | errors.NotPermitted | 403 | application/json |
347
- | errors.ResourceNotFound | 404 | application/json |
348
- | errors.HTTPValidationError | 422 | application/json |
349
- | errors.SDKError | 4XX, 5XX | \*/\* |
350
-
351
- ## updateBenefits
352
-
353
- Update benefits granted by a product.
354
-
355
- **Scopes**: `products:write`
356
-
357
- ### Example Usage
358
-
359
- <!-- UsageSnippet language="typescript" operationID="products:update_benefits" method="post" path="/v1/products/{id}/benefits" -->
360
- ```typescript
361
- import { Polar } from "@polar-sh/sdk";
362
-
363
- const polar = new Polar({
364
- accessToken: process.env["POLAR_ACCESS_TOKEN"] ?? "",
365
- });
366
-
367
- async function run() {
368
- const result = await polar.products.updateBenefits({
369
- id: "<value>",
370
- productBenefitsUpdate: {
371
- benefits: [
372
- "<value 1>",
373
- "<value 2>",
374
- "<value 3>",
375
- ],
376
- },
377
- });
378
-
379
- console.log(result);
380
- }
381
-
382
- run();
383
- ```
384
-
385
- ### Standalone function
386
-
387
- The standalone function version of this method:
388
-
389
- ```typescript
390
- import { PolarCore } from "@polar-sh/sdk/core.js";
391
- import { productsUpdateBenefits } from "@polar-sh/sdk/funcs/productsUpdateBenefits.js";
392
-
393
- // Use `PolarCore` for best tree-shaking performance.
394
- // You can create one instance of it to use across an application.
395
- const polar = new PolarCore({
396
- accessToken: process.env["POLAR_ACCESS_TOKEN"] ?? "",
397
- });
398
-
399
- async function run() {
400
- const res = await productsUpdateBenefits(polar, {
401
- id: "<value>",
402
- productBenefitsUpdate: {
403
- benefits: [
404
- "<value 1>",
405
- "<value 2>",
406
- "<value 3>",
407
- ],
408
- },
409
- });
410
- if (res.ok) {
411
- const { value: result } = res;
412
- console.log(result);
413
- } else {
414
- console.log("productsUpdateBenefits failed:", res.error);
415
- }
416
- }
417
-
418
- run();
419
- ```
420
-
421
- ### Parameters
422
-
423
- | Parameter | Type | Required | Description |
424
- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
425
- | `request` | [operations.ProductsUpdateBenefitsRequest](../../models/operations/productsupdatebenefitsrequest.md) | :heavy_check_mark: | The request object to use for the request. |
426
- | `options` | RequestOptions | :heavy_minus_sign: | Used to set various options for making HTTP requests. |
427
- | `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. |
428
- | `options.retries` | [RetryConfig](../../lib/utils/retryconfig.md) | :heavy_minus_sign: | Enables retrying HTTP requests under certain failure conditions. |
429
-
430
- ### Response
431
-
432
- **Promise\<[components.Product](../../models/components/product.md)\>**
433
-
434
- ### Errors
435
-
436
- | Error Type | Status Code | Content Type |
437
- | -------------------------- | -------------------------- | -------------------------- |
438
- | errors.NotPermitted | 403 | application/json |
439
- | errors.ResourceNotFound | 404 | application/json |
440
- | errors.HTTPValidationError | 422 | application/json |
441
- | errors.SDKError | 4XX, 5XX | \*/\* |
@@ -1,171 +0,0 @@
1
- # Refunds
2
- (*refunds*)
3
-
4
- ## Overview
5
-
6
- ### Available Operations
7
-
8
- * [list](#list) - List Refunds
9
- * [create](#create) - Create Refund
10
-
11
- ## list
12
-
13
- List products.
14
-
15
- **Scopes**: `refunds:read` `refunds:write`
16
-
17
- ### Example Usage
18
-
19
- <!-- UsageSnippet language="typescript" operationID="refunds:list" method="get" path="/v1/refunds/" -->
20
- ```typescript
21
- import { Polar } from "@polar-sh/sdk";
22
-
23
- const polar = new Polar({
24
- accessToken: process.env["POLAR_ACCESS_TOKEN"] ?? "",
25
- });
26
-
27
- async function run() {
28
- const result = await polar.refunds.list({
29
- organizationId: "1dbfc517-0bbf-4301-9ba8-555ca42b9737",
30
- });
31
-
32
- for await (const page of result) {
33
- console.log(page);
34
- }
35
- }
36
-
37
- run();
38
- ```
39
-
40
- ### Standalone function
41
-
42
- The standalone function version of this method:
43
-
44
- ```typescript
45
- import { PolarCore } from "@polar-sh/sdk/core.js";
46
- import { refundsList } from "@polar-sh/sdk/funcs/refundsList.js";
47
-
48
- // Use `PolarCore` for best tree-shaking performance.
49
- // You can create one instance of it to use across an application.
50
- const polar = new PolarCore({
51
- accessToken: process.env["POLAR_ACCESS_TOKEN"] ?? "",
52
- });
53
-
54
- async function run() {
55
- const res = await refundsList(polar, {
56
- organizationId: "1dbfc517-0bbf-4301-9ba8-555ca42b9737",
57
- });
58
- if (res.ok) {
59
- const { value: result } = res;
60
- for await (const page of result) {
61
- console.log(page);
62
- }
63
- } else {
64
- console.log("refundsList failed:", res.error);
65
- }
66
- }
67
-
68
- run();
69
- ```
70
-
71
- ### Parameters
72
-
73
- | Parameter | Type | Required | Description |
74
- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
75
- | `request` | [operations.RefundsListRequest](../../models/operations/refundslistrequest.md) | :heavy_check_mark: | The request object to use for the request. |
76
- | `options` | RequestOptions | :heavy_minus_sign: | Used to set various options for making HTTP requests. |
77
- | `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. |
78
- | `options.retries` | [RetryConfig](../../lib/utils/retryconfig.md) | :heavy_minus_sign: | Enables retrying HTTP requests under certain failure conditions. |
79
-
80
- ### Response
81
-
82
- **Promise\<[operations.RefundsListResponse](../../models/operations/refundslistresponse.md)\>**
83
-
84
- ### Errors
85
-
86
- | Error Type | Status Code | Content Type |
87
- | -------------------------- | -------------------------- | -------------------------- |
88
- | errors.HTTPValidationError | 422 | application/json |
89
- | errors.SDKError | 4XX, 5XX | \*/\* |
90
-
91
- ## create
92
-
93
- Create a refund.
94
-
95
- **Scopes**: `refunds:write`
96
-
97
- ### Example Usage
98
-
99
- <!-- UsageSnippet language="typescript" operationID="refunds:create" method="post" path="/v1/refunds/" -->
100
- ```typescript
101
- import { Polar } from "@polar-sh/sdk";
102
-
103
- const polar = new Polar({
104
- accessToken: process.env["POLAR_ACCESS_TOKEN"] ?? "",
105
- });
106
-
107
- async function run() {
108
- const result = await polar.refunds.create({
109
- orderId: "<value>",
110
- reason: "customer_request",
111
- amount: 90,
112
- });
113
-
114
- console.log(result);
115
- }
116
-
117
- run();
118
- ```
119
-
120
- ### Standalone function
121
-
122
- The standalone function version of this method:
123
-
124
- ```typescript
125
- import { PolarCore } from "@polar-sh/sdk/core.js";
126
- import { refundsCreate } from "@polar-sh/sdk/funcs/refundsCreate.js";
127
-
128
- // Use `PolarCore` for best tree-shaking performance.
129
- // You can create one instance of it to use across an application.
130
- const polar = new PolarCore({
131
- accessToken: process.env["POLAR_ACCESS_TOKEN"] ?? "",
132
- });
133
-
134
- async function run() {
135
- const res = await refundsCreate(polar, {
136
- orderId: "<value>",
137
- reason: "customer_request",
138
- amount: 90,
139
- });
140
- if (res.ok) {
141
- const { value: result } = res;
142
- console.log(result);
143
- } else {
144
- console.log("refundsCreate failed:", res.error);
145
- }
146
- }
147
-
148
- run();
149
- ```
150
-
151
- ### Parameters
152
-
153
- | Parameter | Type | Required | Description |
154
- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
155
- | `request` | [components.RefundCreate](../../models/components/refundcreate.md) | :heavy_check_mark: | The request object to use for the request. |
156
- | `options` | RequestOptions | :heavy_minus_sign: | Used to set various options for making HTTP requests. |
157
- | `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. |
158
- | `options.retries` | [RetryConfig](../../lib/utils/retryconfig.md) | :heavy_minus_sign: | Enables retrying HTTP requests under certain failure conditions. |
159
-
160
- ### Response
161
-
162
- **Promise\<[components.Refund](../../models/components/refund.md)\>**
163
-
164
- ### Errors
165
-
166
- | Error Type | Status Code | Content Type |
167
- | -------------------------- | -------------------------- | -------------------------- |
168
- | errors.RefundAmountTooHigh | 400 | application/json |
169
- | errors.RefundedAlready | 403 | application/json |
170
- | errors.HTTPValidationError | 422 | application/json |
171
- | errors.SDKError | 4XX, 5XX | \*/\* |