ofsc-utility 1.0.32 → 1.0.34

package/dist/index.d.ts

@@ -10,7 +10,7 @@ export * as User from './users';
 export * as Utilities from './utilities';
 export * as WorkZone from './workZones';
 export * from './types';
-export { generateAllOnHandInventoryOfAllResourcesCSV } from './inventory';
+export { generateAllOnHandInventoryOfAllResources, generateAllOnHandInventoryOfAllResourcesCSV } from './inventory';
 export { getOAuthToken } from './oauthTokenService';
 export { downloadWorkZoneCSV } from './workZones';
 export { AllResources, downloadAllResourcesCSV, getworkSkillsOfResource } from './resources';
@@ -18,7 +18,7 @@ export { downloadAllUsersCSV, generateUsersCollaborationCSV } from './users';
 export { downloadAllInventoryTypesCSV, getInventoryTypesDetail, updateCreateInventoryType } from './inventoryTypes';
 export { getActivitybyId, getAllActivities } from './activities';
 export { createActivityCustomerInventories, getActivityCustomerInventories } from './activityInventories';
-export { downloadAllEventsOfDay, downloadAllEventsOfDayCSV, downloadAllEventsOfLastOneHour } from './events';
+export { downloadAllEventsOfDay, downloadAllEventsOfDayCSV, downloadAllEventsOfDLastTwoMinutes, downloadAllEventsOfLastOneHour } from './events';
 export { createExcelFile } from './utilities';
 export { createConfigurationFile } from './metadata';
 declare const 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.downloadAllEventsOfDayCSV = exports.downloadAllEventsOfDay = exports.getActivityCustomerInventories = exports.createActivityCustomerInventories = exports.getAllActivities = exports.getActivitybyId = exports.updateCreateInventoryType = exports.getInventoryTypesDetail = exports.downloadAllInventoryTypesCSV = exports.generateUsersCollaborationCSV = exports.downloadAllUsersCSV = exports.getworkSkillsOfResource = exports.downloadAllResourcesCSV = exports.AllResources = exports.downloadWorkZoneCSV = exports.getOAuthToken = exports.generateAllOnHandInventoryOfAllResourcesCSV = 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.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"));
@@ -52,6 +52,7 @@ exports.WorkZone = __importStar(require("./workZones"));
 // Export types
 __exportStar(require("./types"), exports);
 var inventory_1 = require("./inventory");
+Object.defineProperty(exports, "generateAllOnHandInventoryOfAllResources", { enumerable: true, get: function () { return inventory_1.generateAllOnHandInventoryOfAllResources; } });
 Object.defineProperty(exports, "generateAllOnHandInventoryOfAllResourcesCSV", { enumerable: true, get: function () { return inventory_1.generateAllOnHandInventoryOfAllResourcesCSV; } });
 var oauthTokenService_1 = require("./oauthTokenService");
 Object.defineProperty(exports, "getOAuthToken", { enumerable: true, get: function () { return oauthTokenService_1.getOAuthToken; } });
@@ -77,6 +78,7 @@ Object.defineProperty(exports, "getActivityCustomerInventories", { enumerable: t
 var events_1 = require("./events");
 Object.defineProperty(exports, "downloadAllEventsOfDay", { enumerable: true, get: function () { return events_1.downloadAllEventsOfDay; } });
 Object.defineProperty(exports, "downloadAllEventsOfDayCSV", { enumerable: true, get: function () { return events_1.downloadAllEventsOfDayCSV; } });
+Object.defineProperty(exports, "downloadAllEventsOfDLastTwoMinutes", { enumerable: true, get: function () { return events_1.downloadAllEventsOfDLastTwoMinutes; } });
 Object.defineProperty(exports, "downloadAllEventsOfLastOneHour", { enumerable: true, get: function () { return events_1.downloadAllEventsOfLastOneHour; } });
 var utilities_1 = require("./utilities");
 Object.defineProperty(exports, "createExcelFile", { enumerable: true, get: function () { return utilities_1.createExcelFile; } });

package/dist/inventory/index.d.ts

@@ -1 +1,5 @@
 export declare function generateAllOnHandInventoryOfAllResourcesCSV(clientId: string, clientSecret: string, instanceUrl: string): Promise<void>;
+export declare function generateAllOnHandInventoryOfAllResources(clientId: string, clientSecret: string, instanceUrl: string): Promise<{
+    data: any[];
+    props: string[];
+}>;

package/dist/inventory/index.js

@@ -4,6 +4,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.generateAllOnHandInventoryOfAllResourcesCSV = generateAllOnHandInventoryOfAllResourcesCSV;
+exports.generateAllOnHandInventoryOfAllResources = generateAllOnHandInventoryOfAllResources;
 const path_1 = __importDefault(require("path"));
 const utilities_1 = require("../utilities");
 async function generateAllOnHandInventoryOfAllResourcesCSV(clientId, clientSecret, instanceUrl) {
@@ -77,3 +78,79 @@ async function generateAllOnHandInventoryOfAllResourcesCSV(clientId, clientSecre
     (0, utilities_1.saveCsv)(rows, filename);
     console.log(`📁 CSV saved: ${fullPath}`);
 }
+async function generateAllOnHandInventoryOfAllResources(clientId, clientSecret, instanceUrl) {
+    let offset = 0;
+    const limit = 100;
+    const allResources = [];
+    let token = "";
+    console.log("🚀 Starting all Resources Inventories export...");
+    console.log("--------------------------------------------------");
+    while (true) {
+        const resourcesUrl = `https://${instanceUrl}.fs.ocs.oraclecloud.com/rest/ofscCore/v1/resources/?offset=${offset}&limit=${limit}`;
+        console.log(`➡️ Fetching resources offset=${offset}`);
+        const res = await (0, utilities_1.fetchWithRetry)(resourcesUrl, clientId, clientSecret, instanceUrl, token);
+        token = res.token;
+        const data = res.data;
+        if (!data?.items?.length) {
+            console.warn("⚠ No resource items returned. Breaking.");
+            break;
+        }
+        allResources.push(...data.items);
+        console.log(`   ✔ Received ${data.items.length} resources (Total: ${allResources.length})`);
+        if (offset + limit >= data.totalResults)
+            break;
+        offset += limit;
+    }
+    console.log("--------------------------------------------------");
+    console.log(`Total resources to process: ${allResources.length}`);
+    console.log("--------------------------------------------------");
+    // 2. Fetch on hand inventories for each resource
+    const rows = [];
+    for (const [index, resource] of allResources.entries()) {
+        console.log(`${index} 👤 Fetching Inventories for ${resource.resourceId}`);
+        if (resource.status !== "active") {
+            console.log(`   ⚠ Skipping inactive resource ${resource.resourceId}`);
+            continue;
+        }
+        offset = 0;
+        while (true) {
+            const invUrl = `https://${instanceUrl}.fs.ocs.oraclecloud.com/rest/ofscCore/v1/resources/${encodeURIComponent(resource.resourceId)}/inventories/?offset=${offset}&limit=${limit}`;
+            try {
+                const res = await (0, utilities_1.fetchWithRetry)(invUrl, clientId, clientSecret, instanceUrl, token);
+                token = res.token;
+                const itemsData = res.data;
+                const items = itemsData?.items ?? [];
+                if (!items || items.length === 0) {
+                    console.log(`   ⚠ No Inventories found for ${resource.resourceId}`);
+                    break;
+                }
+                for (const inv of items) {
+                    delete inv.links;
+                    delete inv.status;
+                    rows.push({ resourceName: resource.name, resourceType: resource.resourceType, resourceTimeZone: resource.timeZoneIANA, ...inv, });
+                }
+                console.log(`   ✔ Found ${items.length} Inventories`);
+                if (offset + limit >= itemsData.totalResults)
+                    break;
+                offset += limit;
+            }
+            catch (err) {
+                console.error(`❌ Error fetching Inventories for ${resource.resourceId}:`, err);
+                console.log(`   ⚠ Skipping invUrl ${invUrl}`);
+            }
+        }
+    }
+    console.log("--------------------------------------------------");
+    console.log(`Total rows: ${rows.length}`);
+    console.log("--------------------------------------------------");
+    const props = [...rows.reduce((set, row) => {
+            if (row && typeof row === "object") {
+                Object.keys(row).forEach((key) => set.add(key));
+            }
+            return set;
+        }, new Set())];
+    return {
+        data: rows,
+        props,
+    };
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "ofsc-utility",
-  "version": "1.0.32",
-  "description": "A wrapper for Oracle Field Service REST API",
+  "version": "1.0.34",
+  "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",
   "scripts": {
@@ -16,9 +16,10 @@
   "keywords": [
     "ofs",
     "oracle",
-    "getOAuthToken"
+    "Oracle Field Service",
+    "OFSC"
   ],
-  "author": "MOHD AHSHAN DANISH <mailtodanish@gmail.com>",
+  "author": "MOHD AHSHAN DANISH <https://www.linkedin.com/in/mohdahshandanish/>",
   "license": "MIT",
   "files": [
     "dist",
@@ -27,8 +28,12 @@
   ],
   "repository": {
     "type": "git",
-    "url": "https://github.com/mailtodanish/ofsc-utility"
+    "url": "git+https://github.com/mailtodanish/ofsc-utility.git"
   },
+  "bugs": {
+    "url": "https://github.com/mailtodanish/ofsc-utility/issues"
+  },
+  "homepage": "https://github.com/mailtodanish/ofsc-utility#readme",
   "devDependencies": {
     "@rollup/plugin-commonjs": "^29.0.0",
     "@rollup/plugin-node-resolve": "^16.0.3",

package/readme.md

@@ -144,6 +144,52 @@ await ofs.downloadAllUsersCSV(
 );
 ```
 
+### Resource related methods
+
+```js
+await ofs.generateAllOnHandInventoryOfAllResourcesCSV(
+  process.env.CLIENT_ID,
+  process.env.CLIENT_SECRET,
+  process.env.INSTANCE_NAME,
+);
+```
+
+This helper fetches all active resources and writes their on-hand inventory rows to a CSV file.
+
+```js
+const inventoryResult = await ofs.generateAllOnHandInventoryOfAllResources(
+  process.env.CLIENT_ID,
+  process.env.CLIENT_SECRET,
+  process.env.INSTANCE_NAME,
+);
+
+console.log(`Loaded ${inventoryResult.data.length} inventory rows`);
+console.log("Available table columns:", inventoryResult.props);
+```
+
+This method fetches active resources and returns an object containing:
+
+- `data`: an array of inventory row objects
+- `props`: an array of unique keys found across all row objects
+
+The `props` array can be used as your dynamic table columns. For example:
+
+```js
+const columns = inventoryResult.props;
+const rows = inventoryResult.data;
+
+columns.forEach((col) => {
+  console.log(`Column: ${col}`);
+});
+
+rows.forEach((row) => {
+  const cells = columns.map((col) => row[col]);
+  console.log(cells);
+});
+```
+
+This gives you a dynamic table definition based on the actual inventory row fields returned by OFSC.
+
 ### Activity and inventory helpers
 
 ```js
@@ -237,6 +283,8 @@ Top-level exports include:
 - `downloadWorkZoneCSV`
 - `downloadAllResourcesCSV`
 - `downloadAllUsersCSV`
+- `generateAllOnHandInventoryOfAllResourcesCSV`
+- `generateAllOnHandInventoryOfAllResources`
 - `downloadAllInventoryTypesCSV`
 - `getInventoryTypesDetail`
 - `updateCreateInventoryType`