@playaos/api-client 0.58.0 → 0.59.0

package/README.md

@@ -159,6 +159,25 @@ try {
 }
 ```
 
+A write to an archived event is refused with `403` and code `EVENT_READ_ONLY`; reading it still
+works. Test for it with `isEventReadOnlyError` rather than the status alone, since `403 FORBIDDEN`
+(scope or role) is a different refusal:
+
+```typescript
+import { isEventReadOnlyError } from "@playaos/api-client";
+
+try {
+  await client.members.shifts.signup({ shiftId }, { accessToken });
+} catch (err) {
+  if (isEventReadOnlyError(err)) showNotice("This event is archived and can no longer be changed.");
+  else throw err;
+}
+```
+
+It also matches the embed spelling `event_read_only`, which methods that fall back to the embed
+API receive. `ApiErrorCode` holds the codes worth branching on (`EVENT_READ_ONLY`, `EVENT_REQUIRED`).
+`err.code` stays a `string`, so new server codes never break your types.
+
 ## MCP server
 
 For AI agent access, use the companion [@playaos/mcp](https://www.npmjs.com/package/@playaos/mcp) package.

package/dist/applications-schema.d.ts

@@ -51,6 +51,7 @@ export declare const step5Schema: z.ZodObject<{
 }, z.core.$strip>;
 export declare const applicationSchema: z.ZodObject<{
   submission_id: z.ZodOptional<z.ZodString>;
+  event_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

@@ -52,6 +52,8 @@ const step5Schema = z.object({
 });
 const applicationSchema = z.object({
 	submission_id: z.string().uuid().optional(),
+	/** The event applied to (ADR-132). Required only when the active camp year has several events. */
+	event_id: z.string().uuid().optional(),
 	acknowledged_expectations: z.literal(true).optional(),
 	first_name: z.string().min(1),
 	last_name: z.string(),

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  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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"}
+{"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  /** The event applied to (ADR-132). Required only when the active camp year has several events. */\n  event_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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"}