@playaos/api-client 0.11.0 → 0.13.0

package/dist/index.d.ts

@@ -1,648 +1,907 @@
+//#region src/error.d.ts
 declare class ApiClientError extends Error {
-    readonly status: number;
-    readonly code: string;
-    constructor(status: number, code: string, message: string);
+  readonly status: number;
+  readonly code: string;
+  /**
+   * Seconds to wait before retrying, parsed from a numeric `Retry-After`
+   * response header when the server sends one (commonly on 429 and 503).
+   * Undefined when the header is absent or in HTTP-date form.
+   */
+  readonly retryAfter?: number | undefined;
+  constructor(status: number, code: string, message: string,
+  /**
+   * Seconds to wait before retrying, parsed from a numeric `Retry-After`
+   * response header when the server sends one (commonly on 429 and 503).
+   * Undefined when the header is absent or in HTTP-date form.
+   */
+  retryAfter?: number | undefined);
+}
+//#endregion
+//#region src/types.d.ts
+/** Cursor-paginated list envelope returned by v1 list endpoints (PLA-779). */
+interface Paginated<T> {
+  data: T[];
+  /** Opaque cursor for the next page, or null when this is the last page. */
+  nextCursor: string | null;
 }
-
+/**
+ * Shared cursor-pagination request params for list methods. Declared as a `type`
+ * (not an `interface`) so intersections like `{ year?: number } & PaginationParams`
+ * stay assignable to `Record<string, …>` when serialized into a query string.
+ */
+type PaginationParams = {
+  /** Max rows to return (1-100, default 50). */
+  limit?: number;
+  /** Opaque cursor from a previous response's nextCursor. */
+  cursor?: string;
+};
 interface Member {
-    id: string;
-    firstName: string;
-    lastName: string;
-    name: string | null;
-    email: string;
-    phone?: string | null;
-    role: string | null;
-    status: string | null;
-    orgId: string;
-    createdAt: string | null;
-    bio?: string | null;
-    playaName?: string | null;
-    socialMedia?: Record<string, unknown> | null;
-    showSocialsInDirectory?: boolean;
-    profilePhotoPath?: string | null;
-    emergencyContactName?: string | null;
-    emergencyContactRelationship?: string | null;
-    emergencyContactPhone?: string | null;
-    yearJoined?: number | null;
+  id: string;
+  firstName: string;
+  lastName: string;
+  name: string | null;
+  email: string;
+  phone?: string | null;
+  role: string | null;
+  status: string | null;
+  orgId: string;
+  createdAt: string | null;
+  bio?: string | null;
+  playaName?: string | null;
+  socialMedia?: Record<string, unknown> | null;
+  showSocialsInDirectory?: boolean;
+  profilePhotoPath?: string | null;
+  emergencyContactName?: string | null;
+  emergencyContactRelationship?: string | null;
+  emergencyContactPhone?: string | null;
+  yearJoined?: number | null;
 }
 interface Application {
-    id: string;
-    userId: string;
-    orgId: string;
-    status: string | null;
-    year: number;
-    createdAt: string | null;
-    updatedAt: string | null;
-    email?: string | null;
-    firstName?: string | null;
-    lastName?: string | null;
-    submittedAt?: string | null;
-    whyJoin?: string | null;
-    howHeard?: string | null;
-    shelterType?: string | null;
-    burningManBefore?: boolean | null;
-    customFields?: Record<string, unknown> | null;
+  id: string;
+  userId: string;
+  orgId: string;
+  status: string | null;
+  year: number;
+  createdAt: string | null;
+  updatedAt: string | null;
+  email?: string | null;
+  firstName?: string | null;
+  lastName?: string | null;
+  submittedAt?: string | null;
+  whyJoin?: string | null;
+  howHeard?: string | null;
+  shelterType?: string | null;
+  burningManBefore?: boolean | null;
+  customFields?: Record<string, unknown> | null;
 }
 interface DuesStatus {
-    userId: string | null;
-    year: number | null;
-    paymentStatus: string | null;
-    amountOwed: string | null;
-    amountPaid: string | null;
-    balance: string | null;
+  userId: string | null;
+  year: number | null;
+  paymentStatus: string | null;
+  amountOwed: string | null;
+  amountPaid: string | null;
+  balance: string | null;
 }
 interface ShiftSignup {
-    id: string;
-    userId: string;
-    status: string | null;
-    role: string | null;
+  id: string;
+  userId: string;
+  status: string | null;
+  role: string | null;
 }
 interface ShiftType {
-    id: string;
-    name: string;
-    description: string | null;
+  id: string;
+  name: string;
+  description: string | null;
 }
 interface Shift {
-    id: string;
-    orgId: string;
-    shiftDate: string;
-    year: number;
-    startTime: string | null;
-    endTime: string | null;
-    maxSlots: number | null;
-    isPublished: boolean | null;
-    shiftType: ShiftType | null;
-    shiftSignups: ShiftSignup[];
+  id: string;
+  orgId: string;
+  shiftDate: string;
+  year: number;
+  startTime: string | null;
+  endTime: string | null;
+  maxSlots: number | null;
+  isPublished: boolean | null;
+  shiftType: ShiftType | null;
+  shiftSignups: ShiftSignup[];
 }
 interface OrgConfig {
-    id: string;
-    name: string;
-    slug: string;
-    preset: string | null;
-    customDomain: string | null;
-    settings: Record<string, unknown> | null;
-    features: Record<string, unknown> | null;
-    plan: string | null;
-    logoUrl: string | null;
-}
-type ApplicationStatus = "draft" | "pending" | "invite_sent" | "interview_scheduled" | "interviewed" | "approved" | "waitlisted" | "rejected";
+  id: string;
+  name: string;
+  slug: string;
+  preset: string | null;
+  customDomain: string | null;
+  settings: Record<string, unknown> | null;
+  features: Record<string, unknown> | null;
+  plan: string | null;
+  logoUrl: string | null;
+}
+type CommitmentDataType = "integer" | "boolean";
+type CommitmentValue = number | boolean;
+/** An admin-configured commitment definition (per org + year) the apply form renders. */
+interface Commitment {
+  id: string;
+  name: string;
+  displayName: string;
+  description: string | null;
+  dataType: CommitmentDataType;
+  minValue: number | null;
+  maxValue: number | null;
+}
+interface CommitmentsListResponse {
+  commitments: Commitment[];
+}
+type ApplicationStatus = "draft" | "pending" | "invite_sent" | "interview_scheduled" | "interviewed" | "approved" | "waitlisted" | "rejected" | "spam";
 type MemberRole = "member" | "admin" | "applicant" | "super_admin";
 interface PaymentPageResponse {
-    provider: "givebutter" | "crowded";
-    url: string;
-    modalSupported: boolean;
+  provider: "givebutter" | "crowded";
+  url: string;
+  modalSupported: boolean;
+}
+interface Contact {
+  id: string;
+  name: string | null;
+  email: string | null;
+  phone: string | null;
+  role: string | null;
+  status: string | null;
+}
+interface NotificationLog {
+  id: string;
+  orgId: string;
+  userIds: string[];
+  category: string;
+  title: string;
+  body: string;
+  data: Record<string, unknown> | null;
+  status: string | null;
+  sentAt: string | null;
+  error: string | null;
+  createdAt: string;
+}
+interface PaymentLedgerRow {
+  id: string;
+  memberId: string | null;
+  amount: string;
+  type: "dues" | "payment";
+  provider: "givebutter" | "crowded" | null;
+  status: string | null;
+  timestamp: string | null;
+}
+interface Account {
+  id: string;
+  [key: string]: unknown;
+}
+interface CampDocument {
+  id: string;
+  orgId: string;
+  name: string;
+  description: string | null;
+  documentType: string;
+  year: number;
+  publishedAt: string | null;
+}
+interface Shelter {
+  id: string;
+  name: string | null;
+  shelterType: string;
+  year: number;
+  orgId: string;
+}
+interface Bike {
+  id: string;
+  bikeId: string;
+  status: string;
+  orgId: string;
+}
+interface MemberTag {
+  id: string;
+  name: string;
+  description: string | null;
+  color: string | null;
+  orgId: string;
+}
+interface MemberGroup {
+  id: string;
+  name: string | null;
+  leaderProfileId: string | null;
+  leaderName: string | null;
+  leaderEmail: string | null;
+  memberCount: number;
+  createdAt: string | null;
+}
+interface MemberGroupRosterRow {
+  membershipId: string;
+  profileId: string;
+  role: string;
+  status: string;
+  name: string | null;
+  firstName: string | null;
+  lastName: string | null;
+  email: string | null;
+  profileStatus: string | null;
 }
 interface ApplicationCreatePayload {
-    acknowledged_expectations?: true;
-    first_name: string;
-    last_name: string;
-    email: string;
-    phone?: string;
-    referral_code?: string;
-    socials?: string;
-    birthday?: string;
-    hometown?: string;
-    how_heard?: string;
-    burning_man_before?: "yes" | "no";
-    burning_man_years?: string;
-    shelter_type?: "joining_rv" | "bringing_rv" | "shiftpod_tent" | "car" | "truck" | "van" | "unsure";
-    shelter_mates?: string;
-    ticket_status?: "looking" | "have_ticket" | "unsure";
-    build_available?: boolean;
-    build_skills?: string;
-    strike_available?: boolean;
-    strike_help?: string;
-    about_yourself?: string;
-    agrees_to_principles?: true;
-    custom_fields?: Record<string, unknown>;
+  acknowledged_expectations?: true;
+  first_name: string;
+  last_name: string;
+  email: string;
+  phone?: string;
+  referral_code?: string;
+  socials?: string;
+  birthday?: string;
+  hometown?: string;
+  how_heard?: string;
+  burning_man_before?: "yes" | "no";
+  burning_man_years?: string;
+  shelter_type?: "joining_rv" | "bringing_rv" | "shiftpod_tent" | "car" | "truck" | "van" | "unsure";
+  shelter_mates?: string;
+  ticket_status?: "looking" | "have_ticket" | "unsure";
+  build_available?: boolean;
+  build_skills?: string;
+  strike_available?: boolean;
+  strike_help?: string;
+  about_yourself?: string;
+  agrees_to_principles?: true;
+  /** commitmentId → value (integer or boolean per the commitment dataType), collected at apply (PLA-682). */
+  commitments?: Record<string, number | boolean>;
+  custom_fields?: Record<string, unknown>;
 }
 interface ApplicationCreateResponse {
-    applicationId: string;
-    status: string;
+  applicationId: string;
+  status: string;
 }
 interface ApplicationTransitionPayload {
-    to: ApplicationStatus;
-    rejectionReason?: string;
-    /** When true, sends a templated email to the applicant (PLA-710). */
-    notify?: boolean;
+  to: ApplicationStatus;
+  rejectionReason?: string;
+  /** When true, sends a templated email to the applicant (PLA-710). */
+  notify?: boolean;
 }
 interface ApplicationTransitionResponse {
-    applicationId: string;
-    status: ApplicationStatus;
+  applicationId: string;
+  status: ApplicationStatus;
 }
 interface MemberCreatePayload {
-    firstName: string;
-    lastName: string;
-    email: string;
-    phone?: string | null;
-    role?: "member" | "admin" | "super_admin";
-    status?: string;
+  firstName: string;
+  lastName: string;
+  email: string;
+  phone?: string | null;
+  role?: "member" | "admin" | "super_admin";
+  status?: string;
 }
 interface MemberCreateResponse {
-    profileId: string;
+  profileId: string;
 }
 interface MemberUpdatePayload {
-    firstName?: string;
-    lastName?: string;
-    phone?: string | null;
+  firstName?: string;
+  lastName?: string;
+  phone?: string | null;
 }
 interface MemberUpdateResponse {
-    profileId: string;
+  profileId: string;
 }
 interface MemberDeactivateResponse {
-    profileId: string;
-    status: "inactive";
+  profileId: string;
+  status: "inactive";
 }
 interface WaiverSection {
-    id: string;
-    heading: string;
-    body: string;
-    required: boolean;
+  id: string;
+  heading: string;
+  body: string;
+  required: boolean;
 }
 interface WaiverContent {
-    title: string;
-    sections: WaiverSection[];
-    effectiveDate?: string;
-    orgFields?: {
-        campName?: string;
-        eventYear?: number;
-    };
+  title: string;
+  sections: WaiverSection[];
+  effectiveDate?: string;
+  orgFields?: {
+    campName?: string;
+    eventYear?: number;
+  };
 }
 interface Waiver {
-    id: string;
-    version: number;
-    name: string;
-    year: number;
-    content: WaiverContent;
+  id: string;
+  version: number;
+  name: string;
+  year: number;
+  content: WaiverContent;
 }
 interface WaiverStatus {
-    waiverId: string;
-    version: number;
-    signed: boolean;
-    signedAt: string | null;
-    signatureId: string | null;
+  waiverId: string;
+  version: number;
+  signed: boolean;
+  signedAt: string | null;
+  signatureId: string | null;
 }
 interface WaiverSignPayload {
-    waiverId: string;
-    applicationId: string;
-    signerName: string;
-    /** base64 PNG data URL — required (drawn-canvas signature). */
-    signatureImageData: string;
+  waiverId: string;
+  applicationId: string;
+  signerName: string;
+  /** base64 PNG data URL — required (drawn-canvas signature). */
+  signatureImageData: string;
 }
 interface WaiverSignResponse {
-    signatureId: string;
+  signatureId: string;
 }
 interface ApplicationNote {
-    id: string;
-    authorId: string;
-    authorName: string | null;
-    body: string;
-    createdAt: string;
+  id: string;
+  authorId: string;
+  authorName: string | null;
+  body: string;
+  createdAt: string;
 }
 interface ApplicationScore {
-    adminId: string;
-    adminName: string | null;
-    value: number;
-    updatedAt: string;
+  adminId: string;
+  adminName: string | null;
+  value: number;
+  updatedAt: string;
 }
 interface ApplicationAnnotations {
-    notes: ApplicationNote[];
-    tags: string[];
-    scores: ApplicationScore[];
+  notes: ApplicationNote[];
+  tags: string[];
+  scores: ApplicationScore[];
 }
 interface AnnouncementSendPayload {
-    subject: string;
-    body: string;
-    filters?: {
-        role?: string;
-        status?: string;
-        shiftTypeId?: string;
-    };
-    dryRun?: boolean;
+  subject: string;
+  body: string;
+  filters?: {
+    role?: string;
+    status?: string;
+    shiftTypeId?: string;
+  };
+  dryRun?: boolean;
 }
 interface AnnouncementSendResponse {
-    sent: number;
-    recipients: {
-        name: string | null;
-        email: string;
-    }[];
+  sent: number;
+  recipients: {
+    name: string | null;
+    email: string;
+  }[];
 }
 interface DuesCreatePayload {
-    userId: string;
-    amount: number;
-    paymentMethod?: string;
-    duesCollectionId?: string;
+  userId: string;
+  amount: number;
+  paymentMethod?: string;
+  duesCollectionId?: string;
 }
 interface DuesCreateResponse {
-    paymentId: string;
+  paymentId: string;
 }
 interface DuesUpdatePayload {
-    amount?: number;
-    paymentStatus?: string;
-    paymentMethod?: string;
+  amount?: number;
+  paymentStatus?: string;
+  paymentMethod?: string;
 }
 interface DuesUpdateResponse {
-    paymentId: string;
+  paymentId: string;
 }
 interface OrgUpdatePayload {
-    name?: string;
-    logoUrl?: string | null;
-    tagline?: string | null;
-    description?: string | null;
-    settings?: Record<string, unknown> | null;
-    features?: Record<string, unknown> | null;
+  name?: string;
+  logoUrl?: string | null;
+  tagline?: string | null;
+  description?: string | null;
+  settings?: Record<string, unknown> | null;
+  features?: Record<string, unknown> | null;
 }
 interface OrgUpdateResponse {
-    orgId: string;
+  orgId: string;
 }
 interface ApplicationEvent {
-    id: string;
-    applicationId: string;
-    actorId: string | null;
-    actorName: string | null;
-    type: "status_change" | "note_added" | "tags_updated" | "score_set";
-    timestamp: string;
-    fromStatus?: string | null;
-    toStatus?: string;
-    metadata?: Record<string, unknown>;
+  id: string;
+  applicationId: string;
+  actorId: string | null;
+  actorName: string | null;
+  type: "status_change" | "note_added" | "tags_updated" | "score_set";
+  timestamp: string;
+  fromStatus?: string | null;
+  toStatus?: string;
+  metadata?: Record<string, unknown>;
 }
 interface ApplicationHistoryResponse {
-    events: ApplicationEvent[];
+  events: ApplicationEvent[];
 }
 interface AvailabilityWindow {
-    dayOfWeek: number;
-    startTime: string;
-    endTime: string;
+  dayOfWeek: number;
+  startTime: string;
+  endTime: string;
 }
 interface SetAvailabilityInput {
-    windows: AvailabilityWindow[];
+  windows: AvailabilityWindow[];
 }
 interface SetAvailabilityResponse {
-    windows: {
-        count: number;
-    };
+  windows: {
+    count: number;
+  };
 }
 interface CreateBookingTokenInput {
-    applicationId: string;
-    bookingLinkId: string;
-    expiresAt?: string;
+  applicationId: string;
+  bookingLinkId: string;
+  expiresAt?: string;
 }
 interface BookingToken {
-    id: string;
-    applicationId: string;
-    token: string;
-    url: string;
-    expiresAt: string | null;
-    createdAt: string | null;
+  id: string;
+  applicationId: string;
+  token: string;
+  url: string;
+  expiresAt: string | null;
+  createdAt: string | null;
 }
 interface BookSlotInput {
-    slotUtcStart: string;
-    name: string;
-    email: string;
-    interviewerId?: string;
-    timezone?: string;
+  slotUtcStart: string;
+  name: string;
+  email: string;
+  interviewerId?: string;
+  timezone?: string;
 }
 interface BookSlotResponse {
-    bookingId: string;
-    applicationStatus: string;
+  bookingId: string;
+  applicationStatus: string;
 }
 interface RescheduleInput {
-    slotUtcStart: string;
-    interviewerId?: string;
-    timezone?: string;
+  slotUtcStart: string;
+  interviewerId?: string;
+  timezone?: string;
 }
 interface CalendarStatus {
-    connected: boolean;
-    provider: string;
-    calendarId: string | null;
-    calendarName?: string | null;
+  connected: boolean;
+  provider: string;
+  calendarId: string | null;
+  calendarName?: string | null;
 }
 interface GoogleCalendar {
-    id: string;
-    summary: string;
-    primary?: boolean;
+  id: string;
+  summary: string;
+  primary?: boolean;
 }
 interface SelectCalendarInput {
-    calendarId: string;
-    calendarName?: string;
+  calendarId: string;
+  calendarName?: string;
 }
-
+//#endregion
+//#region src/client.d.ts
 interface ClientOptions {
-    /** Base URL for authenticated /api/v1 routes, e.g. https://api.playaos.app */
-    baseUrl: string;
-    /** Optional base URL for /api/embed/v1 routes when they live on a different host. */
-    embedBaseUrl?: string;
-    /** API key in the format pk_live_* */
-    apiKey: string;
+  /** Base URL for authenticated /api/v1 routes, e.g. https://api.playaos.app */
+  baseUrl: string;
+  /** Optional base URL for /api/embed/v1 routes when they live on a different host. */
+  embedBaseUrl?: string;
+  /** API key in the format pk_live_* */
+  apiKey: string;
+  /**
+   * Supabase session JWT of the acting member, sent as `X-PlayaOS-Member-Token`
+   * on every /api/v1 call (PLA-1195). Member-scoped endpoints (a member's own
+   * dues, payments, application, shelter, shifts signup, …) require it and
+   * return 401 without it. Org-level endpoints do not require it, but a token
+   * that is sent must still verify — an expired or invalid one is a 401 on any
+   * /api/v1 route that installs the member middleware. Prefer
+   * `client.withMember(token)` to derive a per-request client from a shared
+   * server-side one rather than constructing a client per user.
+   */
+  memberToken?: string;
 }
 declare class PlayaOSClient {
-    private readonly baseUrl;
-    private readonly embedBaseUrl;
-    private readonly apiKey;
-    constructor(opts: ClientOptions);
-    readonly members: {
-        list: (params?: {
-            role?: MemberRole;
-            status?: string;
-        }, opts?: {
-            signal?: AbortSignal;
-        }) => Promise<Member[]>;
-        get: (id: string, opts?: {
-            signal?: AbortSignal;
-        }) => Promise<Member>;
-        /** Member-self profile update (PLA-700). Requires camp key + member Bearer token. */
-        selfUpdate: (payload: {
-            bio?: string | null;
-            playaName?: string | null;
-            socialMedia?: Record<string, unknown> | null;
-            showSocialsInDirectory?: boolean;
-            phone?: string | null;
-            emergencyContactName?: string | null;
-            emergencyContactRelationship?: string | null;
-            emergencyContactPhone?: string | null;
-            profilePhotoPath?: string | null;
-            yearJoined?: number | null;
-        }, opts: {
-            accessToken: string;
-            signal?: AbortSignal;
-        }) => Promise<{
-            profileId: string;
-        }>;
-        /** Member-self shift signup + cancel (PLA-705). Requires camp key + member Bearer. */
-        shifts: {
-            signup: (payload: {
-                shiftId: string;
-                role?: string;
-            }, opts: {
-                accessToken: string;
-                signal?: AbortSignal;
-            }) => Promise<{
-                signupId: string;
-                waitlisted: boolean;
-            }>;
-            cancel: (signupId: string, opts: {
-                accessToken: string;
-                signal?: AbortSignal;
-            }) => Promise<{
-                canceled: boolean;
-                promotedSignupId: string | null;
-            }>;
-        };
+  private readonly baseUrl;
+  private readonly embedBaseUrl;
+  private readonly apiKey;
+  private readonly memberToken;
+  constructor(opts: ClientOptions);
+  /** Credentials for /api/v1 calls; the embed surface uses `apiKey` alone as the camp key. */
+  private get auth();
+  /**
+   * Derive a client that acts as one member (PLA-1195): same host and org key,
+   * plus the member's Supabase session JWT on every /api/v1 call. Use this in a
+   * server that holds one org key and serves many signed-in members.
+   */
+  withMember(memberToken: string): PlayaOSClient;
+  readonly members: {
+    list: (params?: {
+      role?: MemberRole;
+      status?: string;
+    } & PaginationParams, opts?: {
+      signal?: AbortSignal;
+    }) => Promise<Paginated<Member>>;
+    /**
+     * Full profile (phone, emergency contact). Requires a member token; pass
+     * `"me"` for the acting member — non-admins may fetch only themselves.
+     */
+    get: (id: string, opts?: {
+      signal?: AbortSignal;
+    }) => Promise<Member>;
+    /** Member-self profile update (PLA-700). Requires camp key + member Bearer token. */
+    selfUpdate: (payload: {
+      bio?: string | null;
+      playaName?: string | null;
+      socialMedia?: Record<string, unknown> | null;
+      showSocialsInDirectory?: boolean;
+      phone?: string | null;
+      emergencyContactName?: string | null;
+      emergencyContactRelationship?: string | null;
+      emergencyContactPhone?: string | null;
+      profilePhotoPath?: string | null;
+      yearJoined?: number | null;
+    }, opts: {
+      accessToken: string;
+      signal?: AbortSignal;
+    }) => Promise<{
+      profileId: string;
+    }>;
+    /** Member-self shift signup + cancel (PLA-705). Requires camp key + member Bearer. */
+    shifts: {
+      signup: (payload: {
+        shiftId: string;
+        role?: string;
+      }, opts: {
+        accessToken: string;
+        signal?: AbortSignal;
+      }) => Promise<{
+        signupId: string;
+        waitlisted: boolean;
+      }>;
+      cancel: (signupId: string, opts: {
+        accessToken: string;
+        signal?: AbortSignal;
+      }) => Promise<{
+        canceled: boolean;
+        promotedSignupId: string | null;
+      }>;
     };
-    readonly applications: {
-        list: (params?: {
-            status?: ApplicationStatus;
-            year?: number;
-        }, opts?: {
-            signal?: AbortSignal;
-        }) => Promise<Application[]>;
-        create: (payload: ApplicationCreatePayload, opts?: {
-            accessToken?: string;
-            signal?: AbortSignal;
-        }) => Promise<ApplicationCreateResponse>;
+  };
+  readonly applications: {
+    list: (params?: {
+      status?: ApplicationStatus;
+      year?: number;
+    } & PaginationParams, opts?: {
+      signal?: AbortSignal;
+    }) => Promise<Paginated<Application>>;
+    create: (payload: ApplicationCreatePayload, opts?: {
+      accessToken?: string;
+      signal?: AbortSignal;
+    }) => Promise<ApplicationCreateResponse>;
+  };
+  readonly waivers: {
+    /** Get the active waiver for an org for the current year. */
+    active: (orgId: string, opts?: {
+      signal?: AbortSignal;
+    }) => Promise<Waiver>;
+    /** Sign a waiver. Requires X-Camp-Key; optional accessToken for Bearer path. */
+    sign: (payload: WaiverSignPayload, opts?: {
+      accessToken?: string;
+      signal?: AbortSignal;
+    }) => Promise<WaiverSignResponse>;
+    /** Has this applicant/member signed the active waiver? Anchor: applicationId query or Bearer accessToken. */
+    status: (orgId: string, opts?: {
+      applicationId?: string;
+      accessToken?: string;
+      signal?: AbortSignal;
+    }) => Promise<WaiverStatus>;
+    /** Get a short-lived download URL for a completed signature's PDF. Anchor: applicationId query or Bearer. */
+    signedPdf: (orgId: string, signatureId: string, opts?: {
+      applicationId?: string;
+      accessToken?: string;
+      signal?: AbortSignal;
+    }) => Promise<{
+      url: string;
+    }>;
+  };
+  readonly dues: {
+    list: (params?: {
+      userId?: string;
+      year?: number;
+      paymentStatus?: "unpaid" | "partial" | "paid";
+    } & PaginationParams, opts?: {
+      signal?: AbortSignal;
+    }) => Promise<Paginated<DuesStatus>>;
+  };
+  readonly shifts: {
+    list: (params?: {
+      year?: number;
+      fromDate?: string;
+      toDate?: string;
+      publishedOnly?: boolean;
+      openOnly?: boolean;
+    } & PaginationParams, opts?: {
+      signal?: AbortSignal;
+    }) => Promise<Paginated<Shift>>;
+  };
+  readonly org: {
+    get: (opts?: {
+      signal?: AbortSignal;
+    }) => Promise<OrgConfig>;
+  };
+  readonly commitments: {
+    list: (opts?: {
+      signal?: AbortSignal;
+    }) => Promise<CommitmentsListResponse>;
+  };
+  readonly payments: {
+    list: (params?: {
+      type?: "dues" | "payment";
+      memberId?: string;
+      from?: string;
+      to?: string;
+      limit?: number;
+      offset?: number;
+    }, opts?: {
+      signal?: AbortSignal;
+    }) => Promise<PaymentLedgerRow[]>;
+    /** Requires a member token. `memberId` may be omitted by a non-admin (defaults to themselves); admins must pass it. */
+    page: (memberId?: string, duesCollectionId?: string, opts?: {
+      signal?: AbortSignal;
+    }) => Promise<PaymentPageResponse>;
+  };
+  readonly accounts: {
+    list: (params?: {
+      limit?: number;
+      offset?: number;
+    }, opts?: {
+      signal?: AbortSignal;
+    }) => Promise<Account[]>;
+  };
+  readonly contacts: {
+    list: (params?: {
+      role?: MemberRole;
+      status?: string;
+      search?: string;
+      sort?: "name" | "email";
+      limit?: number;
+      offset?: number;
+    }, opts?: {
+      signal?: AbortSignal;
+    }) => Promise<Contact[]>;
+  };
+  readonly notifications: {
+    list: (params?: {
+      category?: string;
+      status?: string;
+      recipientId?: string;
+      limit?: number;
+    }, opts?: {
+      signal?: AbortSignal;
+    }) => Promise<NotificationLog[]>;
+  };
+  readonly documents: {
+    list: (params?: {
+      type?: string;
+      year?: number;
+    }, opts?: {
+      signal?: AbortSignal;
+    }) => Promise<CampDocument[]>;
+    get: (id: string, opts?: {
+      signal?: AbortSignal;
+    }) => Promise<CampDocument>;
+  };
+  readonly shelters: {
+    list: (params?: {
+      ownerId?: string;
+      shelterType?: string;
+      year?: number;
+    }, opts?: {
+      signal?: AbortSignal;
+    }) => Promise<Shelter[]>;
+    get: (id: string, opts?: {
+      signal?: AbortSignal;
+    }) => Promise<Shelter>;
+  };
+  readonly bikes: {
+    list: (params?: {
+      status?: string;
+    }, opts?: {
+      signal?: AbortSignal;
+    }) => Promise<Bike[]>;
+    get: (id: string, opts?: {
+      signal?: AbortSignal;
+    }) => Promise<Bike>;
+  };
+  readonly tags: {
+    list: (opts?: {
+      signal?: AbortSignal;
+    }) => Promise<MemberTag[]>;
+  };
+  readonly groups: {
+    list: (opts?: {
+      signal?: AbortSignal;
+    }) => Promise<MemberGroup[]>;
+    get: (id: string, opts?: {
+      signal?: AbortSignal;
+    }) => Promise<MemberGroupRosterRow[]>;
+    create: (payload: {
+      name: string;
+      leaderProfileId: string;
+    }, opts?: {
+      signal?: AbortSignal;
+    }) => Promise<{
+      id: string;
+    }>;
+  };
+  readonly admin: {
+    applications: {
+      /** Get application audit timeline (PLA-712). Requires admin Bearer token. */
+      history: (id: string, opts: {
+        accessToken: string;
+        signal?: AbortSignal;
+      }) => Promise<ApplicationHistoryResponse>;
+      transition: (id: string, payload: ApplicationTransitionPayload, opts: {
+        accessToken: string;
+        signal?: AbortSignal;
+      }) => Promise<ApplicationTransitionResponse>;
+      getAnnotations: (id: string, opts: {
+        accessToken: string;
+        signal?: AbortSignal;
+      }) => Promise<ApplicationAnnotations>;
+      addNote: (id: string, payload: {
+        body: string;
+      }, opts: {
+        accessToken: string;
+        signal?: AbortSignal;
+      }) => Promise<ApplicationNote>;
+      setTags: (id: string, payload: {
+        tags: string[];
+      }, opts: {
+        accessToken: string;
+        signal?: AbortSignal;
+      }) => Promise<string[]>;
+      setScore: (id: string, payload: {
+        value: number;
+      }, opts: {
+        accessToken: string;
+        signal?: AbortSignal;
+      }) => Promise<ApplicationScore>;
     };
-    readonly waivers: {
-        /** Get the active waiver for an org for the current year. */
-        active: (orgId: string, opts?: {
-            signal?: AbortSignal;
-        }) => Promise<Waiver>;
-        /** Sign a waiver. Requires X-Camp-Key; optional accessToken for Bearer path. */
-        sign: (payload: WaiverSignPayload, opts?: {
-            accessToken?: string;
+    givebutter: {
+      campaigns: {
+        list: (opts: {
+          accessToken: string;
+          signal?: AbortSignal;
+        }) => Promise<unknown[]>;
+        discountCodes: {
+          list: (campaignId: number, opts: {
+            accessToken: string;
             signal?: AbortSignal;
-        }) => Promise<WaiverSignResponse>;
-        /** Has this applicant/member signed the active waiver? Anchor: applicationId query or Bearer accessToken. */
-        status: (orgId: string, opts?: {
-            applicationId?: string;
-            accessToken?: string;
+          }) => Promise<unknown[]>;
+          create: (campaignId: number, payload: {
+            code: string;
+            value: number;
+            type: "percent" | "fixed";
+            expirationDate?: string;
+          }, opts: {
+            accessToken: string;
             signal?: AbortSignal;
-        }) => Promise<WaiverStatus>;
-        /** Get a short-lived download URL for a completed signature's PDF. Anchor: applicationId query or Bearer. */
-        signedPdf: (orgId: string, signatureId: string, opts?: {
-            applicationId?: string;
-            accessToken?: string;
+          }) => Promise<unknown>;
+        };
+        tickets: {
+          create: (campaignId: number, payload: {
+            name: string;
+            price: number;
+            totalQuantity?: number;
+          }, opts: {
+            accessToken: string;
             signal?: AbortSignal;
-        }) => Promise<{
-            url: string;
-        }>;
+          }) => Promise<unknown>;
+        };
+      };
     };
-    readonly dues: {
-        list: (params?: {
-            userId?: string;
-            year?: number;
-        }, opts?: {
-            signal?: AbortSignal;
-        }) => Promise<DuesStatus[]>;
+    members: {
+      create: (payload: MemberCreatePayload, opts: {
+        accessToken: string;
+        signal?: AbortSignal;
+      }) => Promise<MemberCreateResponse>;
+      update: (id: string, patch: MemberUpdatePayload, opts: {
+        accessToken: string;
+        signal?: AbortSignal;
+      }) => Promise<MemberUpdateResponse>;
+      deactivate: (id: string, opts: {
+        accessToken: string;
+        signal?: AbortSignal;
+      }) => Promise<MemberDeactivateResponse>;
     };
-    readonly shifts: {
-        list: (params?: {
-            year?: number;
-            fromDate?: string;
-            toDate?: string;
-            publishedOnly?: boolean;
-        }, opts?: {
-            signal?: AbortSignal;
-        }) => Promise<Shift[]>;
+    announcements: {
+      /** Send an email blast to camp members (PLA-706). Requires admin Bearer token. */
+      send: (payload: AnnouncementSendPayload, opts: {
+        accessToken: string;
+        signal?: AbortSignal;
+      }) => Promise<AnnouncementSendResponse>;
     };
-    readonly org: {
-        get: (opts?: {
-            signal?: AbortSignal;
-        }) => Promise<OrgConfig>;
+    dues: {
+      /** Create a manual dues/payment record (PLA-708). Requires admin Bearer token. */
+      create: (payload: DuesCreatePayload, opts: {
+        accessToken: string;
+        signal?: AbortSignal;
+      }) => Promise<DuesCreateResponse>;
+      /** Update a dues/payment record (PLA-708). Requires admin Bearer token. */
+      update: (id: string, payload: DuesUpdatePayload, opts: {
+        accessToken: string;
+        signal?: AbortSignal;
+      }) => Promise<DuesUpdateResponse>;
     };
-    readonly payments: {
-        page: (memberId: string, duesCollectionId?: string, opts?: {
-            signal?: AbortSignal;
-        }) => Promise<PaymentPageResponse>;
+    org: {
+      /** Update camp configuration settings (PLA-709). Requires admin Bearer token. */
+      update: (payload: OrgUpdatePayload, opts: {
+        accessToken: string;
+        signal?: AbortSignal;
+      }) => Promise<OrgUpdateResponse>;
     };
-    readonly admin: {
-        applications: {
-            /** Get application audit timeline (PLA-712). Requires admin Bearer token. */
-            history: (id: string, opts: {
-                accessToken: string;
-                signal?: AbortSignal;
-            }) => Promise<ApplicationHistoryResponse>;
-            transition: (id: string, payload: ApplicationTransitionPayload, opts: {
-                accessToken: string;
-                signal?: AbortSignal;
-            }) => Promise<ApplicationTransitionResponse>;
-            getAnnotations: (id: string, opts: {
-                accessToken: string;
-                signal?: AbortSignal;
-            }) => Promise<ApplicationAnnotations>;
-            addNote: (id: string, payload: {
-                body: string;
-            }, opts: {
-                accessToken: string;
-                signal?: AbortSignal;
-            }) => Promise<ApplicationNote>;
-            setTags: (id: string, payload: {
-                tags: string[];
-            }, opts: {
-                accessToken: string;
-                signal?: AbortSignal;
-            }) => Promise<string[]>;
-            setScore: (id: string, payload: {
-                value: number;
-            }, opts: {
-                accessToken: string;
-                signal?: AbortSignal;
-            }) => Promise<ApplicationScore>;
-        };
-        givebutter: {
-            campaigns: {
-                list: (opts: {
-                    accessToken: string;
-                    signal?: AbortSignal;
-                }) => Promise<unknown[]>;
-                discountCodes: {
-                    list: (campaignId: number, opts: {
-                        accessToken: string;
-                        signal?: AbortSignal;
-                    }) => Promise<unknown[]>;
-                    create: (campaignId: number, payload: {
-                        code: string;
-                        type: string;
-                        amount: number;
-                        active?: boolean;
-                    }, opts: {
-                        accessToken: string;
-                        signal?: AbortSignal;
-                    }) => Promise<unknown>;
-                };
-                tickets: {
-                    create: (campaignId: number, payload: {
-                        name: string;
-                        price: number;
-                        totalQuantity?: number;
-                    }, opts: {
-                        accessToken: string;
-                        signal?: AbortSignal;
-                    }) => Promise<unknown>;
-                };
-            };
-        };
-        members: {
-            create: (payload: MemberCreatePayload, opts: {
-                accessToken: string;
-                signal?: AbortSignal;
-            }) => Promise<MemberCreateResponse>;
-            update: (id: string, patch: MemberUpdatePayload, opts: {
-                accessToken: string;
-                signal?: AbortSignal;
-            }) => Promise<MemberUpdateResponse>;
-            deactivate: (id: string, opts: {
-                accessToken: string;
-                signal?: AbortSignal;
-            }) => Promise<MemberDeactivateResponse>;
-        };
-        announcements: {
-            /** Send an email blast to camp members (PLA-706). Requires admin Bearer token. */
-            send: (payload: AnnouncementSendPayload, opts: {
-                accessToken: string;
-                signal?: AbortSignal;
-            }) => Promise<AnnouncementSendResponse>;
-        };
-        dues: {
-            /** Create a manual dues/payment record (PLA-708). Requires admin Bearer token. */
-            create: (payload: DuesCreatePayload, opts: {
-                accessToken: string;
-                signal?: AbortSignal;
-            }) => Promise<DuesCreateResponse>;
-            /** Update a dues/payment record (PLA-708). Requires admin Bearer token. */
-            update: (id: string, payload: DuesUpdatePayload, opts: {
-                accessToken: string;
-                signal?: AbortSignal;
-            }) => Promise<DuesUpdateResponse>;
-        };
-        org: {
-            /** Update camp configuration settings (PLA-709). Requires admin Bearer token. */
-            update: (payload: OrgUpdatePayload, opts: {
-                accessToken: string;
-                signal?: AbortSignal;
-            }) => Promise<OrgUpdateResponse>;
-        };
-        scheduling: {
-            availability: {
-                /** Get interview availability for an interviewer (PLA-713). Requires admin Bearer token. */
-                get: (interviewerId: string, opts: {
-                    accessToken: string;
-                    signal?: AbortSignal;
-                }) => Promise<SetAvailabilityResponse>;
-                /** Set interview availability for an interviewer (PLA-713). Requires admin Bearer token. */
-                set: (interviewerId: string, payload: SetAvailabilityInput, opts: {
-                    accessToken: string;
-                    signal?: AbortSignal;
-                }) => Promise<SetAvailabilityResponse>;
-            };
-            calendar: {
-                /** Get Google Calendar connection status for an interviewer (PLA-726). Requires admin Bearer. */
-                status: (interviewerId: string, opts: {
-                    accessToken: string;
-                    signal?: AbortSignal;
-                }) => Promise<CalendarStatus>;
-                /** List available Google Calendars (PLA-726). Requires admin Bearer. */
-                listCalendars: (interviewerId: string, opts: {
-                    accessToken: string;
-                    signal?: AbortSignal;
-                }) => Promise<{
-                    calendars: GoogleCalendar[];
-                }>;
-                /** Select which Google Calendar to use (PLA-726). Requires admin Bearer. */
-                select: (interviewerId: string, payload: SelectCalendarInput, opts: {
-                    accessToken: string;
-                    signal?: AbortSignal;
-                }) => Promise<{
-                    calendarId: string;
-                }>;
-                /** Disconnect Google Calendar from interviewer (PLA-726). Requires admin Bearer. */
-                disconnect: (interviewerId: string, opts: {
-                    accessToken: string;
-                    signal?: AbortSignal;
-                }) => Promise<{
-                    disconnected: boolean;
-                }>;
-            };
-            bookingTokens: {
-                /** Create a booking token for an application's interview link (PLA-714). Requires admin Bearer token. */
-                create: (payload: CreateBookingTokenInput, opts: {
-                    accessToken: string;
-                    signal?: AbortSignal;
-                }) => Promise<BookingToken>;
-                /** Get an existing booking token for an application (PLA-714). Requires admin Bearer token. */
-                get: (applicationId: string, opts: {
-                    accessToken: string;
-                    signal?: AbortSignal;
-                }) => Promise<BookingToken>;
-            };
-        };
-    };
-    readonly schedule: {
-        /** List available interview slots for a booking token (PLA-714). Public. */
-        getSlots: (token: string, opts?: {
-            signal?: AbortSignal;
+    scheduling: {
+      availability: {
+        /** Get interview availability for an interviewer (PLA-713). Requires admin Bearer token. */
+        get: (interviewerId: string, opts: {
+          accessToken: string;
+          signal?: AbortSignal;
+        }) => Promise<SetAvailabilityResponse>;
+        /** Set interview availability for an interviewer (PLA-713). Requires admin Bearer token. */
+        set: (interviewerId: string, payload: SetAvailabilityInput, opts: {
+          accessToken: string;
+          signal?: AbortSignal;
+        }) => Promise<SetAvailabilityResponse>;
+      };
+      calendar: {
+        /** Get Google Calendar connection status for an interviewer (PLA-726). Requires admin Bearer. */
+        status: (interviewerId: string, opts: {
+          accessToken: string;
+          signal?: AbortSignal;
+        }) => Promise<CalendarStatus>;
+        /** List available Google Calendars (PLA-726). Requires admin Bearer. */
+        listCalendars: (interviewerId: string, opts: {
+          accessToken: string;
+          signal?: AbortSignal;
         }) => Promise<{
-            slots: {
-                startsAt: string;
-                endsAt: string;
-            }[];
+          calendars: GoogleCalendar[];
         }>;
-        /** Book an interview slot (PLA-714). Public. */
-        book: (token: string, payload: BookSlotInput, opts?: {
-            signal?: AbortSignal;
-        }) => Promise<BookSlotResponse>;
-        /** Cancel an interview booking (PLA-714). Public. */
-        cancel: (token: string, opts?: {
-            signal?: AbortSignal;
-        }) => Promise<BookSlotResponse>;
-        /** Reschedule an interview booking (PLA-714). Public. */
-        reschedule: (token: string, payload: RescheduleInput, opts?: {
-            signal?: AbortSignal;
-        }) => Promise<BookSlotResponse>;
+        /** Select which Google Calendar to use (PLA-726). Requires admin Bearer. */
+        select: (interviewerId: string, payload: SelectCalendarInput, opts: {
+          accessToken: string;
+          signal?: AbortSignal;
+        }) => Promise<{
+          calendarId: string;
+        }>;
+        /** Disconnect Google Calendar from interviewer (PLA-726). Requires admin Bearer. */
+        disconnect: (interviewerId: string, opts: {
+          accessToken: string;
+          signal?: AbortSignal;
+        }) => Promise<{
+          disconnected: boolean;
+        }>;
+      };
+      bookingTokens: {
+        /** Create a booking token for an application's interview link (PLA-714). Requires admin Bearer token. */
+        create: (payload: CreateBookingTokenInput, opts: {
+          accessToken: string;
+          signal?: AbortSignal;
+        }) => Promise<BookingToken>;
+        /** Get an existing booking token for an application (PLA-714). Requires admin Bearer token. */
+        get: (applicationId: string, opts: {
+          accessToken: string;
+          signal?: AbortSignal;
+        }) => Promise<BookingToken>;
+      };
     };
+  };
+  readonly schedule: {
+    /** List available interview slots for a booking token (PLA-714). Public. */
+    getSlots: (token: string, opts?: {
+      signal?: AbortSignal;
+    }) => Promise<{
+      slots: {
+        startsAt: string;
+        endsAt: string;
+      }[];
+    }>;
+    /** Book an interview slot (PLA-714). Public. */
+    book: (token: string, payload: BookSlotInput, opts?: {
+      signal?: AbortSignal;
+    }) => Promise<BookSlotResponse>;
+    /** Cancel an interview booking (PLA-714). Public. */
+    cancel: (token: string, opts?: {
+      signal?: AbortSignal;
+    }) => Promise<BookSlotResponse>;
+    /** Reschedule an interview booking (PLA-714). Public. */
+    reschedule: (token: string, payload: RescheduleInput, opts?: {
+      signal?: AbortSignal;
+    }) => Promise<BookSlotResponse>;
+  };
 }
 /** Convenience factory — equivalent to `new PlayaOSClient(opts)`. */
 declare function createClient(opts: ClientOptions): PlayaOSClient;
-
+//#endregion
+//#region src/exchange.d.ts
 /**
  * Server-side OAuth-code → ID-token exchange.
  *
@@ -654,20 +913,99 @@ declare function createClient(opts: ClientOptions): PlayaOSClient;
  * in `@playaos/react`.
  */
 interface ExchangeParams {
-    authBaseUrl?: string;
-    code: string;
-    codeVerifier: string;
-    clientId: string;
-    /** Confidential clients only. Omit for public/PKCE-only clients. */
-    clientSecret?: string;
-    redirectUri: string;
+  authBaseUrl?: string;
+  code: string;
+  codeVerifier: string;
+  clientId: string;
+  /** Confidential clients only. Omit for public/PKCE-only clients. */
+  clientSecret?: string;
+  redirectUri: string;
 }
 interface ExchangeResult {
-    idToken: string;
-    expiresAt: string;
-    /** Confidential clients only. Undefined for public clients. */
-    refreshToken?: string;
+  idToken: string;
+  expiresAt: string;
+  /** Confidential clients only. Undefined for public clients. */
+  refreshToken?: string;
 }
 declare function exchangeCode(params: ExchangeParams): Promise<ExchangeResult>;
-
-export { ApiClientError, type Application, type ApplicationAnnotations, type ApplicationCreatePayload, type ApplicationCreateResponse, type ApplicationNote, type ApplicationScore, type ApplicationStatus, type ApplicationTransitionPayload, type ApplicationTransitionResponse, type DuesStatus, type ExchangeParams, type ExchangeResult, type Member, type MemberCreatePayload, type MemberCreateResponse, type MemberDeactivateResponse, type MemberRole, type MemberUpdatePayload, type MemberUpdateResponse, type OrgConfig, type PaymentPageResponse, PlayaOSClient, type Shift, type ShiftSignup, type ShiftType, type Waiver, type WaiverContent, type WaiverSection, type WaiverSignPayload, type WaiverSignResponse, type WaiverStatus, createClient, exchangeCode };
+//#endregion
+//#region src/public-marketplace.d.ts
+/** A listing holds at most this many images (matches the DB's position 1–6 check). */
+declare const MAX_IMAGE_POSITION = 6;
+/**
+ * Typed client for the anonymous gift-layer marketplace API (`/api/public/marketplace/*`).
+ *
+ * Unlike `PlayaOSClient` (api-key auth for `/api/v1`), this surface authenticates
+ * writes with a Supabase **Bearer JWT** belonging to a public `global_accounts`
+ * user. The token is supplied by an injected `getToken` provider so the same
+ * client works from any consumer (the marketing UI supplies the browser
+ * Supabase session token; a future surface could supply its own). Keeps the
+ * public API as the single write contract — the UI is just another consumer.
+ */
+interface PublicMarketplaceClientOptions {
+  /** API base, e.g. `https://api.playaos.app`. */
+  baseUrl: string;
+  /** Supplies the Supabase access token (Bearer) for authenticated calls; null/undefined when signed out. */
+  getToken: () => Promise<string | null | undefined> | string | null | undefined;
+}
+interface NewListingInput {
+  category: string;
+  subcategory?: string;
+  title: string;
+  body: string;
+  price?: number;
+  location?: string;
+  replyEmail: string;
+}
+interface ImageUploadTarget {
+  /** Supabase signed upload URL — PUT the file bytes here. */
+  uploadUrl: string;
+  /** Storage path to pass back to `attachImage` once the PUT succeeds. */
+  storagePath: string;
+}
+/** Moderation flag reasons accepted by the API (mirrors the DB enum). */
+type MarketplaceFlagReason = "spam" | "prohibited" | "other";
+interface ListingImage {
+  /** Short-lived signed download URL for the image. */
+  url: string;
+  /** 1-based display order. */
+  position: number;
+}
+interface PublicMarketplaceClient {
+  /**
+   * Create a listing as the signed-in account. Throws a plain `Error` when there
+   * is no token (signed out), or `ApiClientError` on a non-2xx response.
+   */
+  createListing(input: NewListingInput, signal?: AbortSignal): Promise<{
+    id: string;
+  }>;
+  /** Request a signed upload URL for an image on a listing the caller owns. */
+  getImageUploadUrl(listingId: string, signal?: AbortSignal): Promise<ImageUploadTarget>;
+  /** Attach an already-uploaded image (by storage path) to a listing at a 1–6 position. */
+  attachImage(listingId: string, input: {
+    storagePath: string;
+    position: number;
+  }, signal?: AbortSignal): Promise<{
+    id: string;
+  }>;
+  /** Anonymous: list an active listing's images as short-lived signed URLs (for public display). */
+  listListingImages(listingId: string, signal?: AbortSignal): Promise<{
+    images: ListingImage[];
+  }>;
+  /** Anonymous: batch-fetch first-image signed thumbnail URLs (listingId -> url) for browse cards. */
+  listThumbnails(listingIds: string[], signal?: AbortSignal): Promise<{
+    thumbnails: Record<string, string>;
+  }>;
+  /** Flag a listing for moderation (signed-in). Idempotent per (listing, user). */
+  flagListing(listingId: string, reason: MarketplaceFlagReason, signal?: AbortSignal): Promise<{
+    ok: boolean;
+  }>;
+  /** Contact a listing's owner (signed-in); records the reply + queues a notification email. */
+  replyToListing(listingId: string, message: string | undefined, signal?: AbortSignal): Promise<{
+    ok: boolean;
+  }>;
+}
+declare function createPublicMarketplaceClient(opts: PublicMarketplaceClientOptions): PublicMarketplaceClient;
+//#endregion
+export { ApiClientError, type Application, type ApplicationAnnotations, type ApplicationCreatePayload, type ApplicationCreateResponse, type ApplicationNote, type ApplicationScore, type ApplicationStatus, type ApplicationTransitionPayload, type ApplicationTransitionResponse, type Commitment, type CommitmentDataType, type CommitmentValue, type CommitmentsListResponse, type DuesStatus, type ExchangeParams, type ExchangeResult, type ImageUploadTarget, type ListingImage, MAX_IMAGE_POSITION, type MarketplaceFlagReason, type Member, type MemberCreatePayload, type MemberCreateResponse, type MemberDeactivateResponse, type MemberRole, type MemberUpdatePayload, type MemberUpdateResponse, type NewListingInput, type OrgConfig, type PaymentPageResponse, PlayaOSClient, type PublicMarketplaceClient, type PublicMarketplaceClientOptions, type Shift, type ShiftSignup, type ShiftType, type Waiver, type WaiverContent, type WaiverSection, type WaiverSignPayload, type WaiverSignResponse, type WaiverStatus, createClient, createPublicMarketplaceClient, exchangeCode };
+//# sourceMappingURL=index.d.ts.map