halkyon/halkyon_learn_server/lib/server.dart

import 'package:halkyon_learn_server/src/auth/auth_config.dart';
import 'package:halkyon_learn_server/src/generated/serverpod.dart';
import 'package:serverpod_auth_idp_server/core.dart';

/// The starting point of the Serverpod server.
Future<void> run(List<String> args) async {
  // Initialize Serverpod. The generated Serverpod class is already connected
  // with your project's generated code.
  final pod = Serverpod(args);
  pod
    // Token managers validate and issue authentication keys; identity
    // providers are the ways people can sign in (see auth_config.dart).
    ..initializeAuthServices(
      tokenManagerBuilders: tokenManagerBuilders,
      identityProviderBuilders: identityProviderBuilders(pod),
    )
    // Files live in Postgres until the self-hosted S3-compatible storage arrives later.
    ..addCloudStorage(DatabaseCloudStorage('private'))
    ..addCloudStorage(DatabaseCloudStorage('public'));

  // Start the server.
  await pod.start();

  // Abandoned anonymous people are pruned daily (decided 2026-09-30).
  // Scheduling always adds an entry, so the previous one goes first.
  await pod.futureCalls.cancel(_pruning);
  await pod.futureCalls
      .callRecurring(identifier: _pruning)
      .cron('17 3 * * *')
      .pruning
      .pruneAnonymousPeople();

  // So are the files nobody can reach any more (ADR 0004, rule 5).
  await pod.futureCalls.cancel(_filePruning);
  await pod.futureCalls
      .callRecurring(identifier: _filePruning)
      .cron('47 3 * * *')
      .filePruning
      .pruneFiles();
}

/// The identifier of the daily pruning.
const _pruning = 'prune-abandoned-anonymous-people';

/// The identifier of the daily pruning of files.
const _filePruning = 'prune-unreferenced-files';