Added examples.

.gitea/workflows/build.yml

@@ -1,26 +0,0 @@
-name: Build and Push Docker Image
-
-on:
-  push:
-
-jobs:
-  build:
-    runs-on: ubuntu-latest
-    container:
-      image: mcr.microsoft.com/dotnet/sdk:9.0
-    steps:
-      - name: Install Node.js and dependencies
-        run: |
-          apt-get update
-          apt-get install -y curl gnupg
-          curl -fsSL https://deb.nodesource.com/setup_18.x | bash -
-          apt-get install -y nodejs git
-
-      - name: Checkout
-        uses: actions/checkout@v3
-
-      - name: Restore dependencies
-        run: dotnet restore ./code/MessengerApi/MessengerApi.csproj
-
-      - name: Build project
-        run: dotnet build ./code/MessengerApi/MessengerApi.csproj -c Release

Directory.Packages.props

@@ -3,9 +3,10 @@
     <PackageVersion Include="Microsoft.EntityFrameworkCore" Version="9.0.6" />
     <PackageVersion Include="Microsoft.EntityFrameworkCore.Design" Version="9.0.6" />
     <PackageVersion Include="Microsoft.EntityFrameworkCore.Tools" Version="9.0.6" />
+	<PackageVersion Include="Microsoft.EntityFrameworkCore.SqlServer" Version="9.0.6" />
+	<PackageVersion Include="Npgsql.EntityFrameworkCore.PostgreSQL" Version="9.0.4" />
     <PackageVersion Include="portaloggy" Version="1.0.2" />
     <PackageVersion Include="Microsoft.AspNetCore.OpenApi" Version="9.0.0" />
-    <PackageVersion Include="Microsoft.EntityFrameworkCore.SqlServer" Version="9.0.6" />
     <PackageVersion Include="Newtonsoft.Json" Version="13.0.3" />
     <PackageVersion Include="Swashbuckle.AspNetCore" Version="7.1.0" />
   </ItemGroup>

README.md

@@ -49,9 +49,9 @@ Additional tunables, with their sustainable default values:
 - `QUERY_RATE_PER_MINUTE: 100`
   - Sets maximum allowed client query rate per minute for all endpoints. Anonymous users share same limit pool.
   - If send rate is exceeded, client receives a `HTTP 429` with explanation.
-- `DEFAULT_MESSAGE_LIFETIME_IN_MINUTES: 1`
+- `DEFAULT_MESSAGE_TIME_TO_LIVE_IN_SECONDS: 60`
   - Message will wait for delivery for set amount of time. After the time passes, a call to `/receive` will not consider it for delivery anymore.
-  - Override this in message content by setting _optional_ `lifespanInSeconds` value inside the request.
+  - Override this in message content by setting _optional_ `timeToLiveInSeconds` value inside the request.
   - There will be no indication to the sender or to client that there was a missed message. Once it's gone, it's gone.
 - `HOUSEKEEPING_ENABLED: true`
   - Turns on housekeeping job that periodically removes stale, delivered and/or acknowledged messages. You can tune this further, see below. By default, it only removes messages that are 2 hours old, regardless of their delivery or acknowledgement state.
@@ -106,7 +106,7 @@ Request:
         "payloadType": "STATUS",
         "payload": "{\n  \"system\": \"OK\",\n}",
         "toUserId": "46b882b7-4b96-4fa2-ba1b-4955a9500c36",
-        "lifespanInSeconds": "3600"
+        "timeToLiveInSeconds": "3600"
     }
 
 Response:

code/MessengerApi.Configuration/MessengerApi.Configuration.csproj

@@ -4,6 +4,7 @@
     <TargetFramework>net9.0</TargetFramework>
     <ImplicitUsings>enable</ImplicitUsings>
     <Nullable>disable</Nullable>
+	<ManagePackageVersionsCentrally>true</ManagePackageVersionsCentrally>
   </PropertyGroup>
 
 </Project>

code/MessengerApi.Configuration/Model/MessengerConfiguration.cs

@@ -31,7 +31,7 @@ namespace MessengerApi.Configuration.Model
         /// <summary>
         /// Message lifetime unless set differently in message body.
         /// </summary>
-        public int DefaultMessageLifetimeInMinutes { get; set; }
+        public int DefaultMessageTimeToLiveInSeconds { get; set; }
 
         /// <summary>
         /// If true, messages are periodically wiped to free up space.
@@ -72,7 +72,7 @@ namespace MessengerApi.Configuration.Model
             this.Origins = origins ?? [];
             this.Proxies = [];
             this.RateLimitPerMinute = 120;
-            this.DefaultMessageLifetimeInMinutes = 1;
+            this.DefaultMessageTimeToLiveInSeconds = 60;
             this.HousekeepingEnabled = true;
             this.HousekeepingMessageAgeInMinutes = 120;
             this.HousekeepingMessageState = HousekeepingMessageStates.None;
@@ -85,7 +85,7 @@ namespace MessengerApi.Configuration.Model
         {
             Populate<string>(config, Env.PROXIES, x => this.Proxies = ProxiesParser.Parse(x));
             Populate<int>(config, Env.QUERY_RATE_PER_MINUTE, x => this.RateLimitPerMinute = x);
-            Populate<int>(config, Env.DEFAULT_MESSAGE_LIFETIME_IN_MINUTES, x => this.DefaultMessageLifetimeInMinutes = x);
+            Populate<int>(config, Env.DEFAULT_MESSAGE_TIME_TO_LIVE_IN_SECONDS, x => this.DefaultMessageTimeToLiveInSeconds = x);
             Populate<bool>(config, Env.HOUSEKEEPING_ENABLED, x => this.HousekeepingEnabled = x);
             Populate<int>(config, Env.HOUSEKEEPING_MESSAGE_AGE_IN_MINUTES, x => this.HousekeepingMessageAgeInMinutes = x);
             Populate<string>(config, Env.HOUSEKEEPING_MESSAGE_STATE, x => this.HousekeepingMessageState = HousekeepingMessageStateParser.Parse(x));

code/MessengerApi.Configuration/Parsers/PersistenceTypeParser.cs

@@ -6,6 +6,11 @@ namespace MessengerApi.Configuration.Parsers
     {
         public static PersistenceTypes Parse(string value)
         {
+            if (string.IsNullOrWhiteSpace(value))
+            {
+                return PersistenceTypes.Sql;
+            }
+
             return (PersistenceTypes)Enum.Parse(typeof(PersistenceTypes), value, true);
         }
     }

code/MessengerApi.Configuration/Sources/Environment/Constants.EnvironmentVariables.cs

@@ -10,7 +10,7 @@
             public const string CORS_ORIGINS = nameof(CORS_ORIGINS);
             public const string PROXIES = nameof(PROXIES);
             public const string QUERY_RATE_PER_MINUTE = nameof(QUERY_RATE_PER_MINUTE);
-            public const string DEFAULT_MESSAGE_LIFETIME_IN_MINUTES = nameof(DEFAULT_MESSAGE_LIFETIME_IN_MINUTES);
+            public const string DEFAULT_MESSAGE_TIME_TO_LIVE_IN_SECONDS = nameof(DEFAULT_MESSAGE_TIME_TO_LIVE_IN_SECONDS);
             public const string HOUSEKEEPING_ENABLED = nameof(HOUSEKEEPING_ENABLED);
             public const string HOUSEKEEPING_MESSAGE_AGE_IN_MINUTES = nameof(HOUSEKEEPING_MESSAGE_AGE_IN_MINUTES);
             public const string HOUSEKEEPING_MESSAGE_STATE = nameof(HOUSEKEEPING_MESSAGE_STATE);

code/MessengerApi.Db.Contracts/Entities/Message.cs

@@ -20,6 +20,6 @@ namespace MessengerApi.Db.Entities
 
         public string Payload { get; set; }
 
-        public int? PayloadLifespanInSeconds { get; set; }
+        public int? TimeToLiveInSeconds { get; set; }
     }
 }

code/MessengerApi.Db.Contracts/MessengerApi.Db.Contracts.csproj

@@ -4,6 +4,7 @@
     <TargetFramework>net9.0</TargetFramework>
     <ImplicitUsings>enable</ImplicitUsings>
     <Nullable>disable</Nullable>
+	<ManagePackageVersionsCentrally>true</ManagePackageVersionsCentrally>
   </PropertyGroup>
 
 </Project>

code/MessengerApi.Db.Npg.Migrator/MessengerApi.Db.Npg.Migrator.csproj

@@ -8,10 +8,15 @@
   </PropertyGroup>
 
   <ItemGroup>
+    <PackageReference Include="Microsoft.EntityFrameworkCore" Version="9.0.6" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Design" Version="9.0.6">
       <PrivateAssets>all</PrivateAssets>
       <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
     </PackageReference>
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Tools" Version="9.0.6">
+      <PrivateAssets>all</PrivateAssets>
+      <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
+    </PackageReference>
   </ItemGroup>
 
   <ItemGroup>

code/MessengerApi.Db.Npg/MessengerApi.Db.Npg.csproj

@@ -3,11 +3,12 @@
   <PropertyGroup>
     <TargetFramework>net9.0</TargetFramework>
     <ImplicitUsings>enable</ImplicitUsings>
-    <Nullable>enable</Nullable>
+    <Nullable>disable</Nullable>
+	<ManagePackageVersionsCentrally>true</ManagePackageVersionsCentrally>
   </PropertyGroup>
 
   <ItemGroup>
-    <PackageReference Include="Npgsql.EntityFrameworkCore.PostgreSQL" Version="9.0.4" />
+    <PackageReference Include="Npgsql.EntityFrameworkCore.PostgreSQL" />
   </ItemGroup>
 
   <ItemGroup>

code/MessengerApi.Db.Npg/Migrations/20250705145537_RenameTtlColumn.Designer.cs

@@ -0,0 +1,123 @@
+// <auto-generated />
+using System;
+using MessengerApi.Db.Npg;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Infrastructure;
+using Microsoft.EntityFrameworkCore.Migrations;
+using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
+using Npgsql.EntityFrameworkCore.PostgreSQL.Metadata;
+
+#nullable disable
+
+namespace MessengerApi.Db.Npg.Migrations
+{
+    [DbContext(typeof(MessengerNpgDbContext))]
+    [Migration("20250705145537_RenameTtlColumn")]
+    partial class RenameTtlColumn
+    {
+        /// <inheritdoc />
+        protected override void BuildTargetModel(ModelBuilder modelBuilder)
+        {
+#pragma warning disable 612, 618
+            modelBuilder
+                .HasAnnotation("ProductVersion", "9.0.6")
+                .HasAnnotation("Relational:MaxIdentifierLength", 63);
+
+            NpgsqlModelBuilderExtensions.UseIdentityByDefaultColumns(modelBuilder);
+
+            modelBuilder.Entity("MessengerApi.Db.Entities.Message", b =>
+                {
+                    b.Property<Guid>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("uuid");
+
+                    b.Property<DateTime>("CreatedUtc")
+                        .HasColumnType("timestamp with time zone");
+
+                    b.Property<Guid>("FromId")
+                        .HasColumnType("uuid");
+
+                    b.Property<bool>("IsAcknowledged")
+                        .HasColumnType("boolean");
+
+                    b.Property<bool>("IsDelivered")
+                        .HasColumnType("boolean");
+
+                    b.Property<string>("Payload")
+                        .HasColumnType("text");
+
+                    b.Property<string>("PayloadType")
+                        .HasColumnType("text");
+
+                    b.Property<int>("TimeToLiveInSeconds")
+                        .HasColumnType("integer");
+
+                    b.Property<Guid>("ToId")
+                        .HasColumnType("uuid");
+
+                    b.HasKey("Id");
+
+                    b.HasIndex("ToId", "IsDelivered");
+
+                    b.ToTable("Messages");
+                });
+
+            modelBuilder.Entity("MessengerApi.Db.Entities.User", b =>
+                {
+                    b.Property<Guid>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("uuid");
+
+                    b.Property<Guid>("ApiKey")
+                        .HasColumnType("uuid");
+
+                    b.Property<bool>("IsEnabled")
+                        .HasColumnType("boolean");
+
+                    b.Property<string>("Name")
+                        .HasColumnType("text");
+
+                    b.HasKey("Id");
+
+                    b.ToTable("Users");
+                });
+
+            modelBuilder.Entity("MessengerApi.Db.Entities.UserRoute", b =>
+                {
+                    b.Property<Guid>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("uuid");
+
+                    b.Property<Guid?>("FromId")
+                        .HasColumnType("uuid");
+
+                    b.Property<Guid?>("ToId")
+                        .HasColumnType("uuid");
+
+                    b.HasKey("Id");
+
+                    b.HasIndex("FromId");
+
+                    b.HasIndex("ToId");
+
+                    b.ToTable("UserRoutes");
+                });
+
+            modelBuilder.Entity("MessengerApi.Db.Entities.UserRoute", b =>
+                {
+                    b.HasOne("MessengerApi.Db.Entities.User", "From")
+                        .WithMany()
+                        .HasForeignKey("FromId");
+
+                    b.HasOne("MessengerApi.Db.Entities.User", "To")
+                        .WithMany()
+                        .HasForeignKey("ToId");
+
+                    b.Navigation("From");
+
+                    b.Navigation("To");
+                });
+#pragma warning restore 612, 618
+        }
+    }
+}

code/MessengerApi.Db.Npg/Migrations/20250705145537_RenameTtlColumn.cs

@@ -0,0 +1,28 @@
+using Microsoft.EntityFrameworkCore.Migrations;
+
+#nullable disable
+
+namespace MessengerApi.Db.Npg.Migrations
+{
+    /// <inheritdoc />
+    public partial class RenameTtlColumn : Migration
+    {
+        /// <inheritdoc />
+        protected override void Up(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.RenameColumn(
+                name: "PayloadLifespanInSeconds",
+                table: "Messages",
+                newName: "TimeToLiveInSeconds");
+        }
+
+        /// <inheritdoc />
+        protected override void Down(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.RenameColumn(
+                name: "TimeToLiveInSeconds",
+                table: "Messages",
+                newName: "PayloadLifespanInSeconds");
+        }
+    }
+}

code/MessengerApi.Db.Npg/Migrations/MessengerNpgDbContextModelSnapshot.cs

@@ -43,12 +43,12 @@ namespace MessengerApi.Db.Npg.Migrations
                     b.Property<string>("Payload")
                         .HasColumnType("text");
 
-                    b.Property<int>("PayloadLifespanInSeconds")
-                        .HasColumnType("integer");
-
                     b.Property<string>("PayloadType")
                         .HasColumnType("text");
 
+                    b.Property<int>("TimeToLiveInSeconds")
+                        .HasColumnType("integer");
+
                     b.Property<Guid>("ToId")
                         .HasColumnType("uuid");
 

code/MessengerApi.Db.Sql.Migrator/MessengerApi.Db.Sql.Migrator.csproj

@@ -13,6 +13,10 @@
       <PrivateAssets>all</PrivateAssets>
       <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
     </PackageReference>
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Tools" Version="9.0.6">
+      <PrivateAssets>all</PrivateAssets>
+      <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
+    </PackageReference>
   </ItemGroup>
 
   <ItemGroup>

code/MessengerApi.Db.Sql/MessengerApi.Db.Sql.csproj

@@ -4,10 +4,11 @@
     <TargetFramework>net9.0</TargetFramework>
     <ImplicitUsings>enable</ImplicitUsings>
     <Nullable>enable</Nullable>
+	<ManagePackageVersionsCentrally>true</ManagePackageVersionsCentrally>
   </PropertyGroup>
 
   <ItemGroup>
-    <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="9.0.6" />
+    <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" />
   </ItemGroup>
 
   <ItemGroup>

code/MessengerApi.Db.Sql/Migrations/20250705145221_ShortenPayloadLifespanColumnName.Designer.cs

@@ -0,0 +1,125 @@
+// <auto-generated />
+using System;
+using MessengerApi.Db.Sql;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Infrastructure;
+using Microsoft.EntityFrameworkCore.Metadata;
+using Microsoft.EntityFrameworkCore.Migrations;
+using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
+
+#nullable disable
+
+namespace MessengerApi.Db.Sql.Migrations
+{
+    [DbContext(typeof(MessengerSqlDbContext))]
+    [Migration("20250705145221_ShortenPayloadLifespanColumnName")]
+    partial class ShortenPayloadLifespanColumnName
+    {
+        /// <inheritdoc />
+        protected override void BuildTargetModel(ModelBuilder modelBuilder)
+        {
+#pragma warning disable 612, 618
+            modelBuilder
+                .HasAnnotation("ProductVersion", "9.0.6")
+                .HasAnnotation("Relational:MaxIdentifierLength", 128);
+
+            SqlServerModelBuilderExtensions.UseIdentityColumns(modelBuilder);
+
+            modelBuilder.Entity("MessengerApi.Db.Entities.Message", b =>
+                {
+                    b.Property<Guid>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("uniqueidentifier");
+
+                    b.Property<DateTime>("CreatedUtc")
+                        .HasColumnType("datetime2");
+
+                    b.Property<Guid>("FromId")
+                        .HasColumnType("uniqueidentifier");
+
+                    b.Property<bool>("IsAcknowledged")
+                        .HasColumnType("bit");
+
+                    b.Property<bool>("IsDelivered")
+                        .HasColumnType("bit");
+
+                    b.Property<int>("LifespanInSeconds")
+                        .HasColumnType("int");
+
+                    b.Property<string>("Payload")
+                        .HasColumnType("nvarchar(max)");
+
+                    b.Property<string>("PayloadType")
+                        .HasColumnType("nvarchar(max)");
+
+                    b.Property<Guid>("ToId")
+                        .HasColumnType("uniqueidentifier");
+
+                    b.HasKey("Id");
+
+                    b.HasIndex("ToId", "IsDelivered");
+
+                    SqlServerIndexBuilderExtensions.IsClustered(b.HasIndex("ToId", "IsDelivered"), false);
+
+                    b.ToTable("Messages");
+                });
+
+            modelBuilder.Entity("MessengerApi.Db.Entities.User", b =>
+                {
+                    b.Property<Guid>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("uniqueidentifier");
+
+                    b.Property<Guid>("ApiKey")
+                        .HasColumnType("uniqueidentifier");
+
+                    b.Property<bool>("IsEnabled")
+                        .HasColumnType("bit");
+
+                    b.Property<string>("Name")
+                        .HasColumnType("nvarchar(max)");
+
+                    b.HasKey("Id");
+
+                    b.ToTable("Users");
+                });
+
+            modelBuilder.Entity("MessengerApi.Db.Entities.UserRoute", b =>
+                {
+                    b.Property<Guid>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("uniqueidentifier");
+
+                    b.Property<Guid?>("FromId")
+                        .HasColumnType("uniqueidentifier");
+
+                    b.Property<Guid?>("ToId")
+                        .HasColumnType("uniqueidentifier");
+
+                    b.HasKey("Id");
+
+                    b.HasIndex("FromId");
+
+                    b.HasIndex("ToId");
+
+                    b.ToTable("UserRoutes");
+                });
+
+            modelBuilder.Entity("MessengerApi.Db.Entities.UserRoute", b =>
+                {
+                    b.HasOne("MessengerApi.Db.Entities.User", "From")
+                        .WithMany()
+                        .HasForeignKey("FromId");
+
+                    b.HasOne("MessengerApi.Db.Entities.User", "To")
+                        .WithMany()
+                        .HasForeignKey("ToId");
+
+                    b.Navigation("From");
+
+                    b.Navigation("To");
+                });
+#pragma warning restore 612, 618
+        }
+    }
+}

code/MessengerApi.Db.Sql/Migrations/20250705145221_ShortenPayloadLifespanColumnName.cs

@@ -0,0 +1,28 @@
+using Microsoft.EntityFrameworkCore.Migrations;
+
+#nullable disable
+
+namespace MessengerApi.Db.Sql.Migrations
+{
+    /// <inheritdoc />
+    public partial class ShortenPayloadLifespanColumnName : Migration
+    {
+        /// <inheritdoc />
+        protected override void Up(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.RenameColumn(
+                name: "PayloadLifespanInSeconds",
+                table: "Messages",
+                newName: "LifespanInSeconds");
+        }
+
+        /// <inheritdoc />
+        protected override void Down(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.RenameColumn(
+                name: "LifespanInSeconds",
+                table: "Messages",
+                newName: "PayloadLifespanInSeconds");
+        }
+    }
+}

code/MessengerApi.Db.Sql/Migrations/20250705145452_RenameTtlColumnName.Designer.cs

@@ -0,0 +1,125 @@
+// <auto-generated />
+using System;
+using MessengerApi.Db.Sql;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Infrastructure;
+using Microsoft.EntityFrameworkCore.Metadata;
+using Microsoft.EntityFrameworkCore.Migrations;
+using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
+
+#nullable disable
+
+namespace MessengerApi.Db.Sql.Migrations
+{
+    [DbContext(typeof(MessengerSqlDbContext))]
+    [Migration("20250705145452_RenameTtlColumnName")]
+    partial class RenameTtlColumnName
+    {
+        /// <inheritdoc />
+        protected override void BuildTargetModel(ModelBuilder modelBuilder)
+        {
+#pragma warning disable 612, 618
+            modelBuilder
+                .HasAnnotation("ProductVersion", "9.0.6")
+                .HasAnnotation("Relational:MaxIdentifierLength", 128);
+
+            SqlServerModelBuilderExtensions.UseIdentityColumns(modelBuilder);
+
+            modelBuilder.Entity("MessengerApi.Db.Entities.Message", b =>
+                {
+                    b.Property<Guid>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("uniqueidentifier");
+
+                    b.Property<DateTime>("CreatedUtc")
+                        .HasColumnType("datetime2");
+
+                    b.Property<Guid>("FromId")
+                        .HasColumnType("uniqueidentifier");
+
+                    b.Property<bool>("IsAcknowledged")
+                        .HasColumnType("bit");
+
+                    b.Property<bool>("IsDelivered")
+                        .HasColumnType("bit");
+
+                    b.Property<string>("Payload")
+                        .HasColumnType("nvarchar(max)");
+
+                    b.Property<string>("PayloadType")
+                        .HasColumnType("nvarchar(max)");
+
+                    b.Property<int>("TimeToLiveInSeconds")
+                        .HasColumnType("int");
+
+                    b.Property<Guid>("ToId")
+                        .HasColumnType("uniqueidentifier");
+
+                    b.HasKey("Id");
+
+                    b.HasIndex("ToId", "IsDelivered");
+
+                    SqlServerIndexBuilderExtensions.IsClustered(b.HasIndex("ToId", "IsDelivered"), false);
+
+                    b.ToTable("Messages");
+                });
+
+            modelBuilder.Entity("MessengerApi.Db.Entities.User", b =>
+                {
+                    b.Property<Guid>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("uniqueidentifier");
+
+                    b.Property<Guid>("ApiKey")
+                        .HasColumnType("uniqueidentifier");
+
+                    b.Property<bool>("IsEnabled")
+                        .HasColumnType("bit");
+
+                    b.Property<string>("Name")
+                        .HasColumnType("nvarchar(max)");
+
+                    b.HasKey("Id");
+
+                    b.ToTable("Users");
+                });
+
+            modelBuilder.Entity("MessengerApi.Db.Entities.UserRoute", b =>
+                {
+                    b.Property<Guid>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("uniqueidentifier");
+
+                    b.Property<Guid?>("FromId")
+                        .HasColumnType("uniqueidentifier");
+
+                    b.Property<Guid?>("ToId")
+                        .HasColumnType("uniqueidentifier");
+
+                    b.HasKey("Id");
+
+                    b.HasIndex("FromId");
+
+                    b.HasIndex("ToId");
+
+                    b.ToTable("UserRoutes");
+                });
+
+            modelBuilder.Entity("MessengerApi.Db.Entities.UserRoute", b =>
+                {
+                    b.HasOne("MessengerApi.Db.Entities.User", "From")
+                        .WithMany()
+                        .HasForeignKey("FromId");
+
+                    b.HasOne("MessengerApi.Db.Entities.User", "To")
+                        .WithMany()
+                        .HasForeignKey("ToId");
+
+                    b.Navigation("From");
+
+                    b.Navigation("To");
+                });
+#pragma warning restore 612, 618
+        }
+    }
+}

code/MessengerApi.Db.Sql/Migrations/20250705145452_RenameTtlColumnName.cs

@@ -0,0 +1,28 @@
+using Microsoft.EntityFrameworkCore.Migrations;
+
+#nullable disable
+
+namespace MessengerApi.Db.Sql.Migrations
+{
+    /// <inheritdoc />
+    public partial class RenameTtlColumnName : Migration
+    {
+        /// <inheritdoc />
+        protected override void Up(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.RenameColumn(
+                name: "LifespanInSeconds",
+                table: "Messages",
+                newName: "TimeToLiveInSeconds");
+        }
+
+        /// <inheritdoc />
+        protected override void Down(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.RenameColumn(
+                name: "TimeToLiveInSeconds",
+                table: "Messages",
+                newName: "LifespanInSeconds");
+        }
+    }
+}

code/MessengerApi.Db.Sql/Migrations/MessengerSqlDbContextModelSnapshot.cs

@@ -43,12 +43,12 @@ namespace MessengerApi.Db.Sql.Migrations
                     b.Property<string>("Payload")
                         .HasColumnType("nvarchar(max)");
 
-                    b.Property<int>("PayloadLifespanInSeconds")
-                        .HasColumnType("int");
-
                     b.Property<string>("PayloadType")
                         .HasColumnType("nvarchar(max)");
 
+                    b.Property<int>("TimeToLiveInSeconds")
+                        .HasColumnType("int");
+
                     b.Property<Guid>("ToId")
                         .HasColumnType("uniqueidentifier");
 

code/MessengerApi.Db/MessengerDbContext.cs

@@ -19,7 +19,7 @@ namespace MessengerApi.Db
             modelBuilder.Entity<User>().HasKey(e => e.Id);
             modelBuilder.Entity<Message>().HasKey(e => e.Id);
             modelBuilder.Entity<Message>().Property(e => e.CreatedUtc).HasConversion<DateTimeAsUtcValueConverter>();
-            modelBuilder.Entity<Message>().Property(e => e.PayloadLifespanInSeconds).IsRequired();
+            modelBuilder.Entity<Message>().Property(e => e.TimeToLiveInSeconds).IsRequired();
             modelBuilder.Entity<UserRoute>().HasKey(e => e.Id);
         }
     }

code/MessengerApi.Db/Repositories/MessageRepository.cs

@@ -16,7 +16,7 @@ namespace MessengerApi.Db.Repositories
 
             return this.db
                 .Where(x => x.ToId == user.Id && x.IsDelivered == false)
-                .Where(x => x.PayloadLifespanInSeconds == null || x.CreatedUtc.AddSeconds(x.PayloadLifespanInSeconds.Value) >= timestamp)
+                .Where(x => x.TimeToLiveInSeconds == null || x.CreatedUtc.AddSeconds(x.TimeToLiveInSeconds.Value) >= timestamp)
                 .OrderBy(x => x.CreatedUtc);
         }
     }

code/MessengerApi.sln

@@ -28,7 +28,6 @@ EndProject
 Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Solution Items", "Solution Items", "{8EC462FD-D22E-90A8-E5CE-7E832BA40C5D}"
 	ProjectSection(SolutionItems) = preProject
 		..\Directory.Packages.props = ..\Directory.Packages.props
-		..\docker-compose.yml = ..\docker-compose.yml
 		..\Dockerfile = ..\Dockerfile
 		..\assets\example-users.config = ..\assets\example-users.config
 		..\NuGet.config = ..\NuGet.config
@@ -36,7 +35,6 @@ Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Solution Items", "Solution
 EndProject
 Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "workflows", "workflows", "{02EA681E-C7D8-13C7-8484-4AC65E1B71E8}"
 	ProjectSection(SolutionItems) = preProject
-		..\.gitea\workflows\build.yml = ..\.gitea\workflows\build.yml
 		..\.gitea\workflows\docker-build-and-push.yml = ..\.gitea\workflows\docker-build-and-push.yml
 	EndProjectSection
 EndProject

code/MessengerApi/Dockerfile

@@ -1,8 +0,0 @@
-#See https://aka.ms/customizecontainer to learn how to customize your debug container and how Visual Studio uses this Dockerfile to build your images for faster debugging.
-
-FROM mcr.microsoft.com/dotnet/aspnet:9.0 AS base
-USER app
-WORKDIR /app
-EXPOSE 8080
-COPY ./publish .
-ENTRYPOINT ["dotnet", "MessengerApi.dll"]

code/MessengerApi/Handlers/Endpoint/SendEndpointHandler.cs

@@ -32,7 +32,7 @@ namespace MessengerApi.Handlers.Endpoint
             Guid? toUserId,
             string payload,
             string payloadType,
-            int? payloadLifespanInSeconds)
+            int? timeToLiveInSeconds)
         {
             // Authorize.
             var targetRecipientId = toUserId.HasValue
@@ -50,7 +50,7 @@ namespace MessengerApi.Handlers.Endpoint
                 ToId = targetRecipientId,
                 Payload = payload,
                 PayloadType = payloadType,
-                PayloadLifespanInSeconds = payloadLifespanInSeconds ?? (this.configuration.DefaultMessageLifetimeInMinutes * 60)
+                TimeToLiveInSeconds = timeToLiveInSeconds ?? (this.configuration.DefaultMessageTimeToLiveInSeconds)
             };
 
             this.unitOfWork.Messages.Add(message);

code/MessengerApi/Models/Http/SendRequest.cs

@@ -8,6 +8,6 @@
 
         public string PayloadType { get; set; }
 
-        public int? PayloadLifetimeInSeconds { get; set; }
+        public int? TimeToLiveInSeconds { get; set; }
     }
 }

code/MessengerApi/Program.cs

@@ -184,7 +184,7 @@ namespace MessengerApi.Api
             {
                 try
                 {
-                    var response = await handler.SendMessage(request.ToUserId, request.Payload, request.PayloadType, request.PayloadLifetimeInSeconds);
+                    var response = await handler.SendMessage(request.ToUserId, request.Payload, request.PayloadType, request.TimeToLiveInSeconds);
                     await unitOfWork.SaveChanges();
                     return Results.Json(response.Id);
                 }

code/MessengerApi/Properties/launchSettings.json

@@ -4,13 +4,12 @@
       "commandName": "Project",
       "launchBrowser": true,
         "environmentVariables": {
-            "PERSISTENCE_TYPE": "Sql",
             "USERSCONFIG_FILE_PATH": "./../../assets/example-users.config",
             "SQL_CONNECTIONSTRING": ""
             "CORS_ORIGINS": "",
             "PROXIES": "",
             "QUERY_RATE_PER_MINUTE": "100",
-            "DEFAULT_MESSAGE_LIFETIME_IN_MINUTES": "60",
+            "DEFAULT_MESSAGE_TIME_TO_LIVE_IN_SECONDS": "60",
             "HOUSEKEEPING_ENABLED": "False",
             "LOGGING_VERBOSITY": "Trace"
         },

docker-compose.yml

@@ -1,7 +0,0 @@
-services:
-  messengerapi:
-    image: https://gitea.masita.net/mc/messengerapi:latest
-    container_name: messengerapi
-    restart: unless-stopped
-    environment:
-      - ASPNETCORE_ENVIRONMENT=Production

examples/example-docker-compose.yml

@@ -0,0 +1,17 @@
+services:
+  messengerapi:
+    image: gitea.masita.net/mc/messengerapi:latest
+    container_name: messengerapi
+    logging:
+      driver: "json-file"
+      options:
+        max-size: "10m"
+        max-file: "3"
+    ports:
+      - 8080:8080
+    restart: always
+    volumes:
+      - /mnt/config/users.conf:/app/users.conf:ro
+    environment:
+      - SQL_CONNECTIONSTRING
+      - CORS_ORIGINS