ofsc-utility 1.0.30 → 1.0.31

package/dist/utilities/index.js

@@ -76,7 +76,7 @@ const fetchWithRetry = async (url, clientId, clientSecret, instanceUrl, token, r
         res = await doFetch(token);
     }
     /* ---------- 429: retry with backoff ---------- */
-    if (res.status === 429 && retries > 0) {
+    if ((res.status === 429 || res.status === 400) && retries > 0) {
         const retryAfter = res.headers.get("Retry-After");
         console.log("⚠️ 429 received. Retrying...", retryAfter);
         const delay = retryAfter ? Number(retryAfter) * 1000 : baseDelay;

package/package.json

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

package/readme.md

@@ -282,6 +282,29 @@ The `metadata` object exposes metadata helpers such as:
 - `getWorkZonesMetaData`
 - `createConfigurationFile`
 
+### Properties metadata note
+
+The `getPropertiesMetaData` helper fetches OFSC property definitions and then builds:
+
+- `Properties Overview`: one row per property, including label, name, type, entity, GUI, clone flag, and deduplicated comments
+- `Properties Enumerations`: combined enumeration dropdown values for any properties whose data type is `enumeration`
+
+This function requires an `allUsedPropes` array to identify which properties are referenced by other metadata types and to collect comments for the overview.
+
+```js
+const allPropes = [];
+
+const propertiesSheet = await ofs.metadata.getPropertiesMetaData(
+  process.env.CLIENT_ID,
+  process.env.CLIENT_SECRET,
+  process.env.INSTANCE_NAME,
+  allPropes,
+);
+
+console.log(propertiesSheet["Properties Overview"]);
+console.log(propertiesSheet["Properties Enumerations"]);
+```
+
 ## Notes
 
 - `instanceUrl` is the OFSC instance name only, not the full URL. For example: `mycompany` for `mycompany.fs.ocs.oraclecloud.com`.