@go-labs-sg/event-tech 0.7.0 → 0.8.1

package/README.md

@@ -63,10 +63,72 @@ et organization list
 et organization get --organization-id <id>
 et event list --organization-id <id>
 et event get --event-id <id>
+et event appearance get --event-id <id>
+et event appearance get --event-id <id> --public
+et event appearance update --event-id <id> --appearance-version <n> --appearance '<json>'
+et event appearance reset --event-id <id> --appearance-version <n>
+et event appearance upload --event-id <id> --file ./background.mp4 --media-type video --content-type video/mp4
+et event photo-wall display-items --event-id <id> --limit 30
 ```
 
 Commands emit deterministic JSON envelopes. Authentication credentials are never included in successful output, and bearer credentials are redacted from errors.
 
+### Event appearance and Photo Wall display
+
+`event appearance get` returns the canonical appearance, its optimistic-lock
+version, and resolved media URLs. It uses the authenticated event procedure by
+default. Add `--public` for the same safe projection through the unauthenticated
+public procedure; that read does not access the credential store or require CLI
+login. Pass the authenticated result's version back unchanged when saving:
+
+```sh
+et event appearance update \
+  --event-id <id> \
+  --appearance-version 3 \
+  --appearance '{"version":1,"theme":{"accentColor":"#f84404","backgroundColor":"#f6f7f9","textColor":"#20242a","fontFamily":"SYSTEM"},"guestBackground":{"type":"none","key":null},"displayBackground":{"type":"none","key":null},"photoWall":{"durationSeconds":18,"maxVisible":4,"motion":"gentle","showQrCode":true,"showEventName":true}}'
+```
+
+Reset is an explicit, version-fenced null update:
+
+```sh
+et event appearance reset --event-id <id> --appearance-version 3
+```
+
+Upload appearance media before referencing its returned key in the appearance
+JSON. The CLI requests the existing signed attachment URL with the event scope
+and uploads with the declared content type. The server-bound expected size is
+carried in the SDK-signed URL as `x-amz-meta-event-appearance-size`; the CLI and
+browser use that URL unchanged and do not add duplicate metadata headers.
+Before saving a new key, the API checks the event namespace and the actual
+object size/content type, including its expected-size metadata.
+
+The contract is covered by offline tests using the real AWS SDK presigner and
+shared object validator, with only storage HEAD responses modelled. This is not
+live AWS verification. See the [AWS presigner documentation](https://github.com/aws/aws-sdk-js-v3/blob/main/packages/s3-request-presigner/README.md#get-presigned-url-with-headers-that-cannot-be-signed)
+for the distinction between signed query parameters and required upload headers.
+
+Example:
+
+```sh
+et event appearance upload --event-id <id> --file ./background.jpg \
+  --media-type image --content-type image/jpeg
+```
+
+Display pages are approved-only and newest-first. The cursor is JSON with an
+ISO date string; the CLI decodes `createdAt` to a real `Date` before calling the
+API. Retained IDs are sent separately so currently visible items can be
+revalidated:
+
+```sh
+et event photo-wall display-items --event-id <id> --limit 30 \
+  --cursor '{"createdAt":"2026-01-03T00:00:00.000Z","id":"photo-123"}' \
+  --retained-ids '["photo-121","photo-122"]'
+```
+
+`--limit` is 1–60, `--retained-ids` accepts at most 100 non-empty strings, and
+the success data preserves the API's `items`, `nextCursor`, and
+`retainedItems` fields.
+
 ## Lucky draw pre-draw
 
 ```sh