pptb-standard-sample-tool 1.2.0 → 1.2.2

package/dist/app.js

@@ -21,9 +21,11 @@ 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
  */
@@ -61,6 +63,7 @@ async function initialize() {
             showNotification,
             log,
         });
+        await identifyLaunchContext();
         // Setup UI event handlers
         setupEventHandlers();
         // Apply theme
@@ -73,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
  */
@@ -231,6 +269,9 @@ function setupEventHandlers() {
     document.getElementById("list-flows-btn")?.addEventListener("click", listPowerAutomateFlows);
     document.getElementById("list-environments-btn")?.addEventListener("click", listEnvironments);
     document.getElementById("get-governance-btn")?.addEventListener("click", getGovernanceData);
+    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);
     // Clear log button
     document.getElementById("clear-log-btn")?.addEventListener("click", clearLog);
     // Advanced utilities demos
@@ -239,6 +280,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
@@ -1020,6 +1076,142 @@ async function getGovernanceData() {
         log(`Error getting governance data: ${error.message}`, "error");
     }
 }
+/**
+ * Query role definitions from Power Platform Authorization API
+ * Retrieves all available role definitions with their IDs and names
+ */
+async function queryRoleDefinitions() {
+    const output = document.getElementById("role-definitions-output");
+    try {
+        if (output)
+            output.textContent = "Fetching role definitions...\n";
+        // Call the Power Platform Authorization API to get role definitions
+        const result = await powerplatform.Authorization.Get("roleDefinitions?api-version=2024-10-01");
+        if (output) {
+            const roleDefinitions = result.value || [];
+            output.textContent = `Found ${roleDefinitions.length} role definition(s):\n\n`;
+            if (roleDefinitions.length === 0) {
+                output.textContent += "No role definitions found.";
+            }
+            else {
+                // Display role definitions in a formatted table
+                roleDefinitions.forEach((role, index) => {
+                    output.textContent += `${index + 1}. ${role.roleDefinitionName}\n`;
+                    output.textContent += `   ID: ${role.roleDefinitionId}\n`;
+                    if (role.description)
+                        output.textContent += `   Description: ${role.description}\n`;
+                    output.textContent += "\n";
+                });
+            }
+            log(`Retrieved ${roleDefinitions.length} role definitions`, "success");
+            await showNotification("Role Definitions Retrieved", `Found ${roleDefinitions.length} role definition(s)`, "success");
+        }
+    }
+    catch (error) {
+        const errorMessage = error.message;
+        if (output)
+            output.textContent = `Error: ${errorMessage}`;
+        log(`Error querying role definitions: ${errorMessage}`, "error");
+        await showNotification("Error", `Failed to retrieve role definitions: ${errorMessage}`, "error");
+    }
+}
+/**
+ * Assign a role to a principal (user, service principal, or enterprise app)
+ * Creates a role assignment in the Power Platform Authorization API
+ */
+async function assignRole() {
+    const output = document.getElementById("role-assignment-output");
+    const tenantId = document.getElementById("role-assign-tenant-id")?.value;
+    const principalObjectId = document.getElementById("role-assign-principal-object-id")?.value;
+    const principalType = document.getElementById("role-assign-principal-type")?.value || "ApplicationUser";
+    const roleDefinitionId = document.getElementById("role-assign-role-definition-id")?.value;
+    if (!tenantId || !principalObjectId || !roleDefinitionId) {
+        await showNotification("Missing Fields", "Please fill in all required fields", "warning");
+        if (output)
+            output.textContent = "Please provide Tenant ID, Principal Object ID, and Role Definition ID.";
+        return;
+    }
+    try {
+        if (output)
+            output.textContent = "Assigning role...\n";
+        // Build the request body
+        const body = {
+            roleDefinitionId,
+            principalObjectId,
+            principalType,
+            scope: `/tenants/${tenantId}`,
+        };
+        // Call the Power Platform Authorization API to assign role
+        const result = await powerplatform.Authorization.Post("roleAssignments?api-version=2024-10-01", body);
+        if (output) {
+            output.textContent = "Role assignment created successfully!\n\n";
+            output.textContent += "Assignment Details:\n";
+            output.textContent += `ID: ${result.id || result.roleAssignmentId}\n`;
+            output.textContent += `Role Definition ID: ${result.roleDefinitionId}\n`;
+            output.textContent += `Principal Object ID: ${result.principalObjectId}\n`;
+            output.textContent += `Principal Type: ${result.principalType}\n`;
+            output.textContent += `Scope: ${result.scope}\n`;
+        }
+        log(`Role assigned successfully to ${principalObjectId}`, "success");
+        await showNotification("Role Assigned", `Role assigned to ${principalObjectId}`, "success");
+    }
+    catch (error) {
+        const errorMessage = error.message;
+        if (output)
+            output.textContent = `Error: ${errorMessage}`;
+        log(`Error assigning role: ${errorMessage}`, "error");
+        await showNotification("Error", `Failed to assign role: ${errorMessage}`, "error");
+    }
+}
+/**
+ * Query existing role assignments from Power Platform Authorization API
+ * Optionally filter by principal object ID
+ */
+async function queryRoleAssignments() {
+    const output = document.getElementById("role-assignments-list-output");
+    const filterPrincipalId = document.getElementById("query-role-assign-principal-id")?.value;
+    try {
+        if (output)
+            output.textContent = "Fetching role assignments...\n";
+        // Call the Power Platform Authorization API to get role assignments
+        const result = await powerplatform.Authorization.Get("roleAssignments?api-version=2024-10-01");
+        if (output) {
+            const roleAssignments = result.value || [];
+            // Filter by principal object ID if provided
+            let filteredAssignments = roleAssignments;
+            if (filterPrincipalId && filterPrincipalId.trim()) {
+                filteredAssignments = roleAssignments.filter((assignment) => assignment.principalObjectId === filterPrincipalId);
+                output.textContent = `Found ${filteredAssignments.length} role assignment(s) for principal ${filterPrincipalId}:\n\n`;
+            }
+            else {
+                output.textContent = `Found ${roleAssignments.length} total role assignment(s):\n\n`;
+            }
+            if (filteredAssignments.length === 0) {
+                output.textContent += "No role assignments found.";
+            }
+            else {
+                // Display role assignments in a formatted table
+                filteredAssignments.forEach((assignment, index) => {
+                    output.textContent += `${index + 1}. Role Assignment ID: ${assignment.roleAssignmentId || assignment.id}\n`;
+                    output.textContent += `   Role Definition ID: ${assignment.roleDefinitionId}\n`;
+                    output.textContent += `   Principal Object ID: ${assignment.principalObjectId}\n`;
+                    output.textContent += `   Principal Type: ${assignment.principalType}\n`;
+                    output.textContent += `   Scope: ${assignment.scope}\n`;
+                    output.textContent += "\n";
+                });
+            }
+            log(`Retrieved ${filteredAssignments.length} role assignment(s)${filterPrincipalId ? ` for ${filterPrincipalId}` : ""}`, "success");
+            await showNotification("Role Assignments Retrieved", `Found ${filteredAssignments.length} role assignment(s)`, "success");
+        }
+    }
+    catch (error) {
+        const errorMessage = error.message;
+        if (output)
+            output.textContent = `Error: ${errorMessage}`;
+        log(`Error querying role assignments: ${errorMessage}`, "error");
+        await showNotification("Error", `Failed to retrieve role assignments: ${errorMessage}`, "error");
+    }
+}
 // Initialize when DOM is ready
 if (document.readyState === "loading") {
     document.addEventListener("DOMContentLoaded", initialize);

package/dist/index.html

@@ -220,6 +220,84 @@
                     </div>
                     <div id="governance-output" class="output"></div>
                 </div>
+
+                <div class="example-group">
+                    <h3>Authorization API</h3>
+                    <div class="button-group">
+                        <button id="query-role-definitions-btn" class="btn btn-primary">Query Role Definitions</button>
+                    </div>
+                    <div id="role-definitions-output" class="output"></div>
+                </div>
+
+                <div class="example-group">
+                    <h3>Authorization API - Role Assignment</h3>
+                    <div class="input-group">
+                        <label for="role-assign-tenant-id">Tenant ID:</label>
+                        <input type="text" id="role-assign-tenant-id" placeholder="e.g., 15263562-2ed2-4856-8562-42edf998128b" />
+                    </div>
+                    <div class="input-group">
+                        <label for="role-assign-principal-object-id">Principal Object ID:</label>
+                        <input type="text" id="role-assign-principal-object-id" placeholder="e.g., 78541268-7456-7856-a7ba-04424f177c7c" />
+                    </div>
+                    <div class="input-group">
+                        <label for="role-assign-principal-type">Principal Type:</label>
+                        <select id="role-assign-principal-type">
+                            <option value="ApplicationUser">ApplicationUser</option>
+                            <option value="ServicePrincipal">ServicePrincipal</option>
+                            <option value="User">User</option>
+                        </select>
+                    </div>
+                    <div class="input-group">
+                        <label for="role-assign-role-definition-id">Role Definition ID:</label>
+                        <input type="text" id="role-assign-role-definition-id" placeholder="e.g., ff954d61-a89a-4fbe-ace9-01c367b89f87" />
+                    </div>
+                    <div class="button-group">
+                        <button id="assign-role-btn" class="btn btn-success">Assign Role</button>
+                    </div>
+                    <div id="role-assignment-output" class="output"></div>
+                </div>
+
+                <div class="example-group">
+                    <h3>Authorization API - Query Role Assignments</h3>
+                    <div class="input-group">
+                        <label for="query-role-assign-principal-id">Principal Object ID (Optional - filters results):</label>
+                        <input type="text" id="query-role-assign-principal-id" placeholder="e.g., 78541268-7456-7856-a7ba-04424f177c7c" />
+                    </div>
+                    <div class="button-group">
+                        <button id="query-role-assignments-btn" class="btn">Query Role Assignments</button>
+                    </div>
+                    <div id="role-assignments-list-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 -->

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.2.4-beta.0",
+                "@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,15 +69,31 @@
             }
         },
         "node_modules/@pptb/types": {
-            "version": "1.2.4-beta.0",
-            "resolved": "https://registry.npmjs.org/@pptb/types/-/types-1.2.4-beta.0.tgz",
-            "integrity": "sha512-KEY2RjPkxaMkv3XOF48pzGlTiGT2bWdseUgsr2YA9itGkjMj8zegSUiqU6Rb2SA6omdPy1HzD2v5iEB3G4R7ZQ==",
+            "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",
+            "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",
             "resolved": "https://registry.npmjs.org/braces/-/braces-3.0.3.tgz",
@@ -78,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",
@@ -323,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",
@@ -592,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",
@@ -638,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.2.0",
+    "version": "1.2.2",
     "displayName": "HTML Sample Tool",
     "description": "A sample Power Platform ToolBox tool built with HTML, CSS, and TypeScript",
     "main": "index.html",
@@ -45,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.2.4-beta.0",
+        "@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"
+                }
+            }
+        }
+    }
+}