@tummycrypt/acuity-middleware 0.1.0

package/src/middleware/steps/read-slots.ts

@@ -0,0 +1,405 @@
+/**
+ * Wizard Step: Read Time Slots from Acuity Calendar
+ *
+ * Navigates to the service calendar via click-through,
+ * advances to the target date, clicks the day tile,
+ * and reads all available time slot buttons.
+ */
+
+import { Effect } from 'effect';
+import type { Page, ElementHandle } from 'playwright-core';
+import { BrowserService } from '../browser-service.js';
+import { WizardStepError } from '../errors.js';
+import { resolveSelector, Selectors } from '../selectors.js';
+
+// =============================================================================
+// TYPES
+// =============================================================================
+
+export interface ReadSlotsParams {
+	/** Service name to match against the service list */
+	readonly serviceName: string;
+	/** Appointment type ID (used to verify correct service selected) */
+	readonly appointmentTypeId?: string;
+	/** Target date (YYYY-MM-DD) */
+	readonly date: string;
+}
+
+export interface SlotResult {
+	readonly datetime: string; // ISO 8601
+	readonly available: boolean;
+}
+
+// =============================================================================
+// IMPLEMENTATION
+// =============================================================================
+
+/**
+ * Read time slots for a specific date by navigating the Acuity wizard.
+ *
+ * Flow:
+ * 1. Load service page → find service → click "Book"
+ * 2. Navigate calendar to target month
+ * 3. Click target day tile
+ * 4. Read all time slot buttons
+ */
+export const readTimeSlots = (params: ReadSlotsParams) =>
+	Effect.gen(function* () {
+		const { acquirePage, config } = yield* BrowserService;
+		const page: Page = yield* acquirePage;
+
+		// Step 1: Load service page
+		yield* Effect.tryPromise({
+			try: () => page.goto(config.baseUrl, { waitUntil: 'networkidle', timeout: config.timeout }),
+			catch: (e) =>
+				new WizardStepError({
+					step: 'read-slots',
+					message: `Failed to load service page: ${e instanceof Error ? e.message : String(e)}`,
+					cause: e,
+				}),
+		});
+
+		// Step 2: Click the target service's "Book" button
+		yield* clickServiceBook(page, params.serviceName, params.appointmentTypeId);
+
+		// Step 3: Navigate to the target month
+		const targetDate = new Date(params.date + 'T12:00:00');
+		const targetMonth = `${targetDate.getFullYear()}-${String(targetDate.getMonth() + 1).padStart(2, '0')}`;
+		yield* navigateToTargetMonth(page, targetMonth);
+
+		// Step 4: Click the target day
+		yield* clickDay(page, targetDate.getDate());
+
+		// Step 5: Read time slots
+		const slots = yield* readSlotButtons(page, params.date);
+
+		return slots;
+	});
+
+// =============================================================================
+// HELPERS
+// =============================================================================
+
+const clickServiceBook = (
+	page: Page,
+	serviceName: string,
+	expectedId?: string,
+) =>
+	Effect.gen(function* () {
+		yield* resolveSelector(page, Selectors.serviceList, 10000).pipe(
+			Effect.catchTag('SelectorError', () =>
+				Effect.fail(
+					new WizardStepError({
+						step: 'read-slots',
+						message: 'Service list did not load',
+					}),
+				),
+			),
+		);
+
+		const serviceItem: ElementHandle | null = yield* Effect.tryPromise({
+			try: async () => {
+				const items = await page.$$(Selectors.serviceList[0]);
+				for (const item of items) {
+					const nameEl = await item.$(Selectors.serviceName[0]);
+					const name = await nameEl?.textContent();
+					if (name && name.trim().toLowerCase().includes(serviceName.toLowerCase())) {
+						return item;
+					}
+				}
+				return null;
+			},
+			catch: (e) =>
+				new WizardStepError({
+					step: 'read-slots',
+					message: `Error searching services: ${e instanceof Error ? e.message : String(e)}`,
+					cause: e,
+				}),
+		});
+
+		if (!serviceItem) {
+			return yield* Effect.fail(
+				new WizardStepError({
+					step: 'read-slots',
+					message: `Service "${serviceName}" not found`,
+				}),
+			);
+		}
+
+		const bookBtn = yield* Effect.tryPromise({
+			try: () => serviceItem.$(Selectors.serviceBookButton[0]),
+			catch: (e) =>
+				new WizardStepError({
+					step: 'read-slots',
+					message: `Book button error: ${e instanceof Error ? e.message : String(e)}`,
+					cause: e,
+				}),
+		});
+
+		if (!bookBtn) {
+			return yield* Effect.fail(
+				new WizardStepError({
+					step: 'read-slots',
+					message: `"Book" button not found for "${serviceName}"`,
+				}),
+			);
+		}
+
+		yield* Effect.tryPromise({
+			try: async () => {
+				await bookBtn.click();
+				await page.waitForURL(/\/appointment\/\d+\/calendar\/\d+/, { timeout: 10000 });
+			},
+			catch: (e) =>
+				new WizardStepError({
+					step: 'read-slots',
+					message: `Failed to navigate to calendar: ${e instanceof Error ? e.message : String(e)}`,
+					cause: e,
+				}),
+		});
+
+		if (expectedId) {
+			const url = page.url();
+			const match = url.match(/\/appointment\/(\d+)/);
+			if (match && match[1] !== expectedId) {
+				return yield* Effect.fail(
+					new WizardStepError({
+						step: 'read-slots',
+						message: `Expected appointment type ${expectedId} but got ${match[1]}`,
+					}),
+				);
+			}
+		}
+	});
+
+const MONTH_NAMES = [
+	'january', 'february', 'march', 'april', 'may', 'june',
+	'july', 'august', 'september', 'october', 'november', 'december',
+];
+
+const navigateToTargetMonth = (page: Page, targetMonth: string): Effect.Effect<void, WizardStepError> =>
+	Effect.gen(function* () {
+		yield* resolveSelector(page, Selectors.calendar, 10000).pipe(
+			Effect.catchTag('SelectorError', () =>
+				Effect.fail(
+					new WizardStepError({
+						step: 'read-slots',
+						message: 'Calendar did not load',
+					}),
+				),
+			),
+		);
+
+		const [yearStr, monthStr] = targetMonth.split('-');
+		const targetYear = parseInt(yearStr, 10);
+		const targetMonthIdx = parseInt(monthStr, 10) - 1;
+
+		for (let i = 0; i < 12; i++) {
+			const current = yield* getCalendarMonth(page);
+			if (!current) {
+				return yield* Effect.fail(
+					new WizardStepError({
+						step: 'read-slots',
+						message: 'Could not determine calendar month',
+					}),
+				);
+			}
+
+			if (current.month === targetMonthIdx && current.year === targetYear) return;
+
+			const currentFirst = new Date(current.year, current.month, 1);
+			const targetFirst = new Date(targetYear, targetMonthIdx, 1);
+			const direction = targetFirst > currentFirst ? 'next' : 'prev';
+			const selectors = direction === 'prev' ? Selectors.calendarPrev : Selectors.calendarNext;
+
+			const btn = yield* resolveSelector(page, selectors, 3000).pipe(
+				Effect.catchTag('SelectorError', () =>
+					Effect.fail(
+						new WizardStepError({
+							step: 'read-slots',
+							message: `Calendar ${direction} button not found`,
+						}),
+					),
+				),
+			);
+
+			yield* Effect.tryPromise({
+				try: async () => {
+					await btn.element.click();
+					await page.waitForTimeout(500);
+				},
+				catch: (e) =>
+					new WizardStepError({
+						step: 'read-slots',
+						message: `Calendar nav failed: ${e instanceof Error ? e.message : String(e)}`,
+						cause: e,
+					}),
+			});
+		}
+	});
+
+const getCalendarMonth = (
+	page: Page,
+): Effect.Effect<{ month: number; year: number } | null, never> =>
+	Effect.gen(function* () {
+		// Wait for calendar month label to appear
+		yield* Effect.tryPromise({
+			try: () => page.waitForSelector(Selectors.calendarMonth[0], { timeout: 5000 }),
+			catch: () => null,
+		}).pipe(Effect.orElseSucceed(() => null));
+
+		// Retry up to 3 times — React may still be rendering
+		for (let retry = 0; retry < 3; retry++) {
+			const info = yield* Effect.tryPromise({
+				try: async () => {
+					for (const selector of Selectors.calendarMonth) {
+						const text = await page.$eval(selector, (el) => el.textContent?.trim() ?? null).catch(() => null);
+						if (text) {
+							const match = text.match(/([A-Za-z]+)\s*(\d{4})/);
+							if (match) {
+								const monthIndex = MONTH_NAMES.indexOf(match[1].toLowerCase());
+								if (monthIndex >= 0) {
+									return { month: monthIndex, year: parseInt(match[2], 10) };
+								}
+							}
+						}
+					}
+					// Also try innerText which resolves visibility better than textContent
+					for (const selector of Selectors.calendarMonth) {
+						const text = await page.$eval(selector, (el) => (el as HTMLElement).innerText?.trim() ?? null).catch(() => null);
+						if (text) {
+							const match = text.match(/([A-Za-z]+)\s*(\d{4})/);
+							if (match) {
+								const monthIndex = MONTH_NAMES.indexOf(match[1].toLowerCase());
+								if (monthIndex >= 0) {
+									return { month: monthIndex, year: parseInt(match[2], 10) };
+								}
+							}
+						}
+					}
+					return null;
+				},
+				catch: () => null,
+			}).pipe(Effect.orElseSucceed(() => null));
+
+			if (info) return info;
+
+			// Wait before retrying
+			yield* Effect.tryPromise({
+				try: () => page.waitForTimeout(1000),
+				catch: () => null,
+			}).pipe(Effect.orElseSucceed(() => null));
+		}
+
+		return null;
+	});
+
+/**
+ * Click the calendar tile for a specific day number.
+ */
+const clickDay = (page: Page, dayOfMonth: number): Effect.Effect<void, WizardStepError> =>
+	Effect.gen(function* () {
+		const clicked = yield* Effect.tryPromise({
+			try: async () => {
+				const tiles = await page.$$(Selectors.calendarDay[0]);
+				for (const tile of tiles) {
+					const isDisabled = await tile.evaluate((el) => (el as HTMLButtonElement).disabled);
+					if (isDisabled) continue;
+
+					const classes = (await tile.getAttribute('class')) ?? '';
+					if (classes.includes('neighboringMonth')) continue;
+
+					const text = await tile.textContent();
+					const num = parseInt(text?.trim() ?? '', 10);
+					if (num === dayOfMonth) {
+						await tile.click();
+						return true;
+					}
+				}
+				return false;
+			},
+			catch: (e) =>
+				new WizardStepError({
+					step: 'read-slots',
+					message: `Error clicking day ${dayOfMonth}: ${e instanceof Error ? e.message : String(e)}`,
+					cause: e,
+				}),
+		});
+
+		if (!clicked) {
+			return yield* Effect.fail(
+				new WizardStepError({
+					step: 'read-slots',
+					message: `Day ${dayOfMonth} not available on calendar`,
+				}),
+			);
+		}
+
+		// Wait for time slots to appear
+		yield* resolveSelector(page, Selectors.timeSlotContainer, 10000).pipe(
+			Effect.catchTag('SelectorError', () =>
+				Effect.fail(
+					new WizardStepError({
+						step: 'read-slots',
+						message: 'Time slots did not appear after clicking day',
+					}),
+				),
+			),
+		);
+	});
+
+/**
+ * Read all time slot buttons and return structured data.
+ * Slot text format: "10:00 AM1 spot left" or "2:30 PM"
+ */
+const readSlotButtons = (
+	page: Page,
+	dateStr: string,
+): Effect.Effect<SlotResult[], WizardStepError> =>
+	Effect.tryPromise({
+		try: async () => {
+			const results: SlotResult[] = [];
+			const slots = await page.$$(Selectors.timeSlot[0]);
+
+			for (const slot of slots) {
+				const text = await slot.textContent();
+				if (!text) continue;
+
+				// Extract time from slot text: "10:00 AM1 spot left" → "10:00 AM"
+				const timeMatch = text.trim().match(/^(\d{1,2}:\d{2}\s*[AP]M)/i);
+				if (!timeMatch) continue;
+
+				const timeStr = timeMatch[1].trim();
+
+				// Convert to ISO 8601 datetime
+				const datetime = buildIsoDatetime(dateStr, timeStr);
+				results.push({ datetime, available: true });
+			}
+
+			return results;
+		},
+		catch: (e) =>
+			new WizardStepError({
+				step: 'read-slots',
+				message: `Error reading slots: ${e instanceof Error ? e.message : String(e)}`,
+				cause: e,
+			}),
+	});
+
+/**
+ * Build ISO datetime from date string and time string.
+ * "2026-03-15" + "10:00 AM" → "2026-03-15T10:00:00"
+ */
+const buildIsoDatetime = (dateStr: string, timeStr: string): string => {
+	const match = timeStr.match(/(\d{1,2}):(\d{2})\s*(AM|PM)/i);
+	if (!match) return `${dateStr}T00:00:00`;
+
+	let hours = parseInt(match[1], 10);
+	const minutes = match[2];
+	const ampm = match[3].toUpperCase();
+
+	if (ampm === 'PM' && hours !== 12) hours += 12;
+	if (ampm === 'AM' && hours === 12) hours = 0;
+
+	return `${dateStr}T${String(hours).padStart(2, '0')}:${minutes}:00`;
+};

package/src/middleware/steps/submit.ts

@@ -0,0 +1,168 @@
+/**
+ * Wizard Step: Submit Booking
+ *
+ * Clicks the submit/complete button and waits for the confirmation page.
+ * Handles the race between successful navigation to confirmation
+ * and validation error display.
+ */
+
+import { Effect, Schedule } from 'effect';
+import type { Page } from 'playwright-core';
+import { BrowserService } from '../browser-service.js';
+import { WizardStepError } from '../errors.js';
+import { resolveSelector, probe, Selectors } from '../selectors.js';
+
+// =============================================================================
+// TYPES
+// =============================================================================
+
+export interface SubmitResult {
+	readonly submitted: boolean;
+	readonly confirmationPageReached: boolean;
+}
+
+// =============================================================================
+// IMPLEMENTATION
+// =============================================================================
+
+/**
+ * Submit the booking form and wait for confirmation.
+ */
+export const submitBooking = () =>
+	Effect.gen(function* () {
+		const { acquirePage } = yield* BrowserService;
+		const page: Page = yield* acquirePage;
+
+		// Find submit button
+		const submitBtn = yield* resolveSelector(page, Selectors.submitButton, 10000).pipe(
+			Effect.catchTag('SelectorError', () =>
+				Effect.fail(
+					new WizardStepError({
+						step: 'submit',
+						message: 'Submit button not found. The wizard may not have advanced to the final step.',
+					}),
+				),
+			),
+		);
+
+		// Click submit
+		yield* Effect.tryPromise({
+			try: () => submitBtn.element.click(),
+			catch: (e) =>
+				new WizardStepError({
+					step: 'submit',
+					message: `Failed to click submit: ${e instanceof Error ? e.message : String(e)}`,
+					cause: e,
+				}),
+		});
+
+		// Wait for either confirmation page or error
+		const outcome = yield* waitForOutcome(page);
+
+		if (!outcome.confirmationPageReached) {
+			return yield* Effect.fail(
+				new WizardStepError({
+					step: 'submit',
+					message: outcome.errorMessage
+						? `Booking submission failed: ${outcome.errorMessage}`
+						: 'Booking submission did not reach confirmation page',
+				}),
+			);
+		}
+
+		return {
+			submitted: true,
+			confirmationPageReached: true,
+		} satisfies SubmitResult;
+	}).pipe(
+		// Retry once on transient navigation failure
+		Effect.retry({
+			times: 1,
+			schedule: Schedule.spaced('2 seconds'),
+			while: (e) => e._tag === 'WizardStepError' && e.message.includes('did not reach'),
+		}),
+	);
+
+// =============================================================================
+// HELPERS
+// =============================================================================
+
+interface OutcomeCheck {
+	confirmationPageReached: boolean;
+	errorMessage: string | null;
+}
+
+/**
+ * Race between confirmation page appearing and error message appearing.
+ * Polls both conditions until one is met or timeout.
+ */
+const waitForOutcome = (page: Page): Effect.Effect<OutcomeCheck, WizardStepError> =>
+	Effect.gen(function* () {
+		const maxWait = 60000;
+		const pollInterval = 1000;
+		const start = Date.now();
+
+		while (Date.now() - start < maxWait) {
+			// Check for confirmation page via selectors
+			const hasConfirmation = yield* probe(page, 'confirmationPage');
+			if (hasConfirmation) {
+				return { confirmationPageReached: true, errorMessage: null };
+			}
+
+			// Check for confirmation via URL pattern (Acuity redirects after booking)
+			const url = page.url();
+			if (/\/(confirmation|confirmed|thank-you|complete)/i.test(url)) {
+				return { confirmationPageReached: true, errorMessage: null };
+			}
+
+			// Check for confirmation text anywhere on page
+			const hasConfirmText = yield* Effect.tryPromise({
+				try: () =>
+					page
+						.$eval(
+							'body',
+							(el) => {
+								const text = el.textContent?.toLowerCase() ?? '';
+								return text.includes('booking confirmed') ||
+									text.includes('appointment confirmed') ||
+									text.includes('successfully booked') ||
+									text.includes('your appointment is scheduled');
+							},
+						)
+						.catch(() => false),
+				catch: () => false,
+			}).pipe(Effect.orElseSucceed(() => false));
+
+			if (hasConfirmText) {
+				return { confirmationPageReached: true, errorMessage: null };
+			}
+
+			// Check for validation/submission errors
+			const errorText = yield* Effect.tryPromise({
+				try: () =>
+					page
+						.$eval(
+							'.error-message, .validation-error, .form-error, .alert-danger',
+							(el) => el.textContent?.trim() ?? null,
+						)
+						.catch(() => null),
+				catch: () => null,
+			}).pipe(Effect.orElseSucceed(() => null));
+
+			if (errorText) {
+				return { confirmationPageReached: false, errorMessage: errorText };
+			}
+
+			// Wait before next poll
+			yield* Effect.tryPromise({
+				try: () => page.waitForTimeout(pollInterval),
+				catch: () =>
+					new WizardStepError({ step: 'submit', message: 'Poll wait interrupted' }),
+			});
+		}
+
+		return {
+			confirmationPageReached: false,
+			errorMessage: 'Timed out waiting for confirmation page',
+		};
+	});

package/src/server.ts

@@ -0,0 +1,5 @@
+/**
+ * Entry point - re-exports the middleware HTTP server.
+ * When run directly, the server auto-starts (see middleware/server.ts).
+ */
+export { server } from './middleware/server.js';

package/tsconfig.json

@@ -0,0 +1,25 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "lib": ["ES2022", "DOM"],
+    "outDir": "dist",
+    "rootDir": "src",
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "noUnusedLocals": false,
+    "noUnusedParameters": false,
+    "noImplicitReturns": true,
+    "noFallthroughCasesInSwitch": true
+  },
+  "include": ["src/**/*.ts"],
+  "exclude": ["node_modules", "dist", "**/*.test.ts"]
+}