pptb-standard-sample-tool 1.2.7 → 1.3.0

package/dist/app.js

@@ -26,6 +26,23 @@ let securitySuites = null;
 let terminalFeature = null;
 let fileSystemFeature = null;
 let inputEntityName = null;
+const powerPlatformNamespaces = [
+    "Analytics",
+    "AppManagement",
+    "Authorization",
+    "Connectivity",
+    "CopilotStudio",
+    "Dynamics",
+    "EnvironmentManagement",
+    "Governance",
+    "Licensing",
+    "PowerApps",
+    "PowerAutomate",
+    "PowerPages",
+    "ResourceQuery",
+    "UserManagement",
+    "WorkflowAgents",
+];
 /**
  * Initialize the application
  */
@@ -272,6 +289,7 @@ function setupEventHandlers() {
     document.getElementById("query-role-definitions-btn")?.addEventListener("click", queryRoleDefinitions);
     document.getElementById("assign-role-btn")?.addEventListener("click", assignRole);
     document.getElementById("query-role-assignments-btn")?.addEventListener("click", queryRoleAssignments);
+    document.getElementById("pp-generic-execute-btn")?.addEventListener("click", executeGenericPowerPlatformEndpoint);
     // Clear log button
     document.getElementById("clear-log-btn")?.addEventListener("click", clearLog);
     // Advanced utilities demos
@@ -1212,6 +1230,71 @@ async function queryRoleAssignments() {
         await showNotification("Error", `Failed to retrieve role assignments: ${errorMessage}`, "error");
     }
 }
+async function executeGenericPowerPlatformEndpoint() {
+    const output = document.getElementById("pp-generic-output");
+    const method = document.getElementById("pp-generic-method")?.value;
+    const namespace = document.getElementById("pp-generic-namespace")?.value;
+    const path = document.getElementById("pp-generic-path")?.value?.trim();
+    const rawBody = document.getElementById("pp-generic-body")?.value?.trim();
+    if (!method || !namespace || !path) {
+        await showNotification("Missing Inputs", "Method, namespace, and path are required", "warning");
+        if (output)
+            output.textContent = "Please provide method, namespace, and path.";
+        return;
+    }
+    if (!powerPlatformNamespaces.includes(namespace)) {
+        await showNotification("Invalid Namespace", `Unsupported namespace: ${namespace}`, "error");
+        if (output)
+            output.textContent = `Unsupported namespace: ${namespace}`;
+        return;
+    }
+    let parsedBody = undefined;
+    if (rawBody) {
+        try {
+            parsedBody = JSON.parse(rawBody);
+        }
+        catch {
+            await showNotification("Invalid JSON Body", "Request body must be valid JSON", "error");
+            if (output)
+                output.textContent = "Request body is not valid JSON.";
+            return;
+        }
+    }
+    try {
+        if (output) {
+            output.textContent = `Executing ${method.toUpperCase()} ${namespace}/${path}\n\n`;
+        }
+        const namespaceClient = powerplatform[namespace];
+        if (!namespaceClient) {
+            throw new Error(`Namespace '${namespace}' not found on powerplatformAPI`);
+        }
+        const methodClient = namespaceClient[method];
+        if (typeof methodClient !== "function") {
+            throw new Error(`Method '${method}' is not available on namespace '${namespace}'`);
+        }
+        let result;
+        if (method === "Get") {
+            result = await methodClient(path);
+        }
+        else if (method === "Delete") {
+            result = parsedBody === undefined ? await methodClient(path) : await methodClient(path, undefined, undefined, parsedBody);
+        }
+        else {
+            result = await methodClient(path, parsedBody ?? {});
+        }
+        if (output) {
+            output.textContent += JSON.stringify(result, null, 2);
+        }
+        log(`Executed ${method} on ${namespace}: ${path}`, "success");
+    }
+    catch (error) {
+        const message = error.message;
+        if (output)
+            output.textContent = `Error executing endpoint: ${message}`;
+        log(`Generic Power Platform endpoint error: ${message}`, "error");
+        await showNotification("Endpoint Execution Failed", message, "error");
+    }
+}
 // Initialize when DOM is ready
 if (document.readyState === "loading") {
     document.addEventListener("DOMContentLoaded", initialize);

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/dist/index.html

@@ -177,6 +177,60 @@
                 <h2>⚡ Power Platform API Examples</h2>
                 <p style="margin: 4px 0 15px; font-size: 12px; opacity: 0.85">Generic HTTP methods for Power Platform Admin APIs (Power Apps, Power Automate, Environment Management, Governance).</p>
 
+                <div class="example-group">
+                    <h3>Generic Endpoint Tester</h3>
+                    <p style="margin: 4px 0 10px; font-size: 12px; opacity: 0.85">
+                        Select method + namespace from the namespace catalog and provide a relative path (for example:
+                        <code>environments?api-version=2024-10-01</code>).
+                    </p>
+                    <div class="input-group">
+                        <label for="pp-generic-method">Method:</label>
+                        <select id="pp-generic-method">
+                            <option value="Get" selected>GET</option>
+                            <option value="Post">POST</option>
+                            <option value="Put">PUT</option>
+                            <option value="Patch">PATCH</option>
+                            <option value="Delete">DELETE</option>
+                        </select>
+                    </div>
+                    <div class="input-group">
+                        <label for="pp-generic-namespace">Namespace:</label>
+                        <select id="pp-generic-namespace">
+                            <option value="Analytics">Analytics</option>
+                            <option value="AppManagement">AppManagement</option>
+                            <option value="Authorization">Authorization</option>
+                            <option value="Connectivity">Connectivity</option>
+                            <option value="CopilotStudio">CopilotStudio</option>
+                            <option value="Dynamics">Dynamics</option>
+                            <option value="EnvironmentManagement" selected>EnvironmentManagement</option>
+                            <option value="Governance">Governance</option>
+                            <option value="Licensing">Licensing</option>
+                            <option value="PowerApps">PowerApps</option>
+                            <option value="PowerAutomate">PowerAutomate</option>
+                            <option value="PowerPages">PowerPages</option>
+                            <option value="ResourceQuery">ResourceQuery</option>
+                            <option value="UserManagement">UserManagement</option>
+                            <option value="WorkflowAgents">WorkflowAgents</option>
+                        </select>
+                    </div>
+                    <div class="input-group">
+                        <label for="pp-generic-path">Relative Path:</label>
+                        <input type="text" id="pp-generic-path" value="environments?api-version=2024-10-01" placeholder="e.g., environments/{environmentId}/apps?api-version=2024-10-01" />
+                    </div>
+                    <div class="input-group">
+                        <label for="pp-generic-body">Request Body (JSON, optional for POST/PUT/PATCH/DELETE):</label>
+                        <textarea
+                            id="pp-generic-body"
+                            style="width: 100%; min-height: 110px; padding: 10px; border: 2px solid #e0e0e0; border-radius: 6px; font-family: monospace; font-size: 12px; line-height: 1.4"
+                            placeholder="{\n  \"sample\": \"value\"\n}"
+                        ></textarea>
+                    </div>
+                    <div class="button-group">
+                        <button id="pp-generic-execute-btn" class="btn btn-primary">Execute Endpoint</button>
+                    </div>
+                    <div id="pp-generic-output" class="output"></div>
+                </div>
+
                 <div class="example-group">
                     <h3>Power Apps API</h3>
                     <div class="input-group">

package/dist/styles.css

@@ -6,7 +6,7 @@
 }
 
 body {
-    font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', 'Roboto', 'Helvetica', 'Arial', sans-serif;
+    font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", "Roboto", "Helvetica", "Arial", sans-serif;
     background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
     color: #333;
     line-height: 1.6;
@@ -91,7 +91,7 @@ header h1 {
 }
 
 .loading::before {
-    content: '';
+    content: "";
     width: 16px;
     height: 16px;
     border: 2px solid #667eea;
@@ -101,7 +101,9 @@ header h1 {
 }
 
 @keyframes spin {
-    to { transform: rotate(360deg); }
+    to {
+        transform: rotate(360deg);
+    }
 }
 
 /* Connection Status */
@@ -256,6 +258,22 @@ header h1 {
     border-color: #667eea;
 }
 
+.input-group select,
+.input-group textarea {
+    width: 100%;
+    padding: 10px;
+    border: 2px solid #e0e0e0;
+    border-radius: 6px;
+    font-size: 14px;
+    transition: border-color 0.3s ease;
+}
+
+.input-group select:focus,
+.input-group textarea:focus {
+    outline: none;
+    border-color: #667eea;
+}
+
 /* Example Groups */
 .example-group {
     margin: 20px 0;
@@ -271,7 +289,7 @@ header h1 {
     color: #d4d4d4;
     padding: 15px;
     border-radius: 6px;
-    font-family: 'Consolas', 'Monaco', 'Courier New', monospace;
+    font-family: "Consolas", "Monaco", "Courier New", monospace;
     font-size: 13px;
     white-space: pre-wrap;
     word-wrap: break-word;
@@ -283,7 +301,7 @@ header h1 {
 
 .output:empty::before,
 .log:empty::before {
-    content: 'No output yet...';
+    content: "No output yet...";
     color: #666;
     font-style: italic;
 }

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.7",
+    "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"
                 }
             }
         }