@agility/management-sdk 0.1.3 → 0.1.4-beta.1

package/dist/apiMethods/batchMethods.js

@@ -9,12 +9,12 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 var __generator = (this && this.__generator) || function (thisArg, body) {
-    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
-    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
     function verb(n) { return function (v) { return step([n, v]); }; }
     function step(op) {
         if (f) throw new TypeError("Generator is already executing.");
-        while (_) try {
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
             if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
             if (y = 0, t) op = [op[0] & 2, t.value];
             switch (op[0]) {
@@ -43,23 +43,253 @@ var exception_1 = require("../models/exception");
 var BatchMethods = /** @class */ (function () {
     function BatchMethods(options) {
         this._options = options;
-        this._clientInstance = new clientInstance_1.ClientInstance();
+        this._clientInstance = new clientInstance_1.ClientInstance(this._options);
     }
-    BatchMethods.prototype.getBatch = function (batchID) {
-        return __awaiter(this, void 0, void 0, function () {
+    BatchMethods.prototype.getBatch = function (batchID_1, guid_1) {
+        return __awaiter(this, arguments, void 0, function (batchID, guid, expandItems) {
             var apiPath, resp, err_1;
+            if (expandItems === void 0) { expandItems = true; }
             return __generator(this, function (_a) {
                 switch (_a.label) {
                     case 0:
                         _a.trys.push([0, 2, , 3]);
-                        apiPath = "batch/" + batchID;
-                        return [4 /*yield*/, this._clientInstance.executeGet(apiPath, this._options)];
+                        apiPath = "batch/".concat(batchID, "?expandItems=").concat(expandItems);
+                        return [4 /*yield*/, this._clientInstance.executeGet(apiPath, guid, this._options.token)];
                     case 1:
                         resp = _a.sent();
                         return [2 /*return*/, resp.data];
                     case 2:
                         err_1 = _a.sent();
-                        throw new exception_1.Exception("Unable to retreive the batch for id: " + batchID, err_1);
+                        throw new exception_1.Exception("Unable to retrieve the batch for id: ".concat(batchID), err_1);
+                    case 3: return [2 /*return*/];
+                }
+            });
+        });
+    };
+    BatchMethods.prototype.publishBatch = function (batchID_1, guid_1) {
+        return __awaiter(this, arguments, void 0, function (batchID, guid, returnBatchId) {
+            var apiPath, resp, resultBatchID_1, err_2;
+            var _this = this;
+            if (returnBatchId === void 0) { returnBatchId = false; }
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        _a.trys.push([0, 3, , 4]);
+                        apiPath = "batch/".concat(batchID, "/publish");
+                        return [4 /*yield*/, this._clientInstance.executePost(apiPath, guid, this._options.token, null)];
+                    case 1:
+                        resp = _a.sent();
+                        resultBatchID_1 = resp.data;
+                        // If user wants batchID immediately, return it for custom polling
+                        if (returnBatchId) {
+                            return [2 /*return*/, resultBatchID_1];
+                        }
+                        // Default behavior: wait for completion and return batch ID
+                        return [4 /*yield*/, this.Retry(function () { return __awaiter(_this, void 0, void 0, function () { return __generator(this, function (_a) {
+                                switch (_a.label) {
+                                    case 0: return [4 /*yield*/, this.getBatch(resultBatchID_1, guid)];
+                                    case 1: return [2 /*return*/, _a.sent()];
+                                }
+                            }); }); })];
+                    case 2:
+                        // Default behavior: wait for completion and return batch ID
+                        _a.sent();
+                        return [2 /*return*/, resultBatchID_1];
+                    case 3:
+                        err_2 = _a.sent();
+                        throw new exception_1.Exception("Unable to publish the batch with id: ".concat(batchID), err_2);
+                    case 4: return [2 /*return*/];
+                }
+            });
+        });
+    };
+    BatchMethods.prototype.unpublishBatch = function (batchID_1, guid_1) {
+        return __awaiter(this, arguments, void 0, function (batchID, guid, returnBatchId) {
+            var apiPath, resp, resultBatchID_2, err_3;
+            var _this = this;
+            if (returnBatchId === void 0) { returnBatchId = false; }
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        _a.trys.push([0, 3, , 4]);
+                        apiPath = "batch/".concat(batchID, "/unpublish");
+                        return [4 /*yield*/, this._clientInstance.executePost(apiPath, guid, this._options.token, null)];
+                    case 1:
+                        resp = _a.sent();
+                        resultBatchID_2 = resp.data;
+                        // If user wants batchID immediately, return it for custom polling
+                        if (returnBatchId) {
+                            return [2 /*return*/, resultBatchID_2];
+                        }
+                        // Default behavior: wait for completion and return batch ID
+                        return [4 /*yield*/, this.Retry(function () { return __awaiter(_this, void 0, void 0, function () { return __generator(this, function (_a) {
+                                switch (_a.label) {
+                                    case 0: return [4 /*yield*/, this.getBatch(resultBatchID_2, guid)];
+                                    case 1: return [2 /*return*/, _a.sent()];
+                                }
+                            }); }); })];
+                    case 2:
+                        // Default behavior: wait for completion and return batch ID
+                        _a.sent();
+                        return [2 /*return*/, resultBatchID_2];
+                    case 3:
+                        err_3 = _a.sent();
+                        throw new exception_1.Exception("Unable to unpublish the batch with id: ".concat(batchID), err_3);
+                    case 4: return [2 /*return*/];
+                }
+            });
+        });
+    };
+    BatchMethods.prototype.approveBatch = function (batchID_1, guid_1) {
+        return __awaiter(this, arguments, void 0, function (batchID, guid, returnBatchId) {
+            var apiPath, resp, resultBatchID_3, err_4;
+            var _this = this;
+            if (returnBatchId === void 0) { returnBatchId = false; }
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        _a.trys.push([0, 3, , 4]);
+                        apiPath = "batch/".concat(batchID, "/approve");
+                        return [4 /*yield*/, this._clientInstance.executePost(apiPath, guid, this._options.token, null)];
+                    case 1:
+                        resp = _a.sent();
+                        resultBatchID_3 = resp.data;
+                        // If user wants batchID immediately, return it for custom polling
+                        if (returnBatchId) {
+                            return [2 /*return*/, resultBatchID_3];
+                        }
+                        // Default behavior: wait for completion and return batch ID
+                        return [4 /*yield*/, this.Retry(function () { return __awaiter(_this, void 0, void 0, function () { return __generator(this, function (_a) {
+                                switch (_a.label) {
+                                    case 0: return [4 /*yield*/, this.getBatch(resultBatchID_3, guid)];
+                                    case 1: return [2 /*return*/, _a.sent()];
+                                }
+                            }); }); })];
+                    case 2:
+                        // Default behavior: wait for completion and return batch ID
+                        _a.sent();
+                        return [2 /*return*/, resultBatchID_3];
+                    case 3:
+                        err_4 = _a.sent();
+                        throw new exception_1.Exception("Unable to approve the batch with id: ".concat(batchID), err_4);
+                    case 4: return [2 /*return*/];
+                }
+            });
+        });
+    };
+    BatchMethods.prototype.declineBatch = function (batchID_1, guid_1) {
+        return __awaiter(this, arguments, void 0, function (batchID, guid, returnBatchId) {
+            var apiPath, resp, resultBatchID_4, err_5;
+            var _this = this;
+            if (returnBatchId === void 0) { returnBatchId = false; }
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        _a.trys.push([0, 3, , 4]);
+                        apiPath = "batch/".concat(batchID, "/decline");
+                        return [4 /*yield*/, this._clientInstance.executePost(apiPath, guid, this._options.token, null)];
+                    case 1:
+                        resp = _a.sent();
+                        resultBatchID_4 = resp.data;
+                        // If user wants batchID immediately, return it for custom polling
+                        if (returnBatchId) {
+                            return [2 /*return*/, resultBatchID_4];
+                        }
+                        // Default behavior: wait for completion and return batch ID
+                        return [4 /*yield*/, this.Retry(function () { return __awaiter(_this, void 0, void 0, function () { return __generator(this, function (_a) {
+                                switch (_a.label) {
+                                    case 0: return [4 /*yield*/, this.getBatch(resultBatchID_4, guid)];
+                                    case 1: return [2 /*return*/, _a.sent()];
+                                }
+                            }); }); })];
+                    case 2:
+                        // Default behavior: wait for completion and return batch ID
+                        _a.sent();
+                        return [2 /*return*/, resultBatchID_4];
+                    case 3:
+                        err_5 = _a.sent();
+                        throw new exception_1.Exception("Unable to decline the batch with id: ".concat(batchID), err_5);
+                    case 4: return [2 /*return*/];
+                }
+            });
+        });
+    };
+    BatchMethods.prototype.requestApprovalBatch = function (batchID_1, guid_1) {
+        return __awaiter(this, arguments, void 0, function (batchID, guid, returnBatchId) {
+            var apiPath, resp, resultBatchID_5, err_6;
+            var _this = this;
+            if (returnBatchId === void 0) { returnBatchId = false; }
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        _a.trys.push([0, 3, , 4]);
+                        apiPath = "batch/".concat(batchID, "/request-approval");
+                        return [4 /*yield*/, this._clientInstance.executePost(apiPath, guid, this._options.token, null)];
+                    case 1:
+                        resp = _a.sent();
+                        resultBatchID_5 = resp.data;
+                        // If user wants batchID immediately, return it for custom polling
+                        if (returnBatchId) {
+                            return [2 /*return*/, resultBatchID_5];
+                        }
+                        // Default behavior: wait for completion and return batch ID
+                        return [4 /*yield*/, this.Retry(function () { return __awaiter(_this, void 0, void 0, function () { return __generator(this, function (_a) {
+                                switch (_a.label) {
+                                    case 0: return [4 /*yield*/, this.getBatch(resultBatchID_5, guid)];
+                                    case 1: return [2 /*return*/, _a.sent()];
+                                }
+                            }); }); })];
+                    case 2:
+                        // Default behavior: wait for completion and return batch ID
+                        _a.sent();
+                        return [2 /*return*/, resultBatchID_5];
+                    case 3:
+                        err_6 = _a.sent();
+                        throw new exception_1.Exception("Unable to request approval for the batch with id: ".concat(batchID), err_6);
+                    case 4: return [2 /*return*/];
+                }
+            });
+        });
+    };
+    /**
+     * Retrieves all batch-related enum types for developer discovery.
+     * This method provides all available enum values with their names,
+     * enabling dynamic UI population and client-side validation.
+     *
+     * @param guid - Current website guid
+     * @returns Promise containing all batch enum types
+     *
+     * @example
+     * ```typescript
+     * // Get all batch types for UI population
+     * const types = await client.batchMethods.getBatchTypes(guid);
+     *
+     * // Create dropdown options for item types
+     * const itemTypeOptions = types.itemTypes.map(type => ({
+     *   label: type.name,
+     *   value: type.value
+     * }));
+     *
+     * // Validate operation type
+     * const isValidOperation = (value: number) =>
+     *   types.workflowOperations.some(op => op.value === value);
+     * ```
+     */
+    BatchMethods.prototype.getBatchTypes = function (guid) {
+        return __awaiter(this, void 0, void 0, function () {
+            var apiPath, resp, err_7;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        _a.trys.push([0, 2, , 3]);
+                        apiPath = "batch/types";
+                        return [4 /*yield*/, this._clientInstance.executeGet(apiPath, guid, this._options.token)];
+                    case 1:
+                        resp = _a.sent();
+                        return [2 /*return*/, resp.data];
+                    case 2:
+                        err_7 = _a.sent();
+                        throw new exception_1.Exception("Unable to retrieve batch types", err_7);
                     case 3: return [2 /*return*/];
                 }
             });
@@ -67,7 +297,7 @@ var BatchMethods = /** @class */ (function () {
     };
     BatchMethods.prototype.Retry = function (method) {
         return __awaiter(this, void 0, void 0, function () {
-            var retryCount, duration, batch, err_2;
+            var retryCount, duration, batch, err_8;
             return __generator(this, function (_a) {
                 switch (_a.label) {
                     case 0:
@@ -97,7 +327,7 @@ var BatchMethods = /** @class */ (function () {
                         _a.label = 6;
                     case 6: return [3 /*break*/, 8];
                     case 7:
-                        err_2 = _a.sent();
+                        err_8 = _a.sent();
                         throw new Error('Timeout exceeded but operation still in progress. Please check the Batches page in the Agility Content Manager app.');
                     case 8: return [3 /*break*/, 1];
                     case 9: return [2 /*return*/];

package/dist/apiMethods/batchMethods.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"batchMethods.js","sourceRoot":"","sources":["../../src/apiMethods/batchMethods.ts"],"names":[],"mappings":";;;AACA,qDAAkD;AAElD,oDAAiD;AACjD,mDAAgD;AAEhD,MAAa,YAAY;IAIrB,YAAY,OAAgB;QACxB,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;QACxB,IAAI,CAAC,eAAe,GAAG,IAAI,+BAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC7D,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,OAAe,EAAE,IAAY;QACxC,IAAG,CAAC;YACA,IAAI,OAAO,GAAG,SAAS,OAAO,EAAE,CAAC;YACjC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;YAEvF,OAAO,IAAI,CAAC,IAAa,CAAC;QAC9B,CAAC;QAAC,OAAM,GAAG,EAAC,CAAC;YACT,MAAM,UAAU,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;YAC1D,MAAM,IAAI,qBAAS,CAAC,6BAA6B,EAAE,UAAU,CAAC,CAAC;QACnE,CAAC;IACL,CAAC;IAEC,KAAK,CAAC,KAAK,CAAC,MAAgB;QAC1B,IAAI,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,IAAI,GAAG,CAAC;QACjD,IAAI,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,IAAI,IAAI,CAAC;QAC9C,IAAG,UAAU,IAAI,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;QAC7D,OAAM,IAAI,EAAC,CAAC;YACR,IAAG,CAAC;gBACA,IAAI,KAAK,GAAG,MAAM,MAAM,EAAW,CAAC;gBACpC,IAAG,KAAK,CAAC,UAAU,KAAK,uBAAU,CAAC,SAAS;oBACzC,KAAK,CAAC,UAAU,KAAK,uBAAU,CAAC,OAAO;oBACvC,UAAU,IAAI,CAAC,EAAC,CAAC;oBAChB,OAAO,KAAK,CAAC;gBACjB,CAAC;qBACG,CAAC;oBACD,EAAE,UAAU,CAAC;oBACb,IAAG,UAAU,IAAI,CAAC,EAAC,CAAC;wBAChB,MAAM,IAAI,KAAK,CAAC,qHAAqH,CAAC,CAAC;oBAC3I,CAAC;oBACD,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;gBAC/B,CAAC;YACL,CAAC;YAAC,OAAM,GAAG,EAAC,CAAC;gBACT,MAAM,IAAI,KAAK,CAAC,qHAAqH,CAAC,CAAC;YAC3I,CAAC;QACL,CAAC;IACH,CAAC;IAEF,KAAK,CAAC,KAAK,CAAC,EAAU;QACnB,OAAO,IAAI,OAAO,CAAE,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAE,CAAC;IAC7D,CAAC;CACJ;AAlDD,oCAkDC"}

package/dist/apiMethods/clientInstance.d.ts

@@ -1,8 +1,62 @@
 import { AxiosInstance } from 'axios';
 import { Options } from "../models/options";
 export declare class ClientInstance {
-    getInstance(options: Options): AxiosInstance;
-    executeGet(apiPath: string, options: Options): Promise<import("axios").AxiosResponse<any, any>>;
-    executeDelete(apiPath: string, options: Options): Promise<import("axios").AxiosResponse<any, any>>;
-    executePost(apiPath: string, options: Options, data: any): Promise<import("axios").AxiosResponse<any, any>>;
+    _options: Options;
+    private _tokenRefreshHandler?;
+    constructor(options: Options);
+    /**
+     * Set token refresh handler for automatic token refresh on 401 errors
+     * @param handler - Function that returns a valid access token or null
+     */
+    setTokenRefreshHandler(handler: () => Promise<string | null>): void;
+    /**
+     * Handle token refresh on 401 errors
+     * @param error - The error from the API call
+     * @param retryCallback - Function to retry the original request
+     * @returns Promise with retry result or throws error
+     */
+    private handleTokenRefresh;
+    /**
+     * Figure out the Base Url, which can be overriden using options.baseUrl
+     *
+     * @param {string} guid
+     * @returns {string}
+     * @memberof ClientInstance
+     */
+    determineBaseUrl(guid: string): string;
+    /**
+     * Determine OAuth base URL based on region or custom baseUrl
+     * @param region - Optional region code (d, u, c, e, a) or use default
+     * @returns OAuth base URL
+     */
+    determineOAuthBaseUrl(region?: string): string;
+    getInstance(guid: string): AxiosInstance;
+    getAxiosInstance(guid: string): AxiosInstance;
+    /**
+     * Get Axios instance for OAuth endpoints
+     * @param region - Optional region code for OAuth endpoints
+     * @returns Axios instance configured for OAuth endpoints
+     */
+    getOAuthInstance(region?: string): AxiosInstance;
+    executeServerGet(apiPath: string, guid: string, token: string): Promise<any>;
+    executeGet(apiPath: string, guid: string, token: string): Promise<any>;
+    executeDelete(apiPath: string, guid: string, token: string, data?: any): Promise<any>;
+    executePost(apiPath: string, guid: string, token: string, data: any): Promise<any>;
+    /**
+     * Execute OAuth GET request
+     * @param apiPath - API path relative to /oauth
+     * @param region - Optional region code
+     * @param token - Optional bearer token for authenticated requests
+     * @returns Promise with response
+     */
+    executeOAuthGet(apiPath: string, region?: string, token?: string): Promise<import("axios").AxiosResponse<any, any>>;
+    /**
+     * Execute OAuth POST request
+     * @param apiPath - API path relative to /oauth
+     * @param data - Request body data
+     * @param region - Optional region code
+     * @param token - Optional bearer token for authenticated requests
+     * @returns Promise with response
+     */
+    executeOAuthPost(apiPath: string, data: any, region?: string, token?: string): Promise<import("axios").AxiosResponse<any, any>>;
 }