halkyon-days/halkyon
Watch
1
0
Fork
You've already forked halkyon
 0
Code Issues Pull requests Projects Releases 37 Packages Wiki Activity Actions

refactor(base,learn): people's files kept by halkyon_base

Browse source 
ADR 0043, D2, D4, D6 and D7, the first step towards Todo's attachments:
Learn's file store moves into the module, for every server that keeps
files, and Learn becomes its first host.

halkyon_base gets the store as Learn had it: uploads into the caller's
own space by SHA-256, downloads by a row the caller may read, each
person's room (FILE_LIMIT_IDENTIFIED_MB, FILE_LIMIT_INSTANCE_MB, the
operator's file_allowance, which moves into the module unchanged) and
the pruning of files no live row names. It stays free of the sync
engine: a host hands it a FileStore saying which of its rows name a file
and what it takes (HalkyonBase.files); without one the files endpoint
refuses. Its tests, with refusals, run on a stand-in host.

Learn hands it learnFiles: its asset rows, read by their space's members,
a readable file over 20 MB only as a PDF, up to 100 MB. Its app calls the
module; its own asset endpoint stays for released apps alone, forwarding
to the module in Learn's own models, whose names are on the wire. Its
file tests still pass through it, end to end.

Migrations: the module's creates file_allowance. Learn's server migration
holds version rows alone, as tables are matched by name (ADR 0014); its
device migration creates the module's empty table, as every module's.
Todo's, Train's and Meditate's create the empty table.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: Tizian 「ティツィアーン」 <raisondetredev@pm.me>
This commit is contained in:
Tizian 「ティツィアーン」 2026-11-11 00:11:36 +01:00
commit b7f0aaaec7
Signed by: raisondetredev
GPG key ID: 07F6FCF405488B64
1 changed files with 112084 additions and 348 deletions
Download patch file Download diff file Expand all files Collapse all files

27
apps/learn/halkyon_learn_flutter/lib/src/core/asset/data/serverpod_asset_server_gateway.dart
View file

@ -1,10 +1,12 @@
import 'dart:typed_data';
import 'package:halkyon_base_client/halkyon_base_client.dart' as base;
import 'package:halkyon_learn_client/halkyon_learn_client.dart' as protocol;
import 'package:halkyon_learn_flutter/src/core/asset/data/asset_server_gateway.dart';
/// [AssetServerGateway] on the server's asset endpoint, uploading through
/// Serverpod's own upload route.
/// [AssetServerGateway] on halkyon_base's `files` endpoint (Halkyon's ADR
/// 0043), uploading through Serverpod's own upload route. Learn's own
/// `asset` endpoint stays for released apps alone (D7).
class ServerpodAssetServerGateway(final protocol.Client _client)
implements AssetServerGateway {
@override
@ -13,7 +15,11 @@ class ServerpodAssetServerGateway(final protocol.Client _client)
int byteSize, {
bool encrypted = false,
}) => _refusing(
() => _client.asset.startUpload(sha256, byteSize, encrypted: encrypted),
() => _client.modules.base.files.startUpload(
sha256,
byteSize,
encrypted: encrypted,
),
);
@override
@ -24,12 +30,15 @@ class ServerpodAssetServerGateway(final protocol.Client _client)
@override
Future<bool> finishUpload(String sha256, {bool encrypted = false}) =>
_refusing(
() => _client.asset.finishUpload(sha256, encrypted: encrypted),
() => _client.modules.base.files.finishUpload(
sha256,
encrypted: encrypted,
),
);
@override
Future<FileRoom> room() async {
final usage = await _client.asset.usage();
final usage = await _client.modules.base.files.usage();
return (usedBytes: usage.usedBytes, limitBytes: usage.limitBytes);
}
@ -37,7 +46,7 @@ class ServerpodAssetServerGateway(final protocol.Client _client)
Future<T> _refusing<T>(Future<T> Function() call) async {
try {
return await call();
} on protocol.FileLimitExceededException catch (error) {
} on base.FileLimitExceededException catch (error) {
throw FileLimitReached(
instanceFull: error.instanceFull,
limitBytes: error.limitBytes,
@ -49,9 +58,11 @@ class ServerpodAssetServerGateway(final protocol.Client _client)
Future<Uint8List?> download(String id) async {
try {
return Uint8List.sublistView(
await _client.asset.download(protocol.UuidValue.withValidation(id)),
await _client.modules.base.files.download(
protocol.UuidValue.withValidation(id),
),
);
} on protocol.NotFoundException {
} on base.StoredFileNotFoundException {
return null;
}
}