ofsc-utility 1.0.10 → 1.0.11

package/dist/index.d.ts

@@ -11,7 +11,7 @@ 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';
@@ -29,5 +29,6 @@ declare const OfscUtility: {
     createActivityCustomerInventories: any;
     downloadAllEventsOfDayCSV: any;
     downloadAllEventsOfDay: any;
+    generateUsersCollaborationCSV: 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.downloadAllEventsOfDayCSV = exports.downloadAllEventsOfDay = 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.Events = 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"));
@@ -58,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; } });
@@ -83,6 +84,7 @@ const OfscUtility = {
     getActivityCustomerInventories: require('./activityInventories').getActivityCustomerInventories,
     createActivityCustomerInventories: require('./activityInventories').createActivityCustomerInventories,
     downloadAllEventsOfDayCSV: require('./events').downloadAllEventsOfDayCSV,
-    downloadAllEventsOfDay: require('./events').downloadAllEventsOfDay
+    downloadAllEventsOfDay: require('./events').downloadAllEventsOfDay,
+    generateUsersCollaborationCSV: require('./users').generateUsersCollaborationCSV
 };
 exports.default = OfscUtility;

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/package.json

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

@@ -30,6 +30,7 @@ Please see the code snippet below.
     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
 
@@ -47,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");