Merge pull request #15 from jcdcdev/dev/v16

16.1.0

Author: jcdcdev

.github/README.md

@@ -1,22 +1,23 @@
-# Umbraco.Community.SimpleTrees
-
-[![Umbraco Marketplace](https://img.shields.io/badge/Umbraco-Marketplace-%233544B1?style=flat&logo=umbraco)](https://marketplace.umbraco.com/package/Umbraco.Community.SimpleTrees)
-[![License](https://img.shields.io/github/license/jcdcdev/Umbraco.Community.SimpleTrees?color=8AB803&label=License&logo=github)](https://github.com/jcdcdev/Umbraco.Community.SimpleTrees?tab=MIT-1-ov-file)
-[![NuGet Downloads](https://img.shields.io/nuget/dt/Umbraco.Community.SimpleTrees?color=cc9900&label=Downloads&logo=nuget)](https://www.nuget.org/packages/Umbraco.Community.SimpleTrees)
-[![Project Website](https://img.shields.io/badge/Project%20Website-jcdc.dev-jcdcdev?style=flat&color=3c4834&logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIxNiIgaGVpZ2h0PSIxNiIgZmlsbD0id2hpdGUiIGNsYXNzPSJiaSBiaS1wYy1kaXNwbGF5IiB2aWV3Qm94PSIwIDAgMTYgMTYiPgogIDxwYXRoIGQ9Ik04IDFhMSAxIDAgMCAxIDEtMWg2YTEgMSAwIDAgMSAxIDF2MTRhMSAxIDAgMCAxLTEgMUg5YTEgMSAwIDAgMS0xLTF6bTEgMTMuNWEuNS41IDAgMSAwIDEgMCAuNS41IDAgMCAwLTEgMG0yIDBhLjUuNSAwIDEgMCAxIDAgLjUuNSAwIDAgMC0xIDBNOS41IDFhLjUuNSAwIDAgMCAwIDFoNWEuNS41IDAgMCAwIDAtMXpNOSAzLjVhLjUuNSAwIDAgMCAuNS41aDVhLjUuNSAwIDAgMCAwLTFoLTVhLjUuNSAwIDAgMC0uNS41TTEuNSAyQTEuNSAxLjUgMCAwIDAgMCAzLjV2N0ExLjUgMS41IDAgMCAwIDEuNSAxMkg2djJoLS41YS41LjUgMCAwIDAgMCAxSDd2LTRIMS41YS41LjUgMCAwIDEtLjUtLjV2LTdhLjUuNSAwIDAgMSAuNS0uNUg3VjJ6Ii8+Cjwvc3ZnPg==)](https://jcdc.dev/umbraco-packages/simple-trees)
-
-
+# Umbraco.Community.SimpleTrees
+
+[![Umbraco Marketplace](https://img.shields.io/badge/Umbraco-Marketplace-%233544B1?style=flat&logo=umbraco)](https://marketplace.umbraco.com/package/Umbraco.Community.SimpleTrees)
+[![License](https://img.shields.io/github/license/jcdcdev/Umbraco.Community.SimpleTrees?color=8AB803&label=License&logo=github)](https://github.com/jcdcdev/Umbraco.Community.SimpleTrees?tab=MIT-1-ov-file)
+[![NuGet Downloads](https://img.shields.io/nuget/dt/Umbraco.Community.SimpleTrees?color=cc9900&label=Downloads&logo=nuget)](https://www.nuget.org/packages/Umbraco.Community.SimpleTrees)
+[![Project Website](https://img.shields.io/badge/Project%20Website-jcdc.dev-jcdcdev?style=flat&color=3c4834&logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIxNiIgaGVpZ2h0PSIxNiIgZmlsbD0id2hpdGUiIGNsYXNzPSJiaSBiaS1wYy1kaXNwbGF5IiB2aWV3Qm94PSIwIDAgMTYgMTYiPgogIDxwYXRoIGQ9Ik04IDFhMSAxIDAgMCAxIDEtMWg2YTEgMSAwIDAgMSAxIDF2MTRhMSAxIDAgMCAxLTEgMUg5YTEgMSAwIDAgMS0xLTF6bTEgMTMuNWEuNS41IDAgMSAwIDEgMCAuNS41IDAgMCAwLTEgMG0yIDBhLjUuNSAwIDEgMCAxIDAgLjUuNSAwIDAgMC0xIDBNOS41IDFhLjUuNSAwIDAgMCAwIDFoNWEuNS41IDAgMCAwIDAtMXpNOSAzLjVhLjUuNSAwIDAgMCAuNS41aDVhLjUuNSAwIDAgMCAwLTFoLTVhLjUuNSAwIDAgMC0uNS41TTEuNSAyQTEuNSAxLjUgMCAwIDAgMCAzLjV2N0ExLjUgMS41IDAgMCAwIDEuNSAxMkg2djJoLS41YS41LjUgMCAwIDAgMCAxSDd2LTRIMS41YS41LjUgMCAwIDEtLjUtLjV2LTdhLjUuNSAwIDAgMSAuNS0uNUg3VjJ6Ii8+Cjwvc3ZnPg==)](https://jcdc.dev/umbraco-packages/simple-trees)
+
+
 This packages aims to help developers quickly put together Umbraco Trees using C#.
 
 ## Features
 
 - C# custom tree creation
 - No javascript or umbraco-package.json files required
 - Supports both Views & View Components
-- Easy to define section permissions
-
-## Quick Start
-
+- Easy to define section permissions
+- ✨ Custom Entity Actions!
+
+## Quick Start
+
 ### Install Package
 
 ```csharp
@@ -29,7 +30,7 @@ By default, this will display in the content section.
 
 ```csharp title="ExampleTree.cs"
 using Umbraco.Cms.Core.Models;
-using Umbraco.Community.SimpleTrees.Models;
+using Umbraco.Community.SimpleTrees.Core.Models;
 
 namespace Umbraco.Community.SimpleTrees.TestSite.Trees;
 
@@ -78,17 +79,101 @@ public class MyTree : SimpleTree
 		</table>
 	</div>
 </uui-box>
-```
-
-
-
-## Contributing
-
-Contributions to this package are most welcome! Please visit the [Contributing](https://github.com/jcdcdev/Umbraco.Community.SimpleTrees/contribute) page.
-
-## Acknowledgements (Thanks)
-
-- LottePitcher - [opinionated-package-starter](https://github.com/LottePitcher/opinionated-package-starter)
-
-
+```
+
+
+## Extending
+
+### Entity Actions
+
+It is possible to implement two Entity Actions
+
+#### Url Actions
+
+When clicked, the user will be taken to the specific URL.
+
+```csharp title="NuGetPackageItemEntityUrlAction.cs"
+using Umbraco.Community.SimpleTrees.Core.Models;
+
+namespace Umbraco.Community.SimpleTrees.TestSite.Trees;
+
+public class NuGetPackageItemEntityUrlAction : SimpleEntityUrlAction
+{
+    public override string Icon => "icon-link";
+    public override string Name => "Go to Package";
+    public override Type[] ForTreeItems => [typeof(NuGetPackageTree)];
+    public override Type[] ForSimpleEntityTypes => [typeof(NuGetPackageVersionEntityType)];
+
+    public override Task<Uri> GetUrlAsync(string unique, string entityType)
+    {
+        var uri = new Uri("https://www.nuget.org/packages/" + unique);
+        return Task.FromResult(uri);
+    }
+}
+```
+
+#### Execute Actions
+
+When clicked, you custom logic will be executed. You can also return a helpful response to the user.
+
+```csharp title="NuGetPackageItemEntityExecuteAction"
+using System.Net.Http.Headers;
+using Umbraco.Community.SimpleTrees.Core.Models;
+using Umbraco.Community.SimpleTrees.Web.Models;
+
+namespace Umbraco.Community.SimpleTrees.TestSite.Trees;
+
+public class NuGetPackageItemEntityExecuteAction : SimpleEntityExecuteAction
+{
+    private readonly HttpClient _client;
+
+    public NuGetPackageItemEntityExecuteAction(HttpClient client)
+    {
+        var url = "https://functions.marketplace.umbraco.com/api/";
+        client.BaseAddress = new Uri(url);
+        client.DefaultRequestHeaders.UserAgent.Add(new ProductInfoHeaderValue("Umbraco.Community.SimpleTrees.TestSite", "1.0"));
+        _client = client;
+    }
+
+    public override string Icon => "icon-refresh";
+    public override string Name => "Sync Package";
+    public override Type[] ForTreeItems => [typeof(NuGetPackageTree)];
+
+    public override async Task<SimpleEntityActionExecuteResponse> ExecuteAsync(string unique, string entityType)
+    {
+        try
+        {
+            var split = unique.Split('_');
+            var packageId = split[0];
+            var model = new MarketplaceRequest
+            {
+                PackageId = packageId,
+            };
+
+            var result = await _client.PostAsJsonAsync("InitiateSinglePackageSyncFunction", model);
+            if (!result.IsSuccessStatusCode)
+            {
+                return SimpleEntityActionExecuteResponse.Error("Failed to initiate package update", $"Status Code: {result.StatusCode}, Reason: {result.ReasonPhrase}");
+            }
+
+            var message = $"Package {packageId} update has been initiated. You can check the progress in the Umbraco Marketplace.";
+            return SimpleEntityActionExecuteResponse.Success("Package update initiated successfully", message);
+        }
+        catch (Exception ex)
+        {
+            return SimpleEntityActionExecuteResponse.Error("An error occurred while initiating the package update", ex.Message);
+        }
+    }
+}
+```
+
+## Contributing
+
+Contributions to this package are most welcome! Please visit the [Contributing](https://github.com/jcdcdev/Umbraco.Community.SimpleTrees/contribute) page.
+
+## Acknowledgements (Thanks)
+
+- LottePitcher - [opinionated-package-starter](https://github.com/LottePitcher/opinionated-package-starter)
+
+
 

SECURITY.md

@@ -1,55 +1,55 @@
-# Security Policy
-
-## Supported Versions
-
-The following table outlines the versions of the project that are currently supported with security & feature updates:
-
-> [!NOTE]
-> Once a version starts its security phase, it will no longer receive feature updates. Only critical bug fixes and security updates will be provided.
-
-| Package Version                                                                            | Umbraco Version | Security Phase Start | End of Life |
+# Security Policy
+
+## Supported Versions
+
+The following table outlines the versions of the project that are currently supported with security & feature updates:
+
+> [!NOTE]
+> Once a version starts its security phase, it will no longer receive feature updates. Only critical bug fixes and security updates will be provided.
+
+| Package Version                                                                            | Umbraco Version | Security Phase Start | End of Life |
 | ---------------------------------------------------------------------------------- | --------------- | -------------------- | ----------- |
 | [15.x](https://github.com/jcdcdev/Umbraco.Community.SimpleTrees/tree/v15) | 15 | 2025-08-14 | 2025-11-14 |
-| [16.x](https://github.com/jcdcdev/Umbraco.Community.SimpleTrees/tree/v16) | 16 | 2026-03-12 | 2026-06-12 |
-
-
-## Future Support
-
-Project maintainers plan to support all STS (Short-Term Support) and LTS (Long-Term Support) versions of Umbraco. However, exact release dates cannot be guaranteed.
-
-> [!NOTE]
-> Visit [jcdc.dev/blog/umbraco-version-information](https://jcdc.dev/blog/umbraco-version-information) for more information on Umbraco versions.
-
-## Reporting a Vulnerability
-
-If you discover a vulnerability in this project, please follow one of these steps to report it:
-
-- Create an [issue](https://github.com/jcdcdev/Umbraco.Community.SimpleTrees/security/advisories/new)
-- Contact the project author privately at [jcdc.dev/contact](https://jcdc.dev/contact)
-
-### Details
-
-Include as much information as possible about the vulnerability, including:
-
-- Steps to reproduce
-- Potential impact
-- Any suggested fixes
-
-### Acknowledgment
-
-You will receive an acknowledgment of your report as soon as possible.
-
-> [!NOTE]
-> Response times may vary depending on other commitments.
-
-### Resolution
-
-Once the vulnerability is confirmed, project maintainers will work to resolve it as quickly as possible.
-
-You will be notified once the issue has been resolved or rejected.
-
-> [!TIP]
-> If the vulnerability is accepted, you will receive credit in the release notes.
-
-Thank you for helping to keep this project secure!
+| [16.x](https://github.com/jcdcdev/Umbraco.Community.SimpleTrees/tree/v16) | 16 | 2026-03-12 | 2026-06-12 |
+
+
+## Future Support
+
+Project maintainers plan to support all STS (Short-Term Support) and LTS (Long-Term Support) versions of Umbraco. However, exact release dates cannot be guaranteed.
+
+> [!NOTE]
+> Visit [jcdc.dev/blog/umbraco-version-information](https://jcdc.dev/blog/umbraco-version-information) for more information on Umbraco versions.
+
+## Reporting a Vulnerability
+
+If you discover a vulnerability in this project, please follow one of these steps to report it:
+
+- Create an [issue](https://github.com/jcdcdev/Umbraco.Community.SimpleTrees/security/advisories/new)
+- Contact the project author privately at [jcdc.dev/contact](https://jcdc.dev/contact)
+
+### Details
+
+Include as much information as possible about the vulnerability, including:
+
+- Steps to reproduce
+- Potential impact
+- Any suggested fixes
+
+### Acknowledgment
+
+You will receive an acknowledgment of your report as soon as possible.
+
+> [!NOTE]
+> Response times may vary depending on other commitments.
+
+### Resolution
+
+Once the vulnerability is confirmed, project maintainers will work to resolve it as quickly as possible.
+
+You will be notified once the issue has been resolved or rejected.
+
+> [!TIP]
+> If the vulnerability is accepted, you will receive credit in the release notes.
+
+Thank you for helping to keep this project secure!
 

docs/README_nuget.md

@@ -1,23 +1,24 @@
-# Umbraco.Community.SimpleTrees
-
-[![Documentation](https://img.shields.io/badge/Docs-Quickstart-394933?style=flat&logo=github)](https://github.com/jcdcdev/Umbraco.Community.SimpleTrees#quick-start)
-[![Umbraco Marketplace](https://img.shields.io/badge/Umbraco-Marketplace-%233544B1?style=flat&logo=umbraco)](https://marketplace.umbraco.com/package/Umbraco.Community.SimpleTrees)
-[![License](https://img.shields.io/github/license/jcdcdev/Umbraco.Community.SimpleTrees?color=8AB803&label=License&logo=github)](https://github.com/jcdcdev/Umbraco.Community.SimpleTrees?tab=MIT-1-ov-file)
-[![NuGet Downloads](https://img.shields.io/nuget/dt/Umbraco.Community.SimpleTrees?color=cc9900&label=Downloads&logo=nuget)](https://www.nuget.org/packages/Umbraco.Community.SimpleTrees)
-[![Project Website](https://img.shields.io/badge/Project%20Website-jcdc.dev-jcdcdev?style=flat&color=3c4834&logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIxNiIgaGVpZ2h0PSIxNiIgZmlsbD0id2hpdGUiIGNsYXNzPSJiaSBiaS1wYy1kaXNwbGF5IiB2aWV3Qm94PSIwIDAgMTYgMTYiPgogIDxwYXRoIGQ9Ik04IDFhMSAxIDAgMCAxIDEtMWg2YTEgMSAwIDAgMSAxIDF2MTRhMSAxIDAgMCAxLTEgMUg5YTEgMSAwIDAgMS0xLTF6bTEgMTMuNWEuNS41IDAgMSAwIDEgMCAuNS41IDAgMCAwLTEgMG0yIDBhLjUuNSAwIDEgMCAxIDAgLjUuNSAwIDAgMC0xIDBNOS41IDFhLjUuNSAwIDAgMCAwIDFoNWEuNS41IDAgMCAwIDAtMXpNOSAzLjVhLjUuNSAwIDAgMCAuNS41aDVhLjUuNSAwIDAgMCAwLTFoLTVhLjUuNSAwIDAgMC0uNS41TTEuNSAyQTEuNSAxLjUgMCAwIDAgMCAzLjV2N0ExLjUgMS41IDAgMCAwIDEuNSAxMkg2djJoLS41YS41LjUgMCAwIDAgMCAxSDd2LTRIMS41YS41LjUgMCAwIDEtLjUtLjV2LTdhLjUuNSAwIDAgMSAuNS0uNUg3VjJ6Ii8+Cjwvc3ZnPg==)](https://jcdc.dev/umbraco-packages/simple-trees)
-
-
+# Umbraco.Community.SimpleTrees
+
+[![Documentation](https://img.shields.io/badge/Docs-Quickstart-394933?style=flat&logo=github)](https://github.com/jcdcdev/Umbraco.Community.SimpleTrees#quick-start)
+[![Umbraco Marketplace](https://img.shields.io/badge/Umbraco-Marketplace-%233544B1?style=flat&logo=umbraco)](https://marketplace.umbraco.com/package/Umbraco.Community.SimpleTrees)
+[![License](https://img.shields.io/github/license/jcdcdev/Umbraco.Community.SimpleTrees?color=8AB803&label=License&logo=github)](https://github.com/jcdcdev/Umbraco.Community.SimpleTrees?tab=MIT-1-ov-file)
+[![NuGet Downloads](https://img.shields.io/nuget/dt/Umbraco.Community.SimpleTrees?color=cc9900&label=Downloads&logo=nuget)](https://www.nuget.org/packages/Umbraco.Community.SimpleTrees)
+[![Project Website](https://img.shields.io/badge/Project%20Website-jcdc.dev-jcdcdev?style=flat&color=3c4834&logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIxNiIgaGVpZ2h0PSIxNiIgZmlsbD0id2hpdGUiIGNsYXNzPSJiaSBiaS1wYy1kaXNwbGF5IiB2aWV3Qm94PSIwIDAgMTYgMTYiPgogIDxwYXRoIGQ9Ik04IDFhMSAxIDAgMCAxIDEtMWg2YTEgMSAwIDAgMSAxIDF2MTRhMSAxIDAgMCAxLTEgMUg5YTEgMSAwIDAgMS0xLTF6bTEgMTMuNWEuNS41IDAgMSAwIDEgMCAuNS41IDAgMCAwLTEgMG0yIDBhLjUuNSAwIDEgMCAxIDAgLjUuNSAwIDAgMC0xIDBNOS41IDFhLjUuNSAwIDAgMCAwIDFoNWEuNS41IDAgMCAwIDAtMXpNOSAzLjVhLjUuNSAwIDAgMCAuNS41aDVhLjUuNSAwIDAgMCAwLTFoLTVhLjUuNSAwIDAgMC0uNS41TTEuNSAyQTEuNSAxLjUgMCAwIDAgMCAzLjV2N0ExLjUgMS41IDAgMCAwIDEuNSAxMkg2djJoLS41YS41LjUgMCAwIDAgMCAxSDd2LTRIMS41YS41LjUgMCAwIDEtLjUtLjV2LTdhLjUuNSAwIDAgMSAuNS0uNUg3VjJ6Ii8+Cjwvc3ZnPg==)](https://jcdc.dev/umbraco-packages/simple-trees)
+
+
 This packages aims to help developers quickly put together Umbraco Trees using C#.
 
 ## Features
 
 - C# custom tree creation
 - No javascript or umbraco-package.json files required
 - Supports both Views & View Components
-- Easy to define section permissions
-
-## Quick Start
-
+- Easy to define section permissions
+- ✨ Custom Entity Actions!
+
+## Quick Start
+
 ### Install Package
 
 ```csharp
@@ -30,7 +31,7 @@ By default, this will display in the content section.
 
 ```csharp title="ExampleTree.cs"
 using Umbraco.Cms.Core.Models;
-using Umbraco.Community.SimpleTrees.Models;
+using Umbraco.Community.SimpleTrees.Core.Models;
 
 namespace Umbraco.Community.SimpleTrees.TestSite.Trees;
 
@@ -79,16 +80,16 @@ public class MyTree : SimpleTree
 		</table>
 	</div>
 </uui-box>
-```
-
-
-## Contributing
-
-Contributions to this package are most welcome! Please visit the [Contributing](https://github.com/jcdcdev/Umbraco.Community.SimpleTrees/contribute) page.
-
-## Acknowledgements (Thanks)
-
-- LottePitcher - [opinionated-package-starter](https://github.com/LottePitcher/opinionated-package-starter)
-
-
+```
+
+
+## Contributing
+
+Contributions to this package are most welcome! Please visit the [Contributing](https://github.com/jcdcdev/Umbraco.Community.SimpleTrees/contribute) page.
+
+## Acknowledgements (Thanks)
+
+- LottePitcher - [opinionated-package-starter](https://github.com/LottePitcher/opinionated-package-starter)
+
+
 

docs/screenshots/custom-entity-actions.png

@@ -1,7 +1,7 @@
 // This file is auto-generated by @hey-api/openapi-ts
 
 import type { Options as ClientOptions, TDataShape, Client } from './client';
-import type { GetUmbracoSimpleTreesApiV1TreeItemsData, GetUmbracoSimpleTreesApiV1TreeItemsResponses, GetUmbracoSimpleTreesApiV1TreeRenderData, GetUmbracoSimpleTreesApiV1TreeRenderResponses, GetUmbracoSimpleTreesApiV1TreeRootData, GetUmbracoSimpleTreesApiV1TreeRootResponses } from './types.gen';
+import type { PostUmbracoSimpleTreesApiV1EntityActionExecuteData, PostUmbracoSimpleTreesApiV1EntityActionExecuteResponses, PostUmbracoSimpleTreesApiV1EntityActionUrlData, PostUmbracoSimpleTreesApiV1EntityActionUrlResponses, GetUmbracoSimpleTreesApiV1TreeItemsData, GetUmbracoSimpleTreesApiV1TreeItemsResponses, GetUmbracoSimpleTreesApiV1TreeRenderData, GetUmbracoSimpleTreesApiV1TreeRenderResponses, GetUmbracoSimpleTreesApiV1TreeRootData, GetUmbracoSimpleTreesApiV1TreeRootResponses } from './types.gen';
 import { client as _heyApiClient } from './client.gen';
 
 export type Options<TData extends TDataShape = TDataShape, ThrowOnError extends boolean = boolean> = ClientOptions<TData, ThrowOnError> & {
@@ -19,6 +19,28 @@ export type Options<TData extends TDataShape = TDataShape, ThrowOnError extends
 };
 
 export class SimpleTrees {
+    public static postUmbracoSimpleTreesApiV1EntityActionExecute<ThrowOnError extends boolean = true>(options?: Options<PostUmbracoSimpleTreesApiV1EntityActionExecuteData, ThrowOnError>) {
+        return (options?.client ?? _heyApiClient).post<PostUmbracoSimpleTreesApiV1EntityActionExecuteResponses, unknown, ThrowOnError>({
+            url: '/umbraco/SimpleTrees/api/v1/entity-action/execute',
+            ...options,
+            headers: {
+                'Content-Type': 'application/json',
+                ...options?.headers
+            }
+        });
+    }
+    
+    public static postUmbracoSimpleTreesApiV1EntityActionUrl<ThrowOnError extends boolean = true>(options?: Options<PostUmbracoSimpleTreesApiV1EntityActionUrlData, ThrowOnError>) {
+        return (options?.client ?? _heyApiClient).post<PostUmbracoSimpleTreesApiV1EntityActionUrlResponses, unknown, ThrowOnError>({
+            url: '/umbraco/SimpleTrees/api/v1/entity-action/url',
+            ...options,
+            headers: {
+                'Content-Type': 'application/json',
+                ...options?.headers
+            }
+        });
+    }
+    
     public static getUmbracoSimpleTreesApiV1TreeItems<ThrowOnError extends boolean = true>(options?: Options<GetUmbracoSimpleTreesApiV1TreeItemsData, ThrowOnError>) {
         return (options?.client ?? _heyApiClient).get<GetUmbracoSimpleTreesApiV1TreeItemsResponses, unknown, ThrowOnError>({
             url: '/umbraco/SimpleTrees/api/v1/tree/items',