ofsc-utility 1.0.43 → 1.0.45

package/CHANGELOG.md

@@ -0,0 +1,12 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
+
+## [Unreleased]
+
+### Added
+- release v1.0.44 with getResource function and updated keywords
+- version 1.0.43 with built-in resilience and exponential backoff
+- Add -c flag to skip CHANGELOG updates and auto-update logic

package/dist/index.d.ts

@@ -13,7 +13,7 @@ export * from './types';
 export { generateAllOnHandInventoryOfAllResources, generateAllOnHandInventoryOfAllResourcesCSV } from './inventory';
 export { getOAuthToken } from './oauthTokenService';
 export { downloadWorkZoneCSV } from './workZones';
-export { AllResources, downloadAllResourcesCSV, getworkSkillsOfResource } from './resources';
+export { AllResources, downloadAllResourcesCSV, getResourcebyId, getworkSkillsOfResource } from './resources';
 export { downloadAllInactiveUsers, downloadAllInactiveUsersCSV, downloadAllUsersCSV, generateUsersCollaborationCSV } from './users';
 export { downloadAllInventoryTypesCSV, getInventoryTypesDetail, updateCreateInventoryType } from './inventoryTypes';
 export { getActivitybyId, getAllActivities } from './activities';
@@ -56,6 +56,7 @@ declare const OfscUtility: {
     getActivitybyId: any;
     AllResources: any;
     getworkSkillsOfResource: any;
+    getResource: any;
     createExcelFile: any;
 };
 export default OfscUtility;

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.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;
+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.getResourcebyId = 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"));
@@ -61,6 +61,7 @@ Object.defineProperty(exports, "downloadWorkZoneCSV", { enumerable: true, get: f
 var resources_1 = require("./resources");
 Object.defineProperty(exports, "AllResources", { enumerable: true, get: function () { return resources_1.AllResources; } });
 Object.defineProperty(exports, "downloadAllResourcesCSV", { enumerable: true, get: function () { return resources_1.downloadAllResourcesCSV; } });
+Object.defineProperty(exports, "getResourcebyId", { enumerable: true, get: function () { return resources_1.getResourcebyId; } });
 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; } });
@@ -122,6 +123,7 @@ const OfscUtility = {
     getActivitybyId: require('./activities').getActivitybyId,
     AllResources: require('./activities').AllResources,
     getworkSkillsOfResource: require('./resources').getworkSkillsOfResource,
+    getResource: require('./resources').getResourcebyId,
     createExcelFile: require('./utilities').createExcelFile
 };
 exports.default = OfscUtility;

package/dist/resources/index.d.ts

@@ -1,6 +1,8 @@
+import { ResourceResponse } from "../types";
 export declare function downloadAllResourcesCSV(clientId: string, clientSecret: string, instanceUrl: string): Promise<void>;
-export declare function AllResources(clientId: string, clientSecret: string, instanceUrl: string, initialToken?: string): Promise<any[]>;
+export declare function AllResources(clientId: string, clientSecret: string, instanceUrl: string, initialToken?: string): Promise<ResourceResponse[]>;
 export declare function getworkSkillsOfResource(clientId: string, clientSecret: string, instanceUrl: string, resourceId: number, token?: string): Promise<{
     token: string;
     data: any;
 }>;
+export declare function getResourcebyId(resourceId: string, clientId: string, clientSecret: string, instanceUrl: string, initialToken?: string): Promise<ResourceResponse>;

package/dist/resources/index.js

@@ -39,6 +39,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.downloadAllResourcesCSV = downloadAllResourcesCSV;
 exports.AllResources = AllResources;
 exports.getworkSkillsOfResource = getworkSkillsOfResource;
+exports.getResourcebyId = getResourcebyId;
 const fs = __importStar(require("fs"));
 const node_fetch_1 = __importDefault(require("node-fetch"));
 const index_1 = require("../oauthTokenService/index");
@@ -140,3 +141,11 @@ async function getworkSkillsOfResource(clientId, clientSecret, instanceUrl, reso
         data: response.data.items
     };
 }
+async function getResourcebyId(resourceId, clientId, clientSecret, instanceUrl, initialToken = "") {
+    const fetchResources = async (offset, token) => {
+        const url = `https://${instanceUrl}.fs.ocs.oraclecloud.com/rest/ofscCore/v1/resources/${encodeURIComponent(resourceId)}?offset=${offset}&limit=100`;
+        const res = await (0, utilities_1.fetchWithRetry)(url, clientId, clientSecret, instanceUrl, token);
+        return res.data;
+    };
+    return fetchResources(0, initialToken);
+}

package/dist/utilities/index.js

@@ -68,28 +68,35 @@ const fetchWithRetry = async (url, clientId, clientSecret, instanceUrl, token, r
             }
         });
     };
-    console.log(`➡️ Fetching ${url}`);
+    console.log(`Fetching ${url}`);
     // Try with the current token
     let res = await doFetch(token);
     /* ---------- 401: refresh token ONCE per call ---------- */
     if (res.status === 401) {
-        console.warn("⚠️ Token expired — renewing token…");
+        console.warn("Token expired — renewing token…");
         token = await (0, oauthTokenService_1.getOAuthToken)(clientId, clientSecret, instanceUrl);
         res = await doFetch(token);
     }
-    /* ---------- 429: retry with backoff ---------- */
-    if ((res.status === 429 || res.status === 502 || res.status === 503 || res.status === 504) && retries > 0) {
+    const responseText = await res.text();
+    const isNoRouteToHost = res.status === 400 &&
+        responseText.includes("NoRouteToHostException");
+    const isRetryableStatus = res.status === 429 ||
+        res.status === 502 ||
+        res.status === 503 ||
+        res.status === 504;
+    /* ---------- retry with backoff ---------- */
+    if ((isRetryableStatus || isNoRouteToHost) && retries > 0) {
         const retryAfter = res.headers.get("Retry-After");
-        console.log("⚠️ 429 received. Retrying...", retryAfter);
+        console.log("Retrying...", retryAfter);
         const delay = retryAfter ? Number(retryAfter) * 1000 : baseDelay;
-        console.warn(`⚠️ 429 received. Retrying in ${delay}ms... (${retries} left)`);
+        console.warn(`Retrying in ${delay}ms... (${retries} left)`);
         await new Promise(r => setTimeout(r, delay));
         return (0, exports.fetchWithRetry)(url, clientId, clientSecret, instanceUrl, token, retries - 1, baseDelay * 2);
     }
     // If still not OK → fail
     if (!res.ok) {
         const body = await res.text();
-        throw new Error(`❌ Request failed: ${res.status} ${res.statusText}\n${body}`);
+        throw new Error(`Request failed: ${res.status} ${res.statusText}\n${body}`);
     }
     // Return parsed JSON + latest token
     return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ofsc-utility",
-  "version": "1.0.43",
+  "version": "1.0.45",
   "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",
@@ -14,16 +14,21 @@
     "dev": "ts-node src/index.ts"
   },
   "keywords": [
-    "ofs",
     "oracle",
-    "Oracle Field Service",
-    "OFSC"
+    "oracle-field-service",
+    "oracle-field-service-cloud",
+    "ofsc",
+    "ofsc-plugin",
+    "field-service",
+    "oracle-ofsc",
+    "oracle-cloud"
   ],
   "author": "MOHD AHSHAN DANISH <https://www.linkedin.com/in/mohdahshandanish/>",
   "license": "MIT",
   "files": [
     "dist",
     "README.md",
+    "CHANGELOG.md",
     "LICENSE"
   ],
   "repository": {

package/readme.md

@@ -471,6 +471,7 @@ Top-level exports include:
 - `getOAuthToken`
 - `downloadWorkZoneCSV`
 - `downloadAllResourcesCSV`
+- `getResource`
 - `downloadAllUsersCSV`
 - `downloadAllInactiveUsersCSV`
 - `generateAllOnHandInventoryOfAllResourcesCSV`