@medusajs/js-sdk 1.0.0-rc-20241016093905 → 1.0.0-rc-20241022152047

package/dist/admin/campaign.js

@@ -2,21 +2,118 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Campaign = void 0;
 class Campaign {
+    /**
+     * @ignore
+     */
     constructor(client) {
         this.client = client;
     }
+    /**
+     * This method retrieves a campaign by its ID. It sends a request to the
+     * [Get Campaign](https://docs.medusajs.com/v2/api/admin#campaigns_getcampaignsid) API route.
+     *
+     * @param id - The campaign's ID.
+     * @param query - Configure the fields to retrieve in the campaign.
+     * @param headers - Headers to pass in the request
+     * @returns The campaign's details.
+     *
+     * @example
+     * To retrieve a campaign by its ID:
+     *
+     * ```ts
+     * sdk.admin.campaign.retrieve("procamp_123")
+     * .then(({ campaign }) => {
+     *   console.log(campaign)
+     * })
+     * ```
+     *
+     * To specify the fields and relations to retrieve:
+     *
+     * ```ts
+     * sdk.admin.campaign.retrieve("procamp_123", {
+     *   fields: "id,*budget"
+     * })
+     * .then(({ campaign }) => {
+     *   console.log(campaign)
+     * })
+     * ```
+     *
+     * Learn more about the `fields` property in the [API reference](https://docs.medusajs.com/v2/api/store#select-fields-and-relations).
+     */
     async retrieve(id, query, headers) {
         return await this.client.fetch(`/admin/campaigns/${id}`, {
             headers,
             query,
         });
     }
+    /**
+     * This method retrieves a paginated list of campaigns. It sends a request to the
+     * [List Campaigns](https://docs.medusajs.com/v2/api/admin#campaigns_getcampaigns) API route.
+     *
+     * @param query - Filters and pagination configurations.
+     * @param headers - Headers to pass in the request.
+     * @returns The paginated list of campaigns.
+     *
+     * @example
+     * To retrieve the list of campaigns:
+     *
+     * ```ts
+     * sdk.admin.campaign.list()
+     * .then(({ campaigns, count, limit, offset }) => {
+     *   console.log(campaigns)
+     * })
+     * ```
+     *
+     * 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.campaign.list({
+     *   limit: 10,
+     *   offset: 10
+     * })
+     * .then(({ campaigns, count, limit, offset }) => {
+     *   console.log(campaigns)
+     * })
+     * ```
+     *
+     * Using the `fields` query parameter, you can specify the fields and relations to retrieve
+     * in each campaign:
+     *
+     * ```ts
+     * sdk.admin.campaign.list({
+     *   fields: "id,*budget"
+     * })
+     * .then(({ campaigns, count, limit, offset }) => {
+     *   console.log(campaigns)
+     * })
+     * ```
+     *
+     * Learn more about the `fields` property in the [API reference](https://docs.medusajs.com/v2/api/store#select-fields-and-relations).
+     */
     async list(query, headers) {
         return await this.client.fetch(`/admin/campaigns`, {
             headers,
             query,
         });
     }
+    /**
+     * This method creates a campaign. It sends a request to the
+     * [Create Campaign](https://docs.medusajs.com/v2/api/admin#campaigns_postcampaigns) API route.
+     *
+     * @param payload - The details of the campaign to create.
+     * @param headers - Headers to pass in the request
+     * @returns The campaign's details.
+     *
+     * @example
+     * sdk.admin.campaign.create({
+     *   name: "Summer Campaign"
+     * })
+     * .then(({ campaign }) => {
+     *   console.log(campaign)
+     * })
+     */
     async create(payload, headers) {
         return await this.client.fetch(`/admin/campaigns`, {
             method: "POST",
@@ -24,6 +121,23 @@ class Campaign {
             body: payload,
         });
     }
+    /**
+     * This method updates a campaign. It sends a request to the
+     * [Update Campaign](https://docs.medusajs.com/v2/api/admin#campaigns_postcampaignsid) API route.
+     *
+     * @param id - The campaign's ID.
+     * @param payload - The data to update in the campaign.
+     * @param headers - Headers to pass in the request
+     * @returns The campaign's details.
+     *
+     * @example
+     * sdk.admin.campaign.update("procamp_123", {
+     *   name: "Summer Campaign"
+     * })
+     * .then(({ campaign }) => {
+     *   console.log(campaign)
+     * })
+     */
     async update(id, payload, headers) {
         return await this.client.fetch(`/admin/campaigns/${id}`, {
             method: "POST",
@@ -31,12 +145,36 @@ class Campaign {
             body: payload,
         });
     }
+    /**
+     * This method deletes a campaign by its ID. It sends a request to the
+     * [Delete Campaign](https://docs.medusajs.com/v2/api/admin#campaigns_deletecampaignsid) API route.
+     *
+     * @param id - The campaign's ID.
+     * @param headers - Headers to pass in the request
+     * @returns The deletion's details.
+     *
+     * @example
+     * sdk.admin.campaign.delete("procamp_123")
+     * .then(({ deleted }) => {
+     *   console.log(deleted)
+     * })
+     */
     async delete(id, headers) {
         return await this.client.fetch(`/admin/campaigns/${id}`, {
             method: "DELETE",
             headers,
         });
     }
+    /**
+     * This method manages the promotions of a campaign to either add or remove the association between them.
+     * It sends a request to the [Manage Promotions](https://docs.medusajs.com/v2/api/admin#campaigns_postcampaignsidpromotions)
+     * API route.
+     *
+     * @param id - The campaign's ID.
+     * @param payload - The promotions to add or remove associations to them.
+     * @param headers - Headers to pass in the request
+     * @returns The campaign's details.
+     */
     async batchPromotions(id, payload, headers) {
         return await this.client.fetch(`/admin/campaigns/${id}/promotions`, {
             method: "POST",

package/dist/admin/campaign.js.map

@@ -1 +1 @@
-{"version":3,"file":"campaign.js","sourceRoot":"","sources":["../../src/admin/campaign.ts"],"names":[],"mappings":";;;AAIA,MAAa,QAAQ;IAEnB,YAAY,MAAc;QACxB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;IACtB,CAAC;IAED,KAAK,CAAC,QAAQ,CACZ,EAAU,EACV,KAAwC,EACxC,OAAuB;QAEvB,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAC5B,oBAAoB,EAAE,EAAE,EACxB;YACE,OAAO;YACP,KAAK;SACN,CACF,CAAA;IACH,CAAC;IAED,KAAK,CAAC,IAAI,CACR,KAAyC,EACzC,OAAuB;QAEvB,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAC5B,kBAAkB,EAClB;YACE,OAAO;YACP,KAAK;SACN,CACF,CAAA;IACH,CAAC;IAED,KAAK,CAAC,MAAM,CACV,OAAsC,EACtC,OAAuB;QAEvB,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAC5B,kBAAkB,EAClB;YACE,MAAM,EAAE,MAAM;YACd,OAAO;YACP,IAAI,EAAE,OAAO;SACd,CACF,CAAA;IACH,CAAC;IAED,KAAK,CAAC,MAAM,CACV,EAAU,EACV,OAAsC,EACtC,OAAuB;QAEvB,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAC5B,oBAAoB,EAAE,EAAE,EACxB;YACE,MAAM,EAAE,MAAM;YACd,OAAO;YACP,IAAI,EAAE,OAAO;SACd,CACF,CAAA;IACH,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,EAAU,EAAE,OAAuB;QAC9C,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAC5B,oBAAoB,EAAE,EAAE,EACxB;YACE,MAAM,EAAE,QAAQ;YAChB,OAAO;SACR,CACF,CAAA;IACH,CAAC;IAED,KAAK,CAAC,eAAe,CACnB,EAAU,EACV,OAAiC,EACjC,OAAuB;QAEvB,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAC5B,oBAAoB,EAAE,aAAa,EACnC;YACE,MAAM,EAAE,MAAM;YACd,OAAO;YACP,IAAI,EAAE,OAAO;SACd,CACF,CAAA;IACH,CAAC;CACF;AAtFD,4BAsFC"}
+{"version":3,"file":"campaign.js","sourceRoot":"","sources":["../../src/admin/campaign.ts"],"names":[],"mappings":";;;AAIA,MAAa,QAAQ;IAKnB;;OAEG;IACH,YAAY,MAAc;QACxB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;IACtB,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IACH,KAAK,CAAC,QAAQ,CACZ,EAAU,EACV,KAAwC,EACxC,OAAuB;QAEvB,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAC5B,oBAAoB,EAAE,EAAE,EACxB;YACE,OAAO;YACP,KAAK;SACN,CACF,CAAA;IACH,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6CG;IACH,KAAK,CAAC,IAAI,CACR,KAAyC,EACzC,OAAuB;QAEvB,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAC5B,kBAAkB,EAClB;YACE,OAAO;YACP,KAAK;SACN,CACF,CAAA;IACH,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,KAAK,CAAC,MAAM,CACV,OAAsC,EACtC,OAAuB;QAEvB,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAC5B,kBAAkB,EAClB;YACE,MAAM,EAAE,MAAM;YACd,OAAO;YACP,IAAI,EAAE,OAAO;SACd,CACF,CAAA;IACH,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,KAAK,CAAC,MAAM,CACV,EAAU,EACV,OAAsC,EACtC,OAAuB;QAEvB,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAC5B,oBAAoB,EAAE,EAAE,EACxB;YACE,MAAM,EAAE,MAAM;YACd,OAAO;YACP,IAAI,EAAE,OAAO;SACd,CACF,CAAA;IACH,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,KAAK,CAAC,MAAM,CAAC,EAAU,EAAE,OAAuB;QAC9C,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAC5B,oBAAoB,EAAE,EAAE,EACxB;YACE,MAAM,EAAE,QAAQ;YAChB,OAAO;SACR,CACF,CAAA;IACH,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,eAAe,CACnB,EAAU,EACV,OAAiC,EACjC,OAAuB;QAEvB,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAC5B,oBAAoB,EAAE,aAAa,EACnC;YACE,MAAM,EAAE,MAAM;YACd,OAAO;YACP,IAAI,EAAE,OAAO;SACd,CACF,CAAA;IACH,CAAC;CACF;AAnOD,4BAmOC"}