ofsc-utility 1.0.50 → 1.0.52

package/CHANGELOG.md

@@ -10,6 +10,8 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 - version 1.0.46
 
 ### Added
+- update version to 1.0.51 and add user/inventory type management functions
+- Bump version to 1.0.50 and add new export functions
 - add user management methods for standalone OFSC
 - Update version and add resource management APIs
 - version 1.0.47 and add resource APIs

package/dist/activities/activityActions.d.ts

@@ -0,0 +1,16 @@
+export declare function startActivity(clientId: string, clientSecret: string, instanceUrl: string, activityId: number, token?: string): Promise<{
+    token: string;
+    data: any;
+}>;
+export declare function cancelActivity(clientId: string, clientSecret: string, instanceUrl: string, activityId: number, token?: string): Promise<{
+    token: string;
+    data: any;
+}>;
+export declare function completeActivity(clientId: string, clientSecret: string, instanceUrl: string, activityId: number, token?: string): Promise<{
+    token: string;
+    data: any;
+}>;
+export declare function deleteActivity(clientId: string, clientSecret: string, instanceUrl: string, activityId: number, token?: string): Promise<{
+    token: string;
+    data: any;
+}>;

package/dist/activities/activityActions.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startActivity = startActivity;
+exports.cancelActivity = cancelActivity;
+exports.completeActivity = completeActivity;
+exports.deleteActivity = deleteActivity;
+const utilities_1 = require("../utilities");
+async function startActivity(clientId, clientSecret, instanceUrl, activityId, token = "") {
+    if (!activityId || isNaN(activityId)) {
+        throw new Error("Invalid activityId. It must be a valid number.");
+    }
+    const url = `https://${instanceUrl}.fs.ocs.oraclecloud.com/rest/ofscCore/v1/activities/${Number(activityId)}/custom-actions/start`;
+    console.log(`➡️ Fetching activity by ID: ${url}`);
+    const response = await (0, utilities_1.fetchWithRetry)(url, clientId, clientSecret, instanceUrl, token);
+    return response;
+}
+async function cancelActivity(clientId, clientSecret, instanceUrl, activityId, token = "") {
+    if (!activityId || isNaN(activityId)) {
+        throw new Error("Invalid activityId. It must be a valid number.");
+    }
+    const url = `https://${instanceUrl}.fs.ocs.oraclecloud.com/rest/ofscCore/v1/activities/${Number(activityId)}/custom-actions/cancel`;
+    console.log(`➡️ Fetching activity by ID: ${url}`);
+    const response = await (0, utilities_1.fetchWithRetry)(url, clientId, clientSecret, instanceUrl, token);
+    return response;
+}
+async function completeActivity(clientId, clientSecret, instanceUrl, activityId, token = "") {
+    if (!activityId || isNaN(activityId)) {
+        throw new Error("Invalid activityId. It must be a valid number.");
+    }
+    const url = `https://${instanceUrl}.fs.ocs.oraclecloud.com/rest/ofscCore/v1/activities/${Number(activityId)}/custom-actions/complete`;
+    console.log(`Completing activity by ID: ${url}`);
+    const response = await (0, utilities_1.fetchWithRetry)(url, clientId, clientSecret, instanceUrl, token);
+    return response;
+}
+async function deleteActivity(clientId, clientSecret, instanceUrl, activityId, token = "") {
+    if (!activityId || isNaN(activityId)) {
+        throw new Error("Invalid activityId. It must be a valid number.");
+    }
+    const url = `https://${instanceUrl}.fs.ocs.oraclecloud.com/rest/ofscCore/v1/activities/${Number(activityId)}`;
+    console.log(`Deleting activity by ID: ${url}`);
+    const response = await (0, utilities_1.deleteWithRetry)(url, clientId, clientSecret, instanceUrl, token);
+    return response;
+}

package/dist/activities/index.d.ts

@@ -1,3 +1,4 @@
+export { startActivity, cancelActivity, completeActivity, deleteActivity } from "./activityActions";
 /**
  * Fetches all activities from the OFSC instance.
  *

package/dist/activities/index.js

@@ -1,9 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.deleteActivity = exports.completeActivity = exports.cancelActivity = exports.startActivity = void 0;
 exports.getAllActivities = getAllActivities;
 exports.getActivitybyId = getActivitybyId;
 const oauthTokenService_1 = require("../oauthTokenService");
 const utilities_1 = require("../utilities");
+var activityActions_1 = require("./activityActions");
+Object.defineProperty(exports, "startActivity", { enumerable: true, get: function () { return activityActions_1.startActivity; } });
+Object.defineProperty(exports, "cancelActivity", { enumerable: true, get: function () { return activityActions_1.cancelActivity; } });
+Object.defineProperty(exports, "completeActivity", { enumerable: true, get: function () { return activityActions_1.completeActivity; } });
+Object.defineProperty(exports, "deleteActivity", { enumerable: true, get: function () { return activityActions_1.deleteActivity; } });
 // Validate YYYY-MM-DD format
 const isValidDate = (date) => /^\d{4}-\d{2}-\d{2}$/.test(date);
 /**

package/dist/index.d.ts

@@ -16,7 +16,7 @@ export { downloadWorkZoneCSV } from './workZones';
 export { AllResources, downloadAllResourcesCSV, getResourcebyId, getworkSkillsOfResource, updateResourcebyId } from './resources';
 export { downloadAllInactiveUsers, downloadAllInactiveUsersCSV, downloadAllUsersCSV, generateUsersCollaborationCSV, getUserByLogin, updateUserbyLogin } from './users';
 export { downloadAllInventoryTypesCSV, getInventoryTypesDetail, updateCreateInventoryType } from './inventoryTypes';
-export { getActivitybyId, getAllActivities } from './activities';
+export { getActivitybyId, getAllActivities, startActivity, cancelActivity, completeActivity, deleteActivity } from './activities';
 export { createActivityCustomerInventories, getActivityCustomerInventories } from './activityInventories';
 export { downloadAllEventsOfDay, downloadAllEventsOfDayCSV, downloadAllEventsOfDLastTwoMinutes, downloadAllEventsOfLastOneHour } from './events';
 export { createExcelFile } from './utilities';
@@ -29,9 +29,16 @@ declare const OfscUtility: {
     downloadAllInventoryTypesCSV: any;
     getInventoryTypesDetail: any;
     updateInventoryType: any;
-    getAllActivities: any;
-    getActivityCustomerInventories: any;
-    createActivityCustomerInventories: any;
+    Activity: {
+        getAllActivities: any;
+        getActivitybyId: any;
+        startActivity: any;
+        cancelActivity: any;
+        completeActivity: any;
+        deleteActivity: any;
+        getActivityCustomerInventories: any;
+        createActivityCustomerInventories: any;
+    };
     metadata: {
         getActivityTypesMetaData: any;
         getActivityTypesGroupsMetaData: any;
@@ -53,10 +60,15 @@ declare const OfscUtility: {
     downloadAllEventsOfLastOneHour: any;
     generateUsersCollaborationCSV: any;
     generateAllOnHandInventoryOfAllResourcesCSV: any;
-    getActivitybyId: any;
     AllResources: any;
     getworkSkillsOfResource: any;
     getResource: any;
+    updateResourcebyId: any;
+    getUserByLogin: any;
+    updateUserbyLogin: any;
+    downloadAllInactiveUsersCSV: any;
+    downloadAllInactiveUsers: any;
+    updateCreateInventoryType: 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.updateUserbyLogin = exports.getUserByLogin = exports.generateUsersCollaborationCSV = exports.downloadAllUsersCSV = exports.downloadAllInactiveUsersCSV = exports.downloadAllInactiveUsers = exports.updateResourcebyId = 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;
+exports.createConfigurationFile = exports.createExcelFile = exports.downloadAllEventsOfLastOneHour = exports.downloadAllEventsOfDLastTwoMinutes = exports.downloadAllEventsOfDayCSV = exports.downloadAllEventsOfDay = exports.getActivityCustomerInventories = exports.createActivityCustomerInventories = exports.deleteActivity = exports.completeActivity = exports.cancelActivity = exports.startActivity = exports.getAllActivities = exports.getActivitybyId = exports.updateCreateInventoryType = exports.getInventoryTypesDetail = exports.downloadAllInventoryTypesCSV = exports.updateUserbyLogin = exports.getUserByLogin = exports.generateUsersCollaborationCSV = exports.downloadAllUsersCSV = exports.downloadAllInactiveUsersCSV = exports.downloadAllInactiveUsers = exports.updateResourcebyId = 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"));
@@ -78,6 +78,10 @@ Object.defineProperty(exports, "updateCreateInventoryType", { enumerable: true,
 var activities_1 = require("./activities");
 Object.defineProperty(exports, "getActivitybyId", { enumerable: true, get: function () { return activities_1.getActivitybyId; } });
 Object.defineProperty(exports, "getAllActivities", { enumerable: true, get: function () { return activities_1.getAllActivities; } });
+Object.defineProperty(exports, "startActivity", { enumerable: true, get: function () { return activities_1.startActivity; } });
+Object.defineProperty(exports, "cancelActivity", { enumerable: true, get: function () { return activities_1.cancelActivity; } });
+Object.defineProperty(exports, "completeActivity", { enumerable: true, get: function () { return activities_1.completeActivity; } });
+Object.defineProperty(exports, "deleteActivity", { enumerable: true, get: function () { return activities_1.deleteActivity; } });
 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; } });
@@ -99,9 +103,16 @@ const OfscUtility = {
     downloadAllInventoryTypesCSV: require('./inventoryTypes').downloadAllInventoryTypesCSV,
     getInventoryTypesDetail: require('./inventoryTypes').getInventoryTypesDetail,
     updateInventoryType: require('./inventoryTypes').updateInventoryType,
-    getAllActivities: require('./activities').getAllActivities,
-    getActivityCustomerInventories: require('./activityInventories').getActivityCustomerInventories,
-    createActivityCustomerInventories: require('./activityInventories').createActivityCustomerInventories,
+    Activity: {
+        getAllActivities: require('./activities').getAllActivities,
+        getActivitybyId: require('./activities').getActivitybyId,
+        startActivity: require('./activities').startActivity,
+        cancelActivity: require('./activities').cancelActivity,
+        completeActivity: require('./activities').completeActivity,
+        deleteActivity: require('./activities').deleteActivity,
+        getActivityCustomerInventories: require('./activityInventories').getActivityCustomerInventories,
+        createActivityCustomerInventories: require('./activityInventories').createActivityCustomerInventories,
+    },
     metadata: {
         getActivityTypesMetaData: require('./metadata').getActivityTypesMetaData,
         getActivityTypesGroupsMetaData: require('./metadata').getActivityTypesGroupsMetaData,
@@ -123,10 +134,15 @@ const OfscUtility = {
     downloadAllEventsOfLastOneHour: require('./events').downloadAllEventsOfLastOneHour,
     generateUsersCollaborationCSV: require('./users').generateUsersCollaborationCSV,
     generateAllOnHandInventoryOfAllResourcesCSV: require('./inventory').generateAllOnHandInventoryOfAllResourcesCSV,
-    getActivitybyId: require('./activities').getActivitybyId,
-    AllResources: require('./activities').AllResources,
+    AllResources: require('./resources').AllResources,
     getworkSkillsOfResource: require('./resources').getworkSkillsOfResource,
     getResource: require('./resources').getResourcebyId,
+    updateResourcebyId: require('./resources').updateResourcebyId,
+    getUserByLogin: require('./users').getUserByLogin,
+    updateUserbyLogin: require('./users').updateUserbyLogin,
+    downloadAllInactiveUsersCSV: require('./users').downloadAllInactiveUsersCSV,
+    downloadAllInactiveUsers: require('./users').downloadAllInactiveUsers,
+    updateCreateInventoryType: require('./inventoryTypes').updateCreateInventoryType,
     createExcelFile: require('./utilities').createExcelFile
 };
 exports.default = OfscUtility;

package/dist/utilities/index.d.ts

@@ -13,6 +13,10 @@ export declare const fetchWithRetry: (url: string, clientId: string, clientSecre
     data: any;
     token: string;
 }>;
+export declare const deleteWithRetry: (url: string, clientId: string, clientSecret: string, instanceUrl: string, token: string, retries?: number, baseDelay?: number) => Promise<{
+    data: any;
+    token: string;
+}>;
 export declare const fetchPatchWithRetry: (url: string, clientId: string, clientSecret: string, instanceUrl: string, token: string, body: any, retries?: number, baseDelay?: number) => Promise<{
     data: any;
     token: string;

package/dist/utilities/index.js

@@ -36,7 +36,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.fetchPostWithRetry = exports.fetchPatchWithRetry = exports.fetchWithRetry = void 0;
+exports.fetchPostWithRetry = exports.fetchPatchWithRetry = exports.deleteWithRetry = exports.fetchWithRetry = void 0;
 exports.saveCsv = saveCsv;
 exports.xmlNodeToObjects = xmlNodeToObjects;
 exports.createExcelFile = createExcelFile;
@@ -122,6 +122,78 @@ const fetchWithRetry = async (url, clientId, clientSecret, instanceUrl, token, r
     }
 };
 exports.fetchWithRetry = fetchWithRetry;
+const deleteWithRetry = async (url, clientId, clientSecret, instanceUrl, token, retries = 5, baseDelay = 500) => {
+    const doDelete = async (bearer) => {
+        return fetch(url, {
+            method: "DELETE",
+            headers: {
+                Authorization: `Bearer ${bearer}`,
+                Accept: "application/json"
+            }
+        });
+    };
+    console.log(`Deleting ${url}`);
+    let currentToken = token;
+    let tokenRefreshed = false;
+    let remainingRetries = retries;
+    let delay = baseDelay;
+    while (true) {
+        const res = await doDelete(currentToken);
+        // Token expired
+        if (res.status === 401 && !tokenRefreshed) {
+            console.warn("Token expired — renewing token…");
+            currentToken = await (0, oauthTokenService_1.getOAuthToken)(clientId, clientSecret, instanceUrl);
+            tokenRefreshed = true;
+            continue;
+        }
+        const responseText = await res.text();
+        const isNoRouteToHost = res.status === 400 &&
+            responseText.includes("NoRouteToHostException");
+        const isRetryableStatus = res.status === 400 ||
+            res.status === 429 ||
+            res.status === 502 ||
+            res.status === 503 ||
+            res.status === 504;
+        if ((isRetryableStatus || isNoRouteToHost) &&
+            remainingRetries > 0) {
+            const retryAfter = res.headers.get("Retry-After");
+            let retryDelay = delay;
+            if (retryAfter) {
+                const retryAfterSeconds = Number(retryAfter);
+                if (!Number.isNaN(retryAfterSeconds)) {
+                    retryDelay = retryAfterSeconds * 1000;
+                }
+            }
+            console.warn(`Retrying DELETE in ${retryDelay}ms... (${remainingRetries} retries left)`);
+            await new Promise(resolve => setTimeout(resolve, retryDelay));
+            remainingRetries--;
+            delay *= 2;
+            continue;
+        }
+        if (!res.ok) {
+            throw new Error(`DELETE request failed: ${res.status} ${res.statusText}\n${responseText}`);
+        }
+        // DELETE APIs commonly return 204 No Content
+        if (res.status === 204 || !responseText.trim()) {
+            return {
+                data: null,
+                token: currentToken
+            };
+        }
+        let data;
+        try {
+            data = JSON.parse(responseText);
+        }
+        catch {
+            throw new Error(`Invalid JSON response from ${url}\n${responseText}`);
+        }
+        return {
+            data,
+            token: currentToken
+        };
+    }
+};
+exports.deleteWithRetry = deleteWithRetry;
 const fetchPatchWithRetry = async (url, clientId, clientSecret, instanceUrl, token, body, retries = 5, baseDelay = 500) => {
     const doFetch = async (bearer) => {
         return fetch(url, {

package/package.json

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

package/readme.md

@@ -102,6 +102,94 @@ async function main() {
 main().catch(console.error);
 ```
 
+## Available exports
+
+The package exposes both top-level helpers and grouped namespaces. This list is validated against the actual exports in [src/index.ts](src/index.ts).
+
+### Top-level exports
+
+- `getOAuthToken`
+- `downloadWorkZoneCSV`
+- `generateAllOnHandInventoryOfAllResources`
+- `generateAllOnHandInventoryOfAllResourcesCSV`
+- `downloadAllResourcesCSV`
+- `AllResources`
+- `getResourcebyId`
+- `getworkSkillsOfResource`
+- `updateResourcebyId`
+- `downloadAllUsersCSV`
+- `downloadAllInactiveUsersCSV`
+- `downloadAllInactiveUsers`
+- `generateUsersCollaborationCSV`
+- `getUserByLogin`
+- `updateUserbyLogin`
+- `downloadAllInventoryTypesCSV`
+- `getInventoryTypesDetail`
+- `updateCreateInventoryType`
+- `getAllActivities`
+- `getActivitybyId`
+- `startActivity`
+- `cancelActivity`
+- `completeActivity`
+- `deleteActivity`
+- `getActivityCustomerInventories`
+- `createActivityCustomerInventories`
+- `downloadAllEventsOfDay`
+- `downloadAllEventsOfDayCSV`
+- `downloadAllEventsOfDLastTwoMinutes`
+- `downloadAllEventsOfLastOneHour`
+- `createExcelFile`
+- `createConfigurationFile`
+
+### Grouped exports
+
+The module-level namespace exports are:
+
+- `ofs.Activity`
+  - `getAllActivities`
+  - `getActivitybyId`
+  - `startActivity`
+  - `cancelActivity`
+  - `completeActivity`
+  - `deleteActivity`
+- `ofs.ActivityInventories`
+  - `getActivityCustomerInventories`
+  - `createActivityCustomerInventories`
+- `ofs.Events`
+  - `downloadAllEventsOfDay`
+  - `downloadAllEventsOfDayCSV`
+  - `downloadAllEventsOfDLastTwoMinutes`
+  - `downloadAllEventsOfLastOneHour`
+- `ofs.Inventory`
+  - `generateAllOnHandInventoryOfAllResources`
+  - `generateAllOnHandInventoryOfAllResourcesCSV`
+- `ofs.InventoryType`
+  - `downloadAllInventoryTypesCSV`
+  - `getInventoryTypesDetail`
+  - `updateCreateInventoryType`
+- `ofs.CreateConfigurationFile`
+  - `createConfigurationFile`
+- `ofs.OauthTokenService`
+  - `getOAuthToken`
+- `ofs.Resource`
+  - `AllResources`
+  - `downloadAllResourcesCSV`
+  - `getResourcebyId`
+  - `getworkSkillsOfResource`
+  - `updateResourcebyId`
+- `ofs.User`
+  - `downloadAllUsersCSV`
+  - `downloadAllInactiveUsersCSV`
+  - `downloadAllInactiveUsers`
+  - `generateUsersCollaborationCSV`
+  - `getUserByLogin`
+  - `updateUserbyLogin`
+- `ofs.Utilities`
+  - `createExcelFile`
+- `ofs.WorkZone`
+  - `downloadWorkZoneCSV`
+
+
 ## Complete Example
 
 This example shows a full CommonJS script that retrieves activity type metadata and prints the result.
@@ -759,8 +847,10 @@ This gives you a dynamic table definition based on the actual inventory row fiel
 
 ### Activity and inventory helpers
 
+The activity API supports both listing and lifecycle actions. Prefer the grouped namespace for organization:
+
 ```js
-const activities = await ofs.getAllActivities(
+const activities = await ofs.Activity.getAllActivities(
   process.env.CLIENT_ID,
   process.env.CLIENT_SECRET,
   process.env.INSTANCE_NAME,
@@ -769,13 +859,61 @@ const activities = await ofs.getAllActivities(
   "2025-11-30",
   "status=='pending'",
   "activityId,activityType,date,status",
+  true,
 );
 
-const activityData = await ofs.getActivitybyId(
+const activityData = await ofs.Activity.getActivitybyId(
   process.env.CLIENT_ID,
   process.env.CLIENT_SECRET,
   process.env.INSTANCE_NAME,
-  "ACTIVITY_ID",
+  123456,
+);
+
+await ofs.Activity.startActivity(
+  process.env.CLIENT_ID,
+  process.env.CLIENT_SECRET,
+  process.env.INSTANCE_NAME,
+  123456,
+);
+
+await ofs.Activity.completeActivity(
+  process.env.CLIENT_ID,
+  process.env.CLIENT_SECRET,
+  process.env.INSTANCE_NAME,
+  123456,
+);
+
+await ofs.Activity.cancelActivity(
+  process.env.CLIENT_ID,
+  process.env.CLIENT_SECRET,
+  process.env.INSTANCE_NAME,
+  123456,
+);
+
+await ofs.Activity.deleteActivity(
+  process.env.CLIENT_ID,
+  process.env.CLIENT_SECRET,
+  process.env.INSTANCE_NAME,
+  123456,
+);
+
+const customerInventories = await ofs.ActivityInventories.getActivityCustomerInventories(
+  process.env.CLIENT_ID,
+  process.env.CLIENT_SECRET,
+  process.env.INSTANCE_NAME,
+  123456,
+);
+
+const createdInventory = await ofs.ActivityInventories.createActivityCustomerInventories(
+  process.env.CLIENT_ID,
+  process.env.CLIENT_SECRET,
+  process.env.INSTANCE_NAME,
+  123456,
+  {
+    code: "INV-1001",
+    quantity: 1,
+    status: "active",
+  },
 );
 
 const inventoryDetail = await ofs.InventoryType.getInventoryTypesDetail(
@@ -786,6 +924,28 @@ const inventoryDetail = await ofs.InventoryType.getInventoryTypesDetail(
 );
 ```
 
+### Activity lifecycle actions
+
+The activity action helpers let you transition an OFSC activity through its standard custom actions:
+
+- `startActivity(clientId, clientSecret, instanceUrl, activityId)`
+- `completeActivity(clientId, clientSecret, instanceUrl, activityId)`
+- `cancelActivity(clientId, clientSecret, instanceUrl, activityId)`
+- `deleteActivity(clientId, clientSecret, instanceUrl, activityId)`
+
+Example:
+
+```js
+const started = await ofs.Activity.startActivity(
+  process.env.CLIENT_ID,
+  process.env.CLIENT_SECRET,
+  process.env.INSTANCE_NAME,
+  123456,
+);
+
+console.log(started.data);
+```
+
 ### Create a configuration workbook
 
 ```js
@@ -842,43 +1002,37 @@ await ofs.User.generateUsersCollaborationCSV(
 );
 ```
 
-## Available exports
 
-Top-level exports include:
+### Default export object
 
-- `getOAuthToken`
-- `downloadWorkZoneCSV`
-- `downloadAllResourcesCSV`
-- `getResource`
-- `downloadAllUsersCSV`
-- `downloadAllInactiveUsersCSV`
-- `generateAllOnHandInventoryOfAllResourcesCSV`
-- `generateAllOnHandInventoryOfAllResources`
-- `downloadAllInventoryTypesCSV`
-- `getInventoryTypesDetail`
-- `updateCreateInventoryType`
-- `getAllActivities`
-- `getActivitybyId`
-- `getActivityCustomerInventories`
-- `createActivityCustomerInventories`
-- `downloadAllEventsOfDay`
-- `downloadAllEventsOfDayCSV`
-- `createExcelFile`
-- `createConfigurationFile`
+The default export object exposes the same functions in a single object, with the metadata helpers grouped under `metadata`:
 
-Grouped exports include:
+```js
+const ofs = require("ofsc-utility");
 
-- `ofs.Activity`
-- `ofs.ActivityInventories`
-- `ofs.Events`
-- `ofs.Inventory`
-- `ofs.InventoryType`
-- `ofs.OauthTokenService`
-- `ofs.Resource`
-- `ofs.User`
-- `ofs.Utilities`
-- `ofs.WorkZone`
-- `ofs.metadata`
+const activities = await ofs.Activity.getAllActivities(
+  process.env.CLIENT_ID,
+  process.env.CLIENT_SECRET,
+  process.env.INSTANCE_NAME,
+  "US",
+  "2025-11-01",
+  "2025-11-30",
+);
+
+await ofs.Activity.startActivity(
+  process.env.CLIENT_ID,
+  process.env.CLIENT_SECRET,
+  process.env.INSTANCE_NAME,
+  123456,
+);
+
+const meta = ofs.metadata;
+const activityTypes = await meta.getActivityTypesMetaData(
+  process.env.CLIENT_ID,
+  process.env.CLIENT_SECRET,
+  process.env.INSTANCE_NAME,
+);
+```
 
 ## Metadata namespace