ofsc-utility 1.0.9 → 1.0.11

package/dist/activityInventories/index.js

@@ -63,8 +63,9 @@ async function createActivityCustomerInventories(clientId, clientSecret, instanc
         },
         body: JSON.stringify(payload)
     });
-    if (!res.ok) {
-        throw new Error(`❌ POST failed: ${res.status} ${res.statusText}`);
-    }
+    // if (!res.ok) {
+    //     return await res.json();
+    //     throw new Error(`❌ POST failed: ${res.status} ${res.statusText}`);
+    // }
     return await res.json();
 }

package/dist/events/index.d.ts

@@ -0,0 +1,7 @@
+type AnyObject = {
+    [key: string]: any;
+};
+export declare function flattenObject(obj: AnyObject, parentKey?: string, result?: AnyObject): AnyObject;
+export declare function downloadAllEventsOfDay(clientId: string, clientSecret: string, instanceUrl: string, subscriptionId: string, sinceDate: string, onlyData: boolean): Promise<any[]>;
+export declare function downloadAllEventsOfDayCSV(clientId: string, clientSecret: string, instanceUrl: string, subscriptionId: string, sinceDate: string, onlyData: boolean): Promise<any[]>;
+export {};

package/dist/events/index.js

@@ -0,0 +1,114 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.flattenObject = flattenObject;
+exports.downloadAllEventsOfDay = downloadAllEventsOfDay;
+exports.downloadAllEventsOfDayCSV = downloadAllEventsOfDayCSV;
+const path_1 = __importDefault(require("path"));
+const index_1 = require("../oauthTokenService/index");
+const utilities_1 = require("../utilities");
+function flattenObject(obj, parentKey = "", result = {}) {
+    for (const key in obj) {
+        const newKey = parentKey ? `${parentKey}_${key}` : key;
+        if (typeof obj[key] === "object" &&
+            obj[key] !== null &&
+            !Array.isArray(obj[key])) {
+            flattenObject(obj[key], newKey, result);
+        }
+        else {
+            result[newKey] = obj[key];
+        }
+    }
+    return result;
+}
+async function fetchEventsPage(url, token, clientId, clientSecret, instanceUrl) {
+    const res = await (0, utilities_1.fetchWithRetry)(url, clientId, clientSecret, instanceUrl, token);
+    return {
+        token: res.token,
+        data: res.data
+    };
+}
+function processEventItems(items, sinceDate, output) {
+    for (const item of items) {
+        const eventTime = item.time;
+        // Stop if date changes
+        if (!eventTime.startsWith(sinceDate)) {
+            console.log("Stopping at different event date:", eventTime);
+            return false;
+        }
+        // Add activityId as first level field
+        const activityId = item.activityDetails?.activityId ?? null;
+        output.push({ activityId, ...item });
+    }
+    return true;
+}
+async function downloadAllEventsOfDay(clientId, clientSecret, instanceUrl, subscriptionId, sinceDate, onlyData) {
+    console.log("Downloading events...OnlyData:", onlyData);
+    let data = await downloadAllEventsOfDayCSV(clientId, clientSecret, instanceUrl, subscriptionId, sinceDate, onlyData);
+    return data;
+}
+async function downloadAllEventsOfDayCSV(clientId, clientSecret, instanceUrl, subscriptionId, sinceDate, onlyData) {
+    // All collected events
+    const events = [];
+    // Build initial request URL
+    const baseUrl = `https://${instanceUrl}.fs.ocs.oraclecloud.com/rest/ofscCore/v1/events`;
+    const initialUrl = `${baseUrl}?subscriptionId=${encodeURIComponent(subscriptionId)}&since=${encodeURIComponent(sinceDate + " 00:00:00")}`;
+    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 > 10) {
+                console.warn("⚠️ Pagination repeating same page more than 10 times. Stopping.");
+                break;
+            }
+        }
+        else {
+            lastSeenPage = nextPage;
+            repeatedPageCount = 0;
+        }
+        // Add events
+        if (page.items) {
+            if (!processEventItems(page.items, sinceDate, events)) {
+                break;
+            }
+        }
+        else {
+            console.warn("⚠️ No items found in page. Stopping.");
+            break;
+        }
+    }
+    // Save CSV
+    const ts = Math.floor(Date.now() / 1000);
+    const filename = `events-${sinceDate}_${ts}.csv`;
+    const fullPath = path_1.default.resolve(filename);
+    if (!onlyData) {
+        (0, utilities_1.saveCsv)(events, fullPath);
+        console.log(`✅ Saved ${events.length} events to: ${fullPath}`);
+    }
+    return events;
+}

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 export * as Activity from './activities';
 export * as ActivityInventories from './activityInventories';
+export * as Events from './events';
 export * as InventoryType from './inventoryTypes';
 export * as OauthTokenService from './oauthTokenService';
 export * as Resource from './resources';
@@ -10,10 +11,11 @@ export * from './types';
 export { getOAuthToken } from './oauthTokenService';
 export { downloadWorkZoneCSV } from './workZones';
 export { downloadAllResourcesCSV } from './resources';
-export { downloadAllUsersCSV } from './users';
+export { downloadAllUsersCSV, generateUsersCollaborationCSV } from './users';
 export { downloadAllInventoryTypesCSV, getInventoryTypesDetail, updateCreateInventoryType } from './inventoryTypes';
 export { getAllActivities } from './activities';
 export { createActivityCustomerInventories, getActivityCustomerInventories } from './activityInventories';
+export { downloadAllEventsOfDay, downloadAllEventsOfDayCSV } from './events';
 declare const OfscUtility: {
     getOAuthToken: any;
     downloadWorkZoneCSV: any;
@@ -25,5 +27,8 @@ declare const OfscUtility: {
     getAllActivities: any;
     getActivityCustomerInventories: any;
     createActivityCustomerInventories: any;
+    downloadAllEventsOfDayCSV: any;
+    downloadAllEventsOfDay: any;
+    generateUsersCollaborationCSV: any;
 };
 export default OfscUtility;

package/dist/index.js

@@ -36,10 +36,11 @@ 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.getActivityCustomerInventories = exports.createActivityCustomerInventories = exports.getAllActivities = exports.updateCreateInventoryType = exports.getInventoryTypesDetail = exports.downloadAllInventoryTypesCSV = exports.downloadAllUsersCSV = exports.downloadAllResourcesCSV = exports.downloadWorkZoneCSV = exports.getOAuthToken = exports.WorkZone = exports.CSV = exports.User = exports.Resource = exports.OauthTokenService = exports.InventoryType = exports.ActivityInventories = exports.Activity = void 0;
+exports.downloadAllEventsOfDayCSV = exports.downloadAllEventsOfDay = exports.getActivityCustomerInventories = exports.createActivityCustomerInventories = exports.getAllActivities = exports.updateCreateInventoryType = exports.getInventoryTypesDetail = exports.downloadAllInventoryTypesCSV = exports.generateUsersCollaborationCSV = exports.downloadAllUsersCSV = exports.downloadAllResourcesCSV = exports.downloadWorkZoneCSV = exports.getOAuthToken = exports.WorkZone = exports.CSV = exports.User = exports.Resource = exports.OauthTokenService = exports.InventoryType = exports.Events = exports.ActivityInventories = exports.Activity = void 0;
 // Export all methods grouped by category
 exports.Activity = __importStar(require("./activities"));
 exports.ActivityInventories = __importStar(require("./activityInventories"));
+exports.Events = __importStar(require("./events"));
 exports.InventoryType = __importStar(require("./inventoryTypes"));
 exports.OauthTokenService = __importStar(require("./oauthTokenService"));
 exports.Resource = __importStar(require("./resources"));
@@ -57,6 +58,7 @@ var resources_1 = require("./resources");
 Object.defineProperty(exports, "downloadAllResourcesCSV", { enumerable: true, get: function () { return resources_1.downloadAllResourcesCSV; } });
 var users_1 = require("./users");
 Object.defineProperty(exports, "downloadAllUsersCSV", { enumerable: true, get: function () { return users_1.downloadAllUsersCSV; } });
+Object.defineProperty(exports, "generateUsersCollaborationCSV", { enumerable: true, get: function () { return users_1.generateUsersCollaborationCSV; } });
 var inventoryTypes_1 = require("./inventoryTypes");
 Object.defineProperty(exports, "downloadAllInventoryTypesCSV", { enumerable: true, get: function () { return inventoryTypes_1.downloadAllInventoryTypesCSV; } });
 Object.defineProperty(exports, "getInventoryTypesDetail", { enumerable: true, get: function () { return inventoryTypes_1.getInventoryTypesDetail; } });
@@ -66,6 +68,9 @@ Object.defineProperty(exports, "getAllActivities", { enumerable: true, get: func
 var activityInventories_1 = require("./activityInventories");
 Object.defineProperty(exports, "createActivityCustomerInventories", { enumerable: true, get: function () { return activityInventories_1.createActivityCustomerInventories; } });
 Object.defineProperty(exports, "getActivityCustomerInventories", { enumerable: true, get: function () { return activityInventories_1.getActivityCustomerInventories; } });
+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; } });
 // Default export with all functionality
 const OfscUtility = {
     getOAuthToken: require('./oauthTokenService').getOAuthToken,
@@ -77,6 +82,9 @@ const OfscUtility = {
     updateInventoryType: require('./inventoryTypes').updateInventoryType,
     getAllActivities: require('./activities').getAllActivities,
     getActivityCustomerInventories: require('./activityInventories').getActivityCustomerInventories,
-    createActivityCustomerInventories: require('./activityInventories').createActivityCustomerInventories
+    createActivityCustomerInventories: require('./activityInventories').createActivityCustomerInventories,
+    downloadAllEventsOfDayCSV: require('./events').downloadAllEventsOfDayCSV,
+    downloadAllEventsOfDay: require('./events').downloadAllEventsOfDay,
+    generateUsersCollaborationCSV: require('./users').generateUsersCollaborationCSV
 };
 exports.default = OfscUtility;

package/dist/types.d.ts

@@ -39,3 +39,8 @@ export interface InventoryTypePayload {
     quantityPrecision: number;
     translations: InventoryTranslation[];
 }
+export interface EventResponse {
+    found?: boolean;
+    nextPage?: string;
+    items?: any[];
+}

package/dist/users/collaborationGroups.d.ts

@@ -0,0 +1 @@
+export declare function generateUsersCollaborationCSV(clientId: string, clientSecret: string, instanceUrl: string): Promise<void>;

package/dist/users/collaborationGroups.js

@@ -0,0 +1,70 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateUsersCollaborationCSV = generateUsersCollaborationCSV;
+const path_1 = __importDefault(require("path"));
+const utilities_1 = require("../utilities");
+async function generateUsersCollaborationCSV(clientId, clientSecret, instanceUrl) {
+    let offset = 0;
+    const limit = 100;
+    const allUsers = [];
+    let token = "";
+    console.log("🚀 Starting Users Collaboration Groups export...");
+    console.log("--------------------------------------------------");
+    while (true) {
+        const usersUrl = `https://${instanceUrl}.fs.ocs.oraclecloud.com/rest/ofscCore/v1/users/?offset=${offset}&limit=${limit}`;
+        console.log(`➡️ Fetching users offset=${offset}`);
+        const res = await (0, utilities_1.fetchWithRetry)(usersUrl, clientId, clientSecret, instanceUrl, token);
+        token = res.token;
+        const data = res.data;
+        if (!data?.items?.length) {
+            console.warn("⚠ No user items returned. Breaking.");
+            break;
+        }
+        allUsers.push(...data.items);
+        console.log(`   ✔ Received ${data.items.length} users (Total: ${allUsers.length})`);
+        if (offset + limit >= data.totalResults)
+            break;
+        offset += limit;
+    }
+    console.log("--------------------------------------------------");
+    console.log(`🧩 Total users to process: ${allUsers.length}`);
+    console.log("--------------------------------------------------");
+    // 2. Fetch collaboration groups for each user
+    const rows = [];
+    for (const user of allUsers) {
+        console.log(`👤 Fetching groups for ${user.login}`);
+        if (user.status !== "active") {
+            console.log(`   ⚠ Skipping inactive user ${user.login}`);
+            continue;
+        }
+        try {
+            const groupUrl = `https://${instanceUrl}.fs.ocs.oraclecloud.com/rest/ofscCore/v1/users/${user.login}/collaborationGroups`;
+            const res = await (0, utilities_1.fetchWithRetry)(groupUrl, clientId, clientSecret, instanceUrl, token);
+            token = res.token;
+            const groupData = res.data;
+            const groups = groupData?.items ?? [];
+            if (groups.length === 0) {
+                console.log(`   ⚠ No groups found for ${user.login}`);
+                continue;
+            }
+            for (const group of groups) {
+                rows.push({ ...group, login: user.login, userType: user.userType, timeZoneIANA: user.timeZoneIANA, userName: user.name });
+            }
+            console.log(`   ✔ Found ${groups.length} groups`);
+        }
+        catch (err) {
+            console.error(`❌ Error fetching groups for ${user.login}:`, err);
+        }
+    }
+    console.log("--------------------------------------------------");
+    console.log(`📦 Total rows: ${rows.length}`);
+    console.log("--------------------------------------------------");
+    const ts = Math.floor(Date.now() / 1000);
+    const filename = `collaborationGroups_${ts}.csv`;
+    const fullPath = path_1.default.resolve(filename);
+    (0, utilities_1.saveCsv)(rows, filename);
+    console.log(`📁 CSV saved: ${fullPath}`);
+}

package/dist/users/index.d.ts

@@ -1 +1,7 @@
 export declare function downloadAllUsersCSV(clientId: string, clientSecret: string, instanceUrl: string): Promise<void>;
+export { generateUsersCollaborationCSV } from './collaborationGroups';
+declare const OfscUserUtility: {
+    generateUsersCollaborationCSV: any;
+    downloadAllUsersCSV: typeof downloadAllUsersCSV;
+};
+export default OfscUserUtility;

package/dist/users/index.js

@@ -36,6 +36,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateUsersCollaborationCSV = void 0;
 exports.downloadAllUsersCSV = downloadAllUsersCSV;
 const fs = __importStar(require("fs"));
 const node_fetch_1 = __importDefault(require("node-fetch"));
@@ -113,3 +114,10 @@ async function downloadAllUsersCSV(clientId, clientSecret, instanceUrl) {
     console.log(`🧩 Date Time: ${new Date()}`);
     console.log("-------------------------------------");
 }
+var collaborationGroups_1 = require("./collaborationGroups");
+Object.defineProperty(exports, "generateUsersCollaborationCSV", { enumerable: true, get: function () { return collaborationGroups_1.generateUsersCollaborationCSV; } });
+const OfscUserUtility = {
+    generateUsersCollaborationCSV: require('./collaborationGroups').generateUsersCollaborationCSV,
+    downloadAllUsersCSV
+};
+exports.default = OfscUserUtility;

package/dist/utilities/index.js

@@ -74,6 +74,9 @@ function saveCsv(rows, filePath) {
 function escapeCsvValue(value) {
     if (value == null)
         return "";
+    if (typeof value === "object") {
+        value = JSON.stringify(value);
+    }
     const str = String(value);
     // Wrap in quotes if needed
     if (str.includes(",") || str.includes('"') || str.includes("\n")) {

package/package.json

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

package/readme.md

@@ -25,10 +25,12 @@ Please see the code snippet below.
 
 #### csv
 
-    downloadWorkZoneCSV("clientId", "clientSecret", "instanceId")
-    downloadAllResourcesCSV("clientId", "clientSecret", "instanceId")
-    downloadAllUsersCSV("clientId", "clientSecret", "instanceId")
-    downloadAllInventoryTypesCSV("clientId", "clientSecret", "instanceId")
+    downloadWorkZoneCSV(process.env.clientID, process.env.clientSecreat, process.env.instanceId)
+    downloadAllResourcesCSV(process.env.clientID, process.env.clientSecreat, process.env.instanceId)
+    downloadAllUsersCSV(process.env.clientID, process.env.clientSecreat, process.env.instanceId)
+    downloadAllInventoryTypesCSV(process.env.clientID, process.env.clientSecreat, process.env.instanceId)
+    downloadAllEventsOfDayCSV(process.env.clientID, process.env.clientSecreat, process.env.instanceId, process.env.subscriptionId,"2025-12-05")
+    generateUsersCollaborationCSV(process.env.clientID, process.env.clientSecreat, process.env.instanceId) // all Collaboration groups of a user
 
 #### records
 
@@ -38,6 +40,7 @@ Please see the code snippet below.
     getAllActivities("clientId", "clientSecret", "instanceId"."resources","dateFrom","dateTo","q","fields")
     getActivityCustomerInventories("clientId", "clientSecret", "instanceId"."activityId")
     createActivityCustomerInventories( "clientId", "clientSecret", "instanceId"."activityId","payload")
+    downloadAllEventsOfDay(process.env.clientID, process.env.clientSecreat, process.env.instanceId, process.env.subscriptionId,"2025-12-05")
 
 ## Usage
 
@@ -45,6 +48,17 @@ downloadWorkZoneCSV("bot", "XXXXXXXXX", "compXXX.test")
 
 ### CommonJS
 
+```js
+const ofs = require("ofsc-utility");
+
+ofs.User.generateUsersCollaborationCSV(
+    process.env.clientID,
+    process.env.clientSecreat,
+    process.env.instanceId,
+    process.env.subscriptionId
+);
+```
+
 ```js
 async function run() {
   let data = await ofs.InventoryType.getInventoryTypesDetail("clientId", "clientSecret", "instanceId", "inventory_label");
@@ -168,6 +182,17 @@ ofs.getActivityCustomerInventories("CLIENT_ID", "CLIENT_SECRET", "INSTANCE_URL",
 });
 ```
 
+```js
+const ofs = require("ofsc-utility");
+ofs.Events.downloadAllEventsOfDayCSV(
+  process.env.clientID,
+  process.env.clientSecreat,
+  process.env.instanceId,
+  process.env.subscriptionId,
+  "2025-12-05"
+);
+```
+
 ## License
 
 MIT