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
9 changed files with 22399 additions and 7 deletions
Download patch file Download diff file Expand all files Collapse all files

668
apps/todo/halkyon_todo_server/lib/src/generated/label/label.dart Normal file
View file

@ -0,0 +1,668 @@
/* 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/serverpod.dart' as _is;
/// A label (ADR 0033, D6): its name, colour and place among the others, in
/// its sealed payload (D5); the instance sees that it exists, its size and
/// when it changed. Changed when edited, the last writer winning. Synced.
abstract class Label
implements _is.TableRow<_is.UuidValue?>, _is.ProtocolSerialization {
Label._({
this.id,
this.spaceId,
this.keyId,
required this.payload,
this.nonce,
});
factory Label({
_is.UuidValue? id,
int? spaceId,
String? keyId,
required _idt.ByteData payload,
_idt.ByteData? nonce,
}) = _LabelImpl;
factory Label.fromJson(Map<String, dynamic> jsonSerialization) {
return Label(
id: jsonSerialization['id'] == null
? null
: _is.UuidValueJsonExtension.fromJson(jsonSerialization['id']),
spaceId: jsonSerialization['spaceId'] as int?,
keyId: jsonSerialization['keyId'] as String?,
payload: _is.ByteDataJsonExtension.fromJson(jsonSerialization['payload']),
nonce: jsonSerialization['nonce'] == null
? null
: _is.ByteDataJsonExtension.fromJson(jsonSerialization['nonce']),
);
}
static final t = LabelTable();
static const db = LabelRepository._();
@override
_is.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
_is.Table<_is.UuidValue?> get table => t;
/// Returns a shallow copy of this [Label]
/// with some or all fields replaced by the given arguments.
@_is.useResult
Label copyWith({
_is.UuidValue? id,
int? spaceId,
String? keyId,
_idt.ByteData? payload,
_idt.ByteData? nonce,
});
@override
Map<String, dynamic> toJson() {
return {
'__className__': 'Label',
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__': 'Label',
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 LabelInclude include() {
return LabelInclude._();
}
static LabelIncludeList includeList({
_is.WhereExpressionBuilder<LabelTable>? where,
int? limit,
int? offset,
_is.OrderByBuilder<LabelTable>? orderBy,
_is.OrderByListBuilder<LabelTable>? orderByList,
LabelInclude? include,
}) {
return LabelIncludeList._(
where: where,
limit: limit,
offset: offset,
orderBy: orderBy?.call(Label.t),
orderByList: orderByList?.call(Label.t),
include: include,
);
}
@override
String toString() {
return _is.SerializationManager.encode(this);
}
}
class _Undefined {}
class _LabelImpl extends Label {
_LabelImpl({
_is.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 [Label]
/// with some or all fields replaced by the given arguments.
@_is.useResult
@override
Label copyWith({
Object? id = _Undefined,
Object? spaceId = _Undefined,
Object? keyId = _Undefined,
_idt.ByteData? payload,
Object? nonce = _Undefined,
}) {
return Label(
id: id is _is.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 LabelUpdateTable extends _is.UpdateTable<LabelTable> {
LabelUpdateTable(super.table);
_is.ColumnValue<int, int> spaceId(int? value) => _is.ColumnValue(
table.spaceId,
value,
);
_is.ColumnValue<String, String> keyId(String? value) => _is.ColumnValue(
table.keyId,
value,
);
_is.ColumnValue<_idt.ByteData, _idt.ByteData> payload(_idt.ByteData value) =>
_is.ColumnValue(
table.payload,
value,
);
_is.ColumnValue<_idt.ByteData, _idt.ByteData> nonce(_idt.ByteData? value) =>
_is.ColumnValue(
table.nonce,
value,
);
}
class LabelTable extends _is.Table<_is.UuidValue?> {
LabelTable({super.tableRelation}) : super(tableName: 'label') {
updateTable = LabelUpdateTable(this);
spaceId = _is.ColumnInt(
'spaceId',
this,
);
keyId = _is.ColumnString(
'keyId',
this,
);
payload = _is.ColumnByteData(
'payload',
this,
);
nonce = _is.ColumnByteData(
'nonce',
this,
);
}
late final LabelUpdateTable updateTable;
/// The space owning this row. Maintained by the sync engine.
late final _is.ColumnInt spaceId;
/// The key it is sealed with (ADR 0002's envelope); never null in Todo,
/// where everything is sealed.
late final _is.ColumnString keyId;
/// The content, sealed: UTF-8 JSON with a `schemaVersion` once opened.
late final _is.ColumnByteData payload;
/// The sealing's nonce (ADR 0002's envelope).
late final _is.ColumnByteData nonce;
@override
List<_is.Column> get columns => [
id,
spaceId,
keyId,
payload,
nonce,
];
}
class LabelInclude extends _is.IncludeObject {
LabelInclude._();
@override
Map<String, _is.Include?> get includes => {};
@override
_is.Table<_is.UuidValue?> get table => Label.t;
}
class LabelIncludeList extends _is.IncludeList {
LabelIncludeList._({
_is.WhereExpressionBuilder<LabelTable>? where,
super.limit,
super.offset,
super.orderBy,
super.orderByList,
super.include,
}) {
super.where = where?.call(Label.t);
}
@override
Map<String, _is.Include?> get includes => include?.includes ?? {};
@override
_is.Table<_is.UuidValue?> get table => Label.t;
}
class LabelRepository {
const LabelRepository._();
/// Returns a list of [Label]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<Label>> find(
_is.DatabaseSession session, {
_is.WhereExpressionBuilder<LabelTable>? where,
int? limit,
int? offset,
_is.OrderByBuilder<LabelTable>? orderBy,
_is.OrderByListBuilder<LabelTable>? orderByList,
_is.Transaction? transaction,
_is.LockMode? lockMode,
_is.LockBehavior? lockBehavior,
}) async {
return session.db.find<Label>(
where: where?.call(Label.t),
orderBy: orderBy?.call(Label.t),
orderByList: orderByList?.call(Label.t),
limit: limit,
offset: offset,
transaction: transaction,
lockMode: lockMode,
lockBehavior: lockBehavior,
);
}
/// Returns the first matching [Label] 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<Label?> findFirstRow(
_is.DatabaseSession session, {
_is.WhereExpressionBuilder<LabelTable>? where,
int? offset,
_is.OrderByBuilder<LabelTable>? orderBy,
_is.OrderByListBuilder<LabelTable>? orderByList,
_is.Transaction? transaction,
_is.LockMode? lockMode,
_is.LockBehavior? lockBehavior,
}) async {
return session.db.findFirstRow<Label>(
where: where?.call(Label.t),
orderBy: orderBy?.call(Label.t),
orderByList: orderByList?.call(Label.t),
offset: offset,
transaction: transaction,
lockMode: lockMode,
lockBehavior: lockBehavior,
);
}
/// Finds a single [Label] by its [id] or null if no such row exists.
Future<Label?> findById(
_is.DatabaseSession session,
_is.UuidValue id, {
_is.Transaction? transaction,
_is.LockMode? lockMode,
_is.LockBehavior? lockBehavior,
}) async {
return session.db.findById<Label>(
id,
transaction: transaction,
lockMode: lockMode,
lockBehavior: lockBehavior,
);
}
/// Inserts all [Label]s in the list and returns the inserted rows.
///
/// The returned [Label]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<Label>> insert(
_is.DatabaseSession session,
List<Label> rows, {
_is.Transaction? transaction,
bool ignoreConflicts = false,
bool noReturn = false,
}) async {
return session.db.insert<Label>(
rows,
transaction: transaction,
ignoreConflicts: ignoreConflicts,
noReturn: noReturn,
);
}
/// Inserts a single [Label] and returns the inserted row.
///
/// The returned [Label] will have its `id` field set.
Future<Label> insertRow(
_is.DatabaseSession session,
Label row, {
_is.Transaction? transaction,
}) async {
return session.db.insertRow<Label>(
row,
transaction: transaction,
);
}
/// Upserts all [Label]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 [Label]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<Label>> upsert(
_is.DatabaseSession session,
List<Label> rows, {
required _is.ColumnSelections<LabelTable> conflictColumns,
_is.ColumnSelections<LabelTable>? updateColumns,
_is.WhereExpressionBuilder<LabelTable>? updateWhere,
_is.Transaction? transaction,
bool noReturn = false,
}) async {
return session.db.upsert<Label>(
rows,
conflictColumns: conflictColumns(Label.t),
updateColumns: updateColumns?.call(Label.t),
updateWhere: updateWhere?.call(Label.t),
transaction: transaction,
noReturn: noReturn,
);
}
/// Upserts a single [Label] 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 [Label] will have its `id` field set.
Future<Label?> upsertRow(
_is.DatabaseSession session,
Label row, {
required _is.ColumnSelections<LabelTable> conflictColumns,
_is.ColumnSelections<LabelTable>? updateColumns,
_is.WhereExpressionBuilder<LabelTable>? updateWhere,
_is.Transaction? transaction,
}) async {
return session.db.upsertRow<Label>(
row,
conflictColumns: conflictColumns(Label.t),
updateColumns: updateColumns?.call(Label.t),
updateWhere: updateWhere?.call(Label.t),
transaction: transaction,
);
}
/// Updates all [Label]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<Label>> update(
_is.DatabaseSession session,
List<Label> rows, {
_is.ColumnSelections<LabelTable>? columns,
_is.Transaction? transaction,
bool noReturn = false,
}) async {
return session.db.update<Label>(
rows,
columns: columns?.call(Label.t),
transaction: transaction,
noReturn: noReturn,
);
}
/// Updates a single [Label]. 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<Label> updateRow(
_is.DatabaseSession session,
Label row, {
_is.ColumnSelections<LabelTable>? columns,
_is.Transaction? transaction,
}) async {
return session.db.updateRow<Label>(
row,
columns: columns?.call(Label.t),
transaction: transaction,
);
}
/// Updates a single [Label] by its [id] with the specified [columnValues].
/// Returns the updated row or null if no row with the given id exists.
Future<Label?> updateById(
_is.DatabaseSession session,
_is.UuidValue id, {
required _is.ColumnValueListBuilder<LabelUpdateTable> columnValues,
_is.Transaction? transaction,
}) async {
return session.db.updateById<Label>(
id,
columnValues: columnValues(Label.t.updateTable),
transaction: transaction,
);
}
/// Updates all [Label]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<Label>> updateWhere(
_is.DatabaseSession session, {
required _is.ColumnValueListBuilder<LabelUpdateTable> columnValues,
required _is.WhereExpressionBuilder<LabelTable> where,
int? limit,
int? offset,
_is.OrderByBuilder<LabelTable>? orderBy,
_is.OrderByListBuilder<LabelTable>? orderByList,
_is.Transaction? transaction,
bool noReturn = false,
}) async {
return session.db.updateWhere<Label>(
columnValues: columnValues(Label.t.updateTable),
where: where(Label.t),
limit: limit,
offset: offset,
orderBy: orderBy?.call(Label.t),
orderByList: orderByList?.call(Label.t),
transaction: transaction,
noReturn: noReturn,
);
}
/// Deletes all [Label]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<Label>> delete(
_is.DatabaseSession session,
List<Label> rows, {
_is.OrderByBuilder<LabelTable>? orderBy,
_is.OrderByListBuilder<LabelTable>? orderByList,
_is.Transaction? transaction,
bool noReturn = false,
}) async {
return session.db.delete<Label>(
rows,
orderBy: orderBy?.call(Label.t),
orderByList: orderByList?.call(Label.t),
transaction: transaction,
noReturn: noReturn,
);
}
/// Deletes a single [Label].
Future<Label> deleteRow(
_is.DatabaseSession session,
Label row, {
_is.Transaction? transaction,
}) async {
return session.db.deleteRow<Label>(
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<Label>> deleteWhere(
_is.DatabaseSession session, {
required _is.WhereExpressionBuilder<LabelTable> where,
_is.OrderByBuilder<LabelTable>? orderBy,
_is.OrderByListBuilder<LabelTable>? orderByList,
_is.Transaction? transaction,
bool noReturn = false,
}) async {
return session.db.deleteWhere<Label>(
where: where(Label.t),
orderBy: orderBy?.call(Label.t),
orderByList: orderByList?.call(Label.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(
_is.DatabaseSession session, {
_is.WhereExpressionBuilder<LabelTable>? where,
int? limit,
_is.Transaction? transaction,
}) async {
return session.db.count<Label>(
where: where?.call(Label.t),
limit: limit,
transaction: transaction,
);
}
/// Acquires row-level locks on [Label] rows matching the [where] expression.
Future<void> lockRows(
_is.DatabaseSession session, {
required _is.WhereExpressionBuilder<LabelTable> where,
required _is.LockMode lockMode,
required _is.Transaction transaction,
_is.LockBehavior lockBehavior = _is.LockBehavior.wait,
}) async {
return session.db.lockRows<Label>(
where: where(Label.t),
lockMode: lockMode,
lockBehavior: lockBehavior,
transaction: transaction,
);
}
}

669
apps/todo/halkyon_todo_server/lib/src/generated/project/section.dart Normal file
View file

@ -0,0 +1,669 @@
/* 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/serverpod.dart' as _is;
/// A section of a project (ADR 0033, D6): its name, description, project and
/// place among the project's sections, all in its sealed payload (D5); the
/// instance sees that it exists, its size and when it changed. Changed when
/// edited, the last writer winning. Synced.
abstract class Section
implements _is.TableRow<_is.UuidValue?>, _is.ProtocolSerialization {
Section._({
this.id,
this.spaceId,
this.keyId,
required this.payload,
this.nonce,
});
factory Section({
_is.UuidValue? id,
int? spaceId,
String? keyId,
required _idt.ByteData payload,
_idt.ByteData? nonce,
}) = _SectionImpl;
factory Section.fromJson(Map<String, dynamic> jsonSerialization) {
return Section(
id: jsonSerialization['id'] == null
? null
: _is.UuidValueJsonExtension.fromJson(jsonSerialization['id']),
spaceId: jsonSerialization['spaceId'] as int?,
keyId: jsonSerialization['keyId'] as String?,
payload: _is.ByteDataJsonExtension.fromJson(jsonSerialization['payload']),
nonce: jsonSerialization['nonce'] == null
? null
: _is.ByteDataJsonExtension.fromJson(jsonSerialization['nonce']),
);
}
static final t = SectionTable();
static const db = SectionRepository._();
@override
_is.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
_is.Table<_is.UuidValue?> get table => t;
/// Returns a shallow copy of this [Section]
/// with some or all fields replaced by the given arguments.
@_is.useResult
Section copyWith({
_is.UuidValue? id,
int? spaceId,
String? keyId,
_idt.ByteData? payload,
_idt.ByteData? nonce,
});
@override
Map<String, dynamic> toJson() {
return {
'__className__': 'Section',
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__': 'Section',
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 SectionInclude include() {
return SectionInclude._();
}
static SectionIncludeList includeList({
_is.WhereExpressionBuilder<SectionTable>? where,
int? limit,
int? offset,
_is.OrderByBuilder<SectionTable>? orderBy,
_is.OrderByListBuilder<SectionTable>? orderByList,
SectionInclude? include,
}) {
return SectionIncludeList._(
where: where,
limit: limit,
offset: offset,
orderBy: orderBy?.call(Section.t),
orderByList: orderByList?.call(Section.t),
include: include,
);
}
@override
String toString() {
return _is.SerializationManager.encode(this);
}
}
class _Undefined {}
class _SectionImpl extends Section {
_SectionImpl({
_is.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 [Section]
/// with some or all fields replaced by the given arguments.
@_is.useResult
@override
Section copyWith({
Object? id = _Undefined,
Object? spaceId = _Undefined,
Object? keyId = _Undefined,
_idt.ByteData? payload,
Object? nonce = _Undefined,
}) {
return Section(
id: id is _is.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 SectionUpdateTable extends _is.UpdateTable<SectionTable> {
SectionUpdateTable(super.table);
_is.ColumnValue<int, int> spaceId(int? value) => _is.ColumnValue(
table.spaceId,
value,
);
_is.ColumnValue<String, String> keyId(String? value) => _is.ColumnValue(
table.keyId,
value,
);
_is.ColumnValue<_idt.ByteData, _idt.ByteData> payload(_idt.ByteData value) =>
_is.ColumnValue(
table.payload,
value,
);
_is.ColumnValue<_idt.ByteData, _idt.ByteData> nonce(_idt.ByteData? value) =>
_is.ColumnValue(
table.nonce,
value,
);
}
class SectionTable extends _is.Table<_is.UuidValue?> {
SectionTable({super.tableRelation}) : super(tableName: 'section') {
updateTable = SectionUpdateTable(this);
spaceId = _is.ColumnInt(
'spaceId',
this,
);
keyId = _is.ColumnString(
'keyId',
this,
);
payload = _is.ColumnByteData(
'payload',
this,
);
nonce = _is.ColumnByteData(
'nonce',
this,
);
}
late final SectionUpdateTable updateTable;
/// The space owning this row. Maintained by the sync engine.
late final _is.ColumnInt spaceId;
/// The key it is sealed with (ADR 0002's envelope); never null in Todo,
/// where everything is sealed.
late final _is.ColumnString keyId;
/// The content, sealed: UTF-8 JSON with a `schemaVersion` once opened.
late final _is.ColumnByteData payload;
/// The sealing's nonce (ADR 0002's envelope).
late final _is.ColumnByteData nonce;
@override
List<_is.Column> get columns => [
id,
spaceId,
keyId,
payload,
nonce,
];
}
class SectionInclude extends _is.IncludeObject {
SectionInclude._();
@override
Map<String, _is.Include?> get includes => {};
@override
_is.Table<_is.UuidValue?> get table => Section.t;
}
class SectionIncludeList extends _is.IncludeList {
SectionIncludeList._({
_is.WhereExpressionBuilder<SectionTable>? where,
super.limit,
super.offset,
super.orderBy,
super.orderByList,
super.include,
}) {
super.where = where?.call(Section.t);
}
@override
Map<String, _is.Include?> get includes => include?.includes ?? {};
@override
_is.Table<_is.UuidValue?> get table => Section.t;
}
class SectionRepository {
const SectionRepository._();
/// Returns a list of [Section]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<Section>> find(
_is.DatabaseSession session, {
_is.WhereExpressionBuilder<SectionTable>? where,
int? limit,
int? offset,
_is.OrderByBuilder<SectionTable>? orderBy,
_is.OrderByListBuilder<SectionTable>? orderByList,
_is.Transaction? transaction,
_is.LockMode? lockMode,
_is.LockBehavior? lockBehavior,
}) async {
return session.db.find<Section>(
where: where?.call(Section.t),
orderBy: orderBy?.call(Section.t),
orderByList: orderByList?.call(Section.t),
limit: limit,
offset: offset,
transaction: transaction,
lockMode: lockMode,
lockBehavior: lockBehavior,
);
}
/// Returns the first matching [Section] 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<Section?> findFirstRow(
_is.DatabaseSession session, {
_is.WhereExpressionBuilder<SectionTable>? where,
int? offset,
_is.OrderByBuilder<SectionTable>? orderBy,
_is.OrderByListBuilder<SectionTable>? orderByList,
_is.Transaction? transaction,
_is.LockMode? lockMode,
_is.LockBehavior? lockBehavior,
}) async {
return session.db.findFirstRow<Section>(
where: where?.call(Section.t),
orderBy: orderBy?.call(Section.t),
orderByList: orderByList?.call(Section.t),
offset: offset,
transaction: transaction,
lockMode: lockMode,
lockBehavior: lockBehavior,
);
}
/// Finds a single [Section] by its [id] or null if no such row exists.
Future<Section?> findById(
_is.DatabaseSession session,
_is.UuidValue id, {
_is.Transaction? transaction,
_is.LockMode? lockMode,
_is.LockBehavior? lockBehavior,
}) async {
return session.db.findById<Section>(
id,
transaction: transaction,
lockMode: lockMode,
lockBehavior: lockBehavior,
);
}
/// Inserts all [Section]s in the list and returns the inserted rows.
///
/// The returned [Section]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<Section>> insert(
_is.DatabaseSession session,
List<Section> rows, {
_is.Transaction? transaction,
bool ignoreConflicts = false,
bool noReturn = false,
}) async {
return session.db.insert<Section>(
rows,
transaction: transaction,
ignoreConflicts: ignoreConflicts,
noReturn: noReturn,
);
}
/// Inserts a single [Section] and returns the inserted row.
///
/// The returned [Section] will have its `id` field set.
Future<Section> insertRow(
_is.DatabaseSession session,
Section row, {
_is.Transaction? transaction,
}) async {
return session.db.insertRow<Section>(
row,
transaction: transaction,
);
}
/// Upserts all [Section]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 [Section]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<Section>> upsert(
_is.DatabaseSession session,
List<Section> rows, {
required _is.ColumnSelections<SectionTable> conflictColumns,
_is.ColumnSelections<SectionTable>? updateColumns,
_is.WhereExpressionBuilder<SectionTable>? updateWhere,
_is.Transaction? transaction,
bool noReturn = false,
}) async {
return session.db.upsert<Section>(
rows,
conflictColumns: conflictColumns(Section.t),
updateColumns: updateColumns?.call(Section.t),
updateWhere: updateWhere?.call(Section.t),
transaction: transaction,
noReturn: noReturn,
);
}
/// Upserts a single [Section] 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 [Section] will have its `id` field set.
Future<Section?> upsertRow(
_is.DatabaseSession session,
Section row, {
required _is.ColumnSelections<SectionTable> conflictColumns,
_is.ColumnSelections<SectionTable>? updateColumns,
_is.WhereExpressionBuilder<SectionTable>? updateWhere,
_is.Transaction? transaction,
}) async {
return session.db.upsertRow<Section>(
row,
conflictColumns: conflictColumns(Section.t),
updateColumns: updateColumns?.call(Section.t),
updateWhere: updateWhere?.call(Section.t),
transaction: transaction,
);
}
/// Updates all [Section]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<Section>> update(
_is.DatabaseSession session,
List<Section> rows, {
_is.ColumnSelections<SectionTable>? columns,
_is.Transaction? transaction,
bool noReturn = false,
}) async {
return session.db.update<Section>(
rows,
columns: columns?.call(Section.t),
transaction: transaction,
noReturn: noReturn,
);
}
/// Updates a single [Section]. 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<Section> updateRow(
_is.DatabaseSession session,
Section row, {
_is.ColumnSelections<SectionTable>? columns,
_is.Transaction? transaction,
}) async {
return session.db.updateRow<Section>(
row,
columns: columns?.call(Section.t),
transaction: transaction,
);
}
/// Updates a single [Section] by its [id] with the specified [columnValues].
/// Returns the updated row or null if no row with the given id exists.
Future<Section?> updateById(
_is.DatabaseSession session,
_is.UuidValue id, {
required _is.ColumnValueListBuilder<SectionUpdateTable> columnValues,
_is.Transaction? transaction,
}) async {
return session.db.updateById<Section>(
id,
columnValues: columnValues(Section.t.updateTable),
transaction: transaction,
);
}
/// Updates all [Section]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<Section>> updateWhere(
_is.DatabaseSession session, {
required _is.ColumnValueListBuilder<SectionUpdateTable> columnValues,
required _is.WhereExpressionBuilder<SectionTable> where,
int? limit,
int? offset,
_is.OrderByBuilder<SectionTable>? orderBy,
_is.OrderByListBuilder<SectionTable>? orderByList,
_is.Transaction? transaction,
bool noReturn = false,
}) async {
return session.db.updateWhere<Section>(
columnValues: columnValues(Section.t.updateTable),
where: where(Section.t),
limit: limit,
offset: offset,
orderBy: orderBy?.call(Section.t),
orderByList: orderByList?.call(Section.t),
transaction: transaction,
noReturn: noReturn,
);
}
/// Deletes all [Section]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<Section>> delete(
_is.DatabaseSession session,
List<Section> rows, {
_is.OrderByBuilder<SectionTable>? orderBy,
_is.OrderByListBuilder<SectionTable>? orderByList,
_is.Transaction? transaction,
bool noReturn = false,
}) async {
return session.db.delete<Section>(
rows,
orderBy: orderBy?.call(Section.t),
orderByList: orderByList?.call(Section.t),
transaction: transaction,
noReturn: noReturn,
);
}
/// Deletes a single [Section].
Future<Section> deleteRow(
_is.DatabaseSession session,
Section row, {
_is.Transaction? transaction,
}) async {
return session.db.deleteRow<Section>(
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<Section>> deleteWhere(
_is.DatabaseSession session, {
required _is.WhereExpressionBuilder<SectionTable> where,
_is.OrderByBuilder<SectionTable>? orderBy,
_is.OrderByListBuilder<SectionTable>? orderByList,
_is.Transaction? transaction,
bool noReturn = false,
}) async {
return session.db.deleteWhere<Section>(
where: where(Section.t),
orderBy: orderBy?.call(Section.t),
orderByList: orderByList?.call(Section.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(
_is.DatabaseSession session, {
_is.WhereExpressionBuilder<SectionTable>? where,
int? limit,
_is.Transaction? transaction,
}) async {
return session.db.count<Section>(
where: where?.call(Section.t),
limit: limit,
transaction: transaction,
);
}
/// Acquires row-level locks on [Section] rows matching the [where] expression.
Future<void> lockRows(
_is.DatabaseSession session, {
required _is.WhereExpressionBuilder<SectionTable> where,
required _is.LockMode lockMode,
required _is.Transaction transaction,
_is.LockBehavior lockBehavior = _is.LockBehavior.wait,
}) async {
return session.db.lockRows<Section>(
where: where(Section.t),
lockMode: lockMode,
lockBehavior: lockBehavior,
transaction: transaction,
);
}
}

249
apps/todo/halkyon_todo_server/lib/src/generated/protocol.dart
View file

@ -21,10 +21,16 @@ import 'package:serverpod_auth_idp_server/serverpod_auth_idp_server.dart'
as _iais;
import 'package:serverpod_offline_sync_server/serverpod_offline_sync_server.dart'
as _izehhkf5;
import 'label/label.dart' as _ivak08z4;
import 'privacy/content_key.dart' as _imed3x5d;
import 'project/project.dart' as _i9c44spp;
import 'project/section.dart' as _imadkvi9;
import 'task/task.dart' as _ib4f8uyw;
export 'label/label.dart';
export 'privacy/content_key.dart';
export 'project/project.dart';
export 'project/section.dart';
export 'task/task.dart';
export 'sync_tables.dart';
class Protocol extends _is.DatabaseSerializationManager {
@ -96,6 +102,73 @@ class Protocol extends _is.DatabaseSerializationManager {
],
managed: true,
),
_isp.TableDefinition(
name: 'label',
dartName: 'Label',
schema: 'public',
module: 'halkyon_todo',
columns: [
_isp.ColumnDefinition(
name: 'id',
columnType: _isp.ColumnType.uuid,
isNullable: false,
dartType: 'UuidValue?',
columnDefault: 'random_v7',
),
_isp.ColumnDefinition(
name: 'spaceId',
columnType: _isp.ColumnType.bigint,
isNullable: true,
dartType: 'int?',
),
_isp.ColumnDefinition(
name: 'keyId',
columnType: _isp.ColumnType.text,
isNullable: true,
dartType: 'String?',
),
_isp.ColumnDefinition(
name: 'payload',
columnType: _isp.ColumnType.bytea,
isNullable: false,
dartType: 'dart:typed_data:ByteData',
),
_isp.ColumnDefinition(
name: 'nonce',
columnType: _isp.ColumnType.bytea,
isNullable: true,
dartType: 'dart:typed_data:ByteData?',
),
],
foreignKeys: [
_isp.ForeignKeyDefinition(
constraintName: 'label_fk_0',
columns: ['spaceId'],
referenceTable: 'offline_sync_spaces',
referenceTableSchema: 'public',
referenceColumns: ['id'],
onUpdate: _isp.ForeignKeyAction.noAction,
onDelete: _isp.ForeignKeyAction.cascade,
matchType: null,
),
],
indexes: [
_isp.IndexDefinition(
indexName: 'label_space_idx',
tableSpace: null,
elements: [
_isp.IndexElementDefinition(
type: _isp.IndexElementDefinitionType.column,
definition: 'spaceId',
),
],
type: 'btree',
isUnique: false,
isPrimary: false,
),
],
managed: true,
),
_isp.TableDefinition(
name: 'project',
dartName: 'Project',
@ -163,6 +236,140 @@ class Protocol extends _is.DatabaseSerializationManager {
],
managed: true,
),
_isp.TableDefinition(
name: 'section',
dartName: 'Section',
schema: 'public',
module: 'halkyon_todo',
columns: [
_isp.ColumnDefinition(
name: 'id',
columnType: _isp.ColumnType.uuid,
isNullable: false,
dartType: 'UuidValue?',
columnDefault: 'random_v7',
),
_isp.ColumnDefinition(
name: 'spaceId',
columnType: _isp.ColumnType.bigint,
isNullable: true,
dartType: 'int?',
),
_isp.ColumnDefinition(
name: 'keyId',
columnType: _isp.ColumnType.text,
isNullable: true,
dartType: 'String?',
),
_isp.ColumnDefinition(
name: 'payload',
columnType: _isp.ColumnType.bytea,
isNullable: false,
dartType: 'dart:typed_data:ByteData',
),
_isp.ColumnDefinition(
name: 'nonce',
columnType: _isp.ColumnType.bytea,
isNullable: true,
dartType: 'dart:typed_data:ByteData?',
),
],
foreignKeys: [
_isp.ForeignKeyDefinition(
constraintName: 'section_fk_0',
columns: ['spaceId'],
referenceTable: 'offline_sync_spaces',
referenceTableSchema: 'public',
referenceColumns: ['id'],
onUpdate: _isp.ForeignKeyAction.noAction,
onDelete: _isp.ForeignKeyAction.cascade,
matchType: null,
),
],
indexes: [
_isp.IndexDefinition(
indexName: 'section_space_idx',
tableSpace: null,
elements: [
_isp.IndexElementDefinition(
type: _isp.IndexElementDefinitionType.column,
definition: 'spaceId',
),
],
type: 'btree',
isUnique: false,
isPrimary: false,
),
],
managed: true,
),
_isp.TableDefinition(
name: 'task',
dartName: 'Task',
schema: 'public',
module: 'halkyon_todo',
columns: [
_isp.ColumnDefinition(
name: 'id',
columnType: _isp.ColumnType.uuid,
isNullable: false,
dartType: 'UuidValue?',
columnDefault: 'random_v7',
),
_isp.ColumnDefinition(
name: 'spaceId',
columnType: _isp.ColumnType.bigint,
isNullable: true,
dartType: 'int?',
),
_isp.ColumnDefinition(
name: 'keyId',
columnType: _isp.ColumnType.text,
isNullable: true,
dartType: 'String?',
),
_isp.ColumnDefinition(
name: 'payload',
columnType: _isp.ColumnType.bytea,
isNullable: false,
dartType: 'dart:typed_data:ByteData',
),
_isp.ColumnDefinition(
name: 'nonce',
columnType: _isp.ColumnType.bytea,
isNullable: true,
dartType: 'dart:typed_data:ByteData?',
),
],
foreignKeys: [
_isp.ForeignKeyDefinition(
constraintName: 'task_fk_0',
columns: ['spaceId'],
referenceTable: 'offline_sync_spaces',
referenceTableSchema: 'public',
referenceColumns: ['id'],
onUpdate: _isp.ForeignKeyAction.noAction,
onDelete: _isp.ForeignKeyAction.cascade,
matchType: null,
),
],
indexes: [
_isp.IndexDefinition(
indexName: 'task_space_idx',
tableSpace: null,
elements: [
_isp.IndexElementDefinition(
type: _isp.IndexElementDefinitionType.column,
definition: 'spaceId',
),
],
type: 'btree',
isUnique: false,
isPrimary: false,
),
],
managed: true,
),
..._ik8molhd.Protocol.targetTableDefinitions,
..._iais.Protocol.targetTableDefinitions,
..._izehhkf5.Protocol.targetTableDefinitions,
@ -198,18 +405,36 @@ class Protocol extends _is.DatabaseSerializationManager {
}
}
if (t == _ivak08z4.Label) {
return _ivak08z4.Label.fromJson(data) as T;
}
if (t == _imed3x5d.ContentKey) {
return _imed3x5d.ContentKey.fromJson(data) as T;
}
if (t == _i9c44spp.Project) {
return _i9c44spp.Project.fromJson(data) as T;
}
if (t == _imadkvi9.Section) {
return _imadkvi9.Section.fromJson(data) as T;
}
if (t == _ib4f8uyw.Task) {
return _ib4f8uyw.Task.fromJson(data) as T;
}
if (t == _is.getType<_ivak08z4.Label?>()) {
return (data != null ? _ivak08z4.Label.fromJson(data) : null) as T;
}
if (t == _is.getType<_imed3x5d.ContentKey?>()) {
return (data != null ? _imed3x5d.ContentKey.fromJson(data) : null) as T;
}
if (t == _is.getType<_i9c44spp.Project?>()) {
return (data != null ? _i9c44spp.Project.fromJson(data) : null) as T;
}
if (t == _is.getType<_imadkvi9.Section?>()) {
return (data != null ? _imadkvi9.Section.fromJson(data) : null) as T;
}
if (t == _is.getType<_ib4f8uyw.Task?>()) {
return (data != null ? _ib4f8uyw.Task.fromJson(data) : null) as T;
}
try {
return _ik8molhd.Protocol().deserialize<T>(data, t);
} on _is.DeserializationTypeNotFoundException catch (_) {}
@ -233,8 +458,11 @@ class Protocol extends _is.DatabaseSerializationManager {
static String? getClassNameForType(Type type) {
return switch (type) {
_ivak08z4.Label => 'Label',
_imed3x5d.ContentKey => 'ContentKey',
_i9c44spp.Project => 'Project',
_imadkvi9.Section => 'Section',
_ib4f8uyw.Task => 'Task',
_ => null,
};
}
@ -252,10 +480,16 @@ class Protocol extends _is.DatabaseSerializationManager {
}
switch (data) {
case _ivak08z4.Label():
return 'Label';
case _imed3x5d.ContentKey():
return 'ContentKey';
case _i9c44spp.Project():
return 'Project';
case _imadkvi9.Section():
return 'Section';
case _ib4f8uyw.Task():
return 'Task';
}
className = _ik8molhd.Protocol().getClassNameForObject(data);
if (className != null) {
@ -296,12 +530,21 @@ class Protocol extends _is.DatabaseSerializationManager {
if (dataClassName is! String) {
return super.deserializeByClassName(data);
}
if (dataClassName == 'Label') {
return deserialize<_ivak08z4.Label>(data['data']);
}
if (dataClassName == 'ContentKey') {
return deserialize<_imed3x5d.ContentKey>(data['data']);
}
if (dataClassName == 'Project') {
return deserialize<_i9c44spp.Project>(data['data']);
}
if (dataClassName == 'Section') {
return deserialize<_imadkvi9.Section>(data['data']);
}
if (dataClassName == 'Task') {
return deserialize<_ib4f8uyw.Task>(data['data']);
}
if (dataClassName.startsWith('halkyon_base.')) {
data['className'] = dataClassName.substring(13);
return _ik8molhd.Protocol().deserializeByClassName(data);
@ -376,10 +619,16 @@ class Protocol extends _is.DatabaseSerializationManager {
}
}
switch (t) {
case _ivak08z4.Label:
return _ivak08z4.Label.t;
case _imed3x5d.ContentKey:
return _imed3x5d.ContentKey.t;
case _i9c44spp.Project:
return _i9c44spp.Project.t;
case _imadkvi9.Section:
return _imadkvi9.Section.t;
case _ib4f8uyw.Task:
return _ib4f8uyw.Task.t;
}
return null;
}

6
apps/todo/halkyon_todo_server/lib/src/generated/sync_tables.dart
View file

@ -11,13 +11,19 @@
// ignore_for_file: no_leading_underscores_for_library_prefixes
import 'package:serverpod/serverpod.dart' as _is;
import 'label/label.dart' as _ivak08z4;
import 'privacy/content_key.dart' as _imed3x5d;
import 'project/project.dart' as _i9c44spp;
import 'project/section.dart' as _imadkvi9;
import 'task/task.dart' as _ib4f8uyw;
/// The tables synchronized between client and server by the
/// `serverpod_offline_sync` package, including the ones owned by modules and
/// shared packages.
final List<_is.Table> syncTables = [
_imed3x5d.ContentKey.t,
_ivak08z4.Label.t,
_i9c44spp.Project.t,
_imadkvi9.Section.t,
_ib4f8uyw.Task.t,
];

671
apps/todo/halkyon_todo_server/lib/src/generated/task/task.dart Normal file
View file

@ -0,0 +1,671 @@
/* 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/serverpod.dart' as _is;
/// 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 _is.TableRow<_is.UuidValue?>, _is.ProtocolSerialization {
Task._({
this.id,
this.spaceId,
this.keyId,
required this.payload,
this.nonce,
});
factory Task({
_is.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
: _is.UuidValueJsonExtension.fromJson(jsonSerialization['id']),
spaceId: jsonSerialization['spaceId'] as int?,
keyId: jsonSerialization['keyId'] as String?,
payload: _is.ByteDataJsonExtension.fromJson(jsonSerialization['payload']),
nonce: jsonSerialization['nonce'] == null
? null
: _is.ByteDataJsonExtension.fromJson(jsonSerialization['nonce']),
);
}
static final t = TaskTable();
static const db = TaskRepository._();
@override
_is.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
_is.Table<_is.UuidValue?> get table => t;
/// Returns a shallow copy of this [Task]
/// with some or all fields replaced by the given arguments.
@_is.useResult
Task copyWith({
_is.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({
_is.WhereExpressionBuilder<TaskTable>? where,
int? limit,
int? offset,
_is.OrderByBuilder<TaskTable>? orderBy,
_is.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 _is.SerializationManager.encode(this);
}
}
class _Undefined {}
class _TaskImpl extends Task {
_TaskImpl({
_is.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.
@_is.useResult
@override
Task copyWith({
Object? id = _Undefined,
Object? spaceId = _Undefined,
Object? keyId = _Undefined,
_idt.ByteData? payload,
Object? nonce = _Undefined,
}) {
return Task(
id: id is _is.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 _is.UpdateTable<TaskTable> {
TaskUpdateTable(super.table);
_is.ColumnValue<int, int> spaceId(int? value) => _is.ColumnValue(
table.spaceId,
value,
);
_is.ColumnValue<String, String> keyId(String? value) => _is.ColumnValue(
table.keyId,
value,
);
_is.ColumnValue<_idt.ByteData, _idt.ByteData> payload(_idt.ByteData value) =>
_is.ColumnValue(
table.payload,
value,
);
_is.ColumnValue<_idt.ByteData, _idt.ByteData> nonce(_idt.ByteData? value) =>
_is.ColumnValue(
table.nonce,
value,
);
}
class TaskTable extends _is.Table<_is.UuidValue?> {
TaskTable({super.tableRelation}) : super(tableName: 'task') {
updateTable = TaskUpdateTable(this);
spaceId = _is.ColumnInt(
'spaceId',
this,
);
keyId = _is.ColumnString(
'keyId',
this,
);
payload = _is.ColumnByteData(
'payload',
this,
);
nonce = _is.ColumnByteData(
'nonce',
this,
);
}
late final TaskUpdateTable updateTable;
/// The space owning this row. Maintained by the sync engine.
late final _is.ColumnInt spaceId;
/// The key it is sealed with (ADR 0002's envelope); never null in Todo,
/// where everything is sealed.
late final _is.ColumnString keyId;
/// The content, sealed: UTF-8 JSON with a `schemaVersion` once opened.
late final _is.ColumnByteData payload;
/// The sealing's nonce (ADR 0002's envelope).
late final _is.ColumnByteData nonce;
@override
List<_is.Column> get columns => [
id,
spaceId,
keyId,
payload,
nonce,
];
}
class TaskInclude extends _is.IncludeObject {
TaskInclude._();
@override
Map<String, _is.Include?> get includes => {};
@override
_is.Table<_is.UuidValue?> get table => Task.t;
}
class TaskIncludeList extends _is.IncludeList {
TaskIncludeList._({
_is.WhereExpressionBuilder<TaskTable>? where,
super.limit,
super.offset,
super.orderBy,
super.orderByList,
super.include,
}) {
super.where = where?.call(Task.t);
}
@override
Map<String, _is.Include?> get includes => include?.includes ?? {};
@override
_is.Table<_is.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(
_is.DatabaseSession session, {
_is.WhereExpressionBuilder<TaskTable>? where,
int? limit,
int? offset,
_is.OrderByBuilder<TaskTable>? orderBy,
_is.OrderByListBuilder<TaskTable>? orderByList,
_is.Transaction? transaction,
_is.LockMode? lockMode,
_is.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(
_is.DatabaseSession session, {
_is.WhereExpressionBuilder<TaskTable>? where,
int? offset,
_is.OrderByBuilder<TaskTable>? orderBy,
_is.OrderByListBuilder<TaskTable>? orderByList,
_is.Transaction? transaction,
_is.LockMode? lockMode,
_is.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(
_is.DatabaseSession session,
_is.UuidValue id, {
_is.Transaction? transaction,
_is.LockMode? lockMode,
_is.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(
_is.DatabaseSession session,
List<Task> rows, {
_is.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(
_is.DatabaseSession session,
Task row, {
_is.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(
_is.DatabaseSession session,
List<Task> rows, {
required _is.ColumnSelections<TaskTable> conflictColumns,
_is.ColumnSelections<TaskTable>? updateColumns,
_is.WhereExpressionBuilder<TaskTable>? updateWhere,
_is.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(
_is.DatabaseSession session,
Task row, {
required _is.ColumnSelections<TaskTable> conflictColumns,
_is.ColumnSelections<TaskTable>? updateColumns,
_is.WhereExpressionBuilder<TaskTable>? updateWhere,
_is.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(
_is.DatabaseSession session,
List<Task> rows, {
_is.ColumnSelections<TaskTable>? columns,
_is.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(
_is.DatabaseSession session,
Task row, {
_is.ColumnSelections<TaskTable>? columns,
_is.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(
_is.DatabaseSession session,
_is.UuidValue id, {
required _is.ColumnValueListBuilder<TaskUpdateTable> columnValues,
_is.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(
_is.DatabaseSession session, {
required _is.ColumnValueListBuilder<TaskUpdateTable> columnValues,
required _is.WhereExpressionBuilder<TaskTable> where,
int? limit,
int? offset,
_is.OrderByBuilder<TaskTable>? orderBy,
_is.OrderByListBuilder<TaskTable>? orderByList,
_is.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(
_is.DatabaseSession session,
List<Task> rows, {
_is.OrderByBuilder<TaskTable>? orderBy,
_is.OrderByListBuilder<TaskTable>? orderByList,
_is.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(
_is.DatabaseSession session,
Task row, {
_is.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(
_is.DatabaseSession session, {
required _is.WhereExpressionBuilder<TaskTable> where,
_is.OrderByBuilder<TaskTable>? orderBy,
_is.OrderByListBuilder<TaskTable>? orderByList,
_is.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(
_is.DatabaseSession session, {
_is.WhereExpressionBuilder<TaskTable>? where,
int? limit,
_is.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(
_is.DatabaseSession session, {
required _is.WhereExpressionBuilder<TaskTable> where,
required _is.LockMode lockMode,
required _is.Transaction transaction,
_is.LockBehavior lockBehavior = _is.LockBehavior.wait,
}) async {
return session.db.lockRows<Task>(
where: where(Task.t),
lockMode: lockMode,
lockBehavior: lockBehavior,
transaction: transaction,
);
}
}

18
apps/todo/halkyon_todo_server/lib/src/label/label.spy.yaml Normal file
View file

@ -0,0 +1,18 @@
### A label (ADR 0033, D6): its name, colour and place among the others, in
### its sealed payload (D5); the instance sees that it exists, its size and
### when it changed. Changed when edited, the last writer winning. Synced.
class: Label
table: label
database: sync
fields:
### The key it is sealed with (ADR 0002's envelope); never null in Todo,
### where everything is sealed.
keyId: String?
### The content, sealed: UTF-8 JSON with a `schemaVersion` once opened.
payload: ByteData
### The sealing's nonce (ADR 0002's envelope).
nonce: ByteData?
indexes:
# Deleting a space finds its rows through this index (see content_key).
label_space_idx:
fields: spaceId

19
apps/todo/halkyon_todo_server/lib/src/project/section.spy.yaml Normal file
View file

@ -0,0 +1,19 @@
### A section of a project (ADR 0033, D6): its name, description, project and
### place among the project's sections, all in its sealed payload (D5); the
### instance sees that it exists, its size and when it changed. Changed when
### edited, the last writer winning. Synced.
class: Section
table: section
database: sync
fields:
### The key it is sealed with (ADR 0002's envelope); never null in Todo,
### where everything is sealed.
keyId: String?
### The content, sealed: UTF-8 JSON with a `schemaVersion` once opened.
payload: ByteData
### The sealing's nonce (ADR 0002's envelope).
nonce: ByteData?
indexes:
# Deleting a space finds its rows through this index (see content_key).
section_space_idx:
fields: spaceId

21
apps/todo/halkyon_todo_server/lib/src/task/task.spy.yaml Normal file
View file

@ -0,0 +1,21 @@
### 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.
class: Task
table: task
database: sync
fields:
### The key it is sealed with (ADR 0002's envelope); never null in Todo,
### where everything is sealed.
keyId: String?
### The content, sealed: UTF-8 JSON with a `schemaVersion` once opened.
payload: ByteData
### The sealing's nonce (ADR 0002's envelope).
nonce: ByteData?
indexes:
# Deleting a space finds its rows through this index (see content_key).
task_space_idx:
fields: spaceId

2
apps/todo/halkyon_todo_server/lib/src/todo_data.dart
View file

@ -7,7 +7,7 @@ import 'package:serverpod_offline_sync_server/serverpod_offline_sync_server.dart
/// device with a valid session would upload everything again) and before
/// their identities and the person go. Their personal space goes with
/// everything in it: the foreign keys cascade into every synced table (their
/// keys and projects) and the sync engine's bookkeeping.
/// keys, projects, sections, tasks and labels) and the sync engine's bookkeeping.
Future<AfterDeletion?> deleteTodoData(
Session session,
UuidValue authUserId,