feat(realtime): printer approval over the socket (extension 2.4.0, product 1.1.0) #25
No Assignees
Notifications
Due Date
No due date set.
Dependencies
No dependencies set.
Reference: QRun-IO/qbit-printing#25
Reference in new issue
Block a user
Server half of the printer-approval feature (pairs with protocol 1.1.0 on
feat/printer-approval-20261105and Windows connector 1.2.0). Additive: wire payload v1 and subprotocolqqq-printing.v1unchanged; 1.0.x connectors keep working.printer-approval-v1(HELLO up to 5 capabilities, control poll up to 4; stored incontrol_capabilities;ControlPollRequestenum extended).PRINTERS={ "printers": [ { "printerId", "enabled" } ] }: the complete approval state of every printer in the device's latest accepted inventory. Sent only to connections that advertised the capability, after each accepted INVENTORY's ACK and whenever a printer's approval changes through any path (admin route, native processes,enablePrinter), via the existing commit wakeup and the connection's single serialized writer (change-detected, so an unrelated job wakeup does not repeat it). Empty inventory yields[].PrintingService.printerApprovals(deviceId); native extension 2.4.0 advertised; OpenAPI fragment regenerated; product 1.1.0; CHANGELOG/README/REALTIME/OPERATIONS docs and a dated in-progress session-state note.Validation:
.\mvnw.cmd -Pui-demo verifyon the pushed tree: 195 tests, 0 failures, 0 errors, 1 skipped (opt-in workload), 0 Checkstyle violations, BUILD SUCCESS. Nothing tagged, released or published.🤖 Generated with Claude Code
Add the printer-approval-v1 capability and the server-to-client PRINTERS frame so a connector can show per-printer approval for the server it is connected to. - HELLO accepts up to five capabilities including printer-approval-v1; the HTTP control poll accepts up to four and stores it in control_capabilities like the others; the ControlPollRequest schema enumeration is extended. - After an accepted INVENTORY's ACK, a connection that advertised the capability receives PRINTERS: { "printers": [ { "printerId", "enabled" } ] } covering every printer in the device's latest accepted inventory (empty inventory: []). - Every approval change (admin route, native approve/disable/set-approval processes, PrintingService.enablePrinter) already publishes the commit wakeup; the connection's single serialized writer now compares the current approval state with the last PRINTERS frame it sent and resends on change only. Connections without the capability never receive PRINTERS. - PrintingService.printerApprovals(deviceId) exposes the list to host code. - Advertise native extension 2.4.0; regenerate the OpenAPI fragment; bump the product to 1.1.0 (pairs with protocol 1.1.0 and Windows connector 1.2.0; wire payload v1 and subprotocol unchanged). CHANGELOG, README, REALTIME/OPERATIONS docs and a dated in-progress session-state note. - Tests: five-capability HELLO, ACK-then-PRINTERS ordering with new printers disabled, approval via the admin route and the service pushing fresh frames, no PRINTERS on an unrelated job wakeup, empty inventory, a four-capability connection never receiving PRINTERS, and control-poll acceptance/bounds. Verified: .\mvnw.cmd -Pui-demo verify -> 195 tests, 0 failures, 0 errors, 1 skipped (opt-in workload), 0 Checkstyle violations, BUILD SUCCESS. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Signed-off-by: James Maes <james@kof22.com>