@medusajs/js-sdk 2.0.1-snapshot-20241025090810 → 2.0.2-snapshot-20241104135243

package/dist/esm/admin/payment.js

@@ -14,6 +14,52 @@ export class Payment {
     constructor(client) {
         this.client = client;
     }
+    /**
+     * This method retrieves a paginated list of payments. It sends a request to the
+     * [List Payments](https://docs.medusajs.com/api/admin#payments_getpayments) API route.
+     *
+     * @param query  - Filters and pagination configurations.
+     * @param headers - Headers to pass in the request.
+     * @returns The paginated list of payments.
+     *
+     * @example
+     * To retrieve the list of payments:
+     *
+     * ```ts
+     * sdk.admin.payment.list()
+     * .then(({ payments, count, limit, offset }) => {
+     *   console.log(payments)
+     * })
+     * ```
+     *
+     * To configure the pagination, pass the `limit` and `offset` query parameters.
+     *
+     * For example, to retrieve only 10 items and skip 10 items:
+     *
+     * ```ts
+     * sdk.admin.payment.list({
+     *   limit: 10,
+     *   offset: 10
+     * })
+     * .then(({ payments, count, limit, offset }) => {
+     *   console.log(payments)
+     * })
+     * ```
+     *
+     * Using the `fields` query parameter, you can specify the fields and relations to retrieve
+     * in each payment:
+     *
+     * ```ts
+     * sdk.admin.payment.list({
+     *   fields: "id,*payment_collection"
+     * })
+     * .then(({ payments, count, limit, offset }) => {
+     *   console.log(payments)
+     * })
+     * ```
+     *
+     * Learn more about the `fields` property in the [API reference](https://docs.medusajs.com/api/store#select-fields-and-relations).
+     */
     list(query, headers) {
         return __awaiter(this, void 0, void 0, function* () {
             return yield this.client.fetch(`/admin/payments`, {
@@ -22,6 +68,52 @@ export class Payment {
             });
         });
     }
+    /**
+     * This method retrieves a paginated list of payment providers. It sends a request to the
+     * [List Payment Providers](https://docs.medusajs.com/api/admin#payments_getpaymentspaymentproviders) API route.
+     *
+     * @param query - Filters and pagination configurations.
+     * @param headers - Headers to pass in the request.
+     * @returns The paginated list of payment providers.
+     *
+     * @example
+     * To retrieve the list of payment providers:
+     *
+     * ```ts
+     * sdk.admin.payment.listPaymentProviders()
+     * .then(({ payment_providers, count, limit, offset }) => {
+     *   console.log(payment_providers)
+     * })
+     * ```
+     *
+     * To configure the pagination, pass the `limit` and `offset` query parameters.
+     *
+     * For example, to retrieve only 10 items and skip 10 items:
+     *
+     * ```ts
+     * sdk.admin.payment.listPaymentProviders({
+     *   limit: 10,
+     *   offset: 10
+     * })
+     * .then(({ payment_providers, count, limit, offset }) => {
+     *   console.log(payment_providers)
+     * })
+     * ```
+     *
+     * Using the `fields` query parameter, you can specify the fields and relations to retrieve
+     * in each payment provider:
+     *
+     * ```ts
+     * sdk.admin.payment.listPaymentProviders({
+     *   fields: "id,is_enabled"
+     * })
+     * .then(({ payment_providers, count, limit, offset }) => {
+     *   console.log(payment_providers)
+     * })
+     * ```
+     *
+     * Learn more about the `fields` property in the [API reference](https://docs.medusajs.com/api/store#select-fields-and-relations).
+     */
     listPaymentProviders(query, headers) {
         return __awaiter(this, void 0, void 0, function* () {
             return yield this.client.fetch(`/admin/payments/payment-providers`, {
@@ -30,6 +122,39 @@ export class Payment {
             });
         });
     }
+    /**
+     * This method retrieves a payment's details. It sends a request to the
+     * [Get Payment](https://docs.medusajs.com/api/admin#payments_getpaymentsid)
+     * API route.
+     *
+     * @param id - The payment's ID.
+     * @param query - Configure the fields to retrieve in the payment.
+     * @param headers - Headers to pass in the request
+     * @returns The payment's details.
+     *
+     * @example
+     * To retrieve a payment by its ID:
+     *
+     * ```ts
+     * sdk.admin.payment.retrieve("pay_123")
+     * .then(({ payment }) => {
+     *   console.log(payment)
+     * })
+     * ```
+     *
+     * To specify the fields and relations to retrieve:
+     *
+     * ```ts
+     * sdk.admin.payment.retrieve("pay_123", {
+     *   fields: "id,*payment_collection"
+     * })
+     * .then(({ payment }) => {
+     *   console.log(payment)
+     * })
+     * ```
+     *
+     * Learn more about the `fields` property in the [API reference](https://docs.medusajs.com/api/store#select-fields-and-relations).
+     */
     retrieve(id, query, headers) {
         return __awaiter(this, void 0, void 0, function* () {
             return yield this.client.fetch(`/admin/payments/${id}`, {
@@ -38,6 +163,24 @@ export class Payment {
             });
         });
     }
+    /**
+     * This method captures a payment. It sends a request to the
+     * [Capture Payment](https://docs.medusajs.com/api/admin#payments_postpaymentsidcapture) API route.
+     *
+     * The API route uses the `capturePayment` method of the payment provider associated with the payment's collection.
+     *
+     * @param id - The payment's ID.
+     * @param body - The capture's details.
+     * @param query - Configure the fields to retrieve in the payment.
+     * @param headers - Headers to pass in the request
+     * @returns The payment's details.
+     *
+     * @example
+     * sdk.admin.payment.capture("paycol_123", {})
+     * .then(({ payment }) => {
+     *   console.log(payment)
+     * })
+     */
     capture(id, body, query, headers) {
         return __awaiter(this, void 0, void 0, function* () {
             return yield this.client.fetch(`/admin/payments/${id}/capture`, {
@@ -48,6 +191,24 @@ export class Payment {
             });
         });
     }
+    /**
+     * This method refunds a payment. It sends a request to the
+     * [Refund Payment](https://docs.medusajs.com/api/admin#payments_postpaymentsidrefund) API route.
+     *
+     * The API route uses the `refundPayment` method of the payment provider associated with the payment's collection.
+     *
+     * @param id - The payment's ID.
+     * @param body - The refund's details.
+     * @param query - Configure the fields to retrieve in the payment.
+     * @param headers - Headers to pass in the request
+     * @returns The payment's details.
+     *
+     * @example
+     * sdk.admin.payment.refund("paycol_123", {})
+     * .then(({ payment }) => {
+     *   console.log(payment)
+     * })
+     */
     refund(id, body, query, headers) {
         return __awaiter(this, void 0, void 0, function* () {
             return yield this.client.fetch(`/admin/payments/${id}/refund`, {

package/dist/esm/admin/payment.js.map

@@ -1 +1 @@
-{"version":3,"file":"payment.js","sourceRoot":"","sources":["../../../src/admin/payment.ts"],"names":[],"mappings":";;;;;;;;;AAIA,MAAM,OAAO,OAAO;IAKlB;;OAEG;IACH,YAAY,MAAc;QACxB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;IACtB,CAAC;IAEK,IAAI,CAAC,KAAqC,EAAE,OAAuB;;YACvE,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAC5B,iBAAiB,EACjB;gBACE,KAAK;gBACL,OAAO;aACR,CACF,CAAA;QACH,CAAC;KAAA;IAEK,oBAAoB,CACxB,KAAgD,EAChD,OAAuB;;YAEvB,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAC5B,mCAAmC,EACnC;gBACE,KAAK;gBACL,OAAO;aACR,CACF,CAAA;QACH,CAAC;KAAA;IAEK,QAAQ,CACZ,EAAU,EACV,KAAqC,EACrC,OAAuB;;YAEvB,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAC5B,mBAAmB,EAAE,EAAE,EACvB;gBACE,KAAK;gBACL,OAAO;aACR,CACF,CAAA;QACH,CAAC;KAAA;IAEK,OAAO,CACX,EAAU,EACV,IAAmC,EACnC,KAAoB,EACpB,OAAuB;;YAEvB,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAC5B,mBAAmB,EAAE,UAAU,EAC/B;gBACE,MAAM,EAAE,MAAM;gBACd,OAAO;gBACP,IAAI;gBACJ,KAAK;aACN,CACF,CAAA;QACH,CAAC;KAAA;IAEK,MAAM,CACV,EAAU,EACV,IAAkC,EAClC,KAAoB,EACpB,OAAuB;;YAEvB,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAC5B,mBAAmB,EAAE,SAAS,EAC9B;gBACE,MAAM,EAAE,MAAM;gBACd,OAAO;gBACP,IAAI;gBACJ,KAAK;aACN,CACF,CAAA;QACH,CAAC;KAAA;CACF"}
+{"version":3,"file":"payment.js","sourceRoot":"","sources":["../../../src/admin/payment.ts"],"names":[],"mappings":";;;;;;;;;AAIA,MAAM,OAAO,OAAO;IAKlB;;OAEG;IACH,YAAY,MAAc;QACxB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;IACtB,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6CG;IACG,IAAI,CAAC,KAAqC,EAAE,OAAuB;;YACvE,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAC5B,iBAAiB,EACjB;gBACE,KAAK;gBACL,OAAO;aACR,CACF,CAAA;QACH,CAAC;KAAA;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6CG;IACG,oBAAoB,CACxB,KAAgD,EAChD,OAAuB;;YAEvB,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAC5B,mCAAmC,EACnC;gBACE,KAAK;gBACL,OAAO;aACR,CACF,CAAA;QACH,CAAC;KAAA;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgCG;IACG,QAAQ,CACZ,EAAU,EACV,KAAoB,EACpB,OAAuB;;YAEvB,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAC5B,mBAAmB,EAAE,EAAE,EACvB;gBACE,KAAK;gBACL,OAAO;aACR,CACF,CAAA;QACH,CAAC;KAAA;IAED;;;;;;;;;;;;;;;;;OAiBG;IACG,OAAO,CACX,EAAU,EACV,IAAmC,EACnC,KAAoB,EACpB,OAAuB;;YAEvB,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAC5B,mBAAmB,EAAE,UAAU,EAC/B;gBACE,MAAM,EAAE,MAAM;gBACd,OAAO;gBACP,IAAI;gBACJ,KAAK;aACN,CACF,CAAA;QACH,CAAC;KAAA;IAED;;;;;;;;;;;;;;;;;OAiBG;IACG,MAAM,CACV,EAAU,EACV,IAAkC,EAClC,KAAoB,EACpB,OAAuB;;YAEvB,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAC5B,mBAAmB,EAAE,SAAS,EAC9B;gBACE,MAAM,EAAE,MAAM;gBACd,OAAO;gBACP,IAAI;gBACJ,KAAK;aACN,CACF,CAAA;QACH,CAAC;KAAA;CACF"}

package/dist/esm/admin/price-list.d.ts

@@ -10,12 +10,206 @@ export declare class PriceList {
      * @ignore
      */
     constructor(client: Client);
+    /**
+     * This method retrieves a price list. It sends a request to the
+     * [Get Price List](https://docs.medusajs.com/v2/api/admin#price-lists_getpricelistsid)
+     * API route.
+     *
+     * @param id - The price list's ID.
+     * @param query - Configure the fields to retrieve in the price list.
+     * @param headers - Headers to pass in the request
+     * @returns The price list's details.
+     *
+     * @example
+     * To retrieve a price list by its ID:
+     *
+     * ```ts
+     * sdk.admin.priceList.retrieve("plist_123")
+     * .then(({ price_list }) => {
+     *   console.log(price_list)
+     * })
+     * ```
+     *
+     * To specify the fields and relations to retrieve:
+     *
+     * ```ts
+     * sdk.admin.priceList.retrieve("plist_123", {
+     *   fields: "id,*prices"
+     * })
+     * .then(({ price_list }) => {
+     *   console.log(price_list)
+     * })
+     * ```
+     *
+     * Learn more about the `fields` property in the [API reference](https://docs.medusajs.com/v2/api/store#select-fields-and-relations).
+     */
     retrieve(id: string, query?: HttpTypes.AdminPriceListParams, headers?: ClientHeaders): Promise<HttpTypes.AdminPriceListResponse>;
+    /**
+     * This method retrieves a paginated list of price lists. It sends a request to the
+     * [List Price Lists](https://docs.medusajs.com/v2/api/admin#price-lists_getpricelists) API route.
+     *
+     * @param query - Filters and pagination configurations.
+     * @param headers - Headers to pass in the request.
+     * @returns The paginated list of price lists.
+     *
+     * @example
+     * To retrieve the list of price lists:
+     *
+     * ```ts
+     * sdk.admin.priceList.list()
+     * .then(({ price_lists, count, limit, offset }) => {
+     *   console.log(price_lists)
+     * })
+     * ```
+     *
+     * To configure the pagination, pass the `limit` and `offset` query parameters.
+     *
+     * For example, to retrieve only 10 items and skip 10 items:
+     *
+     * ```ts
+     * sdk.admin.priceList.list({
+     *   limit: 10,
+     *   offset: 10
+     * })
+     * .then(({ price_lists, count, limit, offset }) => {
+     *   console.log(price_lists)
+     * })
+     * ```
+     *
+     * Using the `fields` query parameter, you can specify the fields and relations to retrieve
+     * in each price list:
+     *
+     * ```ts
+     * sdk.admin.priceList.list({
+     *   fields: "id,*prices"
+     * })
+     * .then(({ price_lists, count, limit, offset }) => {
+     *   console.log(price_lists)
+     * })
+     * ```
+     *
+     * Learn more about the `fields` property in the [API reference](https://docs.medusajs.com/v2/api/store#select-fields-and-relations).
+     */
     list(query?: HttpTypes.AdminPriceListListParams, headers?: ClientHeaders): Promise<HttpTypes.AdminPriceListListResponse>;
+    /**
+     * This method creates a price list. It sends a request to the
+     * [Create Price List](https://docs.medusajs.com/v2/api/admin#price-lists_postpricelists)
+     * API route.
+     *
+     * @param body - The details of the price list to create.
+     * @param query - Configure the fields to retrieve in the price list.
+     * @param headers - Headers to pass in the request
+     * @returns The price list's details.
+     *
+     * @example
+     * sdk.admin.priceList.create({
+     *   title: "My Price List",
+     *   status: "active",
+     *   type: "sale",
+     *   prices: [
+     *     {
+     *       variant_id: "variant_123",
+     *       amount: 10,
+     *       currency_code: "usd",
+     *       rules: {
+     *         region_id: "reg_123"
+     *       }
+     *     }
+     *   ]
+     * })
+     * .then(({ price_list }) => {
+     *   console.log(price_list)
+     * })
+     */
     create(body: HttpTypes.AdminCreatePriceList, query?: HttpTypes.AdminPriceListParams, headers?: ClientHeaders): Promise<HttpTypes.AdminPriceListResponse>;
+    /**
+     * This method updates a price list. It sends a request to the
+     * [Update Price List](https://docs.medusajs.com/v2/api/admin#price-lists_postpricelistsid)
+     * API route.
+     *
+     * @param id - The price list's ID.
+     * @param body - The data to update in the price list.
+     * @param query - Configure the fields to retrieve in the price list.
+     * @param headers - Headers to pass in the request
+     * @returns The price list's details.
+     *
+     * @example
+     * sdk.admin.priceList.update("plist_123", {
+     *   title: "My Price List",
+     * })
+     * .then(({ price_list }) => {
+     *   console.log(price_list)
+     * })
+     */
     update(id: string, body: HttpTypes.AdminUpdatePriceList, query?: HttpTypes.AdminPriceListParams, headers?: ClientHeaders): Promise<HttpTypes.AdminPriceListResponse>;
+    /**
+     * This method deletes a price list. It sends a request to the
+     * [Delete Price List](https://docs.medusajs.com/v2/api/admin#price-lists_deletepricelistsid)
+     * API route.
+     *
+     * @param id - The price list's ID.
+     * @param headers - Headers to pass in the request
+     * @returns The deletion's details.
+     *
+     * @example
+     * sdk.admin.priceList.delete("plist_123")
+     * .then(({ deleted }) => {
+     *   console.log(deleted)
+     * })
+     */
     delete(id: string, headers?: ClientHeaders): Promise<HttpTypes.AdminPriceListDeleteResponse>;
-    batchPrices(id: string, body: HttpTypes.AdminBatchPriceListPrice, query?: HttpTypes.AdminPriceListParams, headers?: ClientHeaders): Promise<HttpTypes.AdminPriceListResponse>;
+    /**
+     * This method manages the prices of a price list to create, update, or delete them.
+     * It sends a request to the [Manage Prices](https://docs.medusajs.com/v2/api/admin#price-lists_postpricelistsidpricesbatch)
+     * API route.
+     *
+     * @param id - The price list's ID.
+     * @param body - The prices to create, update, or delete.
+     * @param query - Configure the fields to retrieve in the price list.
+     * @param headers - Headers to pass in the request
+     * @returns The price list's details.
+     *
+     * @example
+     * sdk.admin.priceList.batchPrices("plist_123", {
+     *   create: [{
+     *     variant_id: "variant_123",
+     *     currency_code: "usd",
+     *     amount: 10,
+     *     rules: {
+     *       region_id: "reg_123"
+     *     }
+     *   }],
+     *   update: [{
+     *     id: "price_123",
+     *     variant_id: "variant_123",
+     *     amount: 20,
+     *   }],
+     *   delete: ["price_123"]
+     * })
+     * .then(({ created, updated, deleted }) => {
+     *   console.log(created, updated, deleted)
+     * })
+     */
+    batchPrices(id: string, body: HttpTypes.AdminBatchPriceListPrice, query?: HttpTypes.AdminPriceListParams, headers?: ClientHeaders): Promise<HttpTypes.AdminPriceListBatchResponse>;
+    /**
+     * This method removes products from a price list. It sends a request to the
+     * [Remove Product](https://docs.medusajs.com/v2/api/admin#price-lists_postpricelistsidproducts)
+     * API route.
+     *
+     * @param id - The price list's ID.
+     * @param body - The details of the products to remove.
+     * @param query - Configure the fields to retrieve in the price list.
+     * @param headers - Headers to pass in the request
+     * @returns The price list's details.
+     *
+     * @example
+     * sdk.admin.priceList.linkProducts("plist_123", {
+     *   remove: ["prod_123"]
+     * })
+     * .then(({ price_list }) => {
+     *   console.log(price_list)
+     * })
+     */
     linkProducts(id: string, body: HttpTypes.AdminLinkPriceListProducts, query?: HttpTypes.AdminPriceListParams, headers?: ClientHeaders): Promise<HttpTypes.AdminPriceListResponse>;
 }
 //# sourceMappingURL=price-list.d.ts.map

package/dist/esm/admin/price-list.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"price-list.d.ts","sourceRoot":"","sources":["../../../src/admin/price-list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAExC,qBAAa,SAAS;IACpB;;OAEG;IACH,OAAO,CAAC,MAAM,CAAQ;IAEtB;;OAEG;gBACS,MAAM,EAAE,MAAM;IAIpB,QAAQ,CACZ,EAAE,EAAE,MAAM,EACV,KAAK,CAAC,EAAE,SAAS,CAAC,oBAAoB,EACtC,OAAO,CAAC,EAAE,aAAa;IAYnB,IAAI,CACR,KAAK,CAAC,EAAE,SAAS,CAAC,wBAAwB,EAC1C,OAAO,CAAC,EAAE,aAAa;IAYnB,MAAM,CACV,IAAI,EAAE,SAAS,CAAC,oBAAoB,EACpC,KAAK,CAAC,EAAE,SAAS,CAAC,oBAAoB,EACtC,OAAO,CAAC,EAAE,aAAa;IAanB,MAAM,CACV,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,SAAS,CAAC,oBAAoB,EACpC,KAAK,CAAC,EAAE,SAAS,CAAC,oBAAoB,EACtC,OAAO,CAAC,EAAE,aAAa;IAanB,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa;IAU1C,WAAW,CACf,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,SAAS,CAAC,wBAAwB,EACxC,KAAK,CAAC,EAAE,SAAS,CAAC,oBAAoB,EACtC,OAAO,CAAC,EAAE,aAAa;IAanB,YAAY,CAChB,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,SAAS,CAAC,0BAA0B,EAC1C,KAAK,CAAC,EAAE,SAAS,CAAC,oBAAoB,EACtC,OAAO,CAAC,EAAE,aAAa;CAY1B"}
+{"version":3,"file":"price-list.d.ts","sourceRoot":"","sources":["../../../src/admin/price-list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAExC,qBAAa,SAAS;IACpB;;OAEG;IACH,OAAO,CAAC,MAAM,CAAQ;IAEtB;;OAEG;gBACS,MAAM,EAAE,MAAM;IAI1B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgCG;IACG,QAAQ,CACZ,EAAE,EAAE,MAAM,EACV,KAAK,CAAC,EAAE,SAAS,CAAC,oBAAoB,EACtC,OAAO,CAAC,EAAE,aAAa;IAYzB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6CG;IACG,IAAI,CACR,KAAK,CAAC,EAAE,SAAS,CAAC,wBAAwB,EAC1C,OAAO,CAAC,EAAE,aAAa;IAYzB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACG,MAAM,CACV,IAAI,EAAE,SAAS,CAAC,oBAAoB,EACpC,KAAK,CAAC,EAAE,SAAS,CAAC,oBAAoB,EACtC,OAAO,CAAC,EAAE,aAAa;IAazB;;;;;;;;;;;;;;;;;;OAkBG;IACG,MAAM,CACV,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,SAAS,CAAC,oBAAoB,EACpC,KAAK,CAAC,EAAE,SAAS,CAAC,oBAAoB,EACtC,OAAO,CAAC,EAAE,aAAa;IAazB;;;;;;;;;;;;;;OAcG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa;IAUhD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IACG,WAAW,CACf,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,SAAS,CAAC,wBAAwB,EACxC,KAAK,CAAC,EAAE,SAAS,CAAC,oBAAoB,EACtC,OAAO,CAAC,EAAE,aAAa;IAazB;;;;;;;;;;;;;;;;;;OAkBG;IACG,YAAY,CAChB,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,SAAS,CAAC,0BAA0B,EAC1C,KAAK,CAAC,EAAE,SAAS,CAAC,oBAAoB,EACtC,OAAO,CAAC,EAAE,aAAa;CAY1B"}

package/dist/esm/admin/price-list.js

@@ -14,6 +14,39 @@ export class PriceList {
     constructor(client) {
         this.client = client;
     }
+    /**
+     * This method retrieves a price list. It sends a request to the
+     * [Get Price List](https://docs.medusajs.com/v2/api/admin#price-lists_getpricelistsid)
+     * API route.
+     *
+     * @param id - The price list's ID.
+     * @param query - Configure the fields to retrieve in the price list.
+     * @param headers - Headers to pass in the request
+     * @returns The price list's details.
+     *
+     * @example
+     * To retrieve a price list by its ID:
+     *
+     * ```ts
+     * sdk.admin.priceList.retrieve("plist_123")
+     * .then(({ price_list }) => {
+     *   console.log(price_list)
+     * })
+     * ```
+     *
+     * To specify the fields and relations to retrieve:
+     *
+     * ```ts
+     * sdk.admin.priceList.retrieve("plist_123", {
+     *   fields: "id,*prices"
+     * })
+     * .then(({ price_list }) => {
+     *   console.log(price_list)
+     * })
+     * ```
+     *
+     * Learn more about the `fields` property in the [API reference](https://docs.medusajs.com/v2/api/store#select-fields-and-relations).
+     */
     retrieve(id, query, headers) {
         return __awaiter(this, void 0, void 0, function* () {
             return this.client.fetch(`/admin/price-lists/${id}`, {
@@ -23,6 +56,52 @@ export class PriceList {
             });
         });
     }
+    /**
+     * This method retrieves a paginated list of price lists. It sends a request to the
+     * [List Price Lists](https://docs.medusajs.com/v2/api/admin#price-lists_getpricelists) API route.
+     *
+     * @param query - Filters and pagination configurations.
+     * @param headers - Headers to pass in the request.
+     * @returns The paginated list of price lists.
+     *
+     * @example
+     * To retrieve the list of price lists:
+     *
+     * ```ts
+     * sdk.admin.priceList.list()
+     * .then(({ price_lists, count, limit, offset }) => {
+     *   console.log(price_lists)
+     * })
+     * ```
+     *
+     * To configure the pagination, pass the `limit` and `offset` query parameters.
+     *
+     * For example, to retrieve only 10 items and skip 10 items:
+     *
+     * ```ts
+     * sdk.admin.priceList.list({
+     *   limit: 10,
+     *   offset: 10
+     * })
+     * .then(({ price_lists, count, limit, offset }) => {
+     *   console.log(price_lists)
+     * })
+     * ```
+     *
+     * Using the `fields` query parameter, you can specify the fields and relations to retrieve
+     * in each price list:
+     *
+     * ```ts
+     * sdk.admin.priceList.list({
+     *   fields: "id,*prices"
+     * })
+     * .then(({ price_lists, count, limit, offset }) => {
+     *   console.log(price_lists)
+     * })
+     * ```
+     *
+     * Learn more about the `fields` property in the [API reference](https://docs.medusajs.com/v2/api/store#select-fields-and-relations).
+     */
     list(query, headers) {
         return __awaiter(this, void 0, void 0, function* () {
             return this.client.fetch(`/admin/price-lists`, {
@@ -32,6 +111,36 @@ export class PriceList {
             });
         });
     }
+    /**
+     * This method creates a price list. It sends a request to the
+     * [Create Price List](https://docs.medusajs.com/v2/api/admin#price-lists_postpricelists)
+     * API route.
+     *
+     * @param body - The details of the price list to create.
+     * @param query - Configure the fields to retrieve in the price list.
+     * @param headers - Headers to pass in the request
+     * @returns The price list's details.
+     *
+     * @example
+     * sdk.admin.priceList.create({
+     *   title: "My Price List",
+     *   status: "active",
+     *   type: "sale",
+     *   prices: [
+     *     {
+     *       variant_id: "variant_123",
+     *       amount: 10,
+     *       currency_code: "usd",
+     *       rules: {
+     *         region_id: "reg_123"
+     *       }
+     *     }
+     *   ]
+     * })
+     * .then(({ price_list }) => {
+     *   console.log(price_list)
+     * })
+     */
     create(body, query, headers) {
         return __awaiter(this, void 0, void 0, function* () {
             return this.client.fetch(`/admin/price-lists`, {
@@ -42,6 +151,25 @@ export class PriceList {
             });
         });
     }
+    /**
+     * This method updates a price list. It sends a request to the
+     * [Update Price List](https://docs.medusajs.com/v2/api/admin#price-lists_postpricelistsid)
+     * API route.
+     *
+     * @param id - The price list's ID.
+     * @param body - The data to update in the price list.
+     * @param query - Configure the fields to retrieve in the price list.
+     * @param headers - Headers to pass in the request
+     * @returns The price list's details.
+     *
+     * @example
+     * sdk.admin.priceList.update("plist_123", {
+     *   title: "My Price List",
+     * })
+     * .then(({ price_list }) => {
+     *   console.log(price_list)
+     * })
+     */
     update(id, body, query, headers) {
         return __awaiter(this, void 0, void 0, function* () {
             return this.client.fetch(`/admin/price-lists/${id}`, {
@@ -52,6 +180,21 @@ export class PriceList {
             });
         });
     }
+    /**
+     * This method deletes a price list. It sends a request to the
+     * [Delete Price List](https://docs.medusajs.com/v2/api/admin#price-lists_deletepricelistsid)
+     * API route.
+     *
+     * @param id - The price list's ID.
+     * @param headers - Headers to pass in the request
+     * @returns The deletion's details.
+     *
+     * @example
+     * sdk.admin.priceList.delete("plist_123")
+     * .then(({ deleted }) => {
+     *   console.log(deleted)
+     * })
+     */
     delete(id, headers) {
         return __awaiter(this, void 0, void 0, function* () {
             return this.client.fetch(`/admin/price-lists/${id}`, {
@@ -60,6 +203,38 @@ export class PriceList {
             });
         });
     }
+    /**
+     * This method manages the prices of a price list to create, update, or delete them.
+     * It sends a request to the [Manage Prices](https://docs.medusajs.com/v2/api/admin#price-lists_postpricelistsidpricesbatch)
+     * API route.
+     *
+     * @param id - The price list's ID.
+     * @param body - The prices to create, update, or delete.
+     * @param query - Configure the fields to retrieve in the price list.
+     * @param headers - Headers to pass in the request
+     * @returns The price list's details.
+     *
+     * @example
+     * sdk.admin.priceList.batchPrices("plist_123", {
+     *   create: [{
+     *     variant_id: "variant_123",
+     *     currency_code: "usd",
+     *     amount: 10,
+     *     rules: {
+     *       region_id: "reg_123"
+     *     }
+     *   }],
+     *   update: [{
+     *     id: "price_123",
+     *     variant_id: "variant_123",
+     *     amount: 20,
+     *   }],
+     *   delete: ["price_123"]
+     * })
+     * .then(({ created, updated, deleted }) => {
+     *   console.log(created, updated, deleted)
+     * })
+     */
     batchPrices(id, body, query, headers) {
         return __awaiter(this, void 0, void 0, function* () {
             return this.client.fetch(`/admin/price-lists/${id}/prices/batch`, {
@@ -70,6 +245,25 @@ export class PriceList {
             });
         });
     }
+    /**
+     * This method removes products from a price list. It sends a request to the
+     * [Remove Product](https://docs.medusajs.com/v2/api/admin#price-lists_postpricelistsidproducts)
+     * API route.
+     *
+     * @param id - The price list's ID.
+     * @param body - The details of the products to remove.
+     * @param query - Configure the fields to retrieve in the price list.
+     * @param headers - Headers to pass in the request
+     * @returns The price list's details.
+     *
+     * @example
+     * sdk.admin.priceList.linkProducts("plist_123", {
+     *   remove: ["prod_123"]
+     * })
+     * .then(({ price_list }) => {
+     *   console.log(price_list)
+     * })
+     */
     linkProducts(id, body, query, headers) {
         return __awaiter(this, void 0, void 0, function* () {
             return this.client.fetch(`/admin/price-lists/${id}/products`, {

package/dist/esm/admin/price-list.js.map

@@ -1 +1 @@
-{"version":3,"file":"price-list.js","sourceRoot":"","sources":["../../../src/admin/price-list.ts"],"names":[],"mappings":";;;;;;;;;AAIA,MAAM,OAAO,SAAS;IAMpB;;OAEG;IACH,YAAY,MAAc;QACxB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;IACtB,CAAC;IAEK,QAAQ,CACZ,EAAU,EACV,KAAsC,EACtC,OAAuB;;YAEvB,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CACtB,sBAAsB,EAAE,EAAE,EAC1B;gBACE,MAAM,EAAE,KAAK;gBACb,OAAO;gBACP,KAAK;aACN,CACF,CAAA;QACH,CAAC;KAAA;IAEK,IAAI,CACR,KAA0C,EAC1C,OAAuB;;YAEvB,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CACtB,oBAAoB,EACpB;gBACE,MAAM,EAAE,KAAK;gBACb,OAAO;gBACP,KAAK;aACN,CACF,CAAA;QACH,CAAC;KAAA;IAEK,MAAM,CACV,IAAoC,EACpC,KAAsC,EACtC,OAAuB;;YAEvB,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CACtB,oBAAoB,EACpB;gBACE,MAAM,EAAE,MAAM;gBACd,OAAO;gBACP,IAAI;gBACJ,KAAK;aACN,CACF,CAAA;QACH,CAAC;KAAA;IAEK,MAAM,CACV,EAAU,EACV,IAAoC,EACpC,KAAsC,EACtC,OAAuB;;YAEvB,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CACtB,sBAAsB,EAAE,EAAE,EAC1B;gBACE,MAAM,EAAE,MAAM;gBACd,OAAO;gBACP,IAAI;gBACJ,KAAK;aACN,CACF,CAAA;QACH,CAAC;KAAA;IAEK,MAAM,CAAC,EAAU,EAAE,OAAuB;;YAC9C,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CACtB,sBAAsB,EAAE,EAAE,EAC1B;gBACE,MAAM,EAAE,QAAQ;gBAChB,OAAO;aACR,CACF,CAAA;QACH,CAAC;KAAA;IAEK,WAAW,CACf,EAAU,EACV,IAAwC,EACxC,KAAsC,EACtC,OAAuB;;YAEvB,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CACtB,sBAAsB,EAAE,eAAe,EACvC;gBACE,MAAM,EAAE,MAAM;gBACd,OAAO;gBACP,IAAI;gBACJ,KAAK;aACN,CACF,CAAA;QACH,CAAC;KAAA;IAEK,YAAY,CAChB,EAAU,EACV,IAA0C,EAC1C,KAAsC,EACtC,OAAuB;;YAEvB,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CACtB,sBAAsB,EAAE,WAAW,EACnC;gBACE,MAAM,EAAE,MAAM;gBACd,OAAO;gBACP,IAAI;gBACJ,KAAK;aACN,CACF,CAAA;QACH,CAAC;KAAA;CACF"}
+{"version":3,"file":"price-list.js","sourceRoot":"","sources":["../../../src/admin/price-list.ts"],"names":[],"mappings":";;;;;;;;;AAIA,MAAM,OAAO,SAAS;IAMpB;;OAEG;IACH,YAAY,MAAc;QACxB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;IACtB,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgCG;IACG,QAAQ,CACZ,EAAU,EACV,KAAsC,EACtC,OAAuB;;YAEvB,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CACtB,sBAAsB,EAAE,EAAE,EAC1B;gBACE,MAAM,EAAE,KAAK;gBACb,OAAO;gBACP,KAAK;aACN,CACF,CAAA;QACH,CAAC;KAAA;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6CG;IACG,IAAI,CACR,KAA0C,EAC1C,OAAuB;;YAEvB,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CACtB,oBAAoB,EACpB;gBACE,MAAM,EAAE,KAAK;gBACb,OAAO;gBACP,KAAK;aACN,CACF,CAAA;QACH,CAAC;KAAA;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACG,MAAM,CACV,IAAoC,EACpC,KAAsC,EACtC,OAAuB;;YAEvB,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CACtB,oBAAoB,EACpB;gBACE,MAAM,EAAE,MAAM;gBACd,OAAO;gBACP,IAAI;gBACJ,KAAK;aACN,CACF,CAAA;QACH,CAAC;KAAA;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACG,MAAM,CACV,EAAU,EACV,IAAoC,EACpC,KAAsC,EACtC,OAAuB;;YAEvB,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CACtB,sBAAsB,EAAE,EAAE,EAC1B;gBACE,MAAM,EAAE,MAAM;gBACd,OAAO;gBACP,IAAI;gBACJ,KAAK;aACN,CACF,CAAA;QACH,CAAC;KAAA;IAED;;;;;;;;;;;;;;OAcG;IACG,MAAM,CAAC,EAAU,EAAE,OAAuB;;YAC9C,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CACtB,sBAAsB,EAAE,EAAE,EAC1B;gBACE,MAAM,EAAE,QAAQ;gBAChB,OAAO;aACR,CACF,CAAA;QACH,CAAC;KAAA;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IACG,WAAW,CACf,EAAU,EACV,IAAwC,EACxC,KAAsC,EACtC,OAAuB;;YAEvB,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CACtB,sBAAsB,EAAE,eAAe,EACvC;gBACE,MAAM,EAAE,MAAM;gBACd,OAAO;gBACP,IAAI;gBACJ,KAAK;aACN,CACF,CAAA;QACH,CAAC;KAAA;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACG,YAAY,CAChB,EAAU,EACV,IAA0C,EAC1C,KAAsC,EACtC,OAAuB;;YAEvB,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CACtB,sBAAsB,EAAE,WAAW,EACnC;gBACE,MAAM,EAAE,MAAM;gBACd,OAAO;gBACP,IAAI;gBACJ,KAAK;aACN,CACF,CAAA;QACH,CAAC;KAAA;CACF"}