ofsc-utility 1.0.41 → 1.0.44

package/CHANGELOG.md

@@ -0,0 +1,11 @@
+# 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
+- 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

@@ -78,7 +78,7 @@ const fetchWithRetry = async (url, clientId, clientSecret, instanceUrl, token, r
         res = await doFetch(token);
     }
     /* ---------- 429: retry with backoff ---------- */
-    if ((res.status === 429 || res.status === 400) && retries > 0) {
+    if ((res.status === 429 || res.status === 502 || res.status === 503 || res.status === 504) && retries > 0) {
         const retryAfter = res.headers.get("Retry-After");
         console.log("⚠️ 429 received. Retrying...", retryAfter);
         const delay = retryAfter ? Number(retryAfter) * 1000 : baseDelay;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ofsc-utility",
-  "version": "1.0.41",
+  "version": "1.0.44",
   "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

@@ -9,10 +9,29 @@ This package exposes grouped API helpers for common OFSC operations, including:
 - inventory and activity records
 - metadata file generation
 
+### Built-in resilience for OFSC's server errors
+
+OFSC's REST API sits behind Oracle's gateway infrastructure, which means calls can occasionally fail with transient errors that have nothing to do with your request — the gateway losing its connection to the backend, a brief service restart, or normal rate limiting under load. This package handles those cases automatically so your integration doesn't fail on a blip that would have succeeded a second later.
+
+### Exponential backoff
+
+Retries don't hammer the API at a fixed interval — each attempt waits longer than the last (starting at a small base delay and doubling each time), unless OFSC explicitly tells us how long to wait via Retry-After. This gives Oracle's backend room to recover instead of adding to the load that likely caused the error in the first place.
+
+### Why this matters for OFSC specifically
+
+OFSC's gateway is known to return 503s and connection resets during normal operation — not just outages — especially under sustained polling or bulk export workloads (events, activities, inventory).Handling these
+transparently means:
+
+- Scheduled jobs don't die on a single flaky response and require manual re-runs
+- Token expiry mid-session is handled without the caller needing to track token lifetimes
+- You get clear, real error messages (with the response body attached) for
+  genuine failures, instead of noisy retries on errors that were never going
+  to succeed
+
 ## Installation
 
 ```bash
-npm install ofsc-utility
+npm install ofsc-utility@latest
 ```
 
 ## Getting Started
@@ -452,6 +471,7 @@ Top-level exports include:
 - `getOAuthToken`
 - `downloadWorkZoneCSV`
 - `downloadAllResourcesCSV`
+- `getResource`
 - `downloadAllUsersCSV`
 - `downloadAllInactiveUsersCSV`
 - `generateAllOnHandInventoryOfAllResourcesCSV`