@go-labs-sg/rsvp 1.8.0 → 1.9.0

package/README.md

@@ -800,6 +800,50 @@ population. Non-operational statuses remain excluded, and permissions, payment
 gates, duplicate protection, and undo behavior are unchanged. The web panel's
 realtime connection and manual refresh controls do not add a CLI subscription.
 
+### GOSH teams from check-in
+
+A registration form can create a GOSH team and route the first time anyone
+from the registration checks in. The first email is the registrant (captain);
+the rest come from each attendee's email answer, in attendee order. RSVP saves
+the request with the check-in and the worker sends it to GOSH afterwards, so
+check-in never waits on GOSH. The crew screen shows **Pending team
+assignment**, then the route and team name, or a failure to follow up.
+
+The binding is off by default. Set it up in GOSH first (`gosh rsvp-check-in
+binding set`), then link the RSVP form to the GOSH binding ID:
+
+```sh
+rsvp check-in gosh binding set \
+  --allow-state-change \
+  --target form_123 \
+  --payload '{"organizationId":"org_123","eventId":"evt_123","flowId":"form_123","goshBindingId":"gosh_binding_id","memberEmailOutputKey":"teammate_email","enabled":true}'
+rsvp check-in gosh list --payload '{"organizationId":"org_123","eventId":"evt_123","filter":"DELIVERY_FAILED"}'
+rsvp check-in gosh retry --allow-state-change --target reg_123 \
+  --payload '{"organizationId":"org_123","eventId":"evt_123","registrationId":"reg_123"}'
+rsvp check-in gosh reconcile --allow-state-change --target evt_123 \
+  --payload '{"organizationId":"org_123","eventId":"evt_123","dryRun":false,"retryFailed":true}'
+```
+
+The worker needs `RSVP_GOSH_API_URL`, `RSVP_GOSH_CHECK_IN_KEY_ID` and
+`RSVP_GOSH_CHECK_IN_SECRET` (the same `whsec_` secret GOSH holds under that key
+ID). Without them, deliveries fail with a configuration error instead of
+retrying forever.
+
+- Only the first check-in of a registration sends a team. Teammates checking in
+  later, or at the same moment, do not create another team.
+- Undoing the last check-in keeps the GOSH team and route but flags it for
+  review. Checking in again reuses the same team.
+- Retry and reconcile reuse the same delivery ID, so GOSH returns the team it
+  already created. Reconcile defaults to `dryRun: true` and never rescans QR
+  codes or moves teams.
+- A registration without a registrant email is rejected with
+  `CAPTAIN_EMAIL_MISSING` instead of making a teammate captain. Add the email,
+  then retry.
+- Turning the binding off stops queued deliveries too; they show `PAUSED` and
+  attendance is kept. To resume, turn it back on, then run reconcile with
+  `"dryRun": false, "retryFailed": true`. Check-ins made while it was off are
+  picked up by the same reconcile.
+
 Set `registrationMasterList.includeAttendanceSheets: true` with an approved
 `event setup step update` (`section: "REGISTRATION_RULES"`) to add response-based
 **Attending**, **Not attending** (explicit declines only), and **All** tabs,

package/dist/index.js

@@ -11135,6 +11135,33 @@ var requestExportInputSchema = eventScopeSchema3.extend({
 var getExportDownloadInputSchema = eventScopeSchema3.extend({
   exportJobId: string2().min(1)
 });
+// ../validators/src/gosh-check-in.ts
+var id = string2().trim().min(1).max(128);
+var upsertGoshCheckInBindingInputSchema = organizationEventByIdInputSchema.extend({
+  enabled: boolean2(),
+  flowId: id,
+  goshBindingId: id,
+  memberEmailOutputKey: string2().trim().min(1).max(120).nullable()
+});
+var getGoshCheckInStatusInputSchema = organizationEventByIdInputSchema.extend({ registrationId: id });
+var listGoshCheckInSyncsInputSchema = organizationEventByIdInputSchema.extend({
+  cursor: id.optional(),
+  filter: _enum([
+    "ALL",
+    "PENDING",
+    "ASSIGNED",
+    "REJECTED",
+    "DELIVERY_FAILED",
+    "PAUSED"
+  ]).default("ALL"),
+  limit: number2().int().min(1).max(100).default(50)
+});
+var retryGoshCheckInDeliveryInputSchema = organizationEventByIdInputSchema.extend({ registrationId: id });
+var reconcileGoshCheckInInputSchema = organizationEventByIdInputSchema.extend({
+  dryRun: boolean2().default(true),
+  limit: number2().int().min(1).max(500).default(200),
+  retryFailed: boolean2().default(false)
+});
 // ../validators/src/workflow.ts
 var verifyRegistrationIdentityInputSchema = object({
   eventSlug: eventSlugSchema,
@@ -12274,6 +12301,42 @@ var commands = {
     payloadOnly: true,
     summary: "Check in by attendee reference (--payload JSON)."
   },
+  "check-in gosh binding list": {
+    effects: [],
+    operation: (api, input) => api.event.getGoshCheckInBindings.query(input),
+    payloadOnly: true,
+    summary: "List GOSH check-in team bindings for an event (--payload JSON). Requires event.manage."
+  },
+  "check-in gosh binding set": {
+    effects: ["state-change"],
+    operation: (api, input) => api.event.upsertGoshCheckInBinding.mutate(input),
+    payloadOnly: true,
+    summary: "Create or update the GOSH check-in team binding for a registration form: {organizationId, eventId, flowId, goshBindingId, memberEmailOutputKey, enabled} (--payload JSON). Disabled by default. Signing keys live in the RSVP worker environment, never in the binding."
+  },
+  "check-in gosh status": {
+    effects: [],
+    operation: (api, input) => api.event.getGoshCheckInStatus.query(input),
+    payloadOnly: true,
+    summary: "Show a registration's GOSH team route: NOT_CONFIGURED, PENDING, ASSIGNED, REJECTED, DELIVERY_FAILED, PAUSED or UNASSIGNED (--payload JSON). No emails are returned."
+  },
+  "check-in gosh list": {
+    effects: [],
+    operation: (api, input) => api.event.listGoshCheckInSyncs.query(input),
+    payloadOnly: true,
+    summary: "List registrations synced to GOSH teams with revision and status; filter ALL, PENDING, ASSIGNED, REJECTED, DELIVERY_FAILED or PAUSED (--payload JSON)."
+  },
+  "check-in gosh retry": {
+    effects: ["state-change"],
+    operation: (api, input) => api.event.retryGoshCheckInDelivery.mutate(input),
+    payloadOnly: true,
+    summary: "Requeue a registration's latest GOSH team assignment with the same webhook ID, so GOSH returns the stored team rather than creating another (--payload JSON)."
+  },
+  "check-in gosh reconcile": {
+    effects: ["state-change"],
+    operation: (api, input) => api.event.reconcileGoshCheckIn.mutate(input),
+    payloadOnly: true,
+    summary: "Find checked-in registrations missing a GOSH team assignment and enqueue them; retryFailed also requeues failed deliveries. dryRun defaults to true (--payload JSON)."
+  },
   "check-in manual": {
     effects: ["state-change"],
     operation: (api, input) => api.event.manualCheckIn.mutate(input),

package/package.json

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