@contentstack/cli-variants 1.2.2 → 1.3.2

package/lib/utils/personalization-api-adapter.js

@@ -26,33 +26,47 @@ const cli_utilities_1 = require("@contentstack/cli-utilities");
 const error_helper_1 = require("./error-helper");
 class PersonalizationAdapter extends adapter_helper_1.AdapterHelper {
     constructor(options) {
+        var _a;
         super(options);
+        cli_utilities_1.log.debug('PersonalizationAdapter initialized', (_a = this.exportConfig) === null || _a === void 0 ? void 0 : _a.context);
     }
     init() {
         return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b;
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            cli_utilities_1.log.debug('Initializing personalization adapter...', (_a = this.exportConfig) === null || _a === void 0 ? void 0 : _a.context);
             yield cli_utilities_1.authenticationHandler.getAuthDetails();
             const token = cli_utilities_1.authenticationHandler.accessToken;
+            cli_utilities_1.log.debug(`Authentication type: ${cli_utilities_1.authenticationHandler.isOauthEnabled ? 'OAuth' : 'Token'}`, (_b = this.exportConfig) === null || _b === void 0 ? void 0 : _b.context);
             if (cli_utilities_1.authenticationHandler.isOauthEnabled) {
+                cli_utilities_1.log.debug('Setting OAuth authorization header', (_c = this.exportConfig) === null || _c === void 0 ? void 0 : _c.context);
                 this.apiClient.headers({ authorization: token });
                 if (this.adapterConfig.cmaConfig) {
-                    (_a = this.cmaAPIClient) === null || _a === void 0 ? void 0 : _a.headers({ authorization: token });
+                    cli_utilities_1.log.debug('Setting OAuth authorization header for CMA client', (_d = this.exportConfig) === null || _d === void 0 ? void 0 : _d.context);
+                    (_e = this.cmaAPIClient) === null || _e === void 0 ? void 0 : _e.headers({ authorization: token });
                 }
             }
             else {
+                cli_utilities_1.log.debug('Setting authtoken header', (_f = this.exportConfig) === null || _f === void 0 ? void 0 : _f.context);
                 this.apiClient.headers({ authtoken: token });
                 if (this.adapterConfig.cmaConfig) {
-                    (_b = this.cmaAPIClient) === null || _b === void 0 ? void 0 : _b.headers({ authtoken: token });
+                    cli_utilities_1.log.debug('Setting authtoken header for CMA client', (_g = this.exportConfig) === null || _g === void 0 ? void 0 : _g.context);
+                    (_h = this.cmaAPIClient) === null || _h === void 0 ? void 0 : _h.headers({ authtoken: token });
                 }
             }
+            cli_utilities_1.log.debug('Personalization adapter initialization completed', (_j = this.exportConfig) === null || _j === void 0 ? void 0 : _j.context);
         });
     }
     projects(options) {
         return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c;
+            cli_utilities_1.log.debug(`Fetching projects for stack API key: ${options.connectedStackApiKey}`, (_a = this.exportConfig) === null || _a === void 0 ? void 0 : _a.context);
             yield this.init();
             const getProjectEndPoint = `/projects?connectedStackApiKey=${options.connectedStackApiKey}`;
+            cli_utilities_1.log.debug(`Making API call to: ${getProjectEndPoint}`, (_b = this.exportConfig) === null || _b === void 0 ? void 0 : _b.context);
             const data = yield this.apiClient.get(getProjectEndPoint);
-            return (yield this.handleVariantAPIRes(data));
+            const result = (yield this.handleVariantAPIRes(data));
+            cli_utilities_1.log.debug(`Fetched ${(result === null || result === void 0 ? void 0 : result.length) || 0} projects`, (_c = this.exportConfig) === null || _c === void 0 ? void 0 : _c.context);
+            return result;
         });
     }
     /**
@@ -67,8 +81,12 @@ class PersonalizationAdapter extends adapter_helper_1.AdapterHelper {
      */
     createProject(project) {
         return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b;
+            cli_utilities_1.log.debug(`Creating project: ${project.name}`, (_a = this.exportConfig) === null || _a === void 0 ? void 0 : _a.context);
             const data = yield this.apiClient.post('/projects', project);
-            return (yield this.handleVariantAPIRes(data));
+            const result = (yield this.handleVariantAPIRes(data));
+            cli_utilities_1.log.debug(`Project created successfully: ${result.uid}`, (_b = this.exportConfig) === null || _b === void 0 ? void 0 : _b.context);
+            return result;
         });
     }
     /**
@@ -82,102 +100,155 @@ class PersonalizationAdapter extends adapter_helper_1.AdapterHelper {
      */
     createAttribute(attribute) {
         return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b;
+            cli_utilities_1.log.debug(`Creating attribute: ${attribute.name}`, (_a = this.exportConfig) === null || _a === void 0 ? void 0 : _a.context);
             const data = yield this.apiClient.post('/attributes', attribute);
-            return (yield this.handleVariantAPIRes(data));
+            const result = (yield this.handleVariantAPIRes(data));
+            cli_utilities_1.log.debug(`Attribute created successfully: ${result.uid}`, (_b = this.exportConfig) === null || _b === void 0 ? void 0 : _b.context);
+            return result;
         });
     }
     getExperiences() {
         return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b;
+            cli_utilities_1.log.debug('Fetching experiences from personalization API', (_a = this.exportConfig) === null || _a === void 0 ? void 0 : _a.context);
             const getExperiencesEndPoint = `/experiences`;
             const data = yield this.apiClient.get(getExperiencesEndPoint);
-            return (yield this.handleVariantAPIRes(data));
+            const result = (yield this.handleVariantAPIRes(data));
+            cli_utilities_1.log.debug(`Fetched ${(result === null || result === void 0 ? void 0 : result.length) || 0} experiences`, (_b = this.exportConfig) === null || _b === void 0 ? void 0 : _b.context);
+            return result;
         });
     }
     getExperience(experienceUid) {
         return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b, _c, _d;
+            var _a, _b, _c, _d, _e, _f;
+            cli_utilities_1.log.debug(`Fetching experience: ${experienceUid}`, (_a = this.exportConfig) === null || _a === void 0 ? void 0 : _a.context);
             const getExperiencesEndPoint = `/experiences/${experienceUid}`;
-            if ((_b = (_a = this.apiClient).requestConfig) === null || _b === void 0 ? void 0 : _b.call(_a).data) {
-                (_d = (_c = this.apiClient).requestConfig) === null || _d === void 0 ? true : delete _d.call(_c).data; // explicitly prevent any accidental body
+            if ((_c = (_b = this.apiClient).requestConfig) === null || _c === void 0 ? void 0 : _c.call(_b).data) {
+                (_e = (_d = this.apiClient).requestConfig) === null || _e === void 0 ? true : delete _e.call(_d).data; // explicitly prevent any accidental body
             }
             const data = yield this.apiClient.get(getExperiencesEndPoint);
-            return (yield this.handleVariantAPIRes(data));
+            const result = (yield this.handleVariantAPIRes(data));
+            cli_utilities_1.log.debug(`Experience fetched successfully: ${result === null || result === void 0 ? void 0 : result.uid}`, (_f = this.exportConfig) === null || _f === void 0 ? void 0 : _f.context);
+            return result;
         });
     }
     getExperienceVersions(experienceUid) {
         return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b, _c, _d;
+            var _a, _b, _c, _d, _e, _f;
+            cli_utilities_1.log.debug(`Fetching versions for experience: ${experienceUid}`, (_a = this.exportConfig) === null || _a === void 0 ? void 0 : _a.context);
             const getExperiencesVersionsEndPoint = `/experiences/${experienceUid}/versions`;
-            if ((_b = (_a = this.apiClient).requestConfig) === null || _b === void 0 ? void 0 : _b.call(_a).data) {
-                (_d = (_c = this.apiClient).requestConfig) === null || _d === void 0 ? true : delete _d.call(_c).data; // explicitly prevent any accidental body
+            if ((_c = (_b = this.apiClient).requestConfig) === null || _c === void 0 ? void 0 : _c.call(_b).data) {
+                (_e = (_d = this.apiClient).requestConfig) === null || _e === void 0 ? true : delete _e.call(_d).data; // explicitly prevent any accidental body
             }
             const data = yield this.apiClient.get(getExperiencesVersionsEndPoint);
-            return (yield this.handleVariantAPIRes(data));
+            const result = (yield this.handleVariantAPIRes(data));
+            cli_utilities_1.log.debug(`Experience versions fetched successfully for: ${experienceUid}`, (_f = this.exportConfig) === null || _f === void 0 ? void 0 : _f.context);
+            return result;
         });
     }
     createExperienceVersion(experienceUid, input) {
         return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b;
+            cli_utilities_1.log.debug(`Creating experience version for: ${experienceUid}`, (_a = this.exportConfig) === null || _a === void 0 ? void 0 : _a.context);
             const createExperiencesVersionsEndPoint = `/experiences/${experienceUid}/versions`;
             const data = yield this.apiClient.post(createExperiencesVersionsEndPoint, input);
-            return (yield this.handleVariantAPIRes(data));
+            const result = (yield this.handleVariantAPIRes(data));
+            cli_utilities_1.log.debug(`Experience version created successfully for: ${experienceUid}`, (_b = this.exportConfig) === null || _b === void 0 ? void 0 : _b.context);
+            return result;
         });
     }
     updateExperienceVersion(experienceUid, versionId, input) {
         return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c;
+            cli_utilities_1.log.debug(`Updating experience version: ${versionId} for experience: ${experienceUid}`, (_a = this.exportConfig) === null || _a === void 0 ? void 0 : _a.context);
             // loop through input and remove shortId from variant
             if (input === null || input === void 0 ? void 0 : input.variants) {
                 input.variants = input.variants.map((_a) => {
                     var { shortUid } = _a, rest = __rest(_a, ["shortUid"]);
                     return rest;
                 });
+                cli_utilities_1.log.debug(`Processed ${input.variants.length} variants for update`, (_b = this.exportConfig) === null || _b === void 0 ? void 0 : _b.context);
             }
             const updateExperiencesVersionsEndPoint = `/experiences/${experienceUid}/versions/${versionId}`;
             const data = yield this.apiClient.put(updateExperiencesVersionsEndPoint, input);
-            return (yield this.handleVariantAPIRes(data));
+            const result = (yield this.handleVariantAPIRes(data));
+            cli_utilities_1.log.debug(`Experience version updated successfully: ${versionId}`, (_c = this.exportConfig) === null || _c === void 0 ? void 0 : _c.context);
+            return result;
         });
     }
     getVariantGroup(input) {
         return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c;
+            cli_utilities_1.log.debug(`Fetching variant group for experience: ${input.experienceUid}`, (_a = this.exportConfig) === null || _a === void 0 ? void 0 : _a.context);
             if (this.cmaAPIClient) {
                 const getVariantGroupEndPoint = `/variant_groups`;
                 const data = yield this.cmaAPIClient
                     .queryParams({ experience_uid: input.experienceUid })
                     .get(getVariantGroupEndPoint);
-                return (yield this.handleVariantAPIRes(data));
+                const result = (yield this.handleVariantAPIRes(data));
+                cli_utilities_1.log.debug(`Variant group fetched successfully for experience: ${input.experienceUid}`, (_b = this.exportConfig) === null || _b === void 0 ? void 0 : _b.context);
+                return result;
+            }
+            else {
+                cli_utilities_1.log.debug('CMA API client not available for variant group fetch', (_c = this.exportConfig) === null || _c === void 0 ? void 0 : _c.context);
             }
         });
     }
     updateVariantGroup(input) {
         return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c;
+            cli_utilities_1.log.debug(`Updating variant group: ${input.uid}`, (_a = this.exportConfig) === null || _a === void 0 ? void 0 : _a.context);
             if (this.cmaAPIClient) {
                 const updateVariantGroupEndPoint = `/variant_groups/${input.uid}`;
                 const data = yield this.cmaAPIClient.put(updateVariantGroupEndPoint, input);
-                return (yield this.handleVariantAPIRes(data));
+                const result = (yield this.handleVariantAPIRes(data));
+                cli_utilities_1.log.debug(`Variant group updated successfully: ${input.uid}`, (_b = this.exportConfig) === null || _b === void 0 ? void 0 : _b.context);
+                return result;
+            }
+            else {
+                cli_utilities_1.log.debug('CMA API client not available for variant group update', (_c = this.exportConfig) === null || _c === void 0 ? void 0 : _c.context);
             }
         });
     }
     getEvents() {
         return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b;
+            cli_utilities_1.log.debug('Fetching events from personalization API', (_a = this.exportConfig) === null || _a === void 0 ? void 0 : _a.context);
             const data = yield this.apiClient.get('/events');
-            return (yield this.handleVariantAPIRes(data));
+            const result = (yield this.handleVariantAPIRes(data));
+            cli_utilities_1.log.debug(`Fetched ${(result === null || result === void 0 ? void 0 : result.length) || 0} events`, (_b = this.exportConfig) === null || _b === void 0 ? void 0 : _b.context);
+            return result;
         });
     }
     createEvents(event) {
         return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b;
+            cli_utilities_1.log.debug(`Creating event: ${event.key}`, (_a = this.exportConfig) === null || _a === void 0 ? void 0 : _a.context);
             const data = yield this.apiClient.post('/events', event);
-            return (yield this.handleVariantAPIRes(data));
+            const result = (yield this.handleVariantAPIRes(data));
+            cli_utilities_1.log.debug(`Event created successfully: ${result.uid}`, (_b = this.exportConfig) === null || _b === void 0 ? void 0 : _b.context);
+            return result;
         });
     }
     getAudiences() {
         return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b;
+            cli_utilities_1.log.debug('Fetching audiences from personalization API', (_a = this.exportConfig) === null || _a === void 0 ? void 0 : _a.context);
             const data = yield this.apiClient.get('/audiences');
-            return (yield this.handleVariantAPIRes(data));
+            const result = (yield this.handleVariantAPIRes(data));
+            cli_utilities_1.log.debug(`Fetched ${(result === null || result === void 0 ? void 0 : result.length) || 0} audiences`, (_b = this.exportConfig) === null || _b === void 0 ? void 0 : _b.context);
+            return result;
         });
     }
     getAttributes() {
         return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b;
+            cli_utilities_1.log.debug('Fetching attributes from personalization API', (_a = this.exportConfig) === null || _a === void 0 ? void 0 : _a.context);
             const data = yield this.apiClient.get('/attributes');
-            return (yield this.handleVariantAPIRes(data));
+            const result = (yield this.handleVariantAPIRes(data));
+            cli_utilities_1.log.debug(`Fetched ${(result === null || result === void 0 ? void 0 : result.length) || 0} attributes`, (_b = this.exportConfig) === null || _b === void 0 ? void 0 : _b.context);
+            return result;
         });
     }
     /**
@@ -190,8 +261,12 @@ class PersonalizationAdapter extends adapter_helper_1.AdapterHelper {
      */
     createAudience(audience) {
         return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b;
+            cli_utilities_1.log.debug(`Creating audience: ${audience.name}`, (_a = this.exportConfig) === null || _a === void 0 ? void 0 : _a.context);
             const data = yield this.apiClient.post('/audiences', audience);
-            return (yield this.handleVariantAPIRes(data));
+            const result = (yield this.handleVariantAPIRes(data));
+            cli_utilities_1.log.debug(`Audience created successfully: ${result.uid}`, (_b = this.exportConfig) === null || _b === void 0 ? void 0 : _b.context);
+            return result;
         });
     }
     /**
@@ -204,8 +279,12 @@ class PersonalizationAdapter extends adapter_helper_1.AdapterHelper {
      */
     createExperience(experience) {
         return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b;
+            cli_utilities_1.log.debug(`Creating experience: ${experience.name}`, (_a = this.exportConfig) === null || _a === void 0 ? void 0 : _a.context);
             const data = yield this.apiClient.post('/experiences', experience);
-            return (yield this.handleVariantAPIRes(data));
+            const result = (yield this.handleVariantAPIRes(data));
+            cli_utilities_1.log.debug(`Experience created successfully: ${result.uid}`, (_b = this.exportConfig) === null || _b === void 0 ? void 0 : _b.context);
+            return result;
         });
     }
     /**
@@ -215,9 +294,13 @@ class PersonalizationAdapter extends adapter_helper_1.AdapterHelper {
      */
     updateCTsInExperience(experience, experienceUid) {
         return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b;
+            cli_utilities_1.log.debug(`Updating content types in experience: ${experienceUid}`, (_a = this.exportConfig) === null || _a === void 0 ? void 0 : _a.context);
             const updateCTInExpEndPoint = `/experiences/${experienceUid}/cms-integration/variant-group`;
             const data = yield this.apiClient.post(updateCTInExpEndPoint, experience);
-            return (yield this.handleVariantAPIRes(data));
+            const result = (yield this.handleVariantAPIRes(data));
+            cli_utilities_1.log.debug(`Content types updated successfully in experience: ${experienceUid}`, (_b = this.exportConfig) === null || _b === void 0 ? void 0 : _b.context);
+            return result;
         });
     }
     /**
@@ -227,9 +310,13 @@ class PersonalizationAdapter extends adapter_helper_1.AdapterHelper {
      */
     getCTsFromExperience(experienceUid) {
         return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b;
+            cli_utilities_1.log.debug(`Fetching content types from experience: ${experienceUid}`, (_a = this.exportConfig) === null || _a === void 0 ? void 0 : _a.context);
             const getCTFromExpEndPoint = `/experiences/${experienceUid}/cms-integration/variant-group`;
             const data = yield this.apiClient.get(getCTFromExpEndPoint);
-            return (yield this.handleVariantAPIRes(data));
+            const result = (yield this.handleVariantAPIRes(data));
+            cli_utilities_1.log.debug(`Content types fetched successfully from experience: ${experienceUid}`, (_b = this.exportConfig) === null || _b === void 0 ? void 0 : _b.context);
+            return result;
         });
     }
     /**
@@ -240,15 +327,20 @@ class PersonalizationAdapter extends adapter_helper_1.AdapterHelper {
      */
     handleVariantAPIRes(res) {
         return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d;
             const { status, data } = res;
+            cli_utilities_1.log.debug(`API response status: ${status}`, (_a = this.exportConfig) === null || _a === void 0 ? void 0 : _a.context);
             if (status >= 200 && status < 300) {
+                cli_utilities_1.log.debug('API request successful', (_b = this.exportConfig) === null || _b === void 0 ? void 0 : _b.context);
                 return data;
             }
+            cli_utilities_1.log.debug(`API request failed with status: ${status}`, (_c = this.exportConfig) === null || _c === void 0 ? void 0 : _c.context);
             // Refresh the access token if it has expired
             yield cli_utilities_1.authenticationHandler.refreshAccessToken(res);
             const errorMsg = (data === null || data === void 0 ? void 0 : data.errors)
                 ? (0, error_helper_1.formatErrors)(data.errors)
                 : (data === null || data === void 0 ? void 0 : data.error) || (data === null || data === void 0 ? void 0 : data.error_message) || (data === null || data === void 0 ? void 0 : data.message) || data;
+            cli_utilities_1.log.debug(`API error: ${errorMsg}`, (_d = this.exportConfig) === null || _d === void 0 ? void 0 : _d.context);
             throw errorMsg;
         });
     }

package/lib/utils/variant-api-adapter.d.ts

@@ -1,9 +1,10 @@
 import { HttpClient, HttpClientOptions, ContentstackClient, ContentstackConfig } from '@contentstack/cli-utilities';
-import { APIConfig, AdapterType, AnyProperty, VariantOptions, VariantsOption, VariantInterface, VariantEntryStruct, CreateVariantEntryDto, CreateVariantEntryOptions, APIResponse, PublishVariantEntryDto, PublishVariantEntryOptions } from '../types';
+import { APIConfig, AdapterType, AnyProperty, ExportConfig, VariantOptions, VariantsOption, VariantInterface, VariantEntryStruct, CreateVariantEntryDto, CreateVariantEntryOptions, APIResponse, PublishVariantEntryDto, PublishVariantEntryOptions } from '../types';
 import messages from '../messages';
 import { AdapterHelper } from './adapter-helper';
 export declare class VariantHttpClient<C> extends AdapterHelper<C, HttpClient> implements VariantInterface<C, HttpClient> {
     baseURL: string;
+    exportConfig?: ExportConfig;
     constructor(config: APIConfig, options?: HttpClientOptions);
     init(): Promise<void>;
     variantEntry(options: VariantOptions): Promise<{
@@ -56,6 +57,7 @@ export declare class VariantHttpClient<C> extends AdapterHelper<C, HttpClient> i
 }
 export declare class VariantManagementSDK<T> extends AdapterHelper<T, ContentstackClient> implements VariantInterface<T, ContentstackClient> {
     apiClient: ContentstackClient;
+    exportConfig?: any;
     init(): Promise<void>;
     variantEntry(options: VariantOptions): Promise<{
         entry: {};
@@ -74,6 +76,7 @@ export declare class VariantManagementSDK<T> extends AdapterHelper<T, Contentsta
 export declare class VariantAdapter<T> {
     protected variantInstance: T;
     readonly messages: typeof messages;
+    exportConfig?: any;
     constructor(config: ContentstackConfig & AnyProperty & AdapterType<T, ContentstackConfig>);
     constructor(config: APIConfig & AdapterType<T, APIConfig & AnyProperty>, options?: HttpClientOptions);
 }

package/lib/utils/variant-api-adapter.js

@@ -32,25 +32,33 @@ const adapter_helper_1 = require("./adapter-helper");
 const error_helper_1 = require("./error-helper");
 class VariantHttpClient extends adapter_helper_1.AdapterHelper {
     constructor(config, options) {
-        var _a;
+        var _a, _b;
         super(config, options);
         this.baseURL = ((_a = config.baseURL) === null || _a === void 0 ? void 0 : _a.includes('http')) ? `${config.baseURL}/v3` : `https://${config.baseURL}/v3`;
         this.apiClient.baseUrl(this.baseURL);
+        cli_utilities_1.log.debug(`VariantHttpClient initialized with base URL: ${this.baseURL}`, (_b = this.exportConfig) === null || _b === void 0 ? void 0 : _b.context);
     }
     init() {
         return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e;
+            cli_utilities_1.log.debug('Initializing VariantHttpClient...', (_a = this.exportConfig) === null || _a === void 0 ? void 0 : _a.context);
             yield cli_utilities_1.authenticationHandler.getAuthDetails();
             const token = cli_utilities_1.authenticationHandler.accessToken;
+            cli_utilities_1.log.debug(`Authentication type: ${cli_utilities_1.authenticationHandler.isOauthEnabled ? 'OAuth' : 'Token'}`, (_b = this.exportConfig) === null || _b === void 0 ? void 0 : _b.context);
             if (cli_utilities_1.authenticationHandler.isOauthEnabled) {
+                cli_utilities_1.log.debug('Setting OAuth authorization header', (_c = this.exportConfig) === null || _c === void 0 ? void 0 : _c.context);
                 this.apiClient.headers({ authorization: token });
             }
             else {
+                cli_utilities_1.log.debug('Setting authtoken header', (_d = this.exportConfig) === null || _d === void 0 ? void 0 : _d.context);
                 this.apiClient.headers({ authtoken: token });
             }
+            cli_utilities_1.log.debug('VariantHttpClient initialization completed', (_e = this.exportConfig) === null || _e === void 0 ? void 0 : _e.context);
         });
     }
     variantEntry(options) {
         return __awaiter(this, void 0, void 0, function* () {
+            cli_utilities_1.log.debug('VariantEntry method called (placeholder implementation)', { module: 'variant-api-adapter' });
             // TODO single entry variant
             return { entry: {} };
         });
@@ -70,18 +78,25 @@ class VariantHttpClient extends adapter_helper_1.AdapterHelper {
      */
     variantEntries(options_1) {
         return __awaiter(this, arguments, void 0, function* (options, entries = []) {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p;
             const variantConfig = this.config.modules.variantEntry;
             const { callback, entry_uid, getAllData, returnResult, content_type_uid, locale, skip = variantConfig.query.skip || 0, limit = variantConfig.query.limit || 100, include_variant = variantConfig.query.include_variant || true, include_count = variantConfig.query.include_count || true, include_publish_details = variantConfig.query.include_publish_details || true, } = options;
+            cli_utilities_1.log.debug(`Fetching variant entries for content type: ${content_type_uid}, entry: ${entry_uid}, locale: ${locale}`, (_a = this.exportConfig) === null || _a === void 0 ? void 0 : _a.context);
+            cli_utilities_1.log.debug(`Query parameters - skip: ${skip}, limit: ${limit}, include_variant: ${include_variant}, include_count: ${include_count}, include_publish_details: ${include_publish_details}`, (_b = this.exportConfig) === null || _b === void 0 ? void 0 : _b.context);
             if (variantConfig.serveMockData && callback) {
+                cli_utilities_1.log.debug('Using mock data for variant entries', (_c = this.exportConfig) === null || _c === void 0 ? void 0 : _c.context);
                 let data = [];
                 if ((0, fs_1.existsSync)(variantConfig.mockDataPath)) {
+                    cli_utilities_1.log.debug(`Loading mock data from: ${variantConfig.mockDataPath}`, (_d = this.exportConfig) === null || _d === void 0 ? void 0 : _d.context);
                     data = require(variantConfig.mockDataPath);
                 }
                 callback(data);
                 return;
             }
-            if (!locale)
+            if (!locale) {
+                cli_utilities_1.log.debug('No locale provided, skipping variant entries fetch', (_e = this.exportConfig) === null || _e === void 0 ? void 0 : _e.context);
                 return;
+            }
             const start = Date.now();
             let endpoint = `/content_types/${content_type_uid}/entries/${entry_uid}/variants?locale=${locale}`;
             if (skip) {
@@ -110,12 +125,18 @@ class VariantHttpClient extends adapter_helper_1.AdapterHelper {
             if (query) {
                 endpoint = endpoint.concat(query);
             }
+            cli_utilities_1.log.debug(`Making API call to: ${endpoint}`, (_f = this.exportConfig) === null || _f === void 0 ? void 0 : _f.context);
             const data = yield this.apiClient.get(endpoint);
             const response = (yield this.handleVariantAPIRes(data));
+            if ((_g = response === null || response === void 0 ? void 0 : response.entries) === null || _g === void 0 ? void 0 : _g.length) {
+                cli_utilities_1.log.debug(`Received ${(_h = response.entries) === null || _h === void 0 ? void 0 : _h.length} variant entries out of total ${response.count}`, (_j = this.exportConfig) === null || _j === void 0 ? void 0 : _j.context);
+            }
             if (callback) {
+                cli_utilities_1.log.debug('Executing callback with variant entries', (_k = this.exportConfig) === null || _k === void 0 ? void 0 : _k.context);
                 callback(response.entries);
             }
             else {
+                cli_utilities_1.log.debug('Adding variant entries to collection', (_l = this.exportConfig) === null || _l === void 0 ? void 0 : _l.context);
                 entries = entries.concat(response.entries);
             }
             if (getAllData && skip + limit < response.count) {
@@ -123,16 +144,20 @@ class VariantHttpClient extends adapter_helper_1.AdapterHelper {
                 const exeTime = end - start;
                 if (exeTime < 1000) {
                     // 1 API call per second
+                    cli_utilities_1.log.debug(`Rate limiting: waiting ${1000 - exeTime}ms before next request`, (_m = this.exportConfig) === null || _m === void 0 ? void 0 : _m.context);
                     yield this.delay(1000 - exeTime);
                 }
                 if (!options.skip) {
                     options['skip'] = 0;
                 }
                 options.skip += limit;
+                cli_utilities_1.log.debug(`Continuing to fetch variant entries with skip: ${options.skip}`, (_o = this.exportConfig) === null || _o === void 0 ? void 0 : _o.context);
                 return yield this.variantEntries(options, entries);
             }
-            if (returnResult)
+            if (returnResult) {
+                cli_utilities_1.log.debug('Returning variant entries result', (_p = this.exportConfig) === null || _p === void 0 ? void 0 : _p.context);
                 return { entries };
+            }
         });
     }
     /**
@@ -145,20 +170,31 @@ class VariantHttpClient extends adapter_helper_1.AdapterHelper {
      */
     createVariantEntry(input, options, apiParams) {
         return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b;
             const { reject, resolve, variantUid, log } = apiParams;
             const variantConfig = this.config.modules.variantEntry;
             const { locale = variantConfig.query.locale || 'en-us', variant_id, entry_uid, content_type_uid } = options;
+            log.debug(`Creating variant entry for content type: ${content_type_uid}, entry: ${entry_uid}, variant: ${variant_id}`, (_a = this.exportConfig) === null || _a === void 0 ? void 0 : _a.context);
             let endpoint = `content_types/${content_type_uid}/entries/${entry_uid}/variants/${variant_id}?locale=${locale}`;
             const query = this.constructQuery((0, omit_1.default)(variantConfig.query, ['locale']));
             if (query) {
                 endpoint = endpoint.concat(query);
             }
-            const onSuccess = (response) => resolve({ response, apiData: { variantUid, entryUid: entry_uid }, log });
-            const onReject = (error) => reject({
-                error,
-                apiData: { variantUid, entryUid: entry_uid },
-                log,
-            });
+            log.debug(`Making API call to: ${endpoint}`, (_b = this.exportConfig) === null || _b === void 0 ? void 0 : _b.context);
+            const onSuccess = (response) => {
+                var _a;
+                log.debug(`Variant entry created successfully: ${variantUid}`, (_a = this.exportConfig) === null || _a === void 0 ? void 0 : _a.context);
+                resolve({ response, apiData: { variantUid, entryUid: entry_uid }, log });
+            };
+            const onReject = (error) => {
+                var _a;
+                log.debug(`Failed to create variant entry: ${variantUid}`, (_a = this.exportConfig) === null || _a === void 0 ? void 0 : _a.context);
+                reject({
+                    error,
+                    apiData: { variantUid, entryUid: entry_uid },
+                    log,
+                });
+            };
             try {
                 this.apiClient.headers({ api_version: undefined });
                 const res = yield this.apiClient.put(endpoint, { entry: input });
@@ -185,15 +221,26 @@ class VariantHttpClient extends adapter_helper_1.AdapterHelper {
      */
     publishVariantEntry(input, options, apiParams) {
         return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b;
             const { reject, resolve, log, variantUid } = apiParams;
             const { entry_uid, content_type_uid } = options;
+            log.debug(`Publishing variant entry for content type: ${content_type_uid}, entry: ${entry_uid}`, (_a = this.exportConfig) === null || _a === void 0 ? void 0 : _a.context);
             let endpoint = `content_types/${content_type_uid}/entries/${entry_uid}/publish`;
-            const onSuccess = (response) => resolve({ response, apiData: { entryUid: entry_uid, variantUid, locales: input.entry.locales }, log });
-            const onReject = (error) => reject({
-                error,
-                apiData: { entryUid: entry_uid, variantUid, locales: input.entry.locales },
-                log,
-            });
+            log.debug(`Making API call to: ${endpoint}`, (_b = this.exportConfig) === null || _b === void 0 ? void 0 : _b.context);
+            const onSuccess = (response) => {
+                var _a;
+                log.debug(`Variant entry published successfully: ${entry_uid}`, (_a = this.exportConfig) === null || _a === void 0 ? void 0 : _a.context);
+                resolve({ response, apiData: { entryUid: entry_uid, variantUid, locales: input.entry.locales }, log });
+            };
+            const onReject = (error) => {
+                var _a;
+                log.debug(`Failed to publish variant entry: ${entry_uid}`, (_a = this.exportConfig) === null || _a === void 0 ? void 0 : _a.context);
+                reject({
+                    error,
+                    apiData: { entryUid: entry_uid, variantUid, locales: input.entry.locales },
+                    log,
+                });
+            };
             try {
                 this.apiClient.headers({ api_version: 3.2 });
                 const res = yield this.apiClient.post(endpoint, input);
@@ -218,15 +265,20 @@ class VariantHttpClient extends adapter_helper_1.AdapterHelper {
      */
     handleVariantAPIRes(res) {
         return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d;
             const { status, data } = res;
+            cli_utilities_1.log.debug(`API response status: ${status}`, (_a = this.exportConfig) === null || _a === void 0 ? void 0 : _a.context);
             if (status >= 200 && status < 300) {
+                cli_utilities_1.log.debug('API request successful', (_b = this.exportConfig) === null || _b === void 0 ? void 0 : _b.context);
                 return data;
             }
+            cli_utilities_1.log.debug(`API request failed with status: ${status}`, (_c = this.exportConfig) === null || _c === void 0 ? void 0 : _c.context);
             // Refresh the access token if the response status is 401
             yield cli_utilities_1.authenticationHandler.refreshAccessToken(res);
             const errorMsg = (data === null || data === void 0 ? void 0 : data.errors)
                 ? (0, error_helper_1.formatErrors)(data.errors)
                 : (data === null || data === void 0 ? void 0 : data.error_message) || (data === null || data === void 0 ? void 0 : data.message) || data;
+            cli_utilities_1.log.debug(`API error: ${errorMsg}`, (_d = this.exportConfig) === null || _d === void 0 ? void 0 : _d.context);
             throw errorMsg;
         });
     }
@@ -235,47 +287,69 @@ exports.VariantHttpClient = VariantHttpClient;
 class VariantManagementSDK extends adapter_helper_1.AdapterHelper {
     init() {
         return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b;
+            cli_utilities_1.log.debug('Initializing VariantManagementSDK...', (_a = this.exportConfig) === null || _a === void 0 ? void 0 : _a.context);
             this.apiClient = yield (0, cli_utilities_1.managementSDKClient)(this.config);
+            cli_utilities_1.log.debug('VariantManagementSDK initialized successfully', (_b = this.exportConfig) === null || _b === void 0 ? void 0 : _b.context);
         });
     }
     variantEntry(options) {
         return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            cli_utilities_1.log.debug('VariantEntry method called (SDK placeholder implementation)', (_a = this.exportConfig) === null || _a === void 0 ? void 0 : _a.context);
             // TODO SDK implementation
             return { entry: {} };
         });
     }
     variantEntries(options) {
         return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            cli_utilities_1.log.debug('VariantEntries method called (SDK placeholder implementation)', (_a = this.exportConfig) === null || _a === void 0 ? void 0 : _a.context);
             // TODO SDK implementation
             return { entries: [{}] };
         });
     }
     createVariantEntry(input, options, apiParams) {
+        var _a;
+        cli_utilities_1.log.debug('CreateVariantEntry method called (SDK placeholder implementation)', (_a = this.exportConfig) === null || _a === void 0 ? void 0 : _a.context);
         // FIXME placeholder
         return Promise.resolve({});
     }
     handleVariantAPIRes(res) {
         return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            cli_utilities_1.log.debug('HandleVariantAPIRes method called (SDK implementation)', (_a = this.exportConfig) === null || _a === void 0 ? void 0 : _a.context);
             return res.data;
         });
     }
-    constructQuery(query) { }
+    constructQuery(query) {
+        var _a;
+        cli_utilities_1.log.debug('ConstructQuery method called (SDK placeholder implementation)', (_a = this.exportConfig) === null || _a === void 0 ? void 0 : _a.context);
+    }
     delay(ms) {
-        return __awaiter(this, void 0, void 0, function* () { });
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            cli_utilities_1.log.debug(`Delay method called for ${ms}ms (SDK placeholder implementation)`, (_a = this.exportConfig) === null || _a === void 0 ? void 0 : _a.context);
+        });
     }
 }
 exports.VariantManagementSDK = VariantManagementSDK;
 class VariantAdapter {
     constructor(config, options) {
+        var _a, _b, _c, _d;
+        cli_utilities_1.log.debug('Initializing VariantAdapter...', (_a = this.exportConfig) === null || _a === void 0 ? void 0 : _a.context);
         if (config.httpClient) {
+            cli_utilities_1.log.debug('Using HTTP client variant instance', (_b = this.exportConfig) === null || _b === void 0 ? void 0 : _b.context);
             const { httpClient, Adapter } = config, restConfig = __rest(config, ["httpClient", "Adapter"]);
             this.variantInstance = new Adapter(restConfig, options);
         }
         else {
+            cli_utilities_1.log.debug('Using SDK variant instance', (_c = this.exportConfig) === null || _c === void 0 ? void 0 : _c.context);
             const { Adapter } = config, restConfig = __rest(config, ["Adapter"]);
             this.variantInstance = new Adapter(restConfig);
         }
         this.messages = messages_1.default;
+        cli_utilities_1.log.debug('VariantAdapter initialized successfully', (_d = this.exportConfig) === null || _d === void 0 ? void 0 : _d.context);
     }
 }
 exports.VariantAdapter = VariantAdapter;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentstack/cli-variants",
-  "version": "1.2.2",
+  "version": "1.3.2",
   "description": "Variants plugin",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -18,6 +18,7 @@
   "license": "MIT",
   "devDependencies": {
     "@contentstack/cli-dev-dependencies": "^1.3.0",
+    "@oclif/plugin-help": "^6.2.28",
     "@oclif/test": "^4.1.13",
     "@types/node": "^20.17.50",
     "mocha": "^10.8.2",
@@ -26,7 +27,9 @@
     "typescript": "^5.8.3"
   },
   "dependencies": {
-    "@contentstack/cli-utilities": "~1.12.0",
+    "@contentstack/cli-utilities": "~1.14.0",
+    "@oclif/core": "^4.3.0",
+    "@oclif/plugin-help": "^6.2.28",
     "lodash": "^4.17.21",
     "mkdirp": "^1.0.4",
     "winston": "^3.17.0"