pptb-standard-sample-tool 1.1.12 → 1.2.1

package/dist/app.js

@@ -15,14 +15,17 @@ import { createSecuritySuites } from "./security/suites.js";
 // Global API references
 const toolbox = window.toolboxAPI;
 const dataverse = window.dataverseAPI;
+const powerplatform = window.powerplatformAPI;
 // Application state
 let currentConnection = null;
 let secondaryConnection = null;
 let currentTerminal = null;
 let createdId = null;
+let currentLaunchContext = null;
 let securitySuites = null;
 let terminalFeature = null;
 let fileSystemFeature = null;
+let inputEntityName = null;
 /**
  * Initialize the application
  */
@@ -60,6 +63,7 @@ async function initialize() {
             showNotification,
             log,
         });
+        await identifyLaunchContext();
         // Setup UI event handlers
         setupEventHandlers();
         // Apply theme
@@ -72,6 +76,41 @@ async function initialize() {
         log(`Initialization error: ${error.message}`, "error");
     }
 }
+/**
+ * Identifying Launch Context
+ */
+async function identifyLaunchContext() {
+    try {
+        const ctx = await toolbox.invocation.getLaunchContext();
+        log(`Launch context: ${ctx}`, "info");
+        if (ctx !== null) {
+            // Tool was launched via inter-tool invocation
+            inputEntityName = ctx.entityName;
+            currentLaunchContext = ctx;
+            log(`Launched with context for entity: ${inputEntityName}`, "success");
+            // Set iti-entity-name value with the entity name from the launch context
+            const entityNameInput = document.getElementById("iti-entity-name");
+            if (entityNameInput) {
+                entityNameInput.value = inputEntityName;
+            }
+            // Set default fetchXML to query the launched entity
+            const defaultFetchOutput = document.getElementById("iti-default-fetch-output");
+            if (defaultFetchOutput) {
+                defaultFetchOutput.textContent = `
+                    <fetch top="10">
+                        <entity name="${inputEntityName}">
+                            <attribute name="name" />
+                            <attribute name="${inputEntityName}id" />
+                            <order attribute="name" />
+                        </entity>
+                    </fetch>`;
+            }
+        }
+    }
+    catch (error) {
+        log(`Error getting launch context: ${error.message}`, "error");
+    }
+}
 /**
  * Refresh connection information
  */
@@ -189,7 +228,6 @@ function setupEventHandlers() {
     document.getElementById("show-info-btn")?.addEventListener("click", () => showNotification("Information", "This is an informational message", "info"));
     document.getElementById("show-warning-btn")?.addEventListener("click", () => showNotification("Warning", "Please review this warning", "warning"));
     document.getElementById("show-error-btn")?.addEventListener("click", () => showNotification("Error", "An error has occurred", "error"));
-    document.getElementById("show-loading-btn")?.addEventListener("click", showLoading);
     // Utility buttons
     document.getElementById("copy-clipboard-btn")?.addEventListener("click", copyToClipboard);
     document.getElementById("get-theme-btn")?.addEventListener("click", showCurrentTheme);
@@ -226,6 +264,11 @@ function setupEventHandlers() {
     document.getElementById("get-metadata-allentities")?.addEventListener("click", getAllEntities);
     //Execute buttons
     document.getElementById("whoami-btn")?.addEventListener("click", executeWhoAmI);
+    // Power Platform API buttons
+    document.getElementById("list-apps-btn")?.addEventListener("click", listPowerApps);
+    document.getElementById("list-flows-btn")?.addEventListener("click", listPowerAutomateFlows);
+    document.getElementById("list-environments-btn")?.addEventListener("click", listEnvironments);
+    document.getElementById("get-governance-btn")?.addEventListener("click", getGovernanceData);
     // Clear log button
     document.getElementById("clear-log-btn")?.addEventListener("click", clearLog);
     // Advanced utilities demos
@@ -234,6 +277,21 @@ function setupEventHandlers() {
     // Settings buttons
     document.getElementById("load-setting-btn")?.addEventListener("click", loadToolSetting);
     document.getElementById("save-setting-btn")?.addEventListener("click", saveToolSetting);
+    // Inter-tool invocation buttons
+    document.getElementById("iti-return-value-btn")?.addEventListener("click", async () => {
+        const fetchXML = document.getElementById("iti-default-fetch-output")?.textContent;
+        await toolbox.invocation.returnData({
+            fetchXml: fetchXML,
+        });
+        log(`Returned data to caller: ${fetchXML}`, "info");
+        // PPTB automatically closes this window after delivering the result.
+    });
+    document.getElementById("iti-launch-fetchxml-btn")?.addEventListener("click", async () => {
+        const entityName = document.getElementById("iti-entity-logical-name").value;
+        const result = await toolbox.invocation.launchTool("@mohsinonxrm/pptb-fetchxml-studio", // npm package name of the target tool
+        { entityName: entityName });
+        log(`Launched entity picker with result: ${JSON.stringify(result)}`, "info");
+    });
 }
 /**
  * Show notification
@@ -252,17 +310,6 @@ async function showNotification(title, body, type) {
         log(`Error showing notification: ${error.message}`, "error");
     }
 }
-async function showLoading() {
-    try {
-        await toolbox.utils.showLoading("Loading... for 3 seconds");
-        log("Loading shown for 3 seconds", "info");
-        await new Promise((resolve) => setTimeout(resolve, 3000));
-        await toolbox.utils.hideLoading();
-    }
-    catch (error) {
-        log(`Error showing loading: ${error.message}`, "error");
-    }
-}
 /**
  * Copy text to clipboard
  */
@@ -885,7 +932,6 @@ async function demoLoading() {
     if (output)
         output.textContent = "Showing loading screen...\n";
     try {
-        await toolbox.utils.showLoading("Processing data...");
         log("Loading screen displayed", "info");
         // Simulate async work or perform a lightweight query
         if (currentConnection) {
@@ -910,13 +956,123 @@ async function demoLoading() {
         await showNotification("Loading Demo Error", error.message, "error");
     }
     finally {
-        await toolbox.utils.hideLoading();
         if (output)
             output.textContent += "\nLoading screen hidden.";
         log("Loading screen hidden", "info");
         await showNotification("Loading Complete", "Demo finished", "success");
     }
 }
+// -----------------------------
+// Power Platform API Examples
+// -----------------------------
+async function listPowerApps() {
+    const output = document.getElementById("powerapps-output");
+    const envId = document.getElementById("ppapps-env-id")?.value;
+    if (!envId) {
+        await showNotification("Missing Environment ID", "Please enter an environment ID", "warning");
+        if (output)
+            output.textContent = "Enter an environment ID to list apps.";
+        return;
+    }
+    try {
+        if (output)
+            output.textContent = "Fetching Power Apps...\n";
+        const result = await powerplatform.PowerApps.Get(`environments/${envId}/apps?api-version=2024-10-01`);
+        if (output) {
+            const apps = result.value || [];
+            output.textContent += `Found ${apps.length} app(s):\n\n`;
+            apps.forEach((app, index) => {
+                output.textContent += `${index + 1}. ${app.name}\n`;
+                output.textContent += `   ID: ${app.id || app.appId}\n`;
+                output.textContent += `   Type: ${app.type || "N/A"}\n\n`;
+            });
+            log(`Listed ${apps.length} Power Apps`, "success");
+        }
+    }
+    catch (error) {
+        if (output)
+            output.textContent = `Error: ${error.message}`;
+        log(`Error listing Power Apps: ${error.message}`, "error");
+    }
+}
+async function listPowerAutomateFlows() {
+    const output = document.getElementById("powerautomate-output");
+    const envId = document.getElementById("ppautomate-env-id")?.value;
+    if (!envId) {
+        await showNotification("Missing Environment ID", "Please enter an environment ID", "warning");
+        if (output)
+            output.textContent = "Enter an environment ID to list flows.";
+        return;
+    }
+    try {
+        if (output)
+            output.textContent = "Fetching Power Automate flows...\n";
+        const result = await powerplatform.PowerAutomate.Get(`environments/${envId}/cloudFlows?api-version=2024-10-01`);
+        if (output) {
+            const flows = result.value || [];
+            output.textContent += `Found ${flows.length} flow(s):\n\n`;
+            flows.forEach((flow, index) => {
+                output.textContent += `${index + 1}. ${flow.displayName || flow.name}\n`;
+                output.textContent += `   ID: ${flow.id || flow.flowId}\n`;
+                output.textContent += `   State: ${flow.state || "N/A"}\n\n`;
+            });
+            log(`Listed ${flows.length} Power Automate flows`, "success");
+        }
+    }
+    catch (error) {
+        if (output)
+            output.textContent = `Error: ${error.message}`;
+        log(`Error listing flows: ${error.message}`, "error");
+    }
+}
+async function listEnvironments() {
+    const output = document.getElementById("environments-output");
+    try {
+        if (output)
+            output.textContent = "Fetching environments...\n";
+        const result = await powerplatform.EnvironmentManagement.Get("environments?api-version=2024-10-01");
+        if (output) {
+            const envs = result.value || [];
+            output.textContent += `Found ${envs.length} environment(s):\n\n`;
+            envs.forEach((env, index) => {
+                output.textContent += `${index + 1}. ${env.displayName}\n`;
+                output.textContent += `   ID: ${env.id || env.environmentId}\n`;
+                output.textContent += `   Type: ${env.type || env.environmentType || "N/A"}\n\n`;
+            });
+            log(`Listed ${envs.length} environments`, "success");
+        }
+    }
+    catch (error) {
+        if (output)
+            output.textContent = `Error: ${error.message}`;
+        log(`Error listing environments: ${error.message}`, "error");
+    }
+}
+async function getGovernanceData() {
+    const output = document.getElementById("governance-output");
+    const envId = document.getElementById("governance-env-id")?.value;
+    if (!envId) {
+        await showNotification("Missing Environment ID", "Please enter an environment ID", "warning");
+        if (output)
+            output.textContent = "Enter an environment ID to get governance data.";
+        return;
+    }
+    try {
+        if (output)
+            output.textContent = "Fetching governance data...\n";
+        const result = await powerplatform.Governance.Get(`ruleBasedPolicies/environments/${envId}/assignments?includeRuleSetCounts=true&api-version=2024-10-01`);
+        if (output) {
+            output.textContent += "Governance Data:\n\n";
+            output.textContent += JSON.stringify(result, null, 2);
+        }
+        log("Governance data retrieved", "success");
+    }
+    catch (error) {
+        if (output)
+            output.textContent = `Error: ${error.message}`;
+        log(`Error getting governance data: ${error.message}`, "error");
+    }
+}
 // Initialize when DOM is ready
 if (document.readyState === "loading") {
     document.addEventListener("DOMContentLoaded", initialize);

package/dist/index.html

@@ -68,10 +68,9 @@
 
                 <div class="example-group">
                     <h3>Advanced Utilities</h3>
-                    <p style="margin: 4px 0 8px; font-size: 12px; opacity: 0.8">Demonstrates <code>executeParallel</code>, <code>showLoading</code> & <code>hideLoading</code>.</p>
+                    <p style="margin: 4px 0 8px; font-size: 12px; opacity: 0.8">Demonstrates <code>executeParallel</code>.</p>
                     <div class="button-group">
                         <button id="parallel-demo-btn" class="btn btn-primary">Run Parallel Demo</button>
-                        <button id="loading-demo-btn" class="btn btn-secondary">Run Loading Demo</button>
                     </div>
                     <div id="parallel-output" class="output"></div>
                 </div>
@@ -173,6 +172,86 @@
                 </div>
             </section>
 
+            <!-- Power Platform API Examples -->
+            <section class="card">
+                <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>Power Apps API</h3>
+                    <div class="input-group">
+                        <label for="ppapps-env-id">Environment ID:</label>
+                        <input type="text" id="ppapps-env-id" placeholder="Enter environment ID" />
+                    </div>
+                    <div class="button-group">
+                        <button id="list-apps-btn" class="btn">List Admin Apps</button>
+                    </div>
+                    <div id="powerapps-output" class="output"></div>
+                </div>
+
+                <div class="example-group">
+                    <h3>Power Automate API</h3>
+                    <div class="input-group">
+                        <label for="ppautomate-env-id">Environment ID:</label>
+                        <input type="text" id="ppautomate-env-id" placeholder="Enter environment ID" />
+                    </div>
+                    <div class="button-group">
+                        <button id="list-flows-btn" class="btn">List Flows</button>
+                    </div>
+                    <div id="powerautomate-output" class="output"></div>
+                </div>
+
+                <div class="example-group">
+                    <h3>Environment Management API</h3>
+                    <div class="button-group">
+                        <button id="list-environments-btn" class="btn btn-primary">List Environments For User</button>
+                    </div>
+                    <div id="environments-output" class="output"></div>
+                </div>
+
+                <div class="example-group">
+                    <h3>Governance API</h3>
+                    <div class="input-group">
+                        <label for="governance-env-id">Environment ID:</label>
+                        <input type="text" id="governance-env-id" placeholder="Enter environment ID" />
+                    </div>
+                    <div class="button-group">
+                        <button id="get-governance-btn" class="btn">List Rule Assignments By Environment Id</button>
+                    </div>
+                    <div id="governance-output" class="output"></div>
+                </div>
+            </section>
+
+            <!-- Inter-tool Invocation Example -->
+            <section class="card">
+                <h2>⚡ Inter-tool Invocation Example</h2>
+                <p style="margin: 4px 0 15px; font-size: 12px; opacity: 0.85">Demonstrates how to invoke other tools or read invoked values within the Power Platform ToolBox.</p>
+
+                <div class="example-group">
+                    <h3>Tool Launched by Another Tool or Agent</h3>
+                    <div class="input-group">
+                        <label for="iti-entity-name">Entity Name:</label>
+                        <input type="text" id="iti-entity-name" readonly />
+                    </div>
+                    <div class="button-group">
+                        <button id="iti-return-value-btn" class="btn">Return Default FetchXml (shown below)</button>
+                    </div>
+                    <div id="iti-default-fetch-output" class="output"></div>
+                </div>
+                <div class="example-group">
+                    <h3>Launch Fetch XML Studio</h3>
+                    <div class="input-group">
+                        <label for="iti-entity-logical-name">Entity Logical Name:</label>
+                        <input type="text" id="iti-entity-logical-name" placeholder="account" />
+                    </div>
+                    <div class="button-group">
+                        <button id="iti-launch-fetchxml-btn" class="btn">Launch Fetch XML Studio</button>
+                    </div>
+                    <h4>Returned FetchXML:</h4>
+                    <div id="iti-returned-fetch-output" class="output"></div>
+                </div>
+            </section>
+
             <!-- Event Log -->
             <section class="card">
                 <h2>📋 Event Log</h2>

package/npm-shrinkwrap.json

@@ -1,15 +1,15 @@
 {
     "name": "pptb-standard-sample-tool",
-    "version": "1.1.12",
+    "version": "1.2.0",
     "lockfileVersion": 3,
     "requires": true,
     "packages": {
         "": {
             "name": "pptb-standard-sample-tool",
-            "version": "1.1.12",
+            "version": "1.2.0",
             "license": "GPL-3.0",
             "devDependencies": {
-                "@pptb/types": "^1.0.19",
+                "@pptb/types": "^1.2.4-beta.4",
                 "shx": "^0.4.0",
                 "typescript": "^5.0.0"
             },
@@ -17,6 +17,19 @@
                 "node": ">=18.0.0"
             }
         },
+        "node_modules/@isaacs/fs-minipass": {
+            "version": "4.0.1",
+            "resolved": "https://registry.npmjs.org/@isaacs/fs-minipass/-/fs-minipass-4.0.1.tgz",
+            "integrity": "sha512-wgm9Ehl2jpeqP3zw/7mo3kRHFp5MEDhqAdwy1fTGkHAwnkGOVsgpvQhL8B5n1qlb01jV3n/bI0ZfZp5lWA1k4w==",
+            "dev": true,
+            "license": "ISC",
+            "dependencies": {
+                "minipass": "^7.0.4"
+            },
+            "engines": {
+                "node": ">=18.0.0"
+            }
+        },
         "node_modules/@nodelib/fs.scandir": {
             "version": "2.1.5",
             "resolved": "https://registry.npmjs.org/@nodelib/fs.scandir/-/fs.scandir-2.1.5.tgz",
@@ -56,11 +69,30 @@
             }
         },
         "node_modules/@pptb/types": {
-            "version": "1.0.19",
-            "resolved": "https://registry.npmjs.org/@pptb/types/-/types-1.0.19.tgz",
-            "integrity": "sha512-1nzI65TZEcP5t672G8T3uzheDI5az7Q58HGOq7F2wh0oxcbLKjSfarD13cNKR01slyBIUTNUF5W3pNHJTLYHYA==",
+            "version": "1.2.4-beta.4",
+            "resolved": "https://registry.npmjs.org/@pptb/types/-/types-1.2.4-beta.4.tgz",
+            "integrity": "sha512-ipoQFehrZ6ndWAsIFZF1MBInM5hY0epUOsNf513oURnfie0Orcx2+7alt6B09LR2OG0egLf0BFxxg4iVDwMvNw==",
             "dev": true,
-            "license": "GPL-3.0"
+            "license": "GPL-3.0",
+            "dependencies": {
+                "@pptb/validate": "^0.0.2"
+            },
+            "bin": {
+                "pptb-validate": "bin/pptb-validate.js"
+            }
+        },
+        "node_modules/@pptb/validate": {
+            "version": "0.0.2",
+            "resolved": "https://registry.npmjs.org/@pptb/validate/-/validate-0.0.2.tgz",
+            "integrity": "sha512-QsuimcuDgEbblqC4uAeXE+ONm5KJ5twKbGFh9d8e4leF2jsISgVpVzYPgivSLUA9iomDGmMnXcklHPgb4jEf1A==",
+            "dev": true,
+            "license": "GPL-3.0",
+            "dependencies": {
+                "tar": "^7.5.16"
+            },
+            "bin": {
+                "pptb-validate": "dist/cli.js"
+            }
         },
         "node_modules/braces": {
             "version": "3.0.3",
@@ -75,6 +107,16 @@
                 "node": ">=8"
             }
         },
+        "node_modules/chownr": {
+            "version": "3.0.0",
+            "resolved": "https://registry.npmjs.org/chownr/-/chownr-3.0.0.tgz",
+            "integrity": "sha512-+IxzY9BZOQd/XuYPRmrvEVjF/nqj5kgT4kEq7VofrDoM1MxoRjEWkrCC3EtLi59TVawxTAn+orJwFQcrqEN1+g==",
+            "dev": true,
+            "license": "BlueOak-1.0.0",
+            "engines": {
+                "node": ">=18"
+            }
+        },
         "node_modules/cross-spawn": {
             "version": "6.0.6",
             "resolved": "https://registry.npmjs.org/cross-spawn/-/cross-spawn-6.0.6.tgz",
@@ -320,6 +362,29 @@
                 "url": "https://github.com/sponsors/ljharb"
             }
         },
+        "node_modules/minipass": {
+            "version": "7.1.3",
+            "resolved": "https://registry.npmjs.org/minipass/-/minipass-7.1.3.tgz",
+            "integrity": "sha512-tEBHqDnIoM/1rXME1zgka9g6Q2lcoCkxHLuc7ODJ5BxbP5d4c2Z5cGgtXAku59200Cx7diuHTOYfSBD8n6mm8A==",
+            "dev": true,
+            "license": "BlueOak-1.0.0",
+            "engines": {
+                "node": ">=16 || 14 >=14.17"
+            }
+        },
+        "node_modules/minizlib": {
+            "version": "3.1.0",
+            "resolved": "https://registry.npmjs.org/minizlib/-/minizlib-3.1.0.tgz",
+            "integrity": "sha512-KZxYo1BUkWD2TVFLr0MQoM8vUUigWD3LlD83a/75BqC+4qE0Hb1Vo5v1FgcfaNXvfXzr+5EhQ6ing/CaBijTlw==",
+            "dev": true,
+            "license": "MIT",
+            "dependencies": {
+                "minipass": "^7.1.2"
+            },
+            "engines": {
+                "node": ">= 18"
+            }
+        },
         "node_modules/nice-try": {
             "version": "1.0.5",
             "resolved": "https://registry.npmjs.org/nice-try/-/nice-try-1.0.5.tgz",
@@ -589,6 +654,23 @@
                 "url": "https://github.com/sponsors/ljharb"
             }
         },
+        "node_modules/tar": {
+            "version": "7.5.16",
+            "resolved": "https://registry.npmjs.org/tar/-/tar-7.5.16.tgz",
+            "integrity": "sha512-56adEpPMouktRlBLXiaYFFzZ/3+JXa8P9n7WbR+ibIjtviN55mEaOkiysCnPnWm+7kkui1Dn8J9l+g6zV8731w==",
+            "dev": true,
+            "license": "BlueOak-1.0.0",
+            "dependencies": {
+                "@isaacs/fs-minipass": "^4.0.0",
+                "chownr": "^3.0.0",
+                "minipass": "^7.1.2",
+                "minizlib": "^3.1.0",
+                "yallist": "^5.0.0"
+            },
+            "engines": {
+                "node": ">=18"
+            }
+        },
         "node_modules/to-regex-range": {
             "version": "5.0.1",
             "resolved": "https://registry.npmjs.org/to-regex-range/-/to-regex-range-5.0.1.tgz",
@@ -635,6 +717,16 @@
             "integrity": "sha512-l4Sp/DRseor9wL6EvV2+TuQn63dMkPjZ/sp9XkghTEbV9KlPS1xUsZ3u7/IQO4wxtcFB4bgpQPRcR3QCvezPcQ==",
             "dev": true,
             "license": "ISC"
+        },
+        "node_modules/yallist": {
+            "version": "5.0.0",
+            "resolved": "https://registry.npmjs.org/yallist/-/yallist-5.0.0.tgz",
+            "integrity": "sha512-YgvUTfwqyc7UXVMrB+SImsVYSmTS8X/tSrtdNZMImM+n7+QTriRXyXim0mBrTXNeqzVF0KWGgHPeiyViFFrNDw==",
+            "dev": true,
+            "license": "BlueOak-1.0.0",
+            "engines": {
+                "node": ">=18"
+            }
         }
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "pptb-standard-sample-tool",
-    "version": "1.1.12",
+    "version": "1.2.1",
     "displayName": "HTML Sample Tool",
     "description": "A sample Power Platform ToolBox tool built with HTML, CSS, and TypeScript",
     "main": "index.html",
@@ -28,7 +28,8 @@
     },
     "features": {
         "minAPI": "1.2.2",
-        "multiConnection": "optional"
+        "multiConnection": "optional",
+        "enabledForPowerPlatformAPI": true
     },
     "repository": {
         "type": "git",
@@ -44,15 +45,16 @@
         "copy-css": "shx cp src/styles.css dist/",
         "copy-icon": "shx cp -r icon/ dist/icon/",
         "finalize-package": "npm shrinkwrap",
-        "watch": "tsc --watch"
+        "validate": "pptb-validate"
     },
     "devDependencies": {
-        "@pptb/types": "^1.0.19",
+        "@pptb/types": "^1.2.4-beta.4",
         "shx": "^0.4.0",
         "typescript": "^5.0.0"
     },
     "files": [
         "dist",
-        "npm-shrinkwrap.json"
+        "npm-shrinkwrap.json",
+        "pptb.config.json"
     ]
-}
+}

package/pptb.config.json

@@ -0,0 +1,23 @@
+{
+    "invocation": {
+        "version": "1.0.0",
+        "agentInvokable": true,
+        "capabilities": [
+            "fetchxml"
+        ],
+        "prefill": {
+            "properties": {
+                "entityName": {
+                    "type": "string"
+                }
+            }
+        },
+        "returnTopic": {
+            "properties": {
+                "fetchXml": {
+                    "type": "string"
+                }
+            }
+        }
+    }
+}