From 76f43cc7817fafed2485ac975426eb2e97ea9986 Mon Sep 17 00:00:00 2001 From: Anders Betts Date: Sun, 20 Sep 2026 22:30:32 +0200 Subject: docs: render enum args as type(values) in the generated catalogue --- docs/PROTOCOL.md | 26 +++++++++++++------------- 1 file changed, 13 insertions(+), 13 deletions(-) (limited to 'docs/PROTOCOL.md') diff --git a/docs/PROTOCOL.md b/docs/PROTOCOL.md index 5aa4ff6..f24e917 100644 --- a/docs/PROTOCOL.md +++ b/docs/PROTOCOL.md @@ -648,24 +648,24 @@ the recipient and subject without sending or updating anything. ## Command catalogue (generated) Generated by `make gen-protocol` from the command tables; do not edit by hand. -Args: `name:type[!][=default][ enum a\|b]`, `!` = required. +Args: `name:type(values)[!][=default]`, `!` = required. | Command | Permission | Org | Mutating | Dry run | Args | |---|---|---|---|---|---| | `health` | public | no | no | no | — | | `meta` | public | no | no | no | — | -| `session.open` | public | no | no | no | `method:enum! enum password\|token`, `username:string`, `password:string`, `token:string` | +| `session.open` | public | no | no | no | `method:enum(password\|token)!`, `username:string`, `password:string`, `token:string` | | `session.close` | viewer | no | no | no | — | | `session.whoami` | viewer | no | no | no | — | | `session.list_orgs` | viewer | no | no | no | — | | `session.use_org` | viewer | no | no | no | `org:int!` | -| `org.create` | viewer | no | yes | yes | `name:string!`, `org_nr:string`, `fiscal_year_start_month:int=1`, `moms_period:enum=month enum month\|quarter\|year`, `framework:enum=K2 enum K2\|K3` | +| `org.create` | viewer | no | yes | yes | `name:string!`, `org_nr:string`, `fiscal_year_start_month:int=1`, `moms_period:enum(month\|quarter\|year)=month`, `framework:enum(K2\|K3)=K2` | | `org.list` | viewer | no | no | no | — | | `org.get` | viewer | yes | no | no | — | -| `org.update` | owner | yes | yes | yes | `name:string`, `org_nr:string`, `vat_nr:string`, `address:string`, `postal_code:string`, `city:string`, `country:string`, `email:string`, `phone:string`, `moms_period:enum enum month\|quarter\|year`, `framework:enum enum K2\|K3`, `description:string`, `fiscal_year_start_month:int`, `shares:int` | +| `org.update` | owner | yes | yes | yes | `name:string`, `org_nr:string`, `vat_nr:string`, `address:string`, `postal_code:string`, `city:string`, `country:string`, `email:string`, `phone:string`, `moms_period:enum(month\|quarter\|year)`, `framework:enum(K2\|K3)`, `description:string`, `fiscal_year_start_month:int`, `shares:int` | | `org.member_list` | viewer | yes | no | no | — | -| `org.member_add` | owner | yes | yes | yes | `username:string!`, `role:enum! enum owner\|bookkeeper\|viewer` | -| `org.member_set_role` | owner | yes | yes | yes | `username:string!`, `role:enum! enum owner\|bookkeeper\|viewer` | +| `org.member_add` | owner | yes | yes | yes | `username:string!`, `role:enum(owner\|bookkeeper\|viewer)!` | +| `org.member_set_role` | owner | yes | yes | yes | `username:string!`, `role:enum(owner\|bookkeeper\|viewer)!` | | `org.member_remove` | owner | yes | yes | yes | `username:string!` | | `board.list` | viewer | yes | no | no | — | | `board.add` | owner | yes | yes | yes | `name:string!`, `title:string=Styrelseledamot` | @@ -683,7 +683,7 @@ Args: `name:type[!][=default][ enum a\|b]`, `!` = required. | `backup.snapshot` | admin | no | yes | no | `dest:string` | | `account.list` | viewer | yes | no | no | `active_only:bool` | | `account.get` | viewer | yes | no | no | `id:int`, `number:string` | -| `account.create` | bookkeeper | yes | yes | yes | `number:string!`, `name:string!`, `type:enum! enum asset\|liability\|equity\|revenue\|expense`, `sru_code:string`, `vat_code:string` | +| `account.create` | bookkeeper | yes | yes | yes | `number:string!`, `name:string!`, `type:enum(asset\|liability\|equity\|revenue\|expense)!`, `sru_code:string`, `vat_code:string` | | `account.update` | bookkeeper | yes | yes | yes | `id:int!`, `name:string`, `sru_code:string`, `vat_code:string`, `active:bool` | | `fiscal_year.list` | viewer | yes | no | no | — | | `fiscal_year.get` | viewer | yes | no | no | `id:int` | @@ -700,13 +700,13 @@ Args: `name:type[!][=default][ enum a\|b]`, `!` = required. | `bokslut.post` | bookkeeper | yes | yes | yes | `fiscal_year:int`, `entries:json`, `periodiseringsfond_ore:int`, `tax_rate:json=20.6`, `dispose:bool=true`, `date:date` | | `settings.get` | viewer | yes | no | no | — | | `settings.set` | bookkeeper | yes | yes | yes | `key:string!`, `value:string` | -| `bank.import` | bookkeeper | yes | yes | yes | `format:enum! enum seb`, `content_base64:string`, `path:string`, `account:string` | -| `bank.list` | viewer | yes | no | no | `status:enum=all enum all\|unmatched\|matched`, `from:date`, `to:date`, `account:string`, `limit:int=200` | +| `bank.import` | bookkeeper | yes | yes | yes | `format:enum(seb)!`, `content_base64:string`, `path:string`, `account:string` | +| `bank.list` | viewer | yes | no | no | `status:enum(all\|unmatched\|matched)=all`, `from:date`, `to:date`, `account:string`, `limit:int=200` | | `bank.match` | bookkeeper | yes | yes | yes | `transaction_id:int!`, `voucher_id:int!` | | `bank.unmatch` | bookkeeper | yes | yes | yes | `transaction_id:int!`, `voucher_id:int!` | -| `report.rule_list` | viewer | yes | no | no | `report:enum enum vat` | -| `report.rule_create` | owner | yes | yes | yes | `report:enum! enum vat`, `box:string!`, `match_type:enum! enum account\|range\|type`, `pattern:string!`, `sign:int=1`, `sort_order:int=0` | -| `report.rule_update` | owner | yes | yes | yes | `id:int!`, `box:string`, `match_type:enum enum account\|range\|type`, `pattern:string`, `sign:int`, `sort_order:int` | +| `report.rule_list` | viewer | yes | no | no | `report:enum(vat)` | +| `report.rule_create` | owner | yes | yes | yes | `report:enum(vat)!`, `box:string!`, `match_type:enum(account\|range\|type)!`, `pattern:string!`, `sign:int=1`, `sort_order:int=0` | +| `report.rule_update` | owner | yes | yes | yes | `id:int!`, `box:string`, `match_type:enum(account\|range\|type)`, `pattern:string`, `sign:int`, `sort_order:int` | | `report.rule_delete` | owner | yes | yes | yes | `id:int!` | | `template.list` | viewer | yes | no | no | `active_only:bool` | | `template.get` | viewer | yes | no | no | `id:int`, `name:string` | @@ -738,7 +738,7 @@ Args: `name:type[!][=default][ enum a\|b]`, `!` = required. | `invoice.preview` | viewer | yes | no | no | `customer_id:int!`, `invoice_date:date!`, `due_date:date!`, `delivery_date:string`, `your_ref:string`, `our_ref:string`, `notes:string`, `rows:json!` | | `invoice.issue` | bookkeeper | yes | yes | yes | `customer_id:int!`, `invoice_date:date!`, `due_date:date!`, `delivery_date:string`, `your_ref:string`, `our_ref:string`, `notes:string`, `rows:json!` | | `invoice.get` | viewer | yes | no | no | `id:int!` | -| `invoice.list` | viewer | yes | no | no | `customer_id:int`, `status:enum enum issued\|credited`, `limit:int=200` | +| `invoice.list` | viewer | yes | no | no | `customer_id:int`, `status:enum(issued\|credited)`, `limit:int=200` | | `invoice.pdf` | viewer | yes | no | no | `id:int!` | | `invoice.send` | bookkeeper | yes | yes | yes | `id:int!`, `to:string` | -- cgit v1.3