ofsc-utility 1.0.31 → 1.0.33

package/dist/events/index.d.ts

@@ -56,4 +56,13 @@ export declare function generateHash(item: {
  * @returns
  */
 export declare function downloadAllEventsOfDLastTwoMinutes(clientId: string, clientSecret: string, instanceUrl: string, subscriptionId: string): Promise<any[]>;
+/**
+ *  Events of last one hour
+ * @param clientId
+ * @param clientSecret
+ * @param instanceUrl
+ * @param subscriptionId
+ * @returns
+ */
+export declare function downloadAllEventsOfLastOneHour(clientId: string, clientSecret: string, instanceUrl: string, subscriptionId: string): Promise<any[]>;
 export {};

package/dist/events/index.js

@@ -8,6 +8,7 @@ exports.downloadAllEventsOfDay = downloadAllEventsOfDay;
 exports.downloadAllEventsOfDayCSV = downloadAllEventsOfDayCSV;
 exports.generateHash = generateHash;
 exports.downloadAllEventsOfDLastTwoMinutes = downloadAllEventsOfDLastTwoMinutes;
+exports.downloadAllEventsOfLastOneHour = downloadAllEventsOfLastOneHour;
 const node_crypto_1 = __importDefault(require("node:crypto"));
 const path_1 = __importDefault(require("path"));
 const index_1 = require("../oauthTokenService/index");
@@ -363,3 +364,92 @@ async function downloadAllEventsOfDLastTwoMinutes(clientId, clientSecret, instan
     }
     return events;
 }
+/**
+ *  Events of last one hour
+ * @param clientId
+ * @param clientSecret
+ * @param instanceUrl
+ * @param subscriptionId
+ * @returns
+ */
+async function downloadAllEventsOfLastOneHour(clientId, clientSecret, instanceUrl, subscriptionId) {
+    /**
+     * Download events from the last ~180 seconds and return them as an
+     * array.
+     *
+     * Differences from `downloadAllEventsOfDayCSV`:
+     * - The `since` timestamp is computed using `getTimeBefore180SecondsAlt`.
+     * - Validates the generated timestamp with `validateDateTimeStrict`.
+     * - For each fetched item, this function attaches a `uniqueId` field
+     *   generated by `generateHash` (used for deduplication or tracing).
+     *
+     * Usage: lightweight polling helper to retrieve recent events for
+     * short-lived processing or monitoring.
+     *
+     * @param clientId - OAuth client id.
+     * @param clientSecret - OAuth client secret.
+     * @param instanceUrl - Instance host.
+     * @param subscriptionId - Subscription id for events.
+     * @returns Array of recent event objects.
+     */
+    // All collected events
+    const events = [];
+    const since = (0, utilities_1.getTimeBefore3600SecondsAlt)();
+    let isValidate = (0, index_2.validateDateTimeStrict)(since);
+    if (!isValidate.isValid) {
+        throw new Error(isValidate.error);
+    }
+    // Build initial request URL
+    const baseUrl = `https://${instanceUrl}.fs.ocs.oraclecloud.com/rest/ofscCore/v1/events`;
+    const initialUrl = `${baseUrl}?subscriptionId=${encodeURIComponent(subscriptionId)}&since=${encodeURIComponent(since)}`;
+    console.log("sinceDate", since);
+    let token = await (0, index_1.getOAuthToken)(clientId, clientSecret, instanceUrl);
+    // Get first page
+    let firstPage = await fetchEventsPage(initialUrl, token, clientId, clientSecret, instanceUrl);
+    token = firstPage.token;
+    let nextPage = firstPage.data.nextPage;
+    let found = firstPage.data.found;
+    // Controls infinite loop
+    let lastSeenPage = nextPage;
+    let repeatedPageCount = 0;
+    // Loop through pages
+    while (found && nextPage) {
+        const pageUrl = new URL(baseUrl);
+        pageUrl.search = new URLSearchParams({
+            subscriptionId,
+            page: nextPage,
+            limit: "1000",
+        }).toString();
+        const finalUrl = pageUrl.toString();
+        const result = await fetchEventsPage(finalUrl, token, clientId, clientSecret, instanceUrl);
+        token = result.token;
+        const page = result.data;
+        found = page.found;
+        nextPage = page.nextPage;
+        console.error("nextPage", nextPage, "Records:", page.items?.length, "Time:", page.items?.[0]?.time);
+        // Prevent infinite looping
+        if (nextPage === lastSeenPage) {
+            repeatedPageCount++;
+            if (repeatedPageCount > 15) {
+                console.warn("⚠️ Pagination repeating same page more than 15 times. Stopping.");
+                break;
+            }
+        }
+        else {
+            lastSeenPage = nextPage;
+            repeatedPageCount = 0;
+        }
+        // Add events
+        if (!page.items) {
+            console.warn("⚠️ No items found in page. Stopping.");
+            break;
+        }
+        for (let k of page.items) {
+            k["uniqueId"] = generateHash(k);
+            k["Change"] = k.activityChanges || k.inventoryChanges || k.requestChanges || k.userChanges || {};
+            k["Id"] = k.activityDetails?.activityId || k.resourceDetails?.resourceId || `${k.userDetails?.login}(${k.userDetails?.status})` || '-';
+            events.push(k);
+        }
+    }
+    return events;
+}

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 } from './events';
+export { downloadAllEventsOfDay, downloadAllEventsOfDayCSV, downloadAllEventsOfDLastTwoMinutes, downloadAllEventsOfLastOneHour } from './events';
 export { createExcelFile } from './utilities';
 export { createConfigurationFile } from './metadata';
 declare const OfscUtility: {
@@ -50,6 +50,7 @@ declare const OfscUtility: {
     };
     downloadAllEventsOfDayCSV: any;
     downloadAllEventsOfDay: any;
+    downloadAllEventsOfLastOneHour: any;
     generateUsersCollaborationCSV: any;
     generateAllOnHandInventoryOfAllResourcesCSV: any;
     getActivitybyId: any;

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.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,8 @@ 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; } });
 var metadata_1 = require("./metadata");
@@ -111,6 +114,7 @@ const OfscUtility = {
     },
     downloadAllEventsOfDayCSV: require('./events').downloadAllEventsOfDayCSV,
     downloadAllEventsOfDay: require('./events').downloadAllEventsOfDay,
+    downloadAllEventsOfLastOneHour: require('./events').downloadAllEventsOfLastOneHour,
     generateUsersCollaborationCSV: require('./users').generateUsersCollaborationCSV,
     generateAllOnHandInventoryOfAllResourcesCSV: require('./inventory').generateAllOnHandInventoryOfAllResourcesCSV,
     getActivitybyId: require('./activities').getActivitybyId,

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/dist/utilities/index.d.ts

@@ -29,4 +29,5 @@ interface ValidationResult {
  */
 export declare function validateDateTimeStrict(dateTimeStr: string): ValidationResult;
 export declare function getTimeBefore180SecondsAlt(): string;
+export declare function getTimeBefore3600SecondsAlt(): string;
 export {};

package/dist/utilities/index.js

@@ -42,6 +42,7 @@ exports.xmlNodeToObjects = xmlNodeToObjects;
 exports.createExcelFile = createExcelFile;
 exports.validateDateTimeStrict = validateDateTimeStrict;
 exports.getTimeBefore180SecondsAlt = getTimeBefore180SecondsAlt;
+exports.getTimeBefore3600SecondsAlt = getTimeBefore3600SecondsAlt;
 const XLSX = __importStar(require("xlsx-js-style"));
 const xmldom_1 = require("xmldom");
 const oauthTokenService_1 = require("../oauthTokenService");
@@ -310,3 +311,10 @@ function getTimeBefore180SecondsAlt() {
         .replace('T', ' ')
         .substring(0, 19);
 }
+function getTimeBefore3600SecondsAlt() {
+    const timeBefore = new Date(Date.now() - 3600000); // 3600 * 1000 = 3600000
+    // Convert to ISO string and format
+    return timeBefore.toISOString()
+        .replace('T', ' ')
+        .substring(0, 19);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ofsc-utility",
-  "version": "1.0.31",
+  "version": "1.0.33",
   "description": "A wrapper for Oracle Field Service REST API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

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`