@playaos/api-client 0.56.2 → 0.58.0

package/README.md

@@ -61,6 +61,44 @@ const created = await client.applications.create({
 
 If your deployment serves both route families from the same host, omit `embedBaseUrl` and the client will reuse `baseUrl`.
 
+### External application receipts
+
+External forms can submit only the fields they collect, plus structured
+`custom_fields`. Omit uncollected birthdays and acknowledgements; never invent
+affirmative consent to satisfy the multi-step wizard's separate requirements.
+The camp must have an active year configured.
+
+The approval workflow requires actual principles agreement. An intake without
+that answer can be stored, but cannot be approved. Collect explicit consent in
+forms intended to complete that workflow and pass `agrees_to_principles: true`
+only after the applicant acknowledges it. Missing consent is never an implied
+agreement, and administrators cannot manufacture it during reconciliation.
+
+For retryable submissions, create one UUID per logical application and retain it
+with the draft. Send it as `submission_id` on every identical retry:
+
+```ts
+const receipt = await client.applications.create({
+  submission_id: submissionId,
+  first_name: "Rain",
+  last_name: "",
+  email: "rain@example.com",
+  custom_fields: { interests: ["pickleball"] },
+});
+```
+
+A fresh opted-in acceptance returns `replayed: false`. An identical retry returns
+the same `applicationId` and original `year` with `replayed: true`, without
+changing the saved application. Different answers under an accepted key conflict;
+an email duplicate under another key is not an owned receipt. Retries remain
+scoped to the issuing camp. Keep this operation on the server when its camp
+credential is server-only.
+
+Start optional mail or spreadsheet side effects only for an explicit
+`replayed === false` result. A replay or older server's missing flag does not
+prove those side effects are safe to repeat. Saved acceptance and notification
+delivery are separate outcomes; reconcile unknown delivery before resending.
+
 ## Route hosts
 
 - `baseUrl` is used for authenticated `/api/v1/*` routes.

package/dist/applications-schema.d.ts

@@ -50,6 +50,7 @@ export declare const step5Schema: z.ZodObject<{
   agrees_to_principles: z.ZodLiteral<true>;
 }, z.core.$strip>;
 export declare const applicationSchema: z.ZodObject<{
+  submission_id: z.ZodOptional<z.ZodString>;
   acknowledged_expectations: z.ZodOptional<z.ZodLiteral<true>>;
   first_name: z.ZodString;
   last_name: z.ZodString;

package/dist/applications-schema.js

@@ -51,9 +51,10 @@ const step5Schema = z.object({
 	agrees_to_principles: z.literal(true, { error: "You must agree to the 10 Principles" })
 });
 const applicationSchema = z.object({
+	submission_id: z.string().uuid().optional(),
 	acknowledged_expectations: z.literal(true).optional(),
 	first_name: z.string().min(1),
-	last_name: z.string().min(1),
+	last_name: z.string(),
 	email: z.string().email(),
 	phone: z.string().optional(),
 	referral_code: z.string().optional(),

package/dist/applications-schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"applications-schema.js","names":[],"sources":["../src/applications-schema.ts"],"sourcesContent":["import { z } from \"zod\";\n\n// Single source of truth for the apply-wizard form shape.\n// The portal apply flow and the @playaos/react <ApplicationForm> SDK both import\n// from here so the validation contract can never drift between them (PLA-483).\n// `ApplicationCreatePayload` in ./types.ts is the zod-free wire mirror; a type\n// equivalence test (applications-schema.test.ts) keeps the two locked together.\n\n// Per-step validation schemas\nexport const step0Schema = z.object({\n  acknowledged_expectations: z.literal(true, {\n    error: \"Please acknowledge the expectations to continue\",\n  }),\n});\n\nexport const step1Schema = z.object({\n  first_name: z.string().min(1, \"First name is required\"),\n  last_name: z.string().min(1, \"Last name is required\"),\n  email: z.string().email(\"Invalid email address\"),\n  phone: z.string().min(10, \"Phone number is required\"),\n  referral_code: z.string().optional(),\n  socials: z.string().optional(),\n  birthday: z.string().min(1, \"Birthday is required\"),\n  hometown: z.string().min(1, \"Location is required\"),\n});\n\nexport const step2Schema = z.object({\n  how_heard: z.string().min(1, \"Please tell us how you heard about us\"),\n  burning_man_before: z.enum([\"yes\", \"no\"], { error: \"Please select an option\" }),\n  burning_man_years: z.string().optional(),\n});\n\nexport const step3Schema = z.object({\n  shelter_type: z.enum([\"joining_rv\", \"bringing_rv\", \"shiftpod_tent\", \"car\", \"truck\", \"van\", \"unsure\"], {\n    error: \"Please select a shelter type\",\n  }),\n  shelter_mates: z.string().optional(),\n  ticket_status: z.enum([\"looking\", \"have_ticket\", \"unsure\"], { error: \"Please select your ticket status\" }),\n});\n\nexport const step4Schema = z\n  .object({\n    build_available: z.boolean(),\n    build_skills: z.string().optional(),\n    strike_available: z.boolean(),\n    strike_help: z.string().optional(),\n    // commitmentId → value. Integers only on the number branch (per dataType);\n    // per-commitment bounds (min/max) are validated against the live defs at\n    // form-render + on the server, not here (PLA-682).\n    commitments: z.record(z.string(), z.union([z.number().int(), z.boolean()])).optional(),\n  })\n  .refine((data) => !data.build_available || data.build_skills, {\n    message: \"Please tell us about your build skills\",\n    path: [\"build_skills\"],\n  })\n  .refine((data) => !data.strike_available || data.strike_help, {\n    message: \"Please tell us how you can help with strike\",\n    path: [\"strike_help\"],\n  });\n\nexport const step5Schema = z.object({\n  about_yourself: z.string().min(50, \"Please write at least 50 characters about yourself\"),\n  agrees_to_principles: z.literal(true, { error: \"You must agree to the 10 Principles\" }),\n});\n\n// Combined schema for API-level validation — permissive so external camps\n// can submit applications with only first_name + last_name + email + custom_fields.\n// Step schemas (above) remain strict for the PlayaOS wizard UI.\nexport const applicationSchema = z.object({\n  acknowledged_expectations: z.literal(true).optional(),\n  first_name: z.string().min(1),\n  last_name: z.string().min(1),\n  email: z.string().email(),\n  phone: z.string().optional(),\n  referral_code: z.string().optional(),\n  socials: z.string().optional(),\n  birthday: z.string().optional(),\n  hometown: z.string().optional(),\n  how_heard: z.string().optional(),\n  burning_man_before: z.enum([\"yes\", \"no\"]).optional(),\n  burning_man_years: z.string().optional(),\n  shelter_type: z.enum([\"joining_rv\", \"bringing_rv\", \"shiftpod_tent\", \"car\", \"truck\", \"van\", \"unsure\"]).optional(),\n  shelter_mates: z.string().optional(),\n  ticket_status: z.enum([\"looking\", \"have_ticket\", \"unsure\"]).optional(),\n  build_available: z.boolean().optional(),\n  build_skills: z.string().optional(),\n  strike_available: z.boolean().optional(),\n  strike_help: z.string().optional(),\n  about_yourself: z.string().optional(),\n  agrees_to_principles: z.literal(true).optional(),\n  // Permissive at the API level (no bounds checks) — the server validates each\n  // value against the live commitment definition before seeding (PLA-682).\n  commitments: z.record(z.string(), z.union([z.number(), z.boolean()])).optional(),\n  custom_fields: z.object({}).passthrough().optional(),\n});\n\nexport type ApplicationFormData = z.infer<typeof applicationSchema>;\nexport type Step0Data = z.infer<typeof step0Schema>;\nexport type Step1Data = z.infer<typeof step1Schema>;\nexport type Step2Data = z.infer<typeof step2Schema>;\nexport type Step3Data = z.infer<typeof step3Schema>;\nexport type Step4Data = z.infer<typeof step4Schema>;\nexport type Step5Data = z.infer<typeof step5Schema>;\n"],"mappings":"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"}
+{"version":3,"file":"applications-schema.js","names":[],"sources":["../src/applications-schema.ts"],"sourcesContent":["import { z } from \"zod\";\n\n// Single source of truth for the apply-wizard form shape.\n// The portal apply flow and the @playaos/react <ApplicationForm> SDK both import\n// from here so the validation contract can never drift between them (PLA-483).\n// `ApplicationCreatePayload` in ./types.ts is the zod-free wire mirror; a type\n// equivalence test (applications-schema.test.ts) keeps the two locked together.\n\n// Per-step validation schemas\nexport const step0Schema = z.object({\n  acknowledged_expectations: z.literal(true, {\n    error: \"Please acknowledge the expectations to continue\",\n  }),\n});\n\nexport const step1Schema = z.object({\n  first_name: z.string().min(1, \"First name is required\"),\n  last_name: z.string().min(1, \"Last name is required\"),\n  email: z.string().email(\"Invalid email address\"),\n  phone: z.string().min(10, \"Phone number is required\"),\n  referral_code: z.string().optional(),\n  socials: z.string().optional(),\n  birthday: z.string().min(1, \"Birthday is required\"),\n  hometown: z.string().min(1, \"Location is required\"),\n});\n\nexport const step2Schema = z.object({\n  how_heard: z.string().min(1, \"Please tell us how you heard about us\"),\n  burning_man_before: z.enum([\"yes\", \"no\"], { error: \"Please select an option\" }),\n  burning_man_years: z.string().optional(),\n});\n\nexport const step3Schema = z.object({\n  shelter_type: z.enum([\"joining_rv\", \"bringing_rv\", \"shiftpod_tent\", \"car\", \"truck\", \"van\", \"unsure\"], {\n    error: \"Please select a shelter type\",\n  }),\n  shelter_mates: z.string().optional(),\n  ticket_status: z.enum([\"looking\", \"have_ticket\", \"unsure\"], { error: \"Please select your ticket status\" }),\n});\n\nexport const step4Schema = z\n  .object({\n    build_available: z.boolean(),\n    build_skills: z.string().optional(),\n    strike_available: z.boolean(),\n    strike_help: z.string().optional(),\n    // commitmentId → value. Integers only on the number branch (per dataType);\n    // per-commitment bounds (min/max) are validated against the live defs at\n    // form-render + on the server, not here (PLA-682).\n    commitments: z.record(z.string(), z.union([z.number().int(), z.boolean()])).optional(),\n  })\n  .refine((data) => !data.build_available || data.build_skills, {\n    message: \"Please tell us about your build skills\",\n    path: [\"build_skills\"],\n  })\n  .refine((data) => !data.strike_available || data.strike_help, {\n    message: \"Please tell us how you can help with strike\",\n    path: [\"strike_help\"],\n  });\n\nexport const step5Schema = z.object({\n  about_yourself: z.string().min(50, \"Please write at least 50 characters about yourself\"),\n  agrees_to_principles: z.literal(true, { error: \"You must agree to the 10 Principles\" }),\n});\n\n// Combined schema for API-level validation — permissive so external camps\n// can submit applications with only first_name + last_name + email + custom_fields.\n// Step schemas (above) remain strict for the PlayaOS wizard UI.\nexport const applicationSchema = z.object({\n  submission_id: z.string().uuid().optional(),\n  acknowledged_expectations: z.literal(true).optional(),\n  first_name: z.string().min(1),\n  last_name: z.string(),\n  email: z.string().email(),\n  phone: z.string().optional(),\n  referral_code: z.string().optional(),\n  socials: z.string().optional(),\n  birthday: z.string().optional(),\n  hometown: z.string().optional(),\n  how_heard: z.string().optional(),\n  burning_man_before: z.enum([\"yes\", \"no\"]).optional(),\n  burning_man_years: z.string().optional(),\n  shelter_type: z.enum([\"joining_rv\", \"bringing_rv\", \"shiftpod_tent\", \"car\", \"truck\", \"van\", \"unsure\"]).optional(),\n  shelter_mates: z.string().optional(),\n  ticket_status: z.enum([\"looking\", \"have_ticket\", \"unsure\"]).optional(),\n  build_available: z.boolean().optional(),\n  build_skills: z.string().optional(),\n  strike_available: z.boolean().optional(),\n  strike_help: z.string().optional(),\n  about_yourself: z.string().optional(),\n  agrees_to_principles: z.literal(true).optional(),\n  // Permissive at the API level (no bounds checks) — the server validates each\n  // value against the live commitment definition before seeding (PLA-682).\n  commitments: z.record(z.string(), z.union([z.number(), z.boolean()])).optional(),\n  custom_fields: z.object({}).passthrough().optional(),\n});\n\nexport type ApplicationFormData = z.infer<typeof applicationSchema>;\nexport type Step0Data = z.infer<typeof step0Schema>;\nexport type Step1Data = z.infer<typeof step1Schema>;\nexport type Step2Data = z.infer<typeof step2Schema>;\nexport type Step3Data = z.infer<typeof step3Schema>;\nexport type Step4Data = z.infer<typeof step4Schema>;\nexport type Step5Data = z.infer<typeof step5Schema>;\n"],"mappings":"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"}

package/dist/index.d.ts

@@ -35,6 +35,19 @@ type PaginationParams = {
   /** Opaque cursor from a previous response's nextCursor. */
   cursor?: string;
 };
+/**
+ * Event scope for event-scoped reads and writes (ADR-132). Send `eventId` for a canonical event.
+ * Year handling is endpoint-specific during the ADR-132 rollout (`playa-0i3qp.11.3.x`): endpoints
+ * that have adopted the contract resolve a `year` alone to at most one event and answer
+ * 409 `EVENT_REQUIRED` with the candidate events when it matches several; endpoints that have
+ * not adopted it yet still treat `year` as the legacy annual filter.
+ */
+type EventScopeParams = {
+  /** Legacy camp year. */
+  year?: number;
+  /** Canonical event ID. */
+  eventId?: string;
+};
 interface Member {
   id: string;
   firstName: string;
@@ -123,7 +136,29 @@ interface ApplicationCapacity {
   limit: number;
   atCapacity: boolean;
 }
+interface ApplicationWorkflowCapabilities {
+  transitions: {
+    to: "approved" | "rejected" | "waitlisted" | "interviewed";
+    enabled: boolean;
+    reason?: string;
+  }[];
+  invite: {
+    enabled: boolean;
+    reason?: string;
+  };
+  interviewNote: {
+    enabled: boolean;
+    reason?: string;
+  };
+  annotations: {
+    notes: boolean;
+    tags: boolean;
+    scores: boolean;
+  };
+}
 interface ApplicationAdmin extends Application {
+  /** Advisory server policy; writes remain authoritative. Absent on older servers. */
+  workflowCapabilities?: ApplicationWorkflowCapabilities;
   /** Applicant phone from the joined profile (PLA-1322). */
   phone: string | null;
   /** Applicant birthday (YYYY-MM-DD) from the joined profile (PLA-1332). */
@@ -174,6 +209,15 @@ interface ImportantDate {
   category: string | null;
   year: number;
 }
+type EventStatus = "draft" | "published" | "archived";
+interface EventSummary {
+  id: string;
+  name: string;
+  status: EventStatus;
+  startDate: string | null;
+  endDate: string | null;
+  timezone: string | null;
+}
 interface SummerCampAttendee {
   profileId: string;
   nightsAttending: string[];
@@ -288,8 +332,9 @@ interface PhotoExportJob {
   completedAt: string | null;
 }
 interface CreatePhotoExportInput {
+  /** Canonical event (`events.id`) to export. Required since 0.58.0, which removed `year`. */
+  eventId: string;
   attending?: "true" | "all";
-  year?: number;
   role?: string;
   status?: string;
   search?: string;
@@ -300,7 +345,8 @@ interface OnboardingProgress {
   orgId: string;
   userId: string;
   itemId: string;
-  year: number;
+  eventId: string | null;
+  year: number | null;
   completed: boolean | null;
 }
 /** A camp year with its per-year member/date counts (`GET /bookkeeping/years`, PLA-1345). */
@@ -444,7 +490,8 @@ interface MemberCustomChecklistItem {
   categoryId: string;
   name: string;
   completed: boolean | null;
-  year: number;
+  eventId: string | null;
+  year: number | null;
 }
 interface DuesStatus {
   userId: string | null;
@@ -471,6 +518,10 @@ interface MemberDuesStatus {
   attendanceResponse: string | null;
   /** Whether the member has ever signed in (PLA-1343). */
   hasLoggedIn: boolean | null;
+  /** Event the row is for; absent or null on the annual path (ADR-132). */
+  eventId?: string | null;
+  /** Event participation status; absent or null on the annual path. */
+  participationStatus?: string | null;
 }
 /** Per-tier dues totals from `dues_summary` (PLA-1336). */
 interface DuesSummaryRow {
@@ -520,6 +571,8 @@ interface ShiftSignup {
   userId: string;
   status: string | null;
   role: string | null;
+  canceledAt?: string | null;
+  waitlistedAt?: string | null;
 }
 interface ShiftType {
   id: string;
@@ -527,6 +580,10 @@ interface ShiftType {
   description: string | null;
 }
 interface Shift {
+  /** Server-owned self-service time window only; publication and capacity are separate. */
+  selfServiceOpen?: boolean;
+  /** Effective capacity for self-service signup; independent of mobile/admin policies. */
+  selfSignupCapacity?: number;
   id: string;
   orgId: string;
   shiftDate: string;
@@ -588,8 +645,28 @@ interface AdminShelter {
     } | null;
   }>;
 }
+/** An organization-owned event, as listed on `GET /org` (ADR-132). */
+interface OrgEvent {
+  id: string;
+  name: string;
+  slug: string;
+  status: "draft" | "published" | "archived";
+  startDate: string | null;
+  endDate: string | null;
+}
 interface OrgConfig {
+  /** Canonical branding fields; absent on older API deployments. */
+  tagline?: string | null;
+  description?: string | null;
+  /**
+   * @deprecated Display and legacy use only: the configured active camp year, else the current
+   * calendar year. Not an event scope (ADR-132); send `eventId` or an explicit `year` instead.
+   */
   activeCampYear: number;
+  /** Actual configured active camp year; absent on older API deployments. Never a calendar fallback. */
+  configuredActiveCampYear?: number | null;
+  /** The organization's events, ordered by start date; absent on older API deployments (ADR-132). */
+  events?: OrgEvent[];
   id: string;
   name: string;
   slug: string;
@@ -821,6 +898,8 @@ interface MemberGroupRosterRow {
   profileStatus: string | null;
 }
 interface ApplicationCreatePayload {
+  /** Stable opaque UUID for exact-payload receipt recovery; never reuse for changed answers. */
+  submission_id?: string;
   acknowledged_expectations?: true;
   first_name: string;
   last_name: string;
@@ -849,6 +928,10 @@ interface ApplicationCreatePayload {
 interface ApplicationCreateResponse {
   applicationId: string;
   status: string;
+  /** Original accepted camp year. */
+  year?: number;
+  /** Present for opted-in submissions; only false authorizes fresh delivery side effects. */
+  replayed?: boolean;
 }
 interface ApplicationTransitionPayload {
   to: ApplicationStatus;
@@ -1291,8 +1374,10 @@ interface BikeRentalInterestedMember {
   unmatchable: boolean;
 }
 interface BikeRentalInterestedNotReservedResponse {
-  /** Active camp year; the calendar year when no camp year is active. */
+  /** Camp year of the list; for an event, its start year. */
   year: number;
+  /** Event the list is for; null on the annual path. */
+  eventId: string | null;
   items: BikeRentalInterestedMember[];
 }
 /** Email template registry entry (PLA-1265). */
@@ -1381,7 +1466,8 @@ interface Scholarship {
   id: string;
   orgId: string;
   userId: string;
-  year: number;
+  eventId: string | null;
+  year: number | null;
   promoCode: string;
   discountAmount: string;
   reason: string | null;
@@ -1396,6 +1482,7 @@ interface CreateScholarshipInput {
   discountAmount: number;
   reason?: string;
   year?: number;
+  eventId?: string;
 }
 type TicketStatus = "have_ticket" | "need_ticket" | "step_enrolled" | "low_income_approved";
 interface AdminTicketRow extends Ticket {
@@ -1457,7 +1544,25 @@ interface MemberSelfProfile {
   otherAllergies: string | null;
   hasEpipen: boolean | null;
 }
+type MemberGateId = "attendance" | "account" | "documents" | "profile" | "shelter";
+interface MemberGateStep {
+  id: MemberGateId;
+  status: "complete" | "pending" | "not_applicable";
+  skippable: boolean;
+  requirements: {
+    id: string;
+    complete: boolean;
+  }[];
+}
+interface MemberGatePlan {
+  year: number;
+  steps: MemberGateStep[];
+  nextGate: MemberGateId | null;
+  remainingCount: number;
+  totalCount: number;
+}
 interface MemberBootstrap {
+  gates: MemberGatePlan;
   year: number;
   profile: MemberSelfProfile;
   campYear: {
@@ -1468,14 +1573,36 @@ interface MemberBootstrap {
   confirmedShelterAssignment: {
     id: string;
   } | null;
+  /** Renderable unsigned documents for the current documents gate; other gates use requirements only. */
   unsignedDocuments: Array<{
     id: string;
     name: string;
     description: string | null;
     content: string | WaiverContent | null;
     filePath: string | null;
+    externalUrl: string | null;
   }>;
 }
+/** Acting member's active-year dues flags and attributed payment history. */
+interface MemberPaymentsOverview {
+  year: number;
+  duesStatus: {
+    hasPaidBaseDues: boolean;
+    hasPaidRvDues: boolean;
+    ownsRvShelter: boolean;
+    rvAmperage: number | null;
+    rvType: string | null;
+    totalPaid: number;
+  };
+  payments: Array<{
+    id: string;
+    amount: number;
+    paymentMethod: string | null;
+    paymentStatus: string | null;
+    paymentDate: string | null;
+  }>;
+  donationWidgetId: string | null;
+}
 interface MemberDashboard {
   year: number;
   profile: MemberSelfProfile;
@@ -2123,6 +2250,11 @@ interface SchedulingAdminResult {
   success?: boolean;
 }
 interface SchedulingAdminSettings {
+  /** Missing on older servers; an empty array means no active camp booking links. */
+  bookingLinks?: {
+    id: string;
+    title: string;
+  }[];
   googleConnected: boolean;
   interviewer: {
     id: string;
@@ -2263,11 +2395,12 @@ interface AdminScholarshipsPage {
   scholarships: {
     id: string;
     userId: string;
+    eventId: string | null;
     promoCode: string;
     discountAmount: string;
     reason: string | null;
     status: ScholarshipStatus;
-    year: number;
+    year: number | null;
     usedAt: string | null;
     createdAt: string | null;
     profile: {
@@ -2969,9 +3102,23 @@ export declare class PlayaOSClient {
     bootstrap: (opts?: {
       signal?: AbortSignal;
     }) => Promise<MemberBootstrap>;
+    gates: (opts?: {
+      signal?: AbortSignal;
+    }) => Promise<MemberGatePlan>;
     dashboard: (opts?: {
       signal?: AbortSignal;
     }) => Promise<MemberDashboard>;
+    /** Always the acting member, including admins; requires a member token and members:read scope. */
+    paymentOverview: (opts?: {
+      signal?: AbortSignal;
+    }) => Promise<MemberPaymentsOverview>;
+    /** Acting member's original photo only; missing originals return 404, never an avatar fallback. */
+    selfPhotoDownloadUrl: (opts?: {
+      signal?: AbortSignal;
+    }) => Promise<{
+      url: string;
+      fileName: string;
+    }>;
     /** Presigned profile-photo upload (PLA-1263). PUT the bytes, then setPhoto. */
     createPhotoUploadUrl: (payload: {
       contentType: "image/jpeg" | "image/png" | "image/webp";
@@ -3037,6 +3184,8 @@ export declare class PlayaOSClient {
       sortBy?: "name" | "email" | "role" | "status" | "createdAt";
       sortOrder?: "asc" | "desc";
       attending?: "true" | "false";
+      /** Canonical event to scope `attending` to; alone, lists that event's participants. */
+      eventId?: string;
     } & PaginationParams & {
       /** Raw row offset — the members table's pager. Mutually exclusive with `cursor`. */
       offset?: number;
@@ -3549,9 +3698,7 @@ export declare class PlayaOSClient {
     }>;
   };
   readonly scholarships: {
-    adminPage: (params?: {
-      year?: number;
-    }, opts?: {
+    adminPage: (params?: EventScopeParams, opts?: {
       signal?: AbortSignal;
     }) => Promise<AdminScholarshipsPage>;
     refresh: (id: string, opts?: {
@@ -3560,9 +3707,7 @@ export declare class PlayaOSClient {
       givebutterActive: boolean;
       givebutterUsed: number;
     }>;
-    stats: (params?: {
-      year?: number;
-    }, opts?: {
+    stats: (params?: EventScopeParams, opts?: {
       signal?: AbortSignal;
     }) => Promise<ScholarshipStats>;
     /** Create a scholarship (code + Givebutter sync). Admin-only (PLA-1266). */
@@ -3846,8 +3991,11 @@ export declare class PlayaOSClient {
     requestReservation: (payload: BikeRentalRequestInput, opts?: {
       signal?: AbortSignal;
     }) => Promise<BikeRentalRequestResult>;
-    /** Members who said they want a bike but have no reservation, for the active camp year. Org key only. */
-    interestedNotReserved: (opts?: {
+    /**
+     * Members who said they want a bike but have no reservation, for one event or camp year. With
+     * no params, the camp's configured active camp year. Org key only.
+     */
+    interestedNotReserved: (params?: EventScopeParams, opts?: {
       signal?: AbortSignal;
     }) => Promise<BikeRentalInterestedNotReservedResponse>;
   };
@@ -4150,6 +4298,14 @@ export declare class PlayaOSClient {
       signal?: AbortSignal;
     }) => Promise<ImportantDate[]>;
   };
+  readonly events: {
+    /** The camp's events with the given status (default `published`), earliest first. */
+    list: (params?: {
+      status?: EventStatus;
+    }, opts?: {
+      signal?: AbortSignal;
+    }) => Promise<EventSummary[]>;
+  };
   readonly emails: {
     recipients: (payload: EmailRecipientFilter, opts?: {
       signal?: AbortSignal;
@@ -4297,22 +4453,19 @@ export declare class PlayaOSClient {
     /** Per-member checklist completion; non-admins are pinned to themselves. */
     progress: (params?: {
       userId?: string;
-      year?: number;
-    } & PaginationParams, opts?: {
+    } & EventScopeParams & PaginationParams, opts?: {
       signal?: AbortSignal;
     }) => Promise<Paginated<OnboardingProgress>>;
     /** The acting member's own custom checklist items for a year (PLA-1340). */
     customItems: (params?: {
       userId?: string;
-      year?: number;
-    } & PaginationParams, opts?: {
+    } & EventScopeParams & PaginationParams, opts?: {
       signal?: AbortSignal;
     }) => Promise<Paginated<MemberCustomChecklistItem>>;
     /** Tick a checklist item for the acting member (PLA-1259). */
     setProgress: (itemId: string, payload: {
       completed: boolean;
-      year?: number;
-    }, opts?: {
+    } & EventScopeParams, opts?: {
       signal?: AbortSignal;
     }) => Promise<OnboardingProgress>;
   };
@@ -4521,23 +4674,21 @@ export declare class PlayaOSClient {
         accessToken?: string;
         signal?: AbortSignal;
       }) => Promise<DuesUpdateResponse>;
-      /** Per-member dues state from `member_dues_status` (PLA-1336). V1-only — requires a member token. */
-      status: (params?: {
-        year?: number;
-      }, opts?: {
+      /**
+       * Per-member dues state for one event or camp year (PLA-1336, ADR-132). With no params, the
+       * configured active camp year. V1-only — requires a member token.
+       */
+      status: (params?: EventScopeParams, opts?: {
         signal?: AbortSignal;
       }) => Promise<MemberDuesStatus[]>;
-      /** Per-tier dues totals from `dues_summary` (PLA-1336). V1-only — requires a member token. */
-      summary: (params?: {
-        year?: number;
-      }, opts?: {
+      /** Per-tier dues totals for one event or camp year (PLA-1336, ADR-132). V1-only — requires a member token. */
+      summary: (params?: EventScopeParams, opts?: {
         signal?: AbortSignal;
       }) => Promise<DuesSummaryRow[]>;
-      /** Members who paid a given dues type (PLA-1336). V1-only — requires a member token. */
+      /** Members who paid a given dues type, for one event or camp year (PLA-1336, ADR-132). V1-only — requires a member token. */
       payors: (params: {
         duesType: string;
-        year: number;
-      }, opts?: {
+      } & EventScopeParams, opts?: {
         signal?: AbortSignal;
       }) => Promise<DuesTypePayor[]>;
     };
@@ -4736,5 +4887,5 @@ interface PublicMarketplaceClient {
 }
 export declare function createPublicMarketplaceClient(opts: PublicMarketplaceClientOptions): PublicMarketplaceClient;
 //#endregion
-export type { AccountReviewProfile, AdminAccountsOperation, AdminAccountsPage, AdminBikeInterestRow, AdminBikeInventory, AdminBikeOperation, AdminBikeOperationResult, AdminBikeRental, AdminBikeType, AdminCampDocument, AdminCampSettings, AdminDocumentSignature, AdminGivebutterCatalog, AdminGivebutterCatalogOperation, AdminGivebutterWidgetOperation, AdminGivebutterWidgets, AdminImportOperation, AdminImportResult, AdminImportRow, AdminImportantDate, AdminImportantDateInput, AdminImportantDateOperation, AdminInterviewBooking, AdminMemberExportRow, AdminMemberInvite, AdminMemberOperation, AdminMemberRole, AdminMemberStatus, AdminNotificationPrefs, AdminPaymentOperation, AdminPaymentOperationResult, AdminPaymentSummary, AdminPaymentsPage, AdminScholarshipsPage, AdminShelter, AdminShelterOperation, AdminShift, AdminShiftType, AdminTicketRow, AdminWebhooksPage, Application, ApplicationActivityItem, ApplicationAdmin, ApplicationAnnotations, ApplicationCapacity, ApplicationCreatePayload, ApplicationCreateResponse, ApplicationNote, ApplicationScore, ApplicationStatus, ApplicationTransitionPayload, ApplicationTransitionResponse, ApplicationWorkflowInput, ApplicationWorkflowOptions, BikeRentalCatalogItem, BikeRentalCatalogResponse, BikeRentalDeliveryMode, BikeRentalFramePreference, BikeRentalInterestedMember, BikeRentalInterestedNotReservedResponse, BikeRentalRequestInput, BikeRentalRequestResult, BikeRentalReservation, BikeRentalReservationListResponse, BikeRentalWaiver, BookkeepingAdminOperation, BookkeepingExportPreview, BuildStrikeReportRow, CampDocumentDownloadUrl, CampDocumentSignature, CampDocumentSignaturesResponse, CampSettingsOperation, CampYearWithCounts, Commitment, CommitmentDataType, CommitmentValue, CommitmentsListResponse, ContactSyncResponse, ContractSection, CreateMeetingInput, CreateSapAssignmentInput, CreateScholarshipInput, DailyHeadcount, DashboardMetrics, DirectoryMember, DirectoryMembersListResponse, DocumentWriteInput, DuesStatus, DuesSummaryRow, DuesTypePayor, EmailCmsPreview, EmailComposerOptions, EmailDeliveryPage, EmailLog, EmailRecipient, EmailRecipientFilter, EmailRetry, EmailRetryCount, EmailRetryListResponse, EmailSegmentKey, EmailTemplate, ExchangeParams, ExchangeResult, ImageUploadTarget, ImportantDate, InterviewFeedBooking, ListingImage, LogisticsBreakdowns, LogisticsSummary, MarketplaceFlagReason, Meeting, MeetingDateOption, MeetingListResponse, MeetingRsvp, Member, MemberBikeStatus, MemberBootstrap, MemberCreatePayload, MemberCreateResponse, MemberCustomChecklistItem, MemberDashboard, MemberDeactivateResponse, MemberDevice, MemberDocumentPage, MemberDuesStatus, MemberInboxNotification, MemberInboxPage, MemberOnboardingUpdate, MemberPreferences, MemberProfileDetails, MemberPushPreferences, MemberRole, MemberSelfProfile, MemberSelfProfilePatch, MemberShelter, MemberShelterPage, MemberShiftView, MemberTag, MemberTagAssignment, MemberTagWithMemberCount, MemberUpdatePayload, MemberUpdateResponse, MobileShifts, NewListingInput, OnboardingChecklistCategory, OnboardingChecklistItem, OnboardingProgress, OrgConfig, OwnerShelterCreate, OwnerShelterPatch, PackingCampAdminItem, PackingCampAdminList, PackingCampCategory, PackingCampCategoryInput, PackingCampItem, PackingContainer, PackingContainerInput, PackingContainerListResponse, PackingContainerType, PackingItem, PackingItemStatus, PackingLayer, PackingListResponse, PackingPersonalItem, PackingPlacementListResponse, PaymentPageResponse, PublicMarketplaceClient, PublicMarketplaceClientOptions, RvAmperageTotal, SapAllocation, SapAssignment, SapDayAllocation, SchedulingAdminOperation, SchedulingAdminResult, SchedulingAdminSettings, SchedulingAvailability, SchedulingOverride, Scholarship, ScholarshipStats, ScholarshipStatus, SetPhotoPayload, SheetsSyncResult, ShelterTypeDistribution, Shift, ShiftAdminOperation, ShiftAdminOperationResult, ShiftAdminWorkflow, ShiftAdminWorkflowResult, ShiftPlannerData, ShiftSignup, ShiftType, SummerCampAttendee, SummerCampEvent, SummerCampRsvp, SummerCampRsvpInput, Ticket, TicketStatus, TicketUpdateInput, TshirtSizeTotal, UnmatchedRefund, UnsureDateMember, UpdateSapAllocationInput, UpdateSapAssignmentInput, UpsertPackingCampItemInput, UpsertSapDayAllocationInput, VehiclePass, VehiclePassStatus, VehiclePassUpdateInput, Waiver, WaiverContent, WaiverSection, WaiverSignPayload, WaiverSignResponse, WaiverStatus, WebhookCandidate, WebhookLog, WebhookMatchSelection };
+export type { AccountReviewProfile, AdminAccountsOperation, AdminAccountsPage, AdminBikeInterestRow, AdminBikeInventory, AdminBikeOperation, AdminBikeOperationResult, AdminBikeRental, AdminBikeType, AdminCampDocument, AdminCampSettings, AdminDocumentSignature, AdminGivebutterCatalog, AdminGivebutterCatalogOperation, AdminGivebutterWidgetOperation, AdminGivebutterWidgets, AdminImportOperation, AdminImportResult, AdminImportRow, AdminImportantDate, AdminImportantDateInput, AdminImportantDateOperation, AdminInterviewBooking, AdminMemberExportRow, AdminMemberInvite, AdminMemberOperation, AdminMemberRole, AdminMemberStatus, AdminNotificationPrefs, AdminPaymentOperation, AdminPaymentOperationResult, AdminPaymentSummary, AdminPaymentsPage, AdminScholarshipsPage, AdminShelter, AdminShelterOperation, AdminShift, AdminShiftType, AdminTicketRow, AdminWebhooksPage, Application, ApplicationActivityItem, ApplicationAdmin, ApplicationAnnotations, ApplicationCapacity, ApplicationCreatePayload, ApplicationCreateResponse, ApplicationEvent, ApplicationNote, ApplicationScore, ApplicationStatus, ApplicationTransitionPayload, ApplicationTransitionResponse, ApplicationWorkflowCapabilities, ApplicationWorkflowInput, ApplicationWorkflowOptions, AvailabilityWindow, BikeRentalCatalogItem, BikeRentalCatalogResponse, BikeRentalDeliveryMode, BikeRentalFramePreference, BikeRentalInterestedMember, BikeRentalInterestedNotReservedResponse, BikeRentalRequestInput, BikeRentalRequestResult, BikeRentalReservation, BikeRentalReservationListResponse, BikeRentalWaiver, BookkeepingAdminOperation, BookkeepingExportPreview, BuildStrikeReportRow, CampDocumentDownloadUrl, CampDocumentSignature, CampDocumentSignaturesResponse, CampSettingsOperation, CampYearWithCounts, Commitment, CommitmentDataType, CommitmentValue, CommitmentsListResponse, ContactSyncResponse, ContractSection, CreateMeetingInput, CreateSapAssignmentInput, CreateScholarshipInput, DailyHeadcount, DashboardMetrics, DirectoryMember, DirectoryMembersListResponse, DocumentWriteInput, DuesStatus, DuesSummaryRow, DuesTypePayor, EmailCmsPreview, EmailComposerOptions, EmailDeliveryPage, EmailLog, EmailRecipient, EmailRecipientFilter, EmailRetry, EmailRetryCount, EmailRetryListResponse, EmailSegmentKey, EmailTemplate, EventScopeParams, EventStatus, EventSummary, ExchangeParams, ExchangeResult, ImageUploadTarget, ImportantDate, InterviewFeedBooking, ListingImage, LogisticsBreakdowns, LogisticsSummary, MarketplaceFlagReason, Meeting, MeetingDateOption, MeetingListResponse, MeetingRsvp, Member, MemberBikeStatus, MemberBootstrap, MemberCreatePayload, MemberCreateResponse, MemberCustomChecklistItem, MemberDashboard, MemberDeactivateResponse, MemberDevice, MemberDocumentPage, MemberDuesStatus, MemberGateId, MemberGatePlan, MemberGateStep, MemberInboxNotification, MemberInboxPage, MemberOnboardingUpdate, MemberPaymentsOverview, MemberPreferences, MemberProfileDetails, MemberPushPreferences, MemberRole, MemberSelfProfile, MemberSelfProfilePatch, MemberShelter, MemberShelterPage, MemberShiftView, MemberTag, MemberTagAssignment, MemberTagWithMemberCount, MemberUpdatePayload, MemberUpdateResponse, MobileShifts, NewListingInput, OnboardingChecklistCategory, OnboardingChecklistItem, OnboardingProgress, OrgConfig, OrgEvent, OwnerShelterCreate, OwnerShelterPatch, PackingCampAdminItem, PackingCampAdminList, PackingCampCategory, PackingCampCategoryInput, PackingCampItem, PackingContainer, PackingContainerInput, PackingContainerListResponse, PackingContainerType, PackingItem, PackingItemStatus, PackingLayer, PackingListResponse, PackingPersonalItem, PackingPlacementListResponse, PaymentPageResponse, PublicMarketplaceClient, PublicMarketplaceClientOptions, RvAmperageTotal, SapAllocation, SapAssignment, SapDayAllocation, SchedulingAdminOperation, SchedulingAdminResult, SchedulingAdminSettings, SchedulingAvailability, SchedulingOverride, Scholarship, ScholarshipStats, ScholarshipStatus, SetPhotoPayload, SheetsSyncResult, ShelterTypeDistribution, Shift, ShiftAdminOperation, ShiftAdminOperationResult, ShiftAdminWorkflow, ShiftAdminWorkflowResult, ShiftPlannerData, ShiftSignup, ShiftType, SummerCampAttendee, SummerCampEvent, SummerCampRsvp, SummerCampRsvpInput, Ticket, TicketStatus, TicketUpdateInput, TshirtSizeTotal, UnmatchedRefund, UnsureDateMember, UpdateSapAllocationInput, UpdateSapAssignmentInput, UpsertPackingCampItemInput, UpsertSapDayAllocationInput, VehiclePass, VehiclePassStatus, VehiclePassUpdateInput, Waiver, WaiverContent, WaiverSection, WaiverSignPayload, WaiverSignResponse, WaiverStatus, WebhookCandidate, WebhookLog, WebhookMatchSelection };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -69,9 +69,10 @@ async function getEmbedAuthed(url, campKey, opts) {
 	if (!res.ok) throw await parseError(res);
 	return res.json();
 }
-async function request(url, auth, signal) {
+async function request(url, auth, signal, cache) {
 	const res = await fetch(url, {
 		headers: v1Headers(auth),
+		...cache ? { cache } : {},
 		signal
 	});
 	if (!res.ok) throw await parseError(res);
@@ -262,8 +263,13 @@ var PlayaOSClient = class PlayaOSClient {
 		adminSetPhoto: (id, payload, opts) => post(buildUrl(this.baseUrl, `/members/${encodeURIComponent(id)}/photo`), this.auth, payload, opts?.signal),
 		adminDeletePhoto: (id, opts) => sendV1("DELETE", buildUrl(this.baseUrl, `/members/${encodeURIComponent(id)}/photo`), this.auth, {}, opts?.signal),
 		updateOnboarding: (payload, opts) => sendV1("PATCH", buildUrl(this.baseUrl, "/members/me/onboarding"), this.auth, payload, opts?.signal),
-		bootstrap: (opts) => request(buildUrl(this.baseUrl, "/members/me/bootstrap"), this.auth, opts?.signal),
+		bootstrap: (opts) => request(buildUrl(this.baseUrl, "/members/me/bootstrap"), this.auth, opts?.signal, "no-store"),
+		gates: (opts) => request(buildUrl(this.baseUrl, "/members/me/gates"), this.auth, opts?.signal, "no-store"),
 		dashboard: (opts) => request(buildUrl(this.baseUrl, "/members/me/dashboard"), this.auth, opts?.signal),
+		/** Always the acting member, including admins; requires a member token and members:read scope. */
+		paymentOverview: (opts) => request(buildUrl(this.baseUrl, "/members/me/payment-overview"), this.auth, opts?.signal, "no-store"),
+		/** Acting member's original photo only; missing originals return 404, never an avatar fallback. */
+		selfPhotoDownloadUrl: (opts) => request(buildUrl(this.baseUrl, "/members/me/photo/download-url"), this.auth, opts?.signal, "no-store"),
 		/** Presigned profile-photo upload (PLA-1263). PUT the bytes, then setPhoto. */
 		createPhotoUploadUrl: (payload, opts) => post(buildUrl(this.baseUrl, "/members/me/photo/upload-url"), this.auth, payload, opts?.signal),
 		setPhoto: (payload, opts) => post(buildUrl(this.baseUrl, "/members/me/photo"), this.auth, payload, opts?.signal),
@@ -526,8 +532,11 @@ var PlayaOSClient = class PlayaOSClient {
 		* the model is sold out, 400 when it is unknown or no longer bookable.
 		*/
 		requestReservation: (payload, opts) => post(buildUrl(this.baseUrl, "/bike-rentals/requests"), this.auth, payload, opts?.signal),
-		/** Members who said they want a bike but have no reservation, for the active camp year. Org key only. */
-		interestedNotReserved: (opts) => request(buildUrl(this.baseUrl, "/bike-rentals/interested-not-reserved"), this.auth, opts?.signal)
+		/**
+		* Members who said they want a bike but have no reservation, for one event or camp year. With
+		* no params, the camp's configured active camp year. Org key only.
+		*/
+		interestedNotReserved: (params, opts) => request(buildUrl(this.baseUrl, "/bike-rentals/interested-not-reserved", params), this.auth, opts?.signal)
 	};
 	tags = {
 		create: (payload, opts) => post(buildUrl(this.baseUrl, "/tags"), this.auth, payload, opts?.signal),
@@ -627,6 +636,9 @@ var PlayaOSClient = class PlayaOSClient {
 		/** Visible camp dates (PLA-1268), optionally pinned to a year. */
 		list: (params, opts) => request(buildUrl(this.baseUrl, "/important-dates", params), this.auth, opts?.signal)
 	};
+	events = { 
+	/** The camp's events with the given status (default `published`), earliest first. */
+list: (params, opts) => request(buildUrl(this.baseUrl, "/events", params), this.auth, opts?.signal) };
 	emails = {
 		recipients: (payload, opts) => post(buildUrl(this.baseUrl, "/email/recipients"), this.auth, payload, opts?.signal),
 		composerOptions: (params, opts) => request(buildUrl(this.baseUrl, "/email/composer-options", params), this.auth, opts?.signal),
@@ -784,17 +796,20 @@ send: (payload, opts) => (({ accessToken, signal }) => this.adminV1OrEmbed("POST
 			create: (payload, opts) => (({ accessToken, signal }) => this.adminV1OrEmbed("POST", "/dues", "/admin/dues", accessToken, payload, signal))(this.adminAccess(opts)),
 			/** Update a dues/payment record (PLA-708). Requires admin Bearer token. */
 			update: (id, payload, opts) => (({ accessToken, signal }) => this.adminV1OrEmbed("PATCH", `/dues/${encodeURIComponent(id)}`, `/admin/dues/${encodeURIComponent(id)}`, accessToken, payload, signal))(this.adminAccess(opts)),
-			/** Per-member dues state from `member_dues_status` (PLA-1336). V1-only — requires a member token. */
+			/**
+			* Per-member dues state for one event or camp year (PLA-1336, ADR-132). With no params, the
+			* configured active camp year. V1-only — requires a member token.
+			*/
 			status: (params, opts) => {
 				if (!this.memberToken) throw new Error("dues.status requires withMember(token)");
 				return request(buildUrl(this.baseUrl, "/admin/dues/status", params), this.auth, opts?.signal).then((r) => r.data);
 			},
-			/** Per-tier dues totals from `dues_summary` (PLA-1336). V1-only — requires a member token. */
+			/** Per-tier dues totals for one event or camp year (PLA-1336, ADR-132). V1-only — requires a member token. */
 			summary: (params, opts) => {
 				if (!this.memberToken) throw new Error("dues.summary requires withMember(token)");
 				return request(buildUrl(this.baseUrl, "/admin/dues/summary", params), this.auth, opts?.signal).then((r) => r.data);
 			},
-			/** Members who paid a given dues type (PLA-1336). V1-only — requires a member token. */
+			/** Members who paid a given dues type, for one event or camp year (PLA-1336, ADR-132). V1-only — requires a member token. */
 			payors: (params, opts) => {
 				if (!this.memberToken) throw new Error("dues.payors requires withMember(token)");
 				return request(buildUrl(this.baseUrl, "/admin/dues/payors", params), this.auth, opts?.signal).then((r) => r.data);