feat(server): runtime setting support (#5602)

---

<details open="true"><summary>Generated summary (powered by <a href="https://app.graphite.dev">Graphite</a>)</summary>

> ## TL;DR
> This pull request adds a new migration file, a new model, and new modules related to runtime settings. It also introduces a new `Runtime` service that allows getting, setting, and updating runtime configurations.
>
> ## What changed
> - Added a new migration file `migration.sql` that creates a table called `application_settings` with columns `key` and `value`.
> - Added a new model `ApplicationSetting` with properties `key` and `value`.
> - Added a new module `RuntimeSettingModule` that exports the `Runtime` service.
> - Added a new service `Runtime` that provides methods for getting, setting, and updating runtime configurations.
> - Modified the `app.module.ts` file to import the `RuntimeSettingModule`.
> - Modified the `index.ts` file in the `fundamentals` directory to export the `Runtime` service.
> - Added a new file `def.ts` in the `runtime` directory that defines the runtime configurations and provides a default implementation.
> - Added a new file `service.ts` in the `runtime` directory that implements the `Runtime` service.
>
> ## How to test
> 1. Run the migration script to create the `application_settings` table.
> 2. Use the `Runtime` service to get, set, and update runtime configurations.
> 3. Verify that the runtime configurations are stored correctly in the database and can be retrieved and modified using the `Runtime` service.
>
> ## Why make this change
> This change introduces a new feature related to runtime settings. The `Runtime` service allows the application to dynamically manage and modify runtime configurations without requiring a restart. This provides flexibility and allows for easier customization and configuration of the application.
</details>

packages/backend/server/src/plugins/storage/config.ts

@@ -0,0 +1,27 @@
+import { S3ClientConfig, S3ClientConfigType } from '@aws-sdk/client-s3';
+
+import { defineStartupConfig, ModuleConfig } from '../../fundamentals/config';
+
+type WARNING = '__YOU_SHOULD_NOT_MANUALLY_CONFIGURATE_THIS_TYPE__';
+declare module '../../fundamentals/storage/config' {
+  interface StorageProvidersConfig {
+    // the type here is only existing for extends [StorageProviderType] with better type inference and checking.
+    'cloudflare-r2'?: WARNING;
+    'aws-s3'?: WARNING;
+  }
+}
+
+export type S3StorageConfig = S3ClientConfigType;
+export type R2StorageConfig = S3ClientConfigType & {
+  accountId?: string;
+};
+
+declare module '../config' {
+  interface PluginsConfig {
+    'aws-s3': ModuleConfig<S3ClientConfig>;
+    'cloudflare-r2': ModuleConfig<R2StorageConfig>;
+  }
+}
+
+defineStartupConfig('plugins.aws-s3', {});
+defineStartupConfig('plugins.cloudflare-r2', {});

packages/backend/server/src/plugins/storage/index.ts

@@ -1,3 +1,5 @@
+import './config';
+
 import { registerStorageProvider } from '../../fundamentals/storage';
 import { Plugin } from '../registry';
 import { R2StorageProvider } from './providers/r2';
@@ -38,5 +40,3 @@ export class CloudflareR2Module {}
   if: config => config.flavor.graphql,
 })
 export class AwsS3Module {}
-
-export type { R2StorageConfig, S3StorageConfig } from './types';

packages/backend/server/src/plugins/storage/providers/r2.ts

@@ -1,12 +1,15 @@
+import assert from 'node:assert';
+
 import { Logger } from '@nestjs/common';
 
-import type { R2StorageConfig } from '../types';
+import type { R2StorageConfig } from '../config';
 import { S3StorageProvider } from './s3';
 
 export class R2StorageProvider extends S3StorageProvider {
   override readonly type = 'cloudflare-r2' as any /* cast 'r2' to 's3' */;
 
   constructor(config: R2StorageConfig, bucket: string) {
+    assert(config.accountId, 'accountId is required for R2 storage provider');
     super(
       {
         ...config,

packages/backend/server/src/plugins/storage/providers/s3.ts

@@ -20,7 +20,7 @@ import {
   StorageProvider,
   toBuffer,
 } from '../../../fundamentals/storage';
-import type { S3StorageConfig } from '../types';
+import type { S3StorageConfig } from '../config';
 
 export class S3StorageProvider implements StorageProvider {
   protected logger: Logger;

packages/backend/server/src/plugins/storage/types.ts

@@ -1,16 +0,0 @@
-import { S3ClientConfigType } from '@aws-sdk/client-s3';
-
-type WARNING = '__YOU_SHOULD_NOT_MANUALLY_CONFIGURATE_THIS_TYPE__';
-export type R2StorageConfig = S3ClientConfigType & {
-  accountId: string;
-};
-
-export type S3StorageConfig = S3ClientConfigType;
-
-declare module '../../fundamentals/config/storage' {
-  interface StorageProvidersConfig {
-    // the type here is only existing for extends [StorageProviderType] with better type inference and checking.
-    'cloudflare-r2'?: WARNING;
-    'aws-s3'?: WARNING;
-  }
-}