DAW/daw-lua-common

Fork 0

Lua-Binding fuer daw_error/v1 bauen #41

New issue

Open

opened 2026-08-10 07:41:41 +02:00 by michael · 2 comments

michael commented

2026-08-10 07:41:41 +02:00

Owner

Ziel

Einen Lua-Konstruktor fuer daw_error/v1-Objekte bereitstellen, den
daw-lua-common und daw-lua-net beim Umbau verwenden koennen.

Begruendung

Beim Umfangs-Check fuer die 2.0.0-Fehlerobjekt-Umstellung wurde
festgestellt: in daw-contracts existiert noch kein bindings/lua/
fuer daw_error/v1 -- es gibt aktuell keinen offiziellen Weg, ein
solches Objekt in Lua zu erzeugen. Ohne diesen Baustein kann die
Umstellung der 171 Fehlerstellen nicht beginnen.

Umfang

Neues Modul, zunaechst in daw-lua-common (z.B. error/init.lua)
Konstruktorfunktion(en) fuer daw_error/v1-Objekte: id (UUID),
source, code, message, optional cause, optional data
source wird modulweit gesetzt (_NAME des jeweiligen Moduls,
z.B. daw.common.base64), nicht pro Funktion
Sobald an base64.lua als Referenzimplementierung erprobt:
Ruecktfuehrung nach daw-contracts/daw_error/v1/bindings/lua/ als
offizielle Referenzbindung (Folgearbeit, nicht Teil dieses Issues)

Akzeptanzkriterien

Konstruktor erzeugt gueltige daw_error/v1-Objekte gemaess
daw-contracts/daw_error/v1/contract.json
cause-Verschachtelung moeglich (ein Objekt referenziert ein
anderes vollstaendiges daw_error/v1-Objekt als cause)
Gegen die examples/valid/ und examples/invalid/ aus
daw-contracts geprueft
fragjan clean besteht

Bezug

DAW/daw-contracts (Vertragsdefinition, daw_error/v1)

## Ziel Einen Lua-Konstruktor fuer `daw_error/v1`-Objekte bereitstellen, den `daw-lua-common` und `daw-lua-net` beim Umbau verwenden koennen. ## Begruendung Beim Umfangs-Check fuer die 2.0.0-Fehlerobjekt-Umstellung wurde festgestellt: in `daw-contracts` existiert noch kein `bindings/lua/` fuer `daw_error/v1` -- es gibt aktuell keinen offiziellen Weg, ein solches Objekt in Lua zu erzeugen. Ohne diesen Baustein kann die Umstellung der 171 Fehlerstellen nicht beginnen. ## Umfang - Neues Modul, zunaechst in `daw-lua-common` (z.B. `error/init.lua`) - Konstruktorfunktion(en) fuer `daw_error/v1`-Objekte: `id` (UUID), `source`, `code`, `message`, optional `cause`, optional `data` - `source` wird modulweit gesetzt (`_NAME` des jeweiligen Moduls, z.B. `daw.common.base64`), nicht pro Funktion - Sobald an `base64.lua` als Referenzimplementierung erprobt: Ruecktfuehrung nach `daw-contracts/daw_error/v1/bindings/lua/` als offizielle Referenzbindung (Folgearbeit, nicht Teil dieses Issues) ## Akzeptanzkriterien - [ ] Konstruktor erzeugt gueltige `daw_error/v1`-Objekte gemaess `daw-contracts/daw_error/v1/contract.json` - [ ] `cause`-Verschachtelung moeglich (ein Objekt referenziert ein anderes vollstaendiges `daw_error/v1`-Objekt als `cause`) - [ ] Gegen die `examples/valid/` und `examples/invalid/` aus `daw-contracts` geprueft - [ ] `fragjan clean` besteht ## Bezug DAW/daw-contracts (Vertragsdefinition, daw_error/v1)

michael added the

coordination/cross-repo

labels

2026-08-10 07:41:41 +02:00

michael commented

2026-08-13 21:20:09 +02:00

Author

Owner

Clarification: the constructor exists in daw-lua-common (daw/common/error/init.lua + util.lua), tested against its own unit tests and against the examples/valid/examples/invalid fixtures from daw-contracts.

This is not yet a 'working reference binding' in the sense of this issue -- so far it is only a theoretical integration. No real running program produces errors with it in actual operation; only daw-lua-common's and daw-lua-net's own test suites exercise it.

Back-porting to daw-contracts/daw_error/v1/bindings/lua/ will happen once a real program (e.g. kaupapi) uses the constructor without issues in practice -- the same waiting condition as the draft->beta promotion trigger for daw_error/v1 itself.

Clarification: the constructor exists in daw-lua-common (`daw/common/error/init.lua` + `util.lua`), tested against its own unit tests and against the `examples/valid`/`examples/invalid` fixtures from daw-contracts. This is not yet a 'working reference binding' in the sense of this issue -- so far it is only a theoretical integration. No real running program produces errors with it in actual operation; only daw-lua-common's and daw-lua-net's own test suites exercise it. Back-porting to `daw-contracts/daw_error/v1/bindings/lua/` will happen once a real program (e.g. kaupapi) uses the constructor without issues in practice -- the same waiting condition as the draft->beta promotion trigger for daw_error/v1 itself.

michael referenced this issue

2026-08-13 21:20:10 +02:00

daw-lua-common auf daw_error/v1 umstellen #42

michael referenced this issue

2026-08-13 21:20:11 +02:00

Migrate 2.0.0 errors to daw_error/v1 #43

michael commented

2026-09-21 16:42:32 +02:00

Author

Owner

Status set to status/review: the implementation is done and tested in daw-lua-common. The waiting condition from the comment above is unchanged -- the binding goes back to daw-contracts only once a real program (e.g. kaupapi) uses it in operation.

michael added

and removed

labels

2026-09-21 16:42:35 +02:00