chore: Update Hugo version to 0.139.0, adjust Docker image tags to 1.1.0, and modify last modified dates in documentation

Author: giovanninocco

.github/workflows/hugo.yml

@@ -31,7 +31,7 @@ jobs:
   build:
     runs-on: ubuntu-latest
     env:
-      HUGO_VERSION: 0.108.0
+      HUGO_VERSION: 0.139.0
     steps:
       - name: Install Hugo CLI
         run: |

.github/workflows/main.yml

@@ -33,7 +33,7 @@ jobs:
     name: Build
     runs-on: ubuntu-latest
     env:
-      HUGO_VERSION: 0.108.0
+      HUGO_VERSION: 0.139.0
 
     steps:
       - name: Checkout 

README.md

@@ -27,21 +27,21 @@
 1. Clone the repository
 2. Run the following command to build the docker image
 ```bash
-docker build -t genocs/genocs-library-docs .
+docker build -t genocs/genocs-library-docs:1.1.0 .
 ```
 3. Run the following command to run the docker image
 ```bash
-docker run -d -p 1313:80 genocs/genocs-library-docs
+docker run -d -p 1313:80 genocs/genocs-library-docs:1.1.0
 ```
 4. Navigate to localhost:1313 to view the documentation
 
 5. push the image to docker hub
 ```bash
 docker login
-docker tag genocs/genocs-library-docs genocs/genocs-library-docs:1.0.0
+docker tag genocs/genocs-library-docs genocs/genocs-library-docs:1.1.0
 docker tag genocs/genocs-library-docs genocs/genocs-library-docs:latest
 
-docker push genocs/genocs-library-docs:1.0.0
+docker push genocs/genocs-library-docs:1.1.0
 docker push genocs/genocs-library-docs:latest
 ```
 

content/en/library/authentication/index.md

@@ -3,7 +3,7 @@ title : "Authentication - JWT"
 description: "Adds the integration with JWT using an available authentication middleware and system components to validate and grant the access tokens."
 lead: ""
 date: 2023-05-13T15:40:19+02:00
-lastmod: 2024-11-17T00:00:00+02:00
+lastmod: 2024-11-30T00:00:00+02:00
 draft: false
 images: []
 menu:
@@ -166,10 +166,35 @@ The default section name for the JWT settings is `jwt`. The following options ar
 - `certificate` - Certificate used to issue or just validate the tokens (including private key or just the public one).
 - `algorithm` - The algorithm used to sign the tokens.
 - `issuer` - A party signing the tokens.
+- `issuerSigningKey` - A key used to sign the tokens.
+- `validIssuer` - An issuer that can use the access tokens.
+- `authority` - The URL of the OpenId provider.
+- `audience` - An audience that can use the access tokens.
+- `challenge` - The challenge used to authenticate the user.    
+- `metadataAddress` - The URL of the OpenId provider metadata.
+- `saveToken` - If true then the token will be saved in the authentication properties.
+- `saveSigninToken` - If true then the token will be saved in the sign-in properties.
+- `requireAudience` - If true then the audience defined in validAudience will be required.
+- `requireHttpsMetadata` - If true then the metadata address will be required to use HTTPS.
+- `requireExpirationTime` - If true then the expiration time will be required.
+- `requireSignedTokens` - If true then the tokens will be required to be signed.
+- `expiryMinutes` - How long the token will remain valid.
 - `secretKey` - A secret key used to create the access tokens (instead of using the certificate).
 - `expiry` - How long the token will remain valid.
 - `validateLifetime` - If true then the lifetime defined in expiryMinutes will be validated.
 - `validAudience` - An audience that can use the access tokens.
+- `validAudiences` - A list of audiences that can use the access tokens.
+- `validIssuer` - An issuer that can use the access tokens.
+- `validIssuers` - A list of issuers that can use the access tokens.
+- `validateActor` - If true then the actor will be validated.
+- `validateIssuer` - If true then the issuer defined in validIssuer will be validated.
+- `validateTokenReplay` - If true then the token replay will be validated.
+- `validateIssuerSigningKey` - If true then the issuer signing key will be validated.
+- `refreshOnIssuerKeyNotFound` - If true then the issuer key will be refreshed.
+- `includeErrorDetails` - If true then the error details will be included.
+- `authenticationType` - The type of the authentication.
+- `nameClaimType` - The type of the name claim.
+- `roleClaimType` - The type of the role claim.
 - `validateAudience` - If true then the audience defined in validAudience will be validated.
 
 ## Settings
@@ -180,14 +205,8 @@ Use the following settings in the `appsettings.json` file according to your need
 "jwt": {
   "enabled": true,
   "allowAnonymousEndpoints": [
-    "/api/health",
-    "/api/health/ready",
-    "/api/health/live",
-    "/api/health/alive",
-    "/api/health/healthz",
-    "/api/health/healthz/ready",
-    "/api/health/healthz/live",
-    "/api/health/healthz/alive"
+    "/api/healthz",
+    "/api/alive"
   ],
   "certificate": {
     "location": "certs/localhost.pfx",
@@ -204,6 +223,7 @@ Use the following settings in the `appsettings.json` file according to your need
   "challenge" : "Bearer",
   "metadataAddress" : "/.well-known/openid-configuration",
   "saveToken": true,
+  "saveSigninToken": false,
   "requireAudience": true,
   "requireHttpsMetadata": true,
   "requireExpirationTime": true,
@@ -224,7 +244,7 @@ Use the following settings in the `appsettings.json` file according to your need
   "includeErrorDetails" : true,
   "authenticationType" : null,
   "nameClaimType" : null,
-  "roleClaimType" : null,
+  "roleClaimType" : "Role"
 }
 ```
 
@@ -246,5 +266,6 @@ Default settings for some variable has bee overwritten with the following config
   "validateLifetime": true,
   "refreshOnIssuerKeyNotFound": true,
   "includeErrorDetails": true,
+  "roleClaimType" : "Role"
 }
 ```

content/en/library/builder/index.md

@@ -3,7 +3,7 @@ title : "Builder"
 description: "Genocs builder is the entrypoint for the application builder."
 lead: ""
 date: 2023-12-20T17:40:19+02:00
-lastmod: 2024-11-17T00:00:00+02:00
+lastmod: 2024-11-30T00:00:00+02:00
 draft: false
 images: []
 menu:
@@ -27,20 +27,49 @@ dotnet add package Genocs.Core
 
 ## Usage
 
-Extend `IServiceCollection` with `AddGenocs(builder.Configuration)` that will get register the required services.
+The builder is the entrypoint for the application builder. You can use the `Genocs.Core` builder to setup the application.
 
-This is what you need to do in the `Program.cs` file.
+There are two ways to setup the builder:
 
-```csharp
-// Create a new WebApplication
-var builder = WebApplication.CreateBuilder(args);
+1. Extend `WebApplicationBuilder` with `UseGenocs()`
 
-// Get the services
-var services = builder.Services;
+    This is what you need to do in the `Program.cs` file.
 
-// Setup the builder
-services.AddGenocs(builder.Configuration);
-```
+    ```csharp
+    // Create a new WebApplication
+    var builder = WebApplication.CreateBuilder(args);
+
+    builder.AddGenocs();
+
+    ... // Add other services
+    ```
+
+    This option will allow you to be able to integrate [Microsoft Aspire](https://learn.microsoft.com/en-us/dotnet/aspire/) effortlessly, as well as, you can add the following services:
+
+    ```csharp
+    ... // From the above code
+    builder.AddJwt()
+            .AddOpenTelemetry()
+            .AddMongoFast()
+            .RegisterMongoRepositories(Assembly.GetExecutingAssembly())
+            .AddApplicationServices()
+            .Build();
+    ```
+
+2. Extend `IServiceCollection` with `AddGenocs(builder.Configuration)` that will get register the required services.
+
+    This is what you need to do in the `Program.cs` file.
+
+    ```csharp
+    // Create a new WebApplication
+    var builder = WebApplication.CreateBuilder(args);
+
+    // Get the services
+    var services = builder.Services;
+
+    // Setup the builder
+    services.AddGenocs(builder.Configuration);
+    ```
 
 
 > NOTE: By Adding `AddGenocs(builder.Configuration)` you are adding the following services:
@@ -50,12 +79,11 @@ services.AddHealthChecks();
 
 No need to call MapHealthChecks, it is already done for you.
 
-
 ```csharp
 // Map the Default Endpoints
 // It contains the following endpoints:
 // - /
-// - /health
+// - /healthz
 // - /live
 app.MapDefaultEndpoints();
 ```
@@ -90,26 +118,26 @@ builder.Host
         .UseAzureKeyVault() // Use Azure Key Vault
         .UseLogging(); // Use Serilog
 
-// Get the services
-var services = builder.Services;
 
 // Setup the builder
-services
-    .AddGenocs(builder.Configuration) // Setup Genocs builder
+builder
+    .AddGenocs() // Setup Genocs builder
     .AddOpenTelemetry() // Add OpenTelemetry
     .AddMongoFast() // Add MongoDb
     .RegisterMongoRepositories(Assembly.GetExecutingAssembly()) // Register MongoDb Repositories
     .AddApplicationServices() // Add Application Services
     .Build(); // Build the services
 
+// Get the services
+var services = builder.Services;
+
 services.AddCors(); // Add Cors
 services.AddControllers().AddJsonOptions(x =>
 {
     // serialize Enums as strings in api responses (e.g. Role)
     x.JsonSerializerOptions.Converters.Add(new JsonStringEnumConverter());
 });
 
-
 var settings = new SecretSettings();
 builder.Configuration.GetSection(SecretSettings.Position).Bind(settings);
 services.AddSingleton(settings);
@@ -153,6 +181,7 @@ app.UseAuthorization();
 
 app.MapControllers();
 
+// Map the Default Endpoints and Health Checks
 app.MapDefaultEndpoints();
 
 // Run the application
@@ -189,7 +218,7 @@ Use the following settings in the `appsettings.json` file according to your need
   "app": {
     "name": "Service Name",
     "service": "service-name",
-    "instance": "000001",
+    "instance": "01",
     "version": "v1.0",
     "displayBanner": true,
     "displayVersion": true

layouts/index.html

@@ -6,7 +6,7 @@ <h1>Genocs</h1>
                 <p class="gradient-banner">{{ .Params.sub }}</p>
                 <h2 style="font-weight: 900;">
                     ✔️ <b class="code-green">
-                        <a href="https://github.com/Genocs/genocs-library/releases/tag/v6.4.0">v6.4.0</a>
+                        <a href="https://github.com/Genocs/genocs-library/releases/tag/v7.1.0">v7.1.0</a>
                     </b>
                 </h2>
             </div>

nginx.conf

@@ -21,7 +21,7 @@ http {
     sendfile        on;
     #tcp_nopush     on;
     #tcp_nodelay    on;
-    keepalive_timeout  65;
+    keepalive_timeout  130;
     #types_hash_max_size 2048;
 
     include /etc/nginx/conf.d/*.conf;

package.json

@@ -35,24 +35,24 @@
   },
   "devDependencies": {
     "@babel/cli": "^7.25",
-    "@babel/core": "^7.25",
-    "@babel/preset-env": "^7.25",
+    "@babel/core": "^7.26",
+    "@babel/preset-env": "^7.26",
     "@fullhuman/postcss-purgecss": "^6.0",
     "auto-changelog": "^2.5.0",
     "autoprefixer": "^10.4",
     "bootstrap": "^5.3",
     "clipboard": "^2.0",
-    "eslint": "^8.54",
+    "eslint": "^9.16",
     "exec-bin": "^1.0.0",
     "flexsearch": "^0.7.43",
     "highlight.js": "^11.10",
     "hugo-installer": "^4.0",
     "instant.page": "^5.2",
     "katex": "^0.16",
     "lazysizes": "^5.3",
-    "markdownlint-cli": "^0.41.0",
-    "mermaid": "^10.9",
-    "node-fetch": "^3.2",
+    "markdownlint-cli": "^0.43.0",
+    "mermaid": "^11.4",
+    "node-fetch": "^3.3",
     "postcss": "^8.4",
     "postcss-cli": "^10.1",
     "purgecss-whitelister": "^2.4",
@@ -61,6 +61,6 @@
     "stylelint-config-standard-scss": "^11.0"
   },
   "otherDependencies": {
-    "hugo": "0.108.0"
+    "hugo": "0.139.0"
   }
 }

theme.toml

@@ -2,7 +2,7 @@ name = "Doks"
 license = "MIT"
 licenselink = "https://github.com/h-enk/doks/blob/master/LICENSE"
 description = "Hugo theme helping you build modern documentation websites that are secure, fast, and SEO-ready — by default."
-timeout = 600000
+timeout = 1200000
 
 homepage = "https://github.com/h-enk/doks"
 demosite = "https://doks.netlify.app"