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/payment/config.ts

@@ -0,0 +1,20 @@
+import type { Stripe } from 'stripe';
+
+import { defineStartupConfig, ModuleConfig } from '../../fundamentals/config';
+
+export interface PaymentStartupConfig {
+  stripe?: {
+    keys: {
+      APIKey: string;
+      webhookKey: string;
+    };
+  } & Stripe.StripeConfig;
+}
+
+declare module '../config' {
+  interface PluginsConfig {
+    payment: ModuleConfig<PaymentStartupConfig>;
+  }
+}
+
+defineStartupConfig('plugins.payment', {});

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

@@ -1,3 +1,5 @@
+import './config';
+
 import { ServerFeature } from '../../core/config';
 import { FeatureModule } from '../../core/features';
 import { Plugin } from '../registry';
@@ -26,5 +28,3 @@ import { StripeWebhook } from './webhook';
   if: config => config.flavor.graphql,
 })
 export class PaymentModule {}
-
-export type { PaymentConfig } from './types';

packages/backend/server/src/plugins/payment/resolver.ts

@@ -19,7 +19,7 @@ import { groupBy } from 'lodash-es';
 
 import { CurrentUser, Public } from '../../core/auth';
 import { UserType } from '../../core/user';
-import { Config } from '../../fundamentals';
+import { Config, URLHelper } from '../../fundamentals';
 import { decodeLookupKey, SubscriptionService } from './service';
 import {
   InvoiceStatus,
@@ -146,8 +146,8 @@ class CreateCheckoutSessionInput {
   @Field(() => String, { nullable: true })
   coupon!: string | null;
 
-  @Field(() => String, { nullable: true })
-  successCallbackLink!: string | null;
+  @Field(() => String)
+  successCallbackLink!: string;
 
   // @FIXME(forehalo): we should put this field in the header instead of as a explicity args
   @Field(() => String)
@@ -158,7 +158,7 @@ class CreateCheckoutSessionInput {
 export class SubscriptionResolver {
   constructor(
     private readonly service: SubscriptionService,
-    private readonly config: Config
+    private readonly url: URLHelper
   ) {}
 
   @Public()
@@ -222,8 +222,7 @@ export class SubscriptionResolver {
       plan: input.plan,
       recurring: input.recurring,
       promotionCode: input.coupon,
-      redirectUrl:
-        input.successCallbackLink ?? `${this.config.baseUrl}/upgrade-success`,
+      redirectUrl: this.url.link(input.successCallbackLink),
       idempotencyKey: input.idempotencyKey,
     });
 

packages/backend/server/src/plugins/payment/stripe.ts

@@ -9,8 +9,8 @@ import { Config } from '../../fundamentals';
 export const StripeProvider: FactoryProvider = {
   provide: Stripe,
   useFactory: (config: Config) => {
-    assert(config.plugins.payment);
     const stripeConfig = config.plugins.payment.stripe;
+    assert(stripeConfig, 'Stripe configuration is missing');
 
     return new Stripe(stripeConfig.keys.APIKey, omit(stripeConfig, 'keys'));
   },

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

@@ -1,17 +1,7 @@
 import type { User } from '@prisma/client';
-import type { Stripe } from 'stripe';
 
 import type { Payload } from '../../fundamentals/event/def';
 
-export interface PaymentConfig {
-  stripe: {
-    keys: {
-      APIKey: string;
-      webhookKey: string;
-    };
-  } & Stripe.StripeConfig;
-}
-
 export enum SubscriptionRecurring {
   Monthly = 'monthly',
   Yearly = 'yearly',

packages/backend/server/src/plugins/payment/webhook.ts

@@ -25,7 +25,7 @@ export class StripeWebhook {
     private readonly stripe: Stripe,
     private readonly event: EventEmitter2
   ) {
-    assert(config.plugins.payment);
+    assert(config.plugins.payment.stripe);
     this.webhookKey = config.plugins.payment.stripe.keys.webhookKey;
   }