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

feat(todo): sections, tasks and labels on the server (ADR 0033, D6)

Browse source 
Three more synced tables, each a sealed payload alone, as project's:
section, task and label; deleted with the person's space.

The migration only adds: the three tables (id uuid defaulting to
gen_random_uuid_v7(), spaceId, keyId, payload, nonce), each indexed on
spaceId and cascading with its space (ON DELETE CASCADE to
offline_sync_spaces), and the modules' version rows. Nothing is dropped
or changed.

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-01 01:06:24 +01:00
commit 128bcb127b
Signed by: raisondetredev
GPG key ID: 07F6FCF405488B64
1 changed files with 22399 additions and 7 deletions
Download patch file Download diff file Expand all files Collapse all files

674
apps/todo/halkyon_todo_client/lib/src/protocol/task/task.dart Normal file
View file

@ -0,0 +1,674 @@
/* AUTOMATICALLY GENERATED CODE DO NOT MODIFY */
/* To generate run: "serverpod generate" */
// ignore_for_file: implementation_imports
// ignore_for_file: library_private_types_in_public_api
// ignore_for_file: non_constant_identifier_names
// ignore_for_file: public_member_api_docs
// ignore_for_file: type_literal_in_constant_pattern
// ignore_for_file: use_super_parameters
// ignore_for_file: invalid_use_of_internal_member
// ignore_for_file: no_leading_underscores_for_library_prefixes
import 'dart:typed_data' as _idt;
import 'package:serverpod_client/serverpod_client.dart' as _isc;
import 'package:serverpod_database/serverpod_database.dart' as _isd;
/// A task (ADR 0033, D6): everything about it is in its sealed payload (D5):
/// its title and description, its project, section and parent (a sub-task's),
/// its place among its siblings, its date, deadline, priority and labels,
/// when it was completed; the instance sees that it exists, its size and
/// when it changed, nor which project it is in. Changed when edited, the
/// last writer winning. Synced.
abstract class Task
implements _isd.TableRow<_isc.UuidValue?>, _isc.ProtocolSerialization {
Task._({
this.id,
this.spaceId,
this.keyId,
required this.payload,
this.nonce,
});
factory Task({
_isc.UuidValue? id,
int? spaceId,
String? keyId,
required _idt.ByteData payload,
_idt.ByteData? nonce,
}) = _TaskImpl;
factory Task.fromJson(Map<String, dynamic> jsonSerialization) {
return Task(
id: jsonSerialization['id'] == null
? null
: _isc.UuidValueJsonExtension.fromJson(jsonSerialization['id']),
spaceId: jsonSerialization['spaceId'] as int?,
keyId: jsonSerialization['keyId'] as String?,
payload: _isc.ByteDataJsonExtension.fromJson(
jsonSerialization['payload'],
),
nonce: jsonSerialization['nonce'] == null
? null
: _isc.ByteDataJsonExtension.fromJson(jsonSerialization['nonce']),
);
}
static final t = TaskTable();
static const db = TaskRepository._();
@override
_isc.UuidValue? id;
/// The space owning this row. Maintained by the sync engine.
int? spaceId;
/// The key it is sealed with (ADR 0002's envelope); never null in Todo,
/// where everything is sealed.
String? keyId;
/// The content, sealed: UTF-8 JSON with a `schemaVersion` once opened.
_idt.ByteData payload;
/// The sealing's nonce (ADR 0002's envelope).
_idt.ByteData? nonce;
@override
_isd.Table<_isc.UuidValue?> get table => t;
/// Returns a shallow copy of this [Task]
/// with some or all fields replaced by the given arguments.
@_isc.useResult
Task copyWith({
_isc.UuidValue? id,
int? spaceId,
String? keyId,
_idt.ByteData? payload,
_idt.ByteData? nonce,
});
@override
Map<String, dynamic> toJson() {
return {
'__className__': 'Task',
if (id != null) 'id': id?.toJson(),
if (spaceId != null) 'spaceId': spaceId,
if (keyId != null) 'keyId': keyId,
'payload': payload.toJson(),
if (nonce != null) 'nonce': nonce?.toJson(),
};
}
@override
Map<String, dynamic> toJsonForProtocol() {
return {
'__className__': 'Task',
if (id != null) 'id': id?.toJson(),
if (spaceId != null) 'spaceId': spaceId,
if (keyId != null) 'keyId': keyId,
'payload': payload.toJson(),
if (nonce != null) 'nonce': nonce?.toJson(),
};
}
static TaskInclude include() {
return TaskInclude._();
}
static TaskIncludeList includeList({
_isd.WhereExpressionBuilder<TaskTable>? where,
int? limit,
int? offset,
_isd.OrderByBuilder<TaskTable>? orderBy,
_isd.OrderByListBuilder<TaskTable>? orderByList,
TaskInclude? include,
}) {
return TaskIncludeList._(
where: where,
limit: limit,
offset: offset,
orderBy: orderBy?.call(Task.t),
orderByList: orderByList?.call(Task.t),
include: include,
);
}
@override
String toString() {
return _isc.SerializationManager.encode(this);
}
}
class _Undefined {}
class _TaskImpl extends Task {
_TaskImpl({
_isc.UuidValue? id,
int? spaceId,
String? keyId,
required _idt.ByteData payload,
_idt.ByteData? nonce,
}) : super._(
id: id,
spaceId: spaceId,
keyId: keyId,
payload: payload,
nonce: nonce,
);
/// Returns a shallow copy of this [Task]
/// with some or all fields replaced by the given arguments.
@_isc.useResult
@override
Task copyWith({
Object? id = _Undefined,
Object? spaceId = _Undefined,
Object? keyId = _Undefined,
_idt.ByteData? payload,
Object? nonce = _Undefined,
}) {
return Task(
id: id is _isc.UuidValue? ? id : this.id,
spaceId: spaceId is int? ? spaceId : this.spaceId,
keyId: keyId is String? ? keyId : this.keyId,
payload: payload ?? this.payload.clone(),
nonce: nonce is _idt.ByteData? ? nonce : this.nonce?.clone(),
);
}
}
class TaskUpdateTable extends _isd.UpdateTable<TaskTable> {
TaskUpdateTable(super.table);
_isd.ColumnValue<int, int> spaceId(int? value) => _isd.ColumnValue(
table.spaceId,
value,
);
_isd.ColumnValue<String, String> keyId(String? value) => _isd.ColumnValue(
table.keyId,
value,
);
_isd.ColumnValue<_idt.ByteData, _idt.ByteData> payload(_idt.ByteData value) =>
_isd.ColumnValue(
table.payload,
value,
);
_isd.ColumnValue<_idt.ByteData, _idt.ByteData> nonce(_idt.ByteData? value) =>
_isd.ColumnValue(
table.nonce,
value,
);
}
class TaskTable extends _isd.Table<_isc.UuidValue?> {
TaskTable({super.tableRelation}) : super(tableName: 'task') {
updateTable = TaskUpdateTable(this);
spaceId = _isd.ColumnInt(
'spaceId',
this,
);
keyId = _isd.ColumnString(
'keyId',
this,
);
payload = _isd.ColumnByteData(
'payload',
this,
);
nonce = _isd.ColumnByteData(
'nonce',
this,
);
}
late final TaskUpdateTable updateTable;
/// The space owning this row. Maintained by the sync engine.
late final _isd.ColumnInt spaceId;
/// The key it is sealed with (ADR 0002's envelope); never null in Todo,
/// where everything is sealed.
late final _isd.ColumnString keyId;
/// The content, sealed: UTF-8 JSON with a `schemaVersion` once opened.
late final _isd.ColumnByteData payload;
/// The sealing's nonce (ADR 0002's envelope).
late final _isd.ColumnByteData nonce;
@override
List<_isd.Column> get columns => [
id,
spaceId,
keyId,
payload,
nonce,
];
}
class TaskInclude extends _isd.IncludeObject {
TaskInclude._();
@override
Map<String, _isd.Include?> get includes => {};
@override
_isd.Table<_isc.UuidValue?> get table => Task.t;
}
class TaskIncludeList extends _isd.IncludeList {
TaskIncludeList._({
_isd.WhereExpressionBuilder<TaskTable>? where,
super.limit,
super.offset,
super.orderBy,
super.orderByList,
super.include,
}) {
super.where = where?.call(Task.t);
}
@override
Map<String, _isd.Include?> get includes => include?.includes ?? {};
@override
_isd.Table<_isc.UuidValue?> get table => Task.t;
}
class TaskRepository {
const TaskRepository._();
/// Returns a list of [Task]s matching the given query parameters.
///
/// Use [where] to specify which items to include in the return value.
/// If none is specified, all items will be returned.
///
/// To specify the order of the items use [orderBy] or [orderByList]
/// when sorting by multiple columns.
///
/// The maximum number of items can be set by [limit]. If no limit is set,
/// all items matching the query will be returned.
///
/// [offset] defines how many items to skip, after which [limit] (or all)
/// items are read from the database.
///
/// ```dart
/// var persons = await Persons.db.find(
/// session,
/// where: (t) => t.lastName.equals('Jones'),
/// orderBy: (t) => t.firstName,
/// limit: 100,
/// );
/// ```
Future<List<Task>> find(
_isd.DatabaseSession session, {
_isd.WhereExpressionBuilder<TaskTable>? where,
int? limit,
int? offset,
_isd.OrderByBuilder<TaskTable>? orderBy,
_isd.OrderByListBuilder<TaskTable>? orderByList,
_isd.Transaction? transaction,
_isd.LockMode? lockMode,
_isd.LockBehavior? lockBehavior,
}) async {
return session.db.find<Task>(
where: where?.call(Task.t),
orderBy: orderBy?.call(Task.t),
orderByList: orderByList?.call(Task.t),
limit: limit,
offset: offset,
transaction: transaction,
lockMode: lockMode,
lockBehavior: lockBehavior,
);
}
/// Returns the first matching [Task] matching the given query parameters.
///
/// Use [where] to specify which items to include in the return value.
/// If none is specified, all items will be returned.
///
/// To specify the order use [orderBy] or [orderByList]
/// when sorting by multiple columns.
///
/// [offset] defines how many items to skip, after which the next one will be picked.
///
/// ```dart
/// var youngestPerson = await Persons.db.findFirstRow(
/// session,
/// where: (t) => t.lastName.equals('Jones'),
/// orderBy: (t) => t.age,
/// );
/// ```
Future<Task?> findFirstRow(
_isd.DatabaseSession session, {
_isd.WhereExpressionBuilder<TaskTable>? where,
int? offset,
_isd.OrderByBuilder<TaskTable>? orderBy,
_isd.OrderByListBuilder<TaskTable>? orderByList,
_isd.Transaction? transaction,
_isd.LockMode? lockMode,
_isd.LockBehavior? lockBehavior,
}) async {
return session.db.findFirstRow<Task>(
where: where?.call(Task.t),
orderBy: orderBy?.call(Task.t),
orderByList: orderByList?.call(Task.t),
offset: offset,
transaction: transaction,
lockMode: lockMode,
lockBehavior: lockBehavior,
);
}
/// Finds a single [Task] by its [id] or null if no such row exists.
Future<Task?> findById(
_isd.DatabaseSession session,
_isc.UuidValue id, {
_isd.Transaction? transaction,
_isd.LockMode? lockMode,
_isd.LockBehavior? lockBehavior,
}) async {
return session.db.findById<Task>(
id,
transaction: transaction,
lockMode: lockMode,
lockBehavior: lockBehavior,
);
}
/// Inserts all [Task]s in the list and returns the inserted rows.
///
/// The returned [Task]s will have their `id` fields set.
///
/// This is an atomic operation, meaning that if one of the rows fails to
/// insert, none of the rows will be inserted.
///
/// If [ignoreConflicts] is set to `true`, rows that conflict with existing
/// rows are silently skipped, and only the successfully inserted rows are
/// returned.
///
/// If [noReturn] is set to `true`, the inserted rows are not read back from
/// the database and an empty list is returned. This avoids the overhead of
/// transferring and deserializing the rows when the result is not needed.
Future<List<Task>> insert(
_isd.DatabaseSession session,
List<Task> rows, {
_isd.Transaction? transaction,
bool ignoreConflicts = false,
bool noReturn = false,
}) async {
return session.db.insert<Task>(
rows,
transaction: transaction,
ignoreConflicts: ignoreConflicts,
noReturn: noReturn,
);
}
/// Inserts a single [Task] and returns the inserted row.
///
/// The returned [Task] will have its `id` field set.
Future<Task> insertRow(
_isd.DatabaseSession session,
Task row, {
_isd.Transaction? transaction,
}) async {
return session.db.insertRow<Task>(
row,
transaction: transaction,
);
}
/// Upserts all [Task]s in the list and returns the resulting rows.
///
/// If a row conflicts on the given [conflictColumns], the existing row is
/// updated with the new values. Otherwise, a new row is inserted.
///
/// If [updateColumns] is provided, only those columns will be updated on
/// conflict. If null, all non-conflict, non-id columns are updated.
///
/// If [updateWhere] is provided, the update only applies to rows matching the
/// given expression. Conflicting rows that don't match are skipped and not
/// returned, so the resulting list may be shorter than [rows].
///
/// The returned [Task]s will have their `id` fields set.
///
/// This is an atomic operation, meaning that if one of the rows fails,
/// none of the rows will be affected.
///
/// If [noReturn] is set to `true`, the resulting rows are not read back from
/// the database and an empty list is returned. This avoids the overhead of
/// transferring and deserializing the rows when the result is not needed.
Future<List<Task>> upsert(
_isd.DatabaseSession session,
List<Task> rows, {
required _isd.ColumnSelections<TaskTable> conflictColumns,
_isd.ColumnSelections<TaskTable>? updateColumns,
_isd.WhereExpressionBuilder<TaskTable>? updateWhere,
_isd.Transaction? transaction,
bool noReturn = false,
}) async {
return session.db.upsert<Task>(
rows,
conflictColumns: conflictColumns(Task.t),
updateColumns: updateColumns?.call(Task.t),
updateWhere: updateWhere?.call(Task.t),
transaction: transaction,
noReturn: noReturn,
);
}
/// Upserts a single [Task] and returns the resulting row.
///
/// If the row conflicts on the given [conflictColumns], the existing row is
/// updated. Otherwise, a new row is inserted.
///
/// If [updateColumns] is provided, only those columns will be updated on
/// conflict. If null, all non-conflict, non-id columns are updated.
///
/// If [updateWhere] is provided, the update only applies when the existing
/// row matches the expression. Returns `null` if no row was affected — for
/// example when [updateWhere] does not match the conflicting row.
///
/// The returned [Task] will have its `id` field set.
Future<Task?> upsertRow(
_isd.DatabaseSession session,
Task row, {
required _isd.ColumnSelections<TaskTable> conflictColumns,
_isd.ColumnSelections<TaskTable>? updateColumns,
_isd.WhereExpressionBuilder<TaskTable>? updateWhere,
_isd.Transaction? transaction,
}) async {
return session.db.upsertRow<Task>(
row,
conflictColumns: conflictColumns(Task.t),
updateColumns: updateColumns?.call(Task.t),
updateWhere: updateWhere?.call(Task.t),
transaction: transaction,
);
}
/// Updates all [Task]s in the list and returns the updated rows. If
/// [columns] is provided, only those columns will be updated. Defaults to
/// all columns.
/// This is an atomic operation, meaning that if one of the rows fails to
/// update, none of the rows will be updated.
///
/// If [noReturn] is set to `true`, the updated rows are not read back from
/// the database and an empty list is returned. This avoids the overhead of
/// transferring and deserializing the rows when the result is not needed.
Future<List<Task>> update(
_isd.DatabaseSession session,
List<Task> rows, {
_isd.ColumnSelections<TaskTable>? columns,
_isd.Transaction? transaction,
bool noReturn = false,
}) async {
return session.db.update<Task>(
rows,
columns: columns?.call(Task.t),
transaction: transaction,
noReturn: noReturn,
);
}
/// Updates a single [Task]. The row needs to have its id set.
/// Optionally, a list of [columns] can be provided to only update those
/// columns. Defaults to all columns.
Future<Task> updateRow(
_isd.DatabaseSession session,
Task row, {
_isd.ColumnSelections<TaskTable>? columns,
_isd.Transaction? transaction,
}) async {
return session.db.updateRow<Task>(
row,
columns: columns?.call(Task.t),
transaction: transaction,
);
}
/// Updates a single [Task] by its [id] with the specified [columnValues].
/// Returns the updated row or null if no row with the given id exists.
Future<Task?> updateById(
_isd.DatabaseSession session,
_isc.UuidValue id, {
required _isd.ColumnValueListBuilder<TaskUpdateTable> columnValues,
_isd.Transaction? transaction,
}) async {
return session.db.updateById<Task>(
id,
columnValues: columnValues(Task.t.updateTable),
transaction: transaction,
);
}
/// Updates all [Task]s matching the [where] expression with the specified [columnValues].
/// Returns the list of updated rows.
///
/// If [noReturn] is set to `true`, the updated rows are not read back from
/// the database and an empty list is returned. This avoids the overhead of
/// transferring and deserializing the rows when the result is not needed.
Future<List<Task>> updateWhere(
_isd.DatabaseSession session, {
required _isd.ColumnValueListBuilder<TaskUpdateTable> columnValues,
required _isd.WhereExpressionBuilder<TaskTable> where,
int? limit,
int? offset,
_isd.OrderByBuilder<TaskTable>? orderBy,
_isd.OrderByListBuilder<TaskTable>? orderByList,
_isd.Transaction? transaction,
bool noReturn = false,
}) async {
return session.db.updateWhere<Task>(
columnValues: columnValues(Task.t.updateTable),
where: where(Task.t),
limit: limit,
offset: offset,
orderBy: orderBy?.call(Task.t),
orderByList: orderByList?.call(Task.t),
transaction: transaction,
noReturn: noReturn,
);
}
/// Deletes all [Task]s in the list and returns the deleted rows.
///
/// To specify the order of the returned rows use [orderBy] or [orderByList]
/// when sorting by multiple columns.
///
/// This is an atomic operation, meaning that if one of the rows fail to
/// be deleted, none of the rows will be deleted.
///
/// If [noReturn] is set to `true`, the deleted rows are not read back from
/// the database and an empty list is returned. This avoids the overhead of
/// transferring and deserializing the rows when the result is not needed.
Future<List<Task>> delete(
_isd.DatabaseSession session,
List<Task> rows, {
_isd.OrderByBuilder<TaskTable>? orderBy,
_isd.OrderByListBuilder<TaskTable>? orderByList,
_isd.Transaction? transaction,
bool noReturn = false,
}) async {
return session.db.delete<Task>(
rows,
orderBy: orderBy?.call(Task.t),
orderByList: orderByList?.call(Task.t),
transaction: transaction,
noReturn: noReturn,
);
}
/// Deletes a single [Task].
Future<Task> deleteRow(
_isd.DatabaseSession session,
Task row, {
_isd.Transaction? transaction,
}) async {
return session.db.deleteRow<Task>(
row,
transaction: transaction,
);
}
/// Deletes all rows matching the [where] expression.
///
/// To specify the order of the returned rows use [orderBy] or [orderByList]
/// when sorting by multiple columns.
///
/// If [noReturn] is set to `true`, the deleted rows are not read back from
/// the database and an empty list is returned. This avoids the overhead of
/// transferring and deserializing the rows when the result is not needed.
Future<List<Task>> deleteWhere(
_isd.DatabaseSession session, {
required _isd.WhereExpressionBuilder<TaskTable> where,
_isd.OrderByBuilder<TaskTable>? orderBy,
_isd.OrderByListBuilder<TaskTable>? orderByList,
_isd.Transaction? transaction,
bool noReturn = false,
}) async {
return session.db.deleteWhere<Task>(
where: where(Task.t),
orderBy: orderBy?.call(Task.t),
orderByList: orderByList?.call(Task.t),
transaction: transaction,
noReturn: noReturn,
);
}
/// Counts the number of rows matching the [where] expression. If omitted,
/// will return the count of all rows in the table.
Future<int> count(
_isd.DatabaseSession session, {
_isd.WhereExpressionBuilder<TaskTable>? where,
int? limit,
_isd.Transaction? transaction,
}) async {
return session.db.count<Task>(
where: where?.call(Task.t),
limit: limit,
transaction: transaction,
);
}
/// Acquires row-level locks on [Task] rows matching the [where] expression.
Future<void> lockRows(
_isd.DatabaseSession session, {
required _isd.WhereExpressionBuilder<TaskTable> where,
required _isd.LockMode lockMode,
required _isd.Transaction transaction,
_isd.LockBehavior lockBehavior = _isd.LockBehavior.wait,
}) async {
return session.db.lockRows<Task>(
where: where(Task.t),
lockMode: lockMode,
lockBehavior: lockBehavior,
transaction: transaction,
);
}
}