@go-labs-sg/rsvp 0.10.3 → 0.12.0

package/README.md

@@ -67,6 +67,38 @@ automation can still record arguments independently of the CLI's error output.
 
 Use `rsvp help` for the command catalogue. Every response is a JSON envelope on stdout; errors and diagnostics go to stderr. `rsvp manifest` emits the machine-readable command reference for tooling.
 
+## Public event page and images
+
+Use `rsvp event get --organization-id <id> --event-id <id>` to inspect the
+current `configurationVersion`, page content in `metadataJson.detailsPage`, and
+the separate `bannerImageKey` and `publicTheme.backgroundImageKey`. To update
+the public details page, copy `examples/event-page-template.json`, replace the
+organization ID, event ID, and version, then edit its rich text and timeline
+items. The version must match the event's current `configurationVersion`.
+
+```sh
+rsvp event page update \
+  --allow-state-change \
+  --target evt_123 \
+  --payload "$(cat event-page.json)"
+```
+
+The command supplies `section: "DETAILS_PAGE"` to the revision-checked setup
+API. One `TIMELINE` section contains many ordered `timelineItems`; each item
+has a time, rich title, and optional rich details. Other sections use
+`layout: "STANDARD"` and their own rich heading and content. The existing
+`event setup step update` command can send the same data when its payload
+includes `section: "DETAILS_PAGE"`.
+
+Banner and background images are separate event assets. Use
+`event banner upload create` or `event background upload create` to get the
+corresponding upload URL and key, upload the image to that URL, then set the
+key with `event banner update` or `event background update`. These update
+commands also require the current configuration version and accept a null
+key to clear the image. The public event guide reuses both assets. Campaign
+HTML can link to the guide with `{{eventDetailsUrl}}`; `{{eventUrl}}` still
+points to the registration page.
+
 For a read-only registration-journey diagnosis, inspect the event, draft,
 published versions, and event-owned resources together:
 
@@ -77,6 +109,39 @@ rsvp event flow versions list --organization-id org_123 --event-id evt_123
 rsvp event flow resources get --organization-id org_123 --event-id evt_123
 ```
 
+## Administrator registration for an invitee
+
+Inspect the invitee's active registration form and current registration version
+before submitting. The context includes the published flow definition, invitee,
+and existing registration (if any):
+
+```sh
+rsvp event flow admin registration context get \
+  --ack-sensitive-data \
+  --payload '{"organizationId":"org_123","eventId":"evt_123","inviteeId":"invitee_123"}'
+```
+
+Use the returned `flowVersionId` and `expectedRegistrationVersion` in the
+submission. Set `expectedOutcomeId` to the outcome selected by the answers in
+the published definition, and provide answers keyed by each field's `outputKey`.
+A new UUID `idempotencyKey` identifies this submission. The audit reason records
+why an administrator submitted on the invitee's behalf.
+
+```sh
+rsvp event flow admin registration submit \
+  --ack-sensitive-data \
+  --allow-state-change \
+  --target invitee_123 \
+  --payload '{"organizationId":"org_123","eventId":"evt_123","inviteeId":"invitee_123","flowVersionId":"flow_version_123","answers":{"attendance":"ATTENDING"},"expectedOutcomeId":"attending","expectedRegistrationVersion":0,"idempotencyKey":"9dd0ba39-b55e-4e65-aa3e-d08242c45b8f","auditReason":"Recorded response by phone"}'
+```
+
+Replace the example answer key and value with those required by the returned
+definition. If the flow requires a consent override, include a nonempty
+`consentOverrideReason` in the submission payload. The override records the
+administrator's reason in the audit trail; it does not record attendee consent
+or a signature. A stale registration version or flow version is rejected; fetch
+the context again before retrying with a new idempotency key.
+
 Create an immutable menu version with an explicit mutation acknowledgement. The
 target is the event ID in the payload:
 

package/dist/index.js

@@ -6046,6 +6046,19 @@ var commands = {
     scope: "event",
     summary: "List the menus, consent documents, images, and seat maps available to the registration flow."
   },
+  "event flow admin registration context get": {
+    effects: ["sensitive-data"],
+    operation: (api, input) => api.eventFlow.getAdminRegistrationContext.query(input),
+    payloadOnly: true,
+    summary: "Get an invitee's published flow and registration version (--payload JSON)."
+  },
+  "event flow admin registration submit": {
+    effects: ["sensitive-data", "state-change"],
+    operation: (api, input) => api.eventFlow.adminSubmit.mutate(input),
+    payloadOnly: true,
+    targetKey: "inviteeId",
+    summary: "Register an invitee with flow answers and an audit reason (--payload JSON)."
+  },
   "event flow consent version create": {
     effects: ["state-change"],
     operation: (api, input) => api.eventFlow.createConsentVersion.mutate(input),
@@ -6319,6 +6332,8 @@ Object.assign(commands, {
   "admission identity-exception resolve": payloadCommand((api, input) => api.admission.resolveIdentityException.mutate(input), "Resolve an identity exception (--payload JSON).", ["sensitive-data", "state-change"]),
   "audit list": payloadCommand((api, input) => api.audit.listEventActivity.query(input), "List event audit activity (--payload JSON).", ["sensitive-data"]),
   "event check-in qr": payloadCommand((api, input) => api.event.checkInByQr.mutate(input), "Check in using a QR token (--payload JSON).", ["state-change"]),
+  "event banner upload create": payloadCommand((api, input) => api.event.createBannerUpload.mutate(input), "Create a banner-image upload URL (--payload JSON).", ["external-write", "state-change"], "eventId"),
+  "event banner update": payloadCommand((api, input) => api.event.updateBanner.mutate(input), "Set or clear the event banner image (--payload JSON).", ["state-change"], "eventId"),
   "event background upload create": payloadCommand((api, input) => api.event.createBackgroundUpload.mutate(input), "Create a background-image upload URL (--payload JSON).", ["external-write", "state-change"]),
   "event background update": payloadCommand((api, input) => api.event.updateBackground.mutate(input), "Set or clear an attendee background image (--payload JSON).", ["state-change"]),
   "event walk-in create": payloadCommand((api, input) => api.event.createWalkIn.mutate(input), "Create a walk-in registration (--payload JSON).", ["sensitive-data", "state-change"]),
@@ -6346,6 +6361,10 @@ Object.assign(commands, {
   "event reminder list": payloadCommand((api, input) => api.event.listReminderSegments.query(input), "List reminder segments (--payload JSON).", ["sensitive-data"]),
   "event rsvp submit": payloadCommand((api, input) => api.event.submitRsvp.mutate(input), "Submit the caller's registration (--payload JSON).", ["sensitive-data", "state-change"]),
   "event setup step update": payloadCommand((api, input) => api.event.updateSetupStep.mutate(input), "Update one event setup step (--payload JSON).", ["state-change"]),
+  "event page update": payloadCommand((api, input) => api.event.updateSetupStep.mutate({
+    ...input,
+    section: "DETAILS_PAGE"
+  }), "Update the public event details page (--payload JSON).", ["state-change"], "eventId"),
   "organization access check": payloadCommand((api, input) => api.organization.checkOrganizationAccess.query(input), "Check organization access (--payload JSON)."),
   "organization manage-access check": payloadCommand((api, input) => api.organization.checkOrganizationManageAccess.query(input), "Check organization management access (--payload JSON)."),
   "organization slug check": payloadCommand((api, input) => api.organization.checkSlug.mutate(input), "Check an organization slug (--payload JSON)."),

package/examples/event-page-template.json

@@ -0,0 +1,65 @@
+{
+	"organizationId": "replace-with-organization-id",
+	"eventId": "replace-with-event-id",
+	"version": 1,
+	"detailsPage": {
+		"titleRichText": {
+			"html": "<p>Annual Awards 2026</p>",
+			"json": {
+				"type": "doc",
+				"content": [
+					{
+						"type": "paragraph",
+						"content": [{ "type": "text", "text": "Annual Awards 2026" }]
+					}
+				]
+			}
+		},
+		"sections": [
+			{
+				"id": "a9e5ea4a-3c9b-424e-b153-7ad8c4c0d2eb",
+				"layout": "TIMELINE",
+				"titleRichText": {
+					"html": "<p>Programme</p>",
+					"json": {
+						"type": "doc",
+						"content": [
+							{
+								"type": "paragraph",
+								"content": [{ "type": "text", "text": "Programme" }]
+							}
+						]
+					}
+				},
+				"contentRichText": {
+					"html": "<p></p>",
+					"json": { "type": "doc", "content": [{ "type": "paragraph" }] }
+				},
+				"timelineItems": [
+					{
+						"id": "218745a9-4464-4085-836a-393533c4180d",
+						"time": "5:30 PM",
+						"titleRichText": {
+							"html": "<p>Registration and photos</p>",
+							"json": {
+								"type": "doc",
+								"content": [
+									{
+										"type": "paragraph",
+										"content": [
+											{ "type": "text", "text": "Registration and photos" }
+										]
+									}
+								]
+							}
+						},
+						"contentRichText": {
+							"html": "<p></p>",
+							"json": { "type": "doc", "content": [{ "type": "paragraph" }] }
+						}
+					}
+				]
+			}
+		]
+	}
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@go-labs-sg/rsvp",
-  "version": "0.10.3",
+  "version": "0.12.0",
   "description": "RSVP CLI for authorized event operations.",
   "type": "module",
   "main": "./dist/index.js",