ofsc-utility 1.0.39 → 1.0.41

package/dist/index.d.ts

@@ -14,7 +14,7 @@ export { generateAllOnHandInventoryOfAllResources, generateAllOnHandInventoryOfA
 export { getOAuthToken } from './oauthTokenService';
 export { downloadWorkZoneCSV } from './workZones';
 export { AllResources, downloadAllResourcesCSV, getworkSkillsOfResource } from './resources';
-export { downloadAllInactiveUsersCSV, downloadAllUsersCSV, generateUsersCollaborationCSV } from './users';
+export { downloadAllInactiveUsers, downloadAllInactiveUsersCSV, downloadAllUsersCSV, generateUsersCollaborationCSV } from './users';
 export { downloadAllInventoryTypesCSV, getInventoryTypesDetail, updateCreateInventoryType } from './inventoryTypes';
 export { getActivitybyId, getAllActivities } from './activities';
 export { createActivityCustomerInventories, getActivityCustomerInventories } from './activityInventories';

package/dist/index.js

@@ -36,7 +36,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createConfigurationFile = exports.createExcelFile = exports.downloadAllEventsOfLastOneHour = exports.downloadAllEventsOfDLastTwoMinutes = exports.downloadAllEventsOfDayCSV = exports.downloadAllEventsOfDay = exports.getActivityCustomerInventories = exports.createActivityCustomerInventories = exports.getAllActivities = exports.getActivitybyId = exports.updateCreateInventoryType = exports.getInventoryTypesDetail = exports.downloadAllInventoryTypesCSV = exports.generateUsersCollaborationCSV = exports.downloadAllUsersCSV = exports.downloadAllInactiveUsersCSV = exports.getworkSkillsOfResource = exports.downloadAllResourcesCSV = exports.AllResources = exports.downloadWorkZoneCSV = exports.getOAuthToken = exports.generateAllOnHandInventoryOfAllResourcesCSV = exports.generateAllOnHandInventoryOfAllResources = exports.WorkZone = exports.Utilities = exports.User = exports.Resource = exports.OauthTokenService = exports.CreateConfigurationFile = exports.InventoryType = exports.Inventory = exports.Events = exports.ActivityInventories = exports.Activity = void 0;
+exports.createConfigurationFile = exports.createExcelFile = exports.downloadAllEventsOfLastOneHour = exports.downloadAllEventsOfDLastTwoMinutes = exports.downloadAllEventsOfDayCSV = exports.downloadAllEventsOfDay = exports.getActivityCustomerInventories = exports.createActivityCustomerInventories = exports.getAllActivities = exports.getActivitybyId = exports.updateCreateInventoryType = exports.getInventoryTypesDetail = exports.downloadAllInventoryTypesCSV = exports.generateUsersCollaborationCSV = exports.downloadAllUsersCSV = exports.downloadAllInactiveUsersCSV = exports.downloadAllInactiveUsers = exports.getworkSkillsOfResource = exports.downloadAllResourcesCSV = exports.AllResources = exports.downloadWorkZoneCSV = exports.getOAuthToken = exports.generateAllOnHandInventoryOfAllResourcesCSV = exports.generateAllOnHandInventoryOfAllResources = exports.WorkZone = exports.Utilities = exports.User = exports.Resource = exports.OauthTokenService = exports.CreateConfigurationFile = exports.InventoryType = exports.Inventory = exports.Events = exports.ActivityInventories = exports.Activity = void 0;
 // Export all methods grouped by category
 exports.Activity = __importStar(require("./activities"));
 exports.ActivityInventories = __importStar(require("./activityInventories"));
@@ -63,6 +63,7 @@ Object.defineProperty(exports, "AllResources", { enumerable: true, get: function
 Object.defineProperty(exports, "downloadAllResourcesCSV", { enumerable: true, get: function () { return resources_1.downloadAllResourcesCSV; } });
 Object.defineProperty(exports, "getworkSkillsOfResource", { enumerable: true, get: function () { return resources_1.getworkSkillsOfResource; } });
 var users_1 = require("./users");
+Object.defineProperty(exports, "downloadAllInactiveUsers", { enumerable: true, get: function () { return users_1.downloadAllInactiveUsers; } });
 Object.defineProperty(exports, "downloadAllInactiveUsersCSV", { enumerable: true, get: function () { return users_1.downloadAllInactiveUsersCSV; } });
 Object.defineProperty(exports, "downloadAllUsersCSV", { enumerable: true, get: function () { return users_1.downloadAllUsersCSV; } });
 Object.defineProperty(exports, "generateUsersCollaborationCSV", { enumerable: true, get: function () { return users_1.generateUsersCollaborationCSV; } });

package/dist/oauthTokenService/index.d.ts

@@ -1 +1,13 @@
-export declare function getOAuthToken(clientId: string, clientSecret: string, instanceUrl: string): Promise<any>;
+interface OAuthTokenOptions {
+    /** Max retry attempts for transient (5xx) failures. Default: 2 */
+    maxRetries?: number;
+    /** Base delay in ms between retries (exponential backoff). Default: 1000 */
+    retryDelayMs?: number;
+    /** Request timeout in ms. Default: 10000 */
+    timeoutMs?: number;
+}
+/**
+ * Fetches an OAuth access token from OFSC.
+ */
+export declare function getOAuthToken(clientId: string, clientSecret: string, instanceUrl: string, options?: OAuthTokenOptions): Promise<string>;
+export {};

package/dist/oauthTokenService/index.js

@@ -1,30 +1,63 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getOAuthToken = getOAuthToken;
-async function getOAuthToken(clientId, clientSecret, instanceUrl) {
+/**
+ * Fetches an OAuth access token from OFSC.
+ */
+async function getOAuthToken(clientId, clientSecret, instanceUrl, options = {}) {
+    const { maxRetries = 3, retryDelayMs = 1000, timeoutMs = 10000 } = options;
     const url = `https://${instanceUrl}.fs.ocs.oraclecloud.com/rest/oauthTokenService/v2/token`;
     const credentials = btoa(`${clientId}@${instanceUrl}:${clientSecret}`);
     const headers = {
         'Content-Type': 'application/x-www-form-urlencoded',
-        'Authorization': `Basic ${credentials}`
+        'Authorization': `Basic ${credentials}`,
     };
-    const body = new URLSearchParams({
-        'grant_type': 'client_credentials'
-    });
-    try {
-        const response = await fetch(url, {
-            method: 'POST',
-            headers: headers,
-            body: body
-        });
-        if (!response.ok) {
-            throw new Error(`HTTP error! status: ${response.status}`);
+    const body = new URLSearchParams({ grant_type: 'client_credentials' });
+    let lastError;
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+        //AbortController is a built-in browser/Node API for cancelling async operations 
+        // controller.signal & controller.abort() are used to cancel the fetch request if it takes too long
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), timeoutMs);
+        try {
+            const response = await fetch(url, {
+                method: 'POST',
+                headers,
+                body,
+                signal: controller.signal,
+            });
+            clearTimeout(timeout);
+            if (response.ok) {
+                const data = (await response.json());
+                if (!data.access_token) {
+                    throw new Error('OAuth response did not contain an access_token');
+                }
+                return data.access_token;
+            }
+            // Retry only on server-side / transient errors
+            if (response.status >= 500 && response.status < 600 && attempt < maxRetries) {
+                lastError = new Error(`OAuth token request failed with status ${response.status}`);
+                await delay(retryDelayMs * 2 ** attempt);
+                continue;
+            }
+            // Non-retriable (4xx) or out of retries — fail fast
+            const bodyText = await response.text().catch(() => '');
+            throw new Error(`OAuth token request failed: ${response.status} ${response.statusText}${bodyText ? ` - ${bodyText}` : ''}`);
+        }
+        catch (error) {
+            clearTimeout(timeout);
+            lastError = error;
+            const isAbort = error instanceof Error && error.name === 'AbortError';
+            const isNetworkError = error instanceof TypeError;
+            if ((isAbort || isNetworkError) && attempt < maxRetries) {
+                await delay(retryDelayMs * 2 ** attempt);
+                continue;
+            }
+            throw new Error(`Failed to fetch OAuth token after ${attempt + 1} attempt(s): ${error instanceof Error ? error.message : String(error)}`);
         }
-        const data = await response.json();
-        return data.access_token;
-    }
-    catch (error) {
-        console.error('Error fetching OAuth token:', error);
-        throw error;
     }
+    throw lastError instanceof Error ? lastError : new Error('Failed to fetch OAuth token');
+}
+function delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
 }

package/dist/users/index.d.ts

@@ -4,6 +4,7 @@ declare const OfscUserUtility: {
     generateUsersCollaborationCSV: any;
     downloadAllUsersCSV: typeof downloadAllUsersCSV;
     downloadAllInactiveUsersCSV: typeof downloadAllInactiveUsersCSV;
+    downloadAllInactiveUsers: typeof downloadAllInactiveUsers;
 };
 export declare function downloadAllInactiveUsersCSV(clientId: string, clientSecret: string, instanceUrl: string, inactivityThresholdDays?: number): Promise<void>;
 export declare function downloadAllInactiveUsers(clientId: string, clientSecret: string, instanceUrl: string, inactivityThresholdDays?: number): Promise<Record<string, any>[]>;

package/dist/users/index.js

@@ -122,7 +122,8 @@ Object.defineProperty(exports, "generateUsersCollaborationCSV", { enumerable: tr
 const OfscUserUtility = {
     generateUsersCollaborationCSV: require('./collaborationGroups').generateUsersCollaborationCSV,
     downloadAllUsersCSV,
-    downloadAllInactiveUsersCSV
+    downloadAllInactiveUsersCSV,
+    downloadAllInactiveUsers
 };
 /**
  * Returns true if the user is "inactive":

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ofsc-utility",
-  "version": "1.0.39",
+  "version": "1.0.41",
   "description": "TypeScript helpers for Oracle Field Service Cloud (OFSC): events, resources, inventories, metadata and CSV/Excel utilities.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/readme.md

@@ -248,7 +248,7 @@ node scripts/test-download-inactive-users.js
 users whose last login is within the inactivity threshold, and returns the
 matching users as an array of plain objects. It does not create a CSV file.
 
-Unlike `downloadAllInactiveUsersCSV`, users with a blank(never loggedin)
+Unlike `downloadAllInactiveUsersCSV`, users with a blank or unparsable
 `lastLoginTime` are skipped. The threshold defaults to `14` days, and a user is
 included only when the time since the last login is strictly greater than the
 threshold.
@@ -301,6 +301,19 @@ downloadAllInactiveUsers(
 The helper retrieves users in pages of 100 records and requires valid OFSC API
 credentials.
 
+To run the repository test script against a built distribution:
+
+```bash
+npm run build
+export CLIENT_ID=yourClientId
+export CLIENT_SECRET=yourClientSecret
+export INSTANCE_URL=yourInstanceName
+export INACTIVITY_THRESHOLD_DAYS=14
+node scripts/test-download-inactive-users-data.js
+```
+
+`INACTIVITY_THRESHOLD_DAYS` is optional in the test script and defaults to `14`.
+
 ### Resource related methods
 
 ```js