@sneat/extension-eventus-contract 0.0.1

package/fesm2022/sneat-extension-eventus-contract.mjs

@@ -0,0 +1,145 @@
+import { InjectionToken } from '@angular/core';
+import { of } from 'rxjs';
+
+// TypeScript mirror of the frozen Eventus bring-along contract
+// (`typespec/api4eventus-bringalong.tsp`). Shapes MUST match the JSON the
+// backend emits/accepts exactly. The host defines slots; responders claim an
+// open slot and may release it back to open, preventing duplicate contributions.
+
+// TypeScript mirror of the frozen Eventus wire contract (`typespec/api4eventus.tsp`).
+// These shapes MUST match the JSON the backend emits/accepts exactly.
+
+/**
+ * Pure join: the events list is the set of happenings that have an eventus
+ * overlay (interim "is-event" marker), projected to list rows. Kept pure so the
+ * join — the bug-prone part — is unit-testable without Firestore.
+ */
+function selectEventListItems(overlays, happenings) {
+    const overlayById = new Map(overlays.map((o) => [o.id, o]));
+    return happenings
+        .filter((h) => overlayById.has(h.id))
+        .map((h) => ({
+        id: h.id,
+        title: h.dbo?.title ?? h.brief?.title ?? '',
+        start: eventStart(h.dbo),
+        happening: h,
+        overlay: overlayById.get(h.id),
+    }));
+}
+function eventStart(dbo) {
+    if (!dbo) {
+        return undefined;
+    }
+    const dtStarts = dbo.dtStarts;
+    if (dtStarts) {
+        return new Date(dtStarts).toISOString();
+    }
+    const slot = Object.values(dbo.slots ?? {})[0];
+    if (slot?.start?.date) {
+        return slot.start.time
+            ? `${slot.start.date} ${slot.start.time}`
+            : slot.start.date;
+    }
+    return undefined;
+}
+
+// TypeScript mirror of the frozen Eventus invitations contract
+// (`typespec/api4eventus-invitations.tsp`). Shapes MUST match the JSON the
+// backend emits/accepts exactly. An invitation references the invitee by id
+// only — Sneat (`spaceus`/`contactus`) stays the source of truth for names.
+
+// TypeScript mirror of the frozen Eventus RSVP contract
+// (`typespec/api4eventus-rsvp.tsp`) plus the public resolve context from
+// (`typespec/api4eventus-links.tsp`). Shapes MUST match the JSON the backend
+// emits/accepts exactly. Submitting an RSVP is pure event-attendance and NEVER
+// joins the host's space.
+/**
+ * Build the submit body from raw form values. When `status == 'no'` the
+ * headcounts are forced to 0 (the backend zeroes them anyway), and blank
+ * dietary/comment/self-identified names are dropped. For an open-link response
+ * the trimmed `selfIdentifiedName` is carried through (the caller enforces it is
+ * non-empty). Pure so it can be unit-tested without rendering.
+ * (AC: no-rsvp-zeroes-headcount, rsvp-full-fields-captured, attribution-by-link-type)
+ */
+function buildRsvpRequest(form) {
+    const attending = form.status !== 'no';
+    const dietary = form.dietary.trim();
+    const comment = form.comment.trim();
+    const name = form.selfIdentifiedName?.trim();
+    const familyName = form.selfIdentifiedFamilyName?.trim();
+    return {
+        status: form.status,
+        adults: attending ? form.adults : 0,
+        children: attending ? form.children : 0,
+        ...(dietary ? { dietary } : {}),
+        ...(comment ? { comment } : {}),
+        ...(name ? { selfIdentifiedName: name } : {}),
+        ...(familyName ? { selfIdentifiedFamilyName: familyName } : {}),
+    };
+}
+
+// TypeScript mirror of the frozen Eventus links contract
+// (`typespec/api4eventus-links.tsp`). Shapes MUST match the JSON the backend
+// emits exactly. The QR code is rendered client-side from `url`.
+
+/**
+ * Base URL the Eventus API is served from (without a trailing slash), e.g.
+ * `https://api.sneat.app`. Defaults to '' so requests are relative to the
+ * app origin (`/api4eventus/...`). The app shell can override it.
+ */
+const EVENTUS_API_BASE_URL = new InjectionToken('EVENTUS_API_BASE_URL', { providedIn: 'root', factory: () => '' });
+
+/** Pulls a human-readable message from an HttpErrorResponse carrying IApiError. */
+function extractErrorMessage(err, fallback) {
+    const body = err?.error;
+    return body?.message ?? fallback;
+}
+
+/**
+ * The identity used when the current user claims or releases a bring-along
+ * slot. Injecting this (rather than hard-coding) keeps claim/release testable
+ * and decoupled from RSVP identity.
+ *
+ * TODO: replace the stub default with the real responder identity once RSVP
+ * lands (Tasks 3/4) — claim/release should use the link-gated guest token or
+ * the signed-in family/person ref instead of this placeholder.
+ */
+const EVENTUS_CURRENT_CLAIMANT = new InjectionToken('EVENTUS_CURRENT_CLAIMANT', {
+    providedIn: 'root',
+    factory: () => ({ ref: 'stub-claimant', label: 'Smith Family' }),
+});
+
+const EVENT_SERVICE = new InjectionToken('EventService');
+const EVENTUS_EVENT_SERVICE = new InjectionToken('EventusEventService');
+const RSVP_SERVICE = new InjectionToken('RsvpService');
+const INVITATION_SERVICE = new InjectionToken('InvitationService');
+const LINK_SERVICE = new InjectionToken('LinkService');
+const BRING_ALONG_SERVICE = new InjectionToken('BringAlongService');
+
+const EVENTUS_INVITEE_SOURCE = new InjectionToken('EVENTUS_INVITEE_SOURCE', { providedIn: 'root', factory: () => new StubInviteeSource() });
+/**
+ * Default stub returning sample data so the picker is usable end-to-end before
+ * real wiring. TODO: replace with an adapter over `spaceus` (family spaces) and
+ * `contactus` (contacts) once those modules are available to the app shell.
+ */
+class StubInviteeSource {
+    families() {
+        return of([
+            { id: 'fam-sample-1', title: 'The Smith Family' },
+            { id: 'fam-sample-2', title: 'The Brown Family' },
+        ]);
+    }
+    persons() {
+        return of([
+            { id: 'person-sample-1', name: 'Alice Smith' },
+            { id: 'person-sample-2', name: 'Bob Brown' },
+        ]);
+    }
+}
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { BRING_ALONG_SERVICE, EVENTUS_API_BASE_URL, EVENTUS_CURRENT_CLAIMANT, EVENTUS_EVENT_SERVICE, EVENTUS_INVITEE_SOURCE, EVENT_SERVICE, INVITATION_SERVICE, LINK_SERVICE, RSVP_SERVICE, StubInviteeSource, buildRsvpRequest, extractErrorMessage, selectEventListItems };
+//# sourceMappingURL=sneat-extension-eventus-contract.mjs.map

package/fesm2022/sneat-extension-eventus-contract.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"sneat-extension-eventus-contract.mjs","sources":["../../../../../../libs/extensions/eventus/contract/src/lib/models/bring-along.ts","../../../../../../libs/extensions/eventus/contract/src/lib/models/event.ts","../../../../../../libs/extensions/eventus/contract/src/lib/models/eventus-event.ts","../../../../../../libs/extensions/eventus/contract/src/lib/models/invitation.ts","../../../../../../libs/extensions/eventus/contract/src/lib/models/rsvp.ts","../../../../../../libs/extensions/eventus/contract/src/lib/models/rsvp-link.ts","../../../../../../libs/extensions/eventus/contract/src/lib/services/api-base-url.ts","../../../../../../libs/extensions/eventus/contract/src/lib/services/api-error.ts","../../../../../../libs/extensions/eventus/contract/src/lib/services/claimant.ts","../../../../../../libs/extensions/eventus/contract/src/lib/services/interfaces.ts","../../../../../../libs/extensions/eventus/contract/src/lib/services/invitee-source.ts","../../../../../../libs/extensions/eventus/contract/src/sneat-extension-eventus-contract.ts"],"sourcesContent":["// TypeScript mirror of the frozen Eventus bring-along contract\n// (`typespec/api4eventus-bringalong.tsp`). Shapes MUST match the JSON the\n// backend emits/accepts exactly. The host defines slots; responders claim an\n// open slot and may release it back to open, preventing duplicate contributions.\n\n/**\n * Who claimed a slot. Stored as an opaque reference plus a display label so the\n * slot can render \"Drinks — Smith Family\" without resolving the reference.\n */\nexport interface ISlotClaimant {\n  /** Opaque claimant reference (e.g. a family space id, contact id, or guest token). */\n  readonly ref: string;\n\n  /** Display label shown next to the slot, e.g. \"Smith Family\". */\n  readonly label: string;\n}\n\n/** A bring-along item slot on an event. `claimedBy` absent => the slot is open. */\nexport interface IBringAlongSlot {\n  /** Slot id, unique within its event. */\n  readonly id: string;\n\n  /** What's needed, e.g. \"Drinks\". */\n  readonly label: string;\n\n  /** Optional free-text quantity/notes, e.g. \"2 bottles\". */\n  readonly note?: string;\n\n  /** Present when claimed; absent means the slot is open. */\n  readonly claimedBy?: ISlotClaimant;\n\n  /** Audit: when the slot was defined (RFC3339). */\n  readonly createdAt: string;\n}\n\n/** POST body to define a slot. Host-only. */\nexport interface IDefineSlotRequest {\n  label: string;\n  note?: string;\n}\n\n/** POST body to claim a slot. */\nexport interface IClaimSlotRequest {\n  ref: string;\n  label: string;\n}\n\n/** POST body to release a slot — only the claiming `ref` may release. */\nexport interface IReleaseSlotRequest {\n  ref: string;\n}\n","// TypeScript mirror of the frozen Eventus wire contract (`typespec/api4eventus.tsp`).\n// These shapes MUST match the JSON the backend emits/accepts exactly.\n\n/** Lifecycle status of an event. */\nexport type EventStatus = 'active' | 'cancelled';\n\n/**\n * An Eventus event. Persisted by the backend at\n * `/spaces/{spaceID}/ext/eventus/events/{eventID}`.\n */\nexport interface IEvent {\n  /** Event id, unique within its host space. */\n  readonly id: string;\n\n  /** Host space id this event belongs to. */\n  readonly spaceID: string;\n\n  /** Display name, e.g. \"Sophie's 10th Birthday\". */\n  readonly title: string;\n\n  /** Event start date/time as an RFC3339 / ISO string. */\n  readonly start: string;\n\n  /** Free-text location. */\n  readonly location: string;\n\n  /** Optional free-text description. */\n  readonly description?: string;\n\n  /** Lifecycle status; `active` on creation. */\n  readonly status: EventStatus;\n\n  /** Audit: creation timestamp (RFC3339). */\n  readonly createdAt: string;\n\n  /** Audit: last-modification timestamp (RFC3339). */\n  readonly updatedAt: string;\n}\n\n/** POST body to create an event. */\nexport interface ICreateEventRequest {\n  /** Display name (required, non-empty). */\n  title: string;\n\n  /** Event start date/time (RFC3339). */\n  start: string;\n\n  /** Free-text location (required, non-empty). */\n  location: string;\n\n  /** Optional free-text description. */\n  description?: string;\n\n  /**\n   * Event length in minutes. Optional — when omitted the backend's calendarius\n   * facade applies its default (60m).\n   */\n  durationMinutes?: number;\n}\n\n/**\n * Response of the create-event endpoint. The event itself is read\n * Firestore-direct (happening + overlay); the create response only identifies\n * the new happening so the UI can navigate to it.\n */\nexport interface ICreateEventResponse {\n  /** New event/happening id. */\n  readonly id: string;\n}\n\n/**\n * PUT body to edit an event. All fields optional; only present fields are\n * updated. Does not change `spaceID` or `status` (use cancel for status).\n */\nexport interface IUpdateEventRequest {\n  title?: string;\n  start?: string;\n  location?: string;\n  description?: string;\n}\n\n/** Standard error body returned by the backend with a non-2xx status. */\nexport interface IApiError {\n  /** Machine-readable error code, e.g. `unauthorized`, `not_found`. */\n  code: string;\n\n  /** Human-readable message. */\n  message: string;\n}\n","import { IIdAndBriefAndDbo } from '@sneat/core';\nimport { IWithCreated, IWithSpaceIDs } from '@sneat/dto';\nimport {\n  IHappeningBrief,\n  IHappeningDbo,\n  ISingleHappeningDbo,\n} from '@sneat/extension-calendarius-contract';\n\n// Eventus hosting overlay on a Calendarius happening.\n//\n// The overlay document id EQUALS the happeningID, so the overlay both (a) marks\n// a happening as an eventus-hosted event — the interim \"is this an event?\"\n// marker until the shared `'event'` HappeningKind lands (deferred with the\n// sneat-libs batch) — and (b) carries eventus-only extras. Display fields\n// (title, start, location, status) live on the happening, NOT here, so there is\n// no duplication of the calendar entity.\n//\n// Stored at `spaces/{spaceID}/ext/eventus/events/{happeningID}`.\n\nexport interface IEventusEventBrief {\n  /** listus list id holding the bring-along / give-away items, when attached. */\n  readonly bringAlongListID?: string;\n}\n\nexport type IEventusEventDbo = IEventusEventBrief & IWithSpaceIDs & IWithCreated;\n\ntype EventOverlay = IIdAndBriefAndDbo<IEventusEventBrief, IEventusEventDbo>;\ntype Happening = IIdAndBriefAndDbo<IHappeningBrief, IHappeningDbo>;\n\n/** A row for the eventus events list: a happening that is an eventus event. */\nexport interface IEventusEventListItem {\n  /** happeningID (overlay and happening share this id). */\n  readonly id: string;\n  readonly title: string;\n  /** Display start: ISO from the single happening, or `date[ time]` from its slot. */\n  readonly start?: string;\n  readonly happening: Happening;\n  readonly overlay?: EventOverlay;\n}\n\n/**\n * Pure join: the events list is the set of happenings that have an eventus\n * overlay (interim \"is-event\" marker), projected to list rows. Kept pure so the\n * join — the bug-prone part — is unit-testable without Firestore.\n */\nexport function selectEventListItems(\n  overlays: readonly EventOverlay[],\n  happenings: readonly Happening[],\n): IEventusEventListItem[] {\n  const overlayById = new Map(overlays.map((o) => [o.id, o]));\n  return happenings\n    .filter((h) => overlayById.has(h.id))\n    .map((h) => ({\n      id: h.id,\n      title: h.dbo?.title ?? h.brief?.title ?? '',\n      start: eventStart(h.dbo),\n      happening: h,\n      overlay: overlayById.get(h.id),\n    }));\n}\n\nfunction eventStart(dbo?: IHappeningDbo | null): string | undefined {\n  if (!dbo) {\n    return undefined;\n  }\n  const dtStarts = (dbo as ISingleHappeningDbo).dtStarts;\n  if (dtStarts) {\n    return new Date(dtStarts).toISOString();\n  }\n  const slot = Object.values(dbo.slots ?? {})[0];\n  if (slot?.start?.date) {\n    return slot.start.time\n      ? `${slot.start.date} ${slot.start.time}`\n      : slot.start.date;\n  }\n  return undefined;\n}\n","// TypeScript mirror of the frozen Eventus invitations contract\n// (`typespec/api4eventus-invitations.tsp`). Shapes MUST match the JSON the\n// backend emits/accepts exactly. An invitation references the invitee by id\n// only — Sneat (`spaceus`/`contactus`) stays the source of truth for names.\n\n/** Whether an invitation targets a whole family (space) or a single person. */\nexport type InviteeType = 'family' | 'person';\n\n/** An invitation of a family or person to an event. */\nexport interface IInvitation {\n  /** Invitation id, unique within its event. */\n  readonly id: string;\n\n  /** Discriminates which reference field is populated. */\n  readonly inviteeType: InviteeType;\n\n  /** Set when `inviteeType === 'family'`: the invited family's space id. */\n  readonly familySpaceID?: string;\n\n  /** Set when `inviteeType === 'person'`: the invited contact's id. */\n  readonly contactID?: string;\n\n  /** Audit: when the invitation was added (RFC3339). */\n  readonly createdAt: string;\n}\n\n/**\n * POST body to add one invitee. Exactly one of `familySpaceID` / `contactID`\n * is set, matching `inviteeType`. No name or contact detail is sent — only id.\n */\nexport interface IAddInviteeRequest {\n  inviteeType: InviteeType;\n  familySpaceID?: string;\n  contactID?: string;\n}\n","// TypeScript mirror of the frozen Eventus RSVP contract\n// (`typespec/api4eventus-rsvp.tsp`) plus the public resolve context from\n// (`typespec/api4eventus-links.tsp`). Shapes MUST match the JSON the backend\n// emits/accepts exactly. Submitting an RSVP is pure event-attendance and NEVER\n// joins the host's space.\n\nimport { LinkKind } from './rsvp-link';\n\n/** Responder's attendance answer. */\nexport type RsvpStatus = 'yes' | 'no' | 'maybe';\n\n/** A submitted RSVP. */\nexport interface IRsvp {\n  /** RSVP id, unique within its event. */\n  readonly id: string;\n\n  /** Invitation this RSVP answers (per-invitee link); empty for an open link. */\n  readonly invitationID?: string;\n\n  /** Attribution for an open-link response: the responder's self-identified name. */\n  readonly selfIdentifiedName?: string;\n\n  /** Optional self-identified family name (open link). */\n  readonly selfIdentifiedFamilyName?: string;\n\n  readonly status: RsvpStatus;\n\n  /** Adults attending. Forced to 0 by the backend when `status == 'no'`. */\n  readonly adults: number;\n\n  /** Children attending. Forced to 0 by the backend when `status == 'no'`. */\n  readonly children: number;\n\n  /** Optional dietary/allergy notes. */\n  readonly dietary?: string;\n\n  /** Optional free-text comment. */\n  readonly comment?: string;\n\n  /** True when submitted by a signed-in Sneat account. */\n  readonly viaAccount: boolean;\n\n  /** Audit: submission time (RFC3339). */\n  readonly submittedAt: string;\n}\n\n/** POST body to submit an RSVP. Headcounts are zeroed by the backend when `status == 'no'`. */\nexport interface ISubmitRsvpRequest {\n  status: RsvpStatus;\n  adults: number;\n  children: number;\n  dietary?: string;\n  comment?: string;\n\n  /**\n   * REQUIRED for an open-link token (the responder self-identifies); omitted for\n   * a per-invitee token (attribution comes from the invitation). Never a\n   * guest-list selection — only this free-text name. (AC: attribution-by-link-type)\n   */\n  selfIdentifiedName?: string;\n\n  /** Optional self-identified family name (open link). */\n  selfIdentifiedFamilyName?: string;\n}\n\n/**\n * Build the submit body from raw form values. When `status == 'no'` the\n * headcounts are forced to 0 (the backend zeroes them anyway), and blank\n * dietary/comment/self-identified names are dropped. For an open-link response\n * the trimmed `selfIdentifiedName` is carried through (the caller enforces it is\n * non-empty). Pure so it can be unit-tested without rendering.\n * (AC: no-rsvp-zeroes-headcount, rsvp-full-fields-captured, attribution-by-link-type)\n */\nexport function buildRsvpRequest(form: {\n  status: RsvpStatus;\n  adults: number;\n  children: number;\n  dietary: string;\n  comment: string;\n  selfIdentifiedName?: string;\n  selfIdentifiedFamilyName?: string;\n}): ISubmitRsvpRequest {\n  const attending = form.status !== 'no';\n  const dietary = form.dietary.trim();\n  const comment = form.comment.trim();\n  const name = form.selfIdentifiedName?.trim();\n  const familyName = form.selfIdentifiedFamilyName?.trim();\n  return {\n    status: form.status,\n    adults: attending ? form.adults : 0,\n    children: attending ? form.children : 0,\n    ...(dietary ? { dietary } : {}),\n    ...(comment ? { comment } : {}),\n    ...(name ? { selfIdentifiedName: name } : {}),\n    ...(familyName ? { selfIdentifiedFamilyName: familyName } : {}),\n  };\n}\n\n/**\n * Public context returned when a token is resolved — only what the RSVP form\n * needs. NEVER includes the guest list or any other invitee.\n */\nexport interface IRsvpContext {\n  /** Display fields for the event. */\n  readonly eventTitle: string;\n  readonly eventStart: string;\n  readonly eventLocation: string;\n\n  /** Whether the event still accepts RSVPs (false once cancelled). */\n  readonly open: boolean;\n\n  /** `invitee` → pre-attributed to one invitee; `open` → responder self-identifies. */\n  readonly kind: LinkKind;\n\n  /** Set only when `kind == 'invitee'`: the invitation this link is bound to. */\n  readonly invitationID?: string;\n}\n","// TypeScript mirror of the frozen Eventus links contract\n// (`typespec/api4eventus-links.tsp`). Shapes MUST match the JSON the backend\n// emits exactly. The QR code is rendered client-side from `url`.\n\n/** `invitee` = bound to a single invitation; `open` = shared event link. */\nexport type LinkKind = 'invitee' | 'open';\n\n/** A tokenized RSVP link (+ url for QR). */\nexport interface IRsvpLink {\n  /** Opaque link token. */\n  readonly token: string;\n\n  /** Full shareable RSVP URL, e.g. `https://eventus.sneat.app/r/{token}`. */\n  readonly url: string;\n\n  /** Whether the link targets one invitee or is the open event link. */\n  readonly kind: LinkKind;\n}\n","import { InjectionToken } from '@angular/core';\n\n/**\n * Base URL the Eventus API is served from (without a trailing slash), e.g.\n * `https://api.sneat.app`. Defaults to '' so requests are relative to the\n * app origin (`/api4eventus/...`). The app shell can override it.\n */\nexport const EVENTUS_API_BASE_URL = new InjectionToken<string>(\n  'EVENTUS_API_BASE_URL',\n  { providedIn: 'root', factory: () => '' },\n);\n","/** Pulls a human-readable message from an HttpErrorResponse carrying IApiError. */\nexport function extractErrorMessage(err: unknown, fallback: string): string {\n  const body = (err as { error?: { message?: string } })?.error;\n  return body?.message ?? fallback;\n}\n","import { InjectionToken } from '@angular/core';\nimport { ISlotClaimant } from '../models/bring-along';\n\n/**\n * The identity used when the current user claims or releases a bring-along\n * slot. Injecting this (rather than hard-coding) keeps claim/release testable\n * and decoupled from RSVP identity.\n *\n * TODO: replace the stub default with the real responder identity once RSVP\n * lands (Tasks 3/4) — claim/release should use the link-gated guest token or\n * the signed-in family/person ref instead of this placeholder.\n */\nexport const EVENTUS_CURRENT_CLAIMANT = new InjectionToken<ISlotClaimant>(\n  'EVENTUS_CURRENT_CLAIMANT',\n  {\n    providedIn: 'root',\n    factory: () => ({ ref: 'stub-claimant', label: 'Smith Family' }),\n  },\n);\n","import { InjectionToken } from '@angular/core';\nimport { IIdAndBriefAndDbo } from '@sneat/core';\nimport { Observable } from 'rxjs';\nimport {\n  IBringAlongSlot,\n  IClaimSlotRequest,\n  IDefineSlotRequest,\n  IReleaseSlotRequest,\n} from '../models/bring-along';\nimport {\n  ICreateEventResponse,\n  ICreateEventRequest,\n  IEvent,\n  IUpdateEventRequest,\n} from '../models/event';\nimport {\n  IEventusEventBrief,\n  IEventusEventDbo,\n  IEventusEventListItem,\n} from '../models/eventus-event';\nimport { IAddInviteeRequest, IInvitation } from '../models/invitation';\nimport { IRsvp, IRsvpContext, ISubmitRsvpRequest } from '../models/rsvp';\nimport { IRsvpLink } from '../models/rsvp-link';\n\n// Runtime-light service contracts the eventus pages/space-menu depend on. Each\n// interface mirrors the public surface of the concrete service in the internal\n// lib; the implementation is bound to the matching token below via\n// provideEventusInternal(). Contract must never import from internal.\n\n/** Bespoke HTTP client for the Eventus event API (read/edit). */\nexport interface IEventService {\n  listEvents(spaceID: string): Observable<IEvent[]>;\n  getEvent(spaceID: string, eventID: string): Observable<IEvent>;\n  updateEvent(\n    spaceID: string,\n    eventID: string,\n    request: IUpdateEventRequest,\n  ): Observable<IEvent>;\n  cancelEvent(spaceID: string, eventID: string): Observable<IEvent>;\n}\n\nexport const EVENT_SERVICE = new InjectionToken<IEventService>('EventService');\n\n/** Firestore-direct access to the eventus hosting overlays + event creation. */\nexport interface IEventusEventService {\n  watchEvents(spaceID: string): Observable<IEventusEventListItem[]>;\n  createEvent(\n    spaceID: string,\n    request: ICreateEventRequest,\n  ): Observable<ICreateEventResponse>;\n  watchEventOverlays(\n    spaceID: string,\n  ): Observable<IIdAndBriefAndDbo<IEventusEventBrief, IEventusEventDbo>[]>;\n}\n\nexport const EVENTUS_EVENT_SERVICE = new InjectionToken<IEventusEventService>(\n  'EventusEventService',\n);\n\n/** Token-gated, public RSVP API client. */\nexport interface IRsvpService {\n  resolveToken(token: string): Observable<IRsvpContext>;\n  submitRsvp(token: string, request: ISubmitRsvpRequest): Observable<IRsvp>;\n  updateRsvp(\n    token: string,\n    rsvpID: string,\n    request: ISubmitRsvpRequest,\n  ): Observable<IRsvp>;\n  listRsvps(spaceID: string, eventID: string): Observable<IRsvp[]>;\n}\n\nexport const RSVP_SERVICE = new InjectionToken<IRsvpService>('RsvpService');\n\n/** Eventus invitations API client. */\nexport interface IInvitationService {\n  addInvitee(\n    spaceID: string,\n    eventID: string,\n    request: IAddInviteeRequest,\n  ): Observable<IInvitation>;\n  listInvitations(\n    spaceID: string,\n    eventID: string,\n  ): Observable<IInvitation[]>;\n}\n\nexport const INVITATION_SERVICE = new InjectionToken<IInvitationService>(\n  'InvitationService',\n);\n\n/** Eventus links API client (host-only). */\nexport interface ILinkService {\n  issueInviteeLink(\n    spaceID: string,\n    eventID: string,\n    invitationID: string,\n  ): Observable<IRsvpLink>;\n  issueOpenLink(spaceID: string, eventID: string): Observable<IRsvpLink>;\n}\n\nexport const LINK_SERVICE = new InjectionToken<ILinkService>('LinkService');\n\n/** Eventus bring-along (slots) API client. */\nexport interface IBringAlongService {\n  defineSlot(\n    spaceID: string,\n    eventID: string,\n    request: IDefineSlotRequest,\n  ): Observable<IBringAlongSlot>;\n  listSlots(spaceID: string, eventID: string): Observable<IBringAlongSlot[]>;\n  claimSlot(\n    spaceID: string,\n    eventID: string,\n    slotID: string,\n    request: IClaimSlotRequest,\n  ): Observable<IBringAlongSlot>;\n  releaseSlot(\n    spaceID: string,\n    eventID: string,\n    slotID: string,\n    request: IReleaseSlotRequest,\n  ): Observable<IBringAlongSlot>;\n}\n\nexport const BRING_ALONG_SERVICE = new InjectionToken<IBringAlongService>(\n  'BringAlongService',\n);\n","import { InjectionToken } from '@angular/core';\nimport { Observable, of } from 'rxjs';\n\n/** A family the host can invite — id + display title only (no contact detail). */\nexport interface IInviteeFamily {\n  readonly id: string;\n  readonly title: string;\n}\n\n/** A person the host can invite — id + display name only (no contact detail). */\nexport interface IInviteePerson {\n  readonly id: string;\n  readonly name: string;\n}\n\n/**\n * Supplies the families and persons the host can pick from. Injecting this\n * (rather than calling `spaceus`/`contactus` directly) keeps the picker\n * testable and decoupled from those modules.\n */\nexport interface InviteeSource {\n  /** Families (Sneat `family` spaces) available to invite. */\n  families(spaceID: string): Observable<IInviteeFamily[]>;\n\n  /** Persons (Sneat `contactus` contacts) available to invite. */\n  persons(spaceID: string): Observable<IInviteePerson[]>;\n}\n\nexport const EVENTUS_INVITEE_SOURCE = new InjectionToken<InviteeSource>(\n  'EVENTUS_INVITEE_SOURCE',\n  { providedIn: 'root', factory: () => new StubInviteeSource() },\n);\n\n/**\n * Default stub returning sample data so the picker is usable end-to-end before\n * real wiring. TODO: replace with an adapter over `spaceus` (family spaces) and\n * `contactus` (contacts) once those modules are available to the app shell.\n */\nexport class StubInviteeSource implements InviteeSource {\n  families(): Observable<IInviteeFamily[]> {\n    return of([\n      { id: 'fam-sample-1', title: 'The Smith Family' },\n      { id: 'fam-sample-2', title: 'The Brown Family' },\n    ]);\n  }\n\n  persons(): Observable<IInviteePerson[]> {\n    return of([\n      { id: 'person-sample-1', name: 'Alice Smith' },\n      { id: 'person-sample-2', name: 'Bob Brown' },\n    ]);\n  }\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@sneat/extension-eventus-contract",
+  "version": "0.0.1",
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "@angular/core": "^21.0.0",
+    "rxjs": "^7.0.0",
+    "@sneat/core": "^0.11.0",
+    "@sneat/dto": "^0.11.0",
+    "@sneat/extension-calendarius-contract": "^0.12.1",
+    "vitest": "^4.0.9"
+  },
+  "sideEffects": false,
+  "module": "fesm2022/sneat-extension-eventus-contract.mjs",
+  "typings": "types/sneat-extension-eventus-contract.d.ts",
+  "exports": {
+    "./package.json": {
+      "default": "./package.json"
+    },
+    ".": {
+      "types": "./types/sneat-extension-eventus-contract.d.ts",
+      "default": "./fesm2022/sneat-extension-eventus-contract.mjs"
+    }
+  },
+  "type": "module",
+  "dependencies": {
+    "tslib": "^2.3.0"
+  }
+}

package/types/sneat-extension-eventus-contract.d.ts

@@ -0,0 +1,349 @@
+import { IIdAndBriefAndDbo } from '@sneat/core';
+import { IWithSpaceIDs, IWithCreated } from '@sneat/dto';
+import { IHappeningBrief, IHappeningDbo } from '@sneat/extension-calendarius-contract';
+import { InjectionToken } from '@angular/core';
+import { Observable } from 'rxjs';
+
+/**
+ * Who claimed a slot. Stored as an opaque reference plus a display label so the
+ * slot can render "Drinks — Smith Family" without resolving the reference.
+ */
+interface ISlotClaimant {
+    /** Opaque claimant reference (e.g. a family space id, contact id, or guest token). */
+    readonly ref: string;
+    /** Display label shown next to the slot, e.g. "Smith Family". */
+    readonly label: string;
+}
+/** A bring-along item slot on an event. `claimedBy` absent => the slot is open. */
+interface IBringAlongSlot {
+    /** Slot id, unique within its event. */
+    readonly id: string;
+    /** What's needed, e.g. "Drinks". */
+    readonly label: string;
+    /** Optional free-text quantity/notes, e.g. "2 bottles". */
+    readonly note?: string;
+    /** Present when claimed; absent means the slot is open. */
+    readonly claimedBy?: ISlotClaimant;
+    /** Audit: when the slot was defined (RFC3339). */
+    readonly createdAt: string;
+}
+/** POST body to define a slot. Host-only. */
+interface IDefineSlotRequest {
+    label: string;
+    note?: string;
+}
+/** POST body to claim a slot. */
+interface IClaimSlotRequest {
+    ref: string;
+    label: string;
+}
+/** POST body to release a slot — only the claiming `ref` may release. */
+interface IReleaseSlotRequest {
+    ref: string;
+}
+
+/** Lifecycle status of an event. */
+type EventStatus = 'active' | 'cancelled';
+/**
+ * An Eventus event. Persisted by the backend at
+ * `/spaces/{spaceID}/ext/eventus/events/{eventID}`.
+ */
+interface IEvent {
+    /** Event id, unique within its host space. */
+    readonly id: string;
+    /** Host space id this event belongs to. */
+    readonly spaceID: string;
+    /** Display name, e.g. "Sophie's 10th Birthday". */
+    readonly title: string;
+    /** Event start date/time as an RFC3339 / ISO string. */
+    readonly start: string;
+    /** Free-text location. */
+    readonly location: string;
+    /** Optional free-text description. */
+    readonly description?: string;
+    /** Lifecycle status; `active` on creation. */
+    readonly status: EventStatus;
+    /** Audit: creation timestamp (RFC3339). */
+    readonly createdAt: string;
+    /** Audit: last-modification timestamp (RFC3339). */
+    readonly updatedAt: string;
+}
+/** POST body to create an event. */
+interface ICreateEventRequest {
+    /** Display name (required, non-empty). */
+    title: string;
+    /** Event start date/time (RFC3339). */
+    start: string;
+    /** Free-text location (required, non-empty). */
+    location: string;
+    /** Optional free-text description. */
+    description?: string;
+    /**
+     * Event length in minutes. Optional — when omitted the backend's calendarius
+     * facade applies its default (60m).
+     */
+    durationMinutes?: number;
+}
+/**
+ * Response of the create-event endpoint. The event itself is read
+ * Firestore-direct (happening + overlay); the create response only identifies
+ * the new happening so the UI can navigate to it.
+ */
+interface ICreateEventResponse {
+    /** New event/happening id. */
+    readonly id: string;
+}
+/**
+ * PUT body to edit an event. All fields optional; only present fields are
+ * updated. Does not change `spaceID` or `status` (use cancel for status).
+ */
+interface IUpdateEventRequest {
+    title?: string;
+    start?: string;
+    location?: string;
+    description?: string;
+}
+/** Standard error body returned by the backend with a non-2xx status. */
+interface IApiError {
+    /** Machine-readable error code, e.g. `unauthorized`, `not_found`. */
+    code: string;
+    /** Human-readable message. */
+    message: string;
+}
+
+interface IEventusEventBrief {
+    /** listus list id holding the bring-along / give-away items, when attached. */
+    readonly bringAlongListID?: string;
+}
+type IEventusEventDbo = IEventusEventBrief & IWithSpaceIDs & IWithCreated;
+type EventOverlay = IIdAndBriefAndDbo<IEventusEventBrief, IEventusEventDbo>;
+type Happening = IIdAndBriefAndDbo<IHappeningBrief, IHappeningDbo>;
+/** A row for the eventus events list: a happening that is an eventus event. */
+interface IEventusEventListItem {
+    /** happeningID (overlay and happening share this id). */
+    readonly id: string;
+    readonly title: string;
+    /** Display start: ISO from the single happening, or `date[ time]` from its slot. */
+    readonly start?: string;
+    readonly happening: Happening;
+    readonly overlay?: EventOverlay;
+}
+/**
+ * Pure join: the events list is the set of happenings that have an eventus
+ * overlay (interim "is-event" marker), projected to list rows. Kept pure so the
+ * join — the bug-prone part — is unit-testable without Firestore.
+ */
+declare function selectEventListItems(overlays: readonly EventOverlay[], happenings: readonly Happening[]): IEventusEventListItem[];
+
+/** Whether an invitation targets a whole family (space) or a single person. */
+type InviteeType = 'family' | 'person';
+/** An invitation of a family or person to an event. */
+interface IInvitation {
+    /** Invitation id, unique within its event. */
+    readonly id: string;
+    /** Discriminates which reference field is populated. */
+    readonly inviteeType: InviteeType;
+    /** Set when `inviteeType === 'family'`: the invited family's space id. */
+    readonly familySpaceID?: string;
+    /** Set when `inviteeType === 'person'`: the invited contact's id. */
+    readonly contactID?: string;
+    /** Audit: when the invitation was added (RFC3339). */
+    readonly createdAt: string;
+}
+/**
+ * POST body to add one invitee. Exactly one of `familySpaceID` / `contactID`
+ * is set, matching `inviteeType`. No name or contact detail is sent — only id.
+ */
+interface IAddInviteeRequest {
+    inviteeType: InviteeType;
+    familySpaceID?: string;
+    contactID?: string;
+}
+
+/** `invitee` = bound to a single invitation; `open` = shared event link. */
+type LinkKind = 'invitee' | 'open';
+/** A tokenized RSVP link (+ url for QR). */
+interface IRsvpLink {
+    /** Opaque link token. */
+    readonly token: string;
+    /** Full shareable RSVP URL, e.g. `https://eventus.sneat.app/r/{token}`. */
+    readonly url: string;
+    /** Whether the link targets one invitee or is the open event link. */
+    readonly kind: LinkKind;
+}
+
+/** Responder's attendance answer. */
+type RsvpStatus = 'yes' | 'no' | 'maybe';
+/** A submitted RSVP. */
+interface IRsvp {
+    /** RSVP id, unique within its event. */
+    readonly id: string;
+    /** Invitation this RSVP answers (per-invitee link); empty for an open link. */
+    readonly invitationID?: string;
+    /** Attribution for an open-link response: the responder's self-identified name. */
+    readonly selfIdentifiedName?: string;
+    /** Optional self-identified family name (open link). */
+    readonly selfIdentifiedFamilyName?: string;
+    readonly status: RsvpStatus;
+    /** Adults attending. Forced to 0 by the backend when `status == 'no'`. */
+    readonly adults: number;
+    /** Children attending. Forced to 0 by the backend when `status == 'no'`. */
+    readonly children: number;
+    /** Optional dietary/allergy notes. */
+    readonly dietary?: string;
+    /** Optional free-text comment. */
+    readonly comment?: string;
+    /** True when submitted by a signed-in Sneat account. */
+    readonly viaAccount: boolean;
+    /** Audit: submission time (RFC3339). */
+    readonly submittedAt: string;
+}
+/** POST body to submit an RSVP. Headcounts are zeroed by the backend when `status == 'no'`. */
+interface ISubmitRsvpRequest {
+    status: RsvpStatus;
+    adults: number;
+    children: number;
+    dietary?: string;
+    comment?: string;
+    /**
+     * REQUIRED for an open-link token (the responder self-identifies); omitted for
+     * a per-invitee token (attribution comes from the invitation). Never a
+     * guest-list selection — only this free-text name. (AC: attribution-by-link-type)
+     */
+    selfIdentifiedName?: string;
+    /** Optional self-identified family name (open link). */
+    selfIdentifiedFamilyName?: string;
+}
+/**
+ * Build the submit body from raw form values. When `status == 'no'` the
+ * headcounts are forced to 0 (the backend zeroes them anyway), and blank
+ * dietary/comment/self-identified names are dropped. For an open-link response
+ * the trimmed `selfIdentifiedName` is carried through (the caller enforces it is
+ * non-empty). Pure so it can be unit-tested without rendering.
+ * (AC: no-rsvp-zeroes-headcount, rsvp-full-fields-captured, attribution-by-link-type)
+ */
+declare function buildRsvpRequest(form: {
+    status: RsvpStatus;
+    adults: number;
+    children: number;
+    dietary: string;
+    comment: string;
+    selfIdentifiedName?: string;
+    selfIdentifiedFamilyName?: string;
+}): ISubmitRsvpRequest;
+/**
+ * Public context returned when a token is resolved — only what the RSVP form
+ * needs. NEVER includes the guest list or any other invitee.
+ */
+interface IRsvpContext {
+    /** Display fields for the event. */
+    readonly eventTitle: string;
+    readonly eventStart: string;
+    readonly eventLocation: string;
+    /** Whether the event still accepts RSVPs (false once cancelled). */
+    readonly open: boolean;
+    /** `invitee` → pre-attributed to one invitee; `open` → responder self-identifies. */
+    readonly kind: LinkKind;
+    /** Set only when `kind == 'invitee'`: the invitation this link is bound to. */
+    readonly invitationID?: string;
+}
+
+/**
+ * Base URL the Eventus API is served from (without a trailing slash), e.g.
+ * `https://api.sneat.app`. Defaults to '' so requests are relative to the
+ * app origin (`/api4eventus/...`). The app shell can override it.
+ */
+declare const EVENTUS_API_BASE_URL: InjectionToken<string>;
+
+/** Pulls a human-readable message from an HttpErrorResponse carrying IApiError. */
+declare function extractErrorMessage(err: unknown, fallback: string): string;
+
+/**
+ * The identity used when the current user claims or releases a bring-along
+ * slot. Injecting this (rather than hard-coding) keeps claim/release testable
+ * and decoupled from RSVP identity.
+ *
+ * TODO: replace the stub default with the real responder identity once RSVP
+ * lands (Tasks 3/4) — claim/release should use the link-gated guest token or
+ * the signed-in family/person ref instead of this placeholder.
+ */
+declare const EVENTUS_CURRENT_CLAIMANT: InjectionToken<ISlotClaimant>;
+
+/** Bespoke HTTP client for the Eventus event API (read/edit). */
+interface IEventService {
+    listEvents(spaceID: string): Observable<IEvent[]>;
+    getEvent(spaceID: string, eventID: string): Observable<IEvent>;
+    updateEvent(spaceID: string, eventID: string, request: IUpdateEventRequest): Observable<IEvent>;
+    cancelEvent(spaceID: string, eventID: string): Observable<IEvent>;
+}
+declare const EVENT_SERVICE: InjectionToken<IEventService>;
+/** Firestore-direct access to the eventus hosting overlays + event creation. */
+interface IEventusEventService {
+    watchEvents(spaceID: string): Observable<IEventusEventListItem[]>;
+    createEvent(spaceID: string, request: ICreateEventRequest): Observable<ICreateEventResponse>;
+    watchEventOverlays(spaceID: string): Observable<IIdAndBriefAndDbo<IEventusEventBrief, IEventusEventDbo>[]>;
+}
+declare const EVENTUS_EVENT_SERVICE: InjectionToken<IEventusEventService>;
+/** Token-gated, public RSVP API client. */
+interface IRsvpService {
+    resolveToken(token: string): Observable<IRsvpContext>;
+    submitRsvp(token: string, request: ISubmitRsvpRequest): Observable<IRsvp>;
+    updateRsvp(token: string, rsvpID: string, request: ISubmitRsvpRequest): Observable<IRsvp>;
+    listRsvps(spaceID: string, eventID: string): Observable<IRsvp[]>;
+}
+declare const RSVP_SERVICE: InjectionToken<IRsvpService>;
+/** Eventus invitations API client. */
+interface IInvitationService {
+    addInvitee(spaceID: string, eventID: string, request: IAddInviteeRequest): Observable<IInvitation>;
+    listInvitations(spaceID: string, eventID: string): Observable<IInvitation[]>;
+}
+declare const INVITATION_SERVICE: InjectionToken<IInvitationService>;
+/** Eventus links API client (host-only). */
+interface ILinkService {
+    issueInviteeLink(spaceID: string, eventID: string, invitationID: string): Observable<IRsvpLink>;
+    issueOpenLink(spaceID: string, eventID: string): Observable<IRsvpLink>;
+}
+declare const LINK_SERVICE: InjectionToken<ILinkService>;
+/** Eventus bring-along (slots) API client. */
+interface IBringAlongService {
+    defineSlot(spaceID: string, eventID: string, request: IDefineSlotRequest): Observable<IBringAlongSlot>;
+    listSlots(spaceID: string, eventID: string): Observable<IBringAlongSlot[]>;
+    claimSlot(spaceID: string, eventID: string, slotID: string, request: IClaimSlotRequest): Observable<IBringAlongSlot>;
+    releaseSlot(spaceID: string, eventID: string, slotID: string, request: IReleaseSlotRequest): Observable<IBringAlongSlot>;
+}
+declare const BRING_ALONG_SERVICE: InjectionToken<IBringAlongService>;
+
+/** A family the host can invite — id + display title only (no contact detail). */
+interface IInviteeFamily {
+    readonly id: string;
+    readonly title: string;
+}
+/** A person the host can invite — id + display name only (no contact detail). */
+interface IInviteePerson {
+    readonly id: string;
+    readonly name: string;
+}
+/**
+ * Supplies the families and persons the host can pick from. Injecting this
+ * (rather than calling `spaceus`/`contactus` directly) keeps the picker
+ * testable and decoupled from those modules.
+ */
+interface InviteeSource {
+    /** Families (Sneat `family` spaces) available to invite. */
+    families(spaceID: string): Observable<IInviteeFamily[]>;
+    /** Persons (Sneat `contactus` contacts) available to invite. */
+    persons(spaceID: string): Observable<IInviteePerson[]>;
+}
+declare const EVENTUS_INVITEE_SOURCE: InjectionToken<InviteeSource>;
+/**
+ * Default stub returning sample data so the picker is usable end-to-end before
+ * real wiring. TODO: replace with an adapter over `spaceus` (family spaces) and
+ * `contactus` (contacts) once those modules are available to the app shell.
+ */
+declare class StubInviteeSource implements InviteeSource {
+    families(): Observable<IInviteeFamily[]>;
+    persons(): Observable<IInviteePerson[]>;
+}
+
+export { BRING_ALONG_SERVICE, EVENTUS_API_BASE_URL, EVENTUS_CURRENT_CLAIMANT, EVENTUS_EVENT_SERVICE, EVENTUS_INVITEE_SOURCE, EVENT_SERVICE, INVITATION_SERVICE, LINK_SERVICE, RSVP_SERVICE, StubInviteeSource, buildRsvpRequest, extractErrorMessage, selectEventListItems };
+export type { EventStatus, IAddInviteeRequest, IApiError, IBringAlongService, IBringAlongSlot, IClaimSlotRequest, ICreateEventRequest, ICreateEventResponse, IDefineSlotRequest, IEvent, IEventService, IEventusEventBrief, IEventusEventDbo, IEventusEventListItem, IEventusEventService, IInvitation, IInvitationService, IInviteeFamily, IInviteePerson, ILinkService, IReleaseSlotRequest, IRsvp, IRsvpContext, IRsvpLink, IRsvpService, ISlotClaimant, ISubmitRsvpRequest, IUpdateEventRequest, InviteeSource, InviteeType, LinkKind, RsvpStatus };