halkyon/apps/meditate/halkyon_meditate_server/lib/server.dart

import 'package:halkyon_base_server/base.dart';
import 'package:halkyon_meditate_server/src/generated/serverpod.dart';
import 'package:halkyon_meditate_server/src/library/meditate_library.dart';
import 'package:halkyon_meditate_server/src/meditate_base.dart';
import 'package:halkyon_meditate_server/src/pruning.dart';
import 'package:serverpod_auth_idp_server/core.dart';

/// The starting point of Halkyon Meditate's server.
Future<void> run(List<String> args) async {
  // The generated Serverpod is already connected with the generated code.
  final pod = Serverpod(args);
  // What every Halkyon server has (ADR 0014): sign-in, the account and its
  // deletion, the pruning, the instance's basics, set up for Meditate; a member
  // of the instance's register where the operator names one (ADR 0016).
  HalkyonBase.configure(
    pod,
    meditateBase(accounts: AccountsMode.fromEnvironment()),
  );
  // Token managers validate and issue authentication keys; identity
  // providers are the ways people can sign in (halkyon_base's
  // auth_config.dart).
  pod.initializeAuthServices(
    tokenManagerBuilders: tokenManagerBuilders,
    identityProviderBuilders: identityProviderBuilders(pod),
  );

  // The calls between the instance's services, on the web server
  // (ADR 0016); Caddy never forwards them.
  addInstanceRoutes(pod);

  // The operator's library's files, to devices holding an access the
  // catalogue gave them (ADR 0038, D16).
  addLibraryRoute(pod);

  await pod.start();

  await schedulePruning(pod);

  // The operator's library, read now and again every ten minutes (D16).
  await startLibrary(pod);
}