Merge branch 'main' of github.com:notifo-io/notifo

backend/src/Notifo.Domain/Liquid/LiquidApp.cs

@@ -19,6 +19,6 @@ public sealed class LiquidApp(App app)
     public static void Describe(LiquidProperties properties)
     {
         properties.AddString("name",
-            "The name of the app.");
+            "The name of the app. Cannot be null or undefined.");
     }
 }

backend/src/Notifo.Domain/Liquid/LiquidNotificationBase.cs

@@ -52,18 +52,21 @@ protected LiquidNotificationBase(
     protected static void DescribeBase(LiquidProperties properties)
     {
         properties.AddString("subject",
-            "The notification subject.");
+            "The notification subject. Cannot be null or undefined.");
 
         properties.AddString("body",
-            "The notification body. Can be null.");
+            "The notification body. Can be null or undefined.");
 
         properties.AddString("linkUrl",
-            "The link URL. Can be null.");
+            "The link URL. Can be null or undefined.");
+
+        properties.AddString("linkText",
+            "The link text that can be set when a linkUrl is set. Can be null or undefined.");
 
         properties.AddString("imageSmall",
-            "The URL to the small image. Optimized for the current use case (e.g. emails). Can be null.");
+            "The URL to the small image. Optimized for the current use case (e.g. emails). Can be null or undefined.");
 
         properties.AddString("imageLarge",
-            "The URL to the large image. Optimized for the current use case (e.g. emails). Can be null.");
+            "The URL to the large image. Optimized for the current use case (e.g. emails). Can be null or undefined.");
     }
 }

backend/src/Notifo.Domain/Liquid/LiquidPropertiesProvider.cs

@@ -5,6 +5,8 @@
 //  All rights reserved. Licensed under the MIT license.
 // ==========================================================================
 
+#pragma warning disable CA1822 // Mark members as static
+
 namespace Notifo.Domain.Liquid;
 
 public sealed class LiquidPropertiesProvider

backend/src/Notifo.Domain/Liquid/LiquidProperty.cs

@@ -36,11 +36,10 @@ public void AddBoolean(string path, string? description = null)
 
     public void AddObject(string path, Action inner, string? description = null)
     {
-        pathStack.Push(path);
-
         Add(new LiquidProperty(FullPath(path), LiquidPropertyType.Object, description));
-        inner();
 
+        pathStack.Push(path);
+        inner();
         pathStack.Pop();
     }
 

backend/src/Notifo.Domain/Liquid/LiquidUser.cs

@@ -23,12 +23,12 @@ public sealed class LiquidUser(User user)
     public static void Describe(LiquidProperties properties)
     {
         properties.AddString("fullName",
-            "The full name of the user.");
+            "The full name of the user. Can be null or undefined.");
 
         properties.AddString("emailAddress",
-            "The email address of the user.");
+            "The email address of the user. Can be null or undefined.");
 
         properties.AddString("phoneNumber",
-            "The phone number of the user.");
+            "The phone number of the user. Can be null or undefined.");
     }
 }

backend/src/Notifo.Domain/Utils/UtilsServiceExtensions.cs

@@ -5,6 +5,7 @@
 //  All rights reserved. Licensed under the MIT license.
 // ==========================================================================
 
+using Notifo.Domain.Liquid;
 using Notifo.Domain.Utils;
 
 namespace Microsoft.Extensions.DependencyInjection;
@@ -15,5 +16,8 @@ public static void AddMyUtils(this IServiceCollection services)
     {
         services.AddSingletonAs<ImageFormatter>()
             .As<IImageFormatter>();
+
+        services.AddSingletonAs<LiquidPropertiesProvider>()
+            .AsSelf();
     }
 }

backend/src/Notifo/Areas/Api/Controllers/ChannelTemplates/ChannelTemplatesController.cs

@@ -9,6 +9,7 @@
 using Notifo.Areas.Api.Controllers.ChannelTemplates.Dtos;
 using Notifo.Domain.ChannelTemplates;
 using Notifo.Domain.Identity;
+using Notifo.Domain.Liquid;
 using Notifo.Infrastructure;
 using Notifo.Infrastructure.Reflection;
 using Notifo.Pipeline;
@@ -20,10 +21,12 @@ namespace Notifo.Areas.Api.Controllers.ChannelTemplates;
 public abstract class ChannelTemplatesController<T, TDto> : BaseController where T : class, new() where TDto : class, new()
 {
     private readonly IChannelTemplateStore<T> channelTemplateStore;
+    private readonly LiquidPropertiesProvider propertiesProvider;
 
-    protected ChannelTemplatesController(IChannelTemplateStore<T> channelTemplateStore)
+    protected ChannelTemplatesController(IChannelTemplateStore<T> channelTemplateStore, LiquidPropertiesProvider propertiesProvider)
     {
         this.channelTemplateStore = channelTemplateStore;
+        this.propertiesProvider = propertiesProvider;
     }
 
     /// <summary>
@@ -47,6 +50,26 @@ public async Task<ListResponseDto<ChannelTemplateDto>> GetTemplates(string appId
         return response;
     }
 
+    /// <summary>
+    /// Get the template properties.
+    /// </summary>
+    /// <param name="appId">The id of the app where the templates belong to.</param>
+    /// <response code="200">Channel templates properties returned.</response>.
+    /// <response code="404">App not found.</response>
+    [HttpGet("properties")]
+    [AppPermission(NotifoRoles.AppAdmin)]
+    public ListResponseDto<TemplatePropertyDto> GetProperties(string appId)
+    {
+        var properties = propertiesProvider.GetProperties();
+
+        var response = new ListResponseDto<TemplatePropertyDto>();
+
+        response.Items.AddRange(properties.OrderBy(x => x.Path).Select(TemplatePropertyDto.FromDomainObject));
+        response.Total = 0;
+
+        return response;
+    }
+
     /// <summary>
     /// Get the channel template by id.
     /// </summary>

backend/src/Notifo/Areas/Api/Controllers/ChannelTemplates/Dtos/TemplatePropertyDto.cs

@@ -0,0 +1,34 @@
+// ==========================================================================
+//  Notifo.io
+// ==========================================================================
+//  Copyright (c) Sebastian Stehle
+//  All rights reserved. Licensed under the MIT license.
+// ==========================================================================
+
+using Notifo.Domain.Liquid;
+using Notifo.Infrastructure.Reflection;
+
+namespace Notifo.Areas.Api.Controllers.ChannelTemplates.Dtos;
+
+public sealed class TemplatePropertyDto
+{
+    /// <summary>
+    /// The property path.
+    /// </summary>
+    public string Path { get; set; }
+
+    /// <summary>
+    /// The data ty.
+    /// </summary>
+    public LiquidPropertyType Type { get; set; }
+
+    /// <summary>
+    /// The optional description.
+    /// </summary>
+    public string? Description { get; set; }
+
+    public static TemplatePropertyDto FromDomainObject(LiquidProperty source)
+    {
+        return SimpleMapper.Map(source, new TemplatePropertyDto());
+    }
+}

backend/src/Notifo/Areas/Api/Controllers/ChannelTemplates/EmailTemplatesController.cs

@@ -9,15 +9,16 @@
 using Notifo.Areas.Api.Controllers.ChannelTemplates.Dtos;
 using Notifo.Domain.Channels.Email;
 using Notifo.Domain.ChannelTemplates;
+using Notifo.Domain.Liquid;
 
 namespace Notifo.Areas.Api.Controllers.ChannelTemplates;
 
 [Route("api/apps/{appId:notEmpty}/email-templates")]
 [ApiExplorerSettings(GroupName = "EmailTemplates")]
 public sealed class EmailTemplatesController : ChannelTemplatesController<EmailTemplate, EmailTemplateDto>
 {
-    public EmailTemplatesController(IChannelTemplateStore<EmailTemplate> channelTemplateStore)
-        : base(channelTemplateStore)
+    public EmailTemplatesController(IChannelTemplateStore<EmailTemplate> channelTemplateStore, LiquidPropertiesProvider propertiesProvider)
+        : base(channelTemplateStore, propertiesProvider)
     {
     }
 }

backend/src/Notifo/Areas/Api/Controllers/ChannelTemplates/MessagingTemplatesController.cs

@@ -9,15 +9,16 @@
 using Notifo.Areas.Api.Controllers.ChannelTemplates.Dtos;
 using Notifo.Domain.Channels.Messaging;
 using Notifo.Domain.ChannelTemplates;
+using Notifo.Domain.Liquid;
 
 namespace Notifo.Areas.Api.Controllers.ChannelTemplates;
 
 [Route("api/apps/{appId:notEmpty}/messaging-templates")]
 [ApiExplorerSettings(GroupName = "MessagingTemplates")]
 public sealed class MessagingTemplatesController : ChannelTemplatesController<MessagingTemplate, MessagingTemplateDto>
 {
-    public MessagingTemplatesController(IChannelTemplateStore<MessagingTemplate> channelTemplateStore)
-        : base(channelTemplateStore)
+    public MessagingTemplatesController(IChannelTemplateStore<MessagingTemplate> channelTemplateStore, LiquidPropertiesProvider propertiesProvider)
+        : base(channelTemplateStore, propertiesProvider)
     {
     }
 }

backend/src/Notifo/Areas/Api/Controllers/ChannelTemplates/SmsTemplatesController.cs

@@ -9,15 +9,16 @@
 using Notifo.Areas.Api.Controllers.ChannelTemplates.Dtos;
 using Notifo.Domain.Channels.Sms;
 using Notifo.Domain.ChannelTemplates;
+using Notifo.Domain.Liquid;
 
 namespace Notifo.Areas.Api.Controllers.ChannelTemplates;
 
 [Route("api/apps/{appId:notEmpty}/sms-templates")]
 [ApiExplorerSettings(GroupName = "SmsTemplates")]
 public sealed class SmsTemplatesController : ChannelTemplatesController<SmsTemplate, SmsTemplateDto>
 {
-    public SmsTemplatesController(IChannelTemplateStore<SmsTemplate> channelTemplateStore)
-        : base(channelTemplateStore)
+    public SmsTemplatesController(IChannelTemplateStore<SmsTemplate> channelTemplateStore, LiquidPropertiesProvider propertiesProvider)
+        : base(channelTemplateStore, propertiesProvider)
     {
     }
 }

frontend/package.json

@@ -32,8 +32,8 @@
     "react-popper": "2.3.0",
     "react-push-preview": "^0.1.9",
     "react-redux": "8.1.3",
-    "react-router": "6.19.0",
-    "react-router-dom": "6.19.0",
+    "react-router": "6.22.3",
+    "react-router-dom": "6.22.3",
     "react-router-redux": "4.0.8",
     "react-split": "2.0.14",
     "react-toastify": "^9.1.3",

frontend/src/app/framework/index.ts

@@ -11,6 +11,7 @@ export * from './model';
 export * from './react/ApiValue';
 export * from './react/ClickOutside';
 export * from './react/Code';
+export * from './react/CodeEditor';
 export * from './react/Confirm';
 export * from './react/DropZone';
 export * from './react/ErrorBoundary';
@@ -20,7 +21,6 @@ export * from './react/FormControlError';
 export * from './react/FormError';
 export * from './react/Gist';
 export * from './react/hooks';
-export * from './react/Marker';
 export * from './react/Icon';
 export * from './react/IFrame';
 export * from './react/LanguageSelector';

frontend/src/app/framework/react/Code.tsx

@@ -40,6 +40,7 @@ export const Code = (props: CodeProps) => {
         const editor = CodeMirror.fromTextArea(textarea, {
             foldGutter: true,
             gutters: [
+                'CodeMirror-lint-markers',
                 'CodeMirror-linenumbers',
                 'CodeMirror-foldgutter',
             ],
@@ -48,6 +49,7 @@ export const Code = (props: CodeProps) => {
             lineNumbers: true,
             lineSeparator: undefined,
             lineWrapping: false,
+            theme: 'material',
             readOnly: true,
             tabindex: 0,
             tabSize: 2,

frontend/src/app/framework/react/CodeEditor.stories.tsx

@@ -0,0 +1,28 @@
+/*
+ * Notifo.io
+ *
+ * @license
+ * Copyright (c) Sebastian Stehle. All rights reserved.
+ */
+
+import type { Meta, StoryObj } from '@storybook/react';
+import * as React from 'react';
+import { CodeEditor } from './CodeEditor';
+
+const meta: Meta<typeof CodeEditor> = {
+    component: CodeEditor,
+    render: args => {
+        // eslint-disable-next-line react-hooks/rules-of-hooks
+        const [value, setValue] = React.useState('Code');
+
+        return (
+            <CodeEditor {...args} value={value} onChange={setValue} />
+        );
+
+    },
+};
+
+export default meta;
+type Story = StoryObj<typeof CodeEditor>;
+
+export const Default: Story = {};