pptb-standard-sample-tool 1.2.8 → 1.3.0

package/dist/headless.js

@@ -1,5 +1,43 @@
 "use strict";
 /// <reference types="@pptb/types" />
+function getDataverseApi() {
+    const runtime = globalThis;
+    const api = runtime.dataverseAPI ?? runtime.window?.dataverseAPI;
+    if (!api) {
+        throw new Error("Dataverse API is not available in this runtime context");
+    }
+    return api;
+}
+function sanitizeEntityName(value) {
+    const trimmed = value.trim();
+    if (!/^[A-Za-z0-9_]+$/.test(trimmed)) {
+        throw new Error("Invalid entity name. Only letters, numbers, and underscores are allowed.");
+    }
+    return trimmed.toLowerCase();
+}
+async function resolveEntityAttributes(api, entityName) {
+    try {
+        const metadata = await api.getEntityMetadata(entityName, true, ["PrimaryIdAttribute", "PrimaryNameAttribute"]);
+        const idAttribute = typeof metadata.PrimaryIdAttribute === "string" && metadata.PrimaryIdAttribute.trim().length > 0 ? metadata.PrimaryIdAttribute : `${entityName}id`;
+        const nameAttribute = typeof metadata.PrimaryNameAttribute === "string" && metadata.PrimaryNameAttribute.trim().length > 0 ? metadata.PrimaryNameAttribute : undefined;
+        return { idAttribute, nameAttribute };
+    }
+    catch {
+        // Fallback keeps headless invocation resilient when metadata lookup is unavailable.
+        return {
+            idAttribute: `${entityName}id`,
+            nameAttribute: "name",
+        };
+    }
+}
+function buildFetchXml(entityName, idAttribute, nameAttribute) {
+    const attributeLines = [
+        `    <attribute name="${idAttribute}" />`,
+        ...(nameAttribute ? [`    <attribute name="${nameAttribute}" />`] : []),
+    ];
+    const orderLine = nameAttribute ? `\n    <order attribute="${nameAttribute}" />` : "";
+    return `<fetch top="10">\n  <entity name="${entityName}">\n${attributeLines.join("\n")}${orderLine}\n  </entity>\n</fetch>`;
+}
 /**
  * Headless invocation handler.
  *
@@ -8,26 +46,30 @@
  */
 async function invokeHeadless(input, context) {
     const { toolId, toolName, invocationMode, authToken, updateProgress, logger } = context;
+    const dataverseApi = getDataverseApi();
     logger.info(`Starting headless run for ${toolName} (${toolId}) in mode ${invocationMode}`);
     updateProgress(10, "validating input");
-    const entityName = typeof input.entityName === "string" && input.entityName.trim() !== "" ? input.entityName.trim() : "account";
+    const entityName = sanitizeEntityName(typeof input.entityName === "string" && input.entityName.trim() !== "" ? input.entityName : "account");
     if (authToken) {
         updateProgress(40, "auth token received");
     }
     else {
         updateProgress(40, "running without auth token");
     }
-    updateProgress(80, "building FetchXML");
-    const fetchXml = `<fetch top="10">
-  <entity name="${entityName}">
-    <attribute name="name" />
-    <attribute name="${entityName}id" />
-    <order attribute="name" />
-  </entity>
-</fetch>`;
+    updateProgress(55, "resolving entity metadata");
+    const { idAttribute, nameAttribute } = await resolveEntityAttributes(dataverseApi, entityName);
+    updateProgress(75, "building FetchXML");
+    const fetchXml = buildFetchXml(entityName, idAttribute, nameAttribute);
+    updateProgress(90, "executing FetchXML query");
+    const result = await dataverseApi.fetchXmlQuery(fetchXml);
     updateProgress(100, "done");
-    logger.info(`Headless run complete for entity: ${entityName}`);
-    return { fetchXml };
+    logger.info(`Headless run complete for entity: ${entityName}. Returned ${result.value.length} record(s).`);
+    return {
+        entityName,
+        fetchXml,
+        recordCount: result.value.length,
+        records: result.value,
+    };
 }
 module.exports = {
     invokeHeadless,

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
     "name": "pptb-standard-sample-tool",
-    "version": "1.2.4",
+    "version": "1.2.8",
     "lockfileVersion": 3,
     "requires": true,
     "packages": {
         "": {
             "name": "pptb-standard-sample-tool",
-            "version": "1.2.4",
+            "version": "1.2.8",
             "license": "GPL-3.0",
             "devDependencies": {
                 "@pptb/types": "^1.2.4-beta.4",

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "pptb-standard-sample-tool",
-    "version": "1.2.8",
+    "version": "1.3.0",
     "displayName": "HTML Sample Tool",
     "description": "A sample Power Platform ToolBox tool built with HTML, CSS, and TypeScript",
     "main": "index.html",

package/pptb.config.json

@@ -13,8 +13,17 @@
         },
         "returnTopic": {
             "properties": {
+                "entityName": {
+                    "type": "string"
+                },
                 "fetchXml": {
                     "type": "string"
+                },
+                "recordCount": {
+                    "type": "number"
+                },
+                "records": {
+                    "type": "array"
                 }
             }
         }