@tummycrypt/acuity-middleware 0.1.0 → 0.1.1

package/dist/adapters/acuity-scraper.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Re-export scraper from @tummycrypt/scheduling-kit.
+ *
+ * @deprecated — see scheduling-kit's acuity-scraper.ts for deprecation details.
+ * Prefer extract-business.ts (BUSINESS object) and wizard steps (readAvailableDates, readTimeSlots).
+ */
+export { AcuityScraper, createScraperAdapter, scrapeServicesOnce, scrapeAvailabilityOnce, type ScraperConfig, type ScrapedService, type ScrapedAvailability, type ScrapedTimeSlot, } from '@tummycrypt/scheduling-kit/adapters';
+//# sourceMappingURL=acuity-scraper.d.ts.map

package/dist/adapters/acuity-scraper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"acuity-scraper.d.ts","sourceRoot":"","sources":["../../src/adapters/acuity-scraper.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EACL,aAAa,EACb,oBAAoB,EACpB,kBAAkB,EAClB,sBAAsB,EACtB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,eAAe,GACrB,MAAM,qCAAqC,CAAC"}

package/dist/adapters/acuity-scraper.js

@@ -0,0 +1,8 @@
+/**
+ * Re-export scraper from @tummycrypt/scheduling-kit.
+ *
+ * @deprecated — see scheduling-kit's acuity-scraper.ts for deprecation details.
+ * Prefer extract-business.ts (BUSINESS object) and wizard steps (readAvailableDates, readTimeSlots).
+ */
+export { AcuityScraper, createScraperAdapter, scrapeServicesOnce, scrapeAvailabilityOnce, } from '@tummycrypt/scheduling-kit/adapters';
+//# sourceMappingURL=acuity-scraper.js.map

package/dist/adapters/acuity-scraper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"acuity-scraper.js","sourceRoot":"","sources":["../../src/adapters/acuity-scraper.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EACL,aAAa,EACb,oBAAoB,EACpB,kBAAkB,EAClB,sBAAsB,GAKvB,MAAM,qCAAqC,CAAC"}

package/dist/adapters/types.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Re-export adapter types from @tummycrypt/scheduling-kit.
+ *
+ * Previously this file was a full copy of scheduling-kit's adapter interface.
+ * Consolidated to prevent type drift.
+ */
+export * from '@tummycrypt/scheduling-kit/adapters';
+//# sourceMappingURL=types.d.ts.map

package/dist/adapters/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/adapters/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,cAAc,qCAAqC,CAAC"}

package/dist/adapters/types.js

@@ -0,0 +1,8 @@
+/**
+ * Re-export adapter types from @tummycrypt/scheduling-kit.
+ *
+ * Previously this file was a full copy of scheduling-kit's adapter interface.
+ * Consolidated to prevent type drift.
+ */
+export * from '@tummycrypt/scheduling-kit/adapters';
+//# sourceMappingURL=types.js.map

package/dist/adapters/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/adapters/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,cAAc,qCAAqC,CAAC"}

package/dist/core/types.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Re-export core types from @tummycrypt/scheduling-kit.
+ *
+ * We selectively re-export only the types module (not utils/pipelines)
+ * to avoid pulling in fp-ts runtime code that has ESM import issues
+ * in the published package.
+ */
+export type { AcuityError, CalComError, PaymentError, ValidationError, ReservationError, IdempotencyError, InfrastructureError, SchedulingError, SchedulingResult, SchedulingReader, Service, Provider, TimeSlot, AvailableDate, ClientInfo, BookingRequest, Booking, BookingStatus, PaymentStatus, SlotReservation, PaymentIntent, PaymentResult, RefundResult, SchedulingConfig, } from '@tummycrypt/scheduling-kit/core';
+export { Errors } from '@tummycrypt/scheduling-kit/core';
+//# sourceMappingURL=types.d.ts.map

package/dist/core/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,YAAY,EACV,WAAW,EACX,WAAW,EACX,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,OAAO,EACP,QAAQ,EACR,QAAQ,EACR,aAAa,EACb,UAAU,EACV,cAAc,EACd,OAAO,EACP,aAAa,EACb,aAAa,EACb,eAAe,EACf,aAAa,EACb,aAAa,EACb,YAAY,EACZ,gBAAgB,GACjB,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EAAE,MAAM,EAAE,MAAM,iCAAiC,CAAC"}

package/dist/core/types.js

@@ -0,0 +1,2 @@
+export { Errors } from '@tummycrypt/scheduling-kit/core';
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAkCA,OAAO,EAAE,MAAM,EAAE,MAAM,iCAAiC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @tummycrypt/acuity-middleware
+ *
+ * Playwright-based Acuity booking middleware server.
+ * Proxies booking operations through browser automation.
+ */
+export type { Service, Provider, TimeSlot, AvailableDate, Booking, BookingRequest, ClientInfo, SchedulingError, SchedulingResult, BookingStatus, PaymentStatus, } from './core/types.js';
+export { Errors } from './core/types.js';
+export type { SchedulingAdapter } from './adapters/types.js';
+export { createWizardAdapter, type WizardAdapterConfig, } from './middleware/acuity-wizard.js';
+export { createRemoteWizardAdapter, type RemoteAdapterConfig, } from './middleware/remote-adapter.js';
+export { BrowserService, BrowserServiceLive, BrowserServiceTest, defaultBrowserConfig, type BrowserConfig, type BrowserServiceShape, } from './middleware/browser-service.js';
+export { BrowserError, SelectorError, WizardStepError, CouponError, toSchedulingError, type MiddlewareError, } from './middleware/errors.js';
+export { Selectors, resolveSelector, resolve, probeSelector, probe, healthCheck, type SelectorKey, type ResolvedSelector, } from './middleware/selectors.js';
+export { createScraperAdapter, AcuityScraper, type ScraperConfig, } from './adapters/acuity-scraper.js';
+export { server } from './middleware/server.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,YAAY,EACX,OAAO,EACP,QAAQ,EACR,QAAQ,EACR,aAAa,EACb,OAAO,EACP,cAAc,EACd,UAAU,EACV,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,aAAa,GACb,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAGzC,YAAY,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAG7D,OAAO,EACN,mBAAmB,EACnB,KAAK,mBAAmB,GACxB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EACN,yBAAyB,EACzB,KAAK,mBAAmB,GACxB,MAAM,gCAAgC,CAAC;AAExC,OAAO,EACN,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,KAAK,aAAa,EAClB,KAAK,mBAAmB,GACxB,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EACN,YAAY,EACZ,aAAa,EACb,eAAe,EACf,WAAW,EACX,iBAAiB,EACjB,KAAK,eAAe,GACpB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACN,SAAS,EACT,eAAe,EACf,OAAO,EACP,aAAa,EACb,KAAK,EACL,WAAW,EACX,KAAK,WAAW,EAChB,KAAK,gBAAgB,GACrB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EACN,oBAAoB,EACpB,aAAa,EACb,KAAK,aAAa,GAClB,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/index.js

@@ -0,0 +1,18 @@
+/**
+ * @tummycrypt/acuity-middleware
+ *
+ * Playwright-based Acuity booking middleware server.
+ * Proxies booking operations through browser automation.
+ */
+export { Errors } from './core/types.js';
+// Middleware exports
+export { createWizardAdapter, } from './middleware/acuity-wizard.js';
+export { createRemoteWizardAdapter, } from './middleware/remote-adapter.js';
+export { BrowserService, BrowserServiceLive, BrowserServiceTest, defaultBrowserConfig, } from './middleware/browser-service.js';
+export { BrowserError, SelectorError, WizardStepError, CouponError, toSchedulingError, } from './middleware/errors.js';
+export { Selectors, resolveSelector, resolve, probeSelector, probe, healthCheck, } from './middleware/selectors.js';
+// Scraper
+export { createScraperAdapter, AcuityScraper, } from './adapters/acuity-scraper.js';
+// Server
+export { server } from './middleware/server.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAgBH,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAKzC,qBAAqB;AACrB,OAAO,EACN,mBAAmB,GAEnB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EACN,yBAAyB,GAEzB,MAAM,gCAAgC,CAAC;AAExC,OAAO,EACN,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,GAGpB,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EACN,YAAY,EACZ,aAAa,EACb,eAAe,EACf,WAAW,EACX,iBAAiB,GAEjB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACN,SAAS,EACT,eAAe,EACf,OAAO,EACP,aAAa,EACb,KAAK,EACL,WAAW,GAGX,MAAM,2BAA2B,CAAC;AAEnC,UAAU;AACV,OAAO,EACN,oBAAoB,EACpB,aAAa,GAEb,MAAM,8BAA8B,CAAC;AAEtC,SAAS;AACT,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/middleware/acuity-wizard.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Acuity Wizard Adapter
+ *
+ * Full SchedulingAdapter implementation that uses Effect TS middleware
+ * to puppeteer the Acuity booking wizard.
+ *
+ * Read operations:
+ * - getServices: returns static service catalog (if provided) or falls back to scraper
+ * - getAvailableDates: Effect program navigates wizard calendar (verified selectors)
+ * - getAvailableSlots: Effect program clicks day tile and reads time buttons
+ *
+ * Write operations:
+ * - createBooking/createBookingWithPaymentRef: Effect TS middleware via Playwright
+ *
+ * This is the bridge between Effect TS (middleware layer) and
+ * fp-ts (pipeline/adapter layer).
+ */
+import type { SchedulingAdapter } from '../adapters/types.js';
+import type { Service } from '../core/types.js';
+import { type BrowserConfig } from './browser-service.js';
+import { type RemoteAdapterConfig } from './remote-adapter.js';
+export interface WizardAdapterConfig extends Partial<BrowserConfig> {
+    /** Base URL for the Acuity scheduling page */
+    baseUrl: string;
+    /** Pre-configured coupon code for payment bypass (from ACUITY_BYPASS_COUPON env) */
+    couponCode?: string;
+    /**
+     * Execution mode:
+     * - 'local': Run Playwright in-process (default, requires Chromium installed)
+     * - 'remote': Proxy all operations to a remote middleware server via HTTP
+     */
+    mode?: 'local' | 'remote';
+    /** Remote adapter config (required when mode is 'remote') */
+    remote?: RemoteAdapterConfig;
+    /**
+     * Static service catalog. If provided, getServices() returns this list
+     * without launching a browser. Recommended for known service sets to avoid
+     * expensive browser launches for read-only operations.
+     */
+    services?: readonly Service[];
+}
+/**
+ * Create a full SchedulingAdapter that puppeteers the Acuity wizard.
+ *
+ * Read operations delegate to the existing scraper.
+ * Write operations use Effect TS middleware via Playwright.
+ */
+export declare const createWizardAdapter: (config: WizardAdapterConfig) => SchedulingAdapter;
+//# sourceMappingURL=acuity-wizard.d.ts.map

package/dist/middleware/acuity-wizard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"acuity-wizard.d.ts","sourceRoot":"","sources":["../../src/middleware/acuity-wizard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,OAAO,KAAK,EAGX,OAAO,EAEP,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAsB,KAAK,aAAa,EAAwB,MAAM,sBAAsB,CAAC;AAEpG,OAAO,EAA6B,KAAK,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAmB1F,MAAM,WAAW,mBAAoB,SAAQ,OAAO,CAAC,aAAa,CAAC;IAClE,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,oFAAoF;IACpF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,IAAI,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC1B,6DAA6D;IAC7D,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;CAC9B;AAgHD;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAAI,QAAQ,mBAAmB,KAAG,iBAuPjE,CAAC"}

package/dist/middleware/acuity-wizard.js

@@ -0,0 +1,265 @@
+/**
+ * Acuity Wizard Adapter
+ *
+ * Full SchedulingAdapter implementation that uses Effect TS middleware
+ * to puppeteer the Acuity booking wizard.
+ *
+ * Read operations:
+ * - getServices: returns static service catalog (if provided) or falls back to scraper
+ * - getAvailableDates: Effect program navigates wizard calendar (verified selectors)
+ * - getAvailableSlots: Effect program clicks day tile and reads time buttons
+ *
+ * Write operations:
+ * - createBooking/createBookingWithPaymentRef: Effect TS middleware via Playwright
+ *
+ * This is the bridge between Effect TS (middleware layer) and
+ * fp-ts (pipeline/adapter layer).
+ */
+import { Effect, pipe } from 'effect';
+import { createScraperAdapter } from '../adapters/acuity-scraper.js';
+import { Errors } from '../core/types.js';
+import { BrowserServiceLive, defaultBrowserConfig } from './browser-service.js';
+import { toSchedulingError } from './errors.js';
+import { createRemoteWizardAdapter } from './remote-adapter.js';
+import { navigateToBooking, fillFormFields, bypassPayment, generateCouponCode, submitBooking, extractConfirmation, toBooking, readAvailableDates, readTimeSlots, } from './steps/index.js';
+// =============================================================================
+// EFFECT PROGRAMS
+// =============================================================================
+/**
+ * Full booking creation via the Acuity wizard.
+ *
+ * Flow:
+ * 1. Click through wizard: service → Book → calendar → time → continue
+ * 2. Fill client form (standard + intake fields) → "Continue to Payment" → /payment page
+ * 3. Apply 100% gift certificate on payment page (coupon toggle → enter code → Apply)
+ * 4. Click "PAY & CONFIRM" at $0 total
+ * 5. Extract confirmation data
+ */
+const createBookingWithPaymentRefProgram = (request, paymentRef, paymentProcessor, couponCode, service) => Effect.scoped(Effect.gen(function* () {
+    // Step 1: Navigate through wizard to client form
+    const serviceName = service?.name ?? request.serviceId;
+    const nav = yield* navigateToBooking({
+        serviceName,
+        datetime: request.datetime,
+        client: request.client,
+    });
+    if (nav.landingStep !== 'client-form') {
+        return yield* Effect.fail({
+            _tag: 'WizardStepError',
+            step: 'navigate',
+            message: `Wizard landed on '${nav.landingStep}' instead of client form. Service or datetime may be unavailable.`,
+        });
+    }
+    // Step 2: Fill form fields (standard + intake) and advance to /payment page
+    yield* fillFormFields({
+        client: request.client,
+        customFields: request.client.customFields,
+    });
+    // Step 3: Apply gift certificate on the payment page (total → $0)
+    yield* bypassPayment(couponCode);
+    // Step 4: Click "PAY & CONFIRM" at $0 total
+    yield* submitBooking();
+    // Step 5: Extract confirmation
+    const confirmation = yield* extractConfirmation();
+    return toBooking(confirmation, request, paymentRef, paymentProcessor, service
+        ? {
+            name: service.name,
+            duration: service.duration,
+            price: service.price,
+            currency: service.currency,
+        }
+        : undefined);
+}));
+/**
+ * Simple booking creation (no payment bypass needed).
+ * For card payments that go through Acuity's normal flow.
+ */
+const createBookingProgram = (request, serviceName) => Effect.scoped(Effect.gen(function* () {
+    const nav = yield* navigateToBooking({
+        serviceName: serviceName ?? request.serviceId,
+        datetime: request.datetime,
+        client: request.client,
+    });
+    if (nav.landingStep !== 'client-form') {
+        return yield* Effect.fail({
+            _tag: 'WizardStepError',
+            step: 'navigate',
+            message: `Wizard landed on '${nav.landingStep}' instead of client form.`,
+        });
+    }
+    yield* fillFormFields({
+        client: request.client,
+        customFields: request.client.customFields,
+    });
+    // No payment bypass - form fills and advances to payment page
+    // where Acuity handles card payment normally
+    yield* submitBooking();
+    const confirmation = yield* extractConfirmation();
+    return toBooking(confirmation, request, '', 'acuity');
+}));
+// =============================================================================
+// ADAPTER FACTORY
+// =============================================================================
+/**
+ * Create a full SchedulingAdapter that puppeteers the Acuity wizard.
+ *
+ * Read operations delegate to the existing scraper.
+ * Write operations use Effect TS middleware via Playwright.
+ */
+export const createWizardAdapter = (config) => {
+    // Remote mode: delegate everything to the middleware server
+    if (config.mode === 'remote') {
+        if (!config.remote) {
+            throw new Error('WizardAdapterConfig.remote is required when mode is "remote"');
+        }
+        return createRemoteWizardAdapter({
+            ...config.remote,
+            couponCode: config.remote.couponCode ?? config.couponCode,
+            services: config.services,
+        });
+    }
+    // Local mode: run Playwright in-process
+    const browserConfig = {
+        ...defaultBrowserConfig,
+        ...config,
+    };
+    const layer = BrowserServiceLive(browserConfig);
+    // Provide browser layer and map MiddlewareError → SchedulingError
+    const runWizard = (effect) => pipe(Effect.scoped(effect), Effect.provide(layer), Effect.mapError(toSchedulingError));
+    // Static services from config (avoids browser launch for service listing)
+    const staticServices = config.services ? [...config.services] : null;
+    // Scraper fallback for services if no static list provided
+    const scraperConfig = {
+        baseUrl: config.baseUrl,
+        headless: browserConfig.headless,
+        timeout: browserConfig.timeout,
+        userAgent: browserConfig.userAgent,
+        executablePath: browserConfig.executablePath,
+        launchArgs: browserConfig.launchArgs ? [...browserConfig.launchArgs] : undefined,
+    };
+    const scraper = createScraperAdapter(scraperConfig);
+    // Cache services for getService lookups
+    let cachedServices = staticServices;
+    // Helper: resolve service name from ID using cached services
+    const resolveServiceName = (serviceId) => cachedServices?.find((s) => s.id === serviceId)?.name;
+    return {
+        name: 'acuity-wizard',
+        // -----------------------------------------------------------------------
+        // Read operations
+        // -----------------------------------------------------------------------
+        getServices: () => {
+            if (staticServices) {
+                return Effect.succeed(staticServices);
+            }
+            // Fallback to scraper (may fail with broken selectors)
+            return pipe(scraper.getServices(), Effect.tap((services) => Effect.sync(() => {
+                cachedServices = services;
+            })));
+        },
+        getService: (serviceId) => {
+            if (cachedServices) {
+                const found = cachedServices.find((s) => s.id === serviceId);
+                return found
+                    ? Effect.succeed(found)
+                    : Effect.fail(Errors.acuity('NOT_FOUND', `Service ${serviceId} not found`));
+            }
+            return pipe(scraper.getServices(), Effect.flatMap((services) => {
+                cachedServices = services;
+                const found = services.find((s) => s.id === serviceId);
+                return found
+                    ? Effect.succeed(found)
+                    : Effect.fail(Errors.acuity('NOT_FOUND', `Service ${serviceId} not found`));
+            }));
+        },
+        getProviders: () => Effect.succeed([
+            {
+                id: '1',
+                name: 'Default Provider',
+                email: 'provider@example.com',
+                description: 'Primary provider',
+                timezone: 'America/New_York',
+            },
+        ]),
+        getProvider: () => Effect.succeed({
+            id: '1',
+            name: 'Default Provider',
+            email: 'provider@example.com',
+            description: 'Primary provider',
+            timezone: 'America/New_York',
+        }),
+        getProvidersForService: () => Effect.succeed([
+            {
+                id: '1',
+                name: 'Default Provider',
+                email: 'provider@example.com',
+                description: 'Primary provider',
+                timezone: 'America/New_York',
+            },
+        ]),
+        getAvailableDates: (params) => {
+            const serviceName = resolveServiceName(params.serviceId);
+            if (!serviceName) {
+                return Effect.fail(Errors.acuity('NOT_FOUND', `Cannot resolve service name for ID ${params.serviceId}. Provide static services in config.`));
+            }
+            return runWizard(Effect.scoped(readAvailableDates({
+                serviceName,
+                // Don't pass appointmentTypeId — our internal IDs don't match Acuity URL IDs
+                targetMonth: params.startDate?.slice(0, 7),
+                monthsToScan: 2,
+            })));
+        },
+        getAvailableSlots: (params) => {
+            const serviceName = resolveServiceName(params.serviceId);
+            if (!serviceName) {
+                return Effect.fail(Errors.acuity('NOT_FOUND', `Cannot resolve service name for ID ${params.serviceId}. Provide static services in config.`));
+            }
+            return runWizard(Effect.scoped(readTimeSlots({
+                serviceName,
+                date: params.date,
+            })));
+        },
+        checkSlotAvailability: (params) => {
+            const serviceName = resolveServiceName(params.serviceId);
+            if (!serviceName) {
+                return Effect.fail(Errors.acuity('NOT_FOUND', `Cannot resolve service name for ID ${params.serviceId}`));
+            }
+            return pipe(runWizard(Effect.scoped(readTimeSlots({
+                serviceName,
+                date: params.datetime.split('T')[0],
+            }))), Effect.map((slots) => {
+                // Slots return local time (no TZ suffix: "2026-03-07T14:00:00").
+                // Request datetime should also be local, but normalize both by
+                // stripping any trailing Z or offset for comparison.
+                const normalize = (dt) => dt.replace(/([+-]\d{2}:\d{2}|Z)$/, '');
+                const requestNorm = normalize(params.datetime);
+                return slots.some((s) => s.available && normalize(s.datetime) === requestNorm);
+            }));
+        },
+        // -----------------------------------------------------------------------
+        // Reservation - not supported (pipeline has graceful fallback)
+        // -----------------------------------------------------------------------
+        createReservation: () => Effect.fail(Errors.reservation('BLOCK_FAILED', 'Reservations not supported by wizard adapter')),
+        releaseReservation: () => Effect.succeed(undefined),
+        // -----------------------------------------------------------------------
+        // Write operations - Effect TS middleware
+        // -----------------------------------------------------------------------
+        createBooking: (request) => {
+            const serviceName = cachedServices?.find((s) => s.id === request.serviceId)?.name;
+            return runWizard(createBookingProgram(request, serviceName));
+        },
+        createBookingWithPaymentRef: (request, paymentRef, paymentProcessor) => {
+            const coupon = config.couponCode ?? generateCouponCode(paymentRef, paymentProcessor);
+            const service = cachedServices?.find((s) => s.id === request.serviceId);
+            return runWizard(createBookingWithPaymentRefProgram(request, paymentRef, paymentProcessor, coupon, service));
+        },
+        getBooking: () => Effect.fail(Errors.acuity('NOT_IMPLEMENTED', 'Get booking not yet supported via wizard')),
+        cancelBooking: () => Effect.fail(Errors.acuity('NOT_IMPLEMENTED', 'Cancel not yet supported via wizard')),
+        rescheduleBooking: () => Effect.fail(Errors.acuity('NOT_IMPLEMENTED', 'Reschedule not yet supported via wizard')),
+        // -----------------------------------------------------------------------
+        // Client - pass-through (client data comes from our form, not Acuity)
+        // -----------------------------------------------------------------------
+        findOrCreateClient: (client) => Effect.succeed({ id: `local-${client.email}`, isNew: true }),
+        getClientByEmail: () => Effect.succeed(null),
+    };
+};
+//# sourceMappingURL=acuity-wizard.js.map

package/dist/middleware/acuity-wizard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"acuity-wizard.js","sourceRoot":"","sources":["../../src/middleware/acuity-wizard.ts"],"names":[],"mappings":"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"}

package/dist/middleware/browser-service.d.ts

@@ -0,0 +1,53 @@
+/**
+ * BrowserService Layer
+ *
+ * Effect TS Layer providing managed Playwright browser lifecycle.
+ * The browser and pages are acquired/released via Effect's Scope,
+ * ensuring proper cleanup even on errors or interruptions.
+ */
+import { Context, Effect, Layer, Scope } from 'effect';
+import type { Page } from 'playwright-core';
+import { BrowserError } from './errors.js';
+export interface BrowserConfig {
+    /** Base URL for the Acuity scheduling page */
+    readonly baseUrl: string;
+    /** Run browser in headless mode (default: true) */
+    readonly headless: boolean;
+    /** Default timeout for page operations in ms (default: 30000) */
+    readonly timeout: number;
+    /** User agent string */
+    readonly userAgent: string;
+    /** Take screenshot on failure (default: true) */
+    readonly screenshotOnFailure: boolean;
+    /** Directory for failure screenshots */
+    readonly screenshotDir: string;
+    /** Path to Chromium executable (for Lambda/serverless) */
+    readonly executablePath?: string;
+    /** Additional chromium.launch() args (e.g., Lambda sandbox flags) */
+    readonly launchArgs?: readonly string[];
+}
+export declare const defaultBrowserConfig: BrowserConfig;
+export interface BrowserServiceShape {
+    /** Get a managed Page (scoped - auto-closed when scope ends) */
+    readonly acquirePage: Effect.Effect<Page, BrowserError, Scope.Scope>;
+    /** Take a screenshot of the most recently created page */
+    readonly screenshot: (label: string) => Effect.Effect<Buffer, BrowserError>;
+    /** The browser configuration */
+    readonly config: BrowserConfig;
+}
+declare const BrowserService_base: Context.TagClass<BrowserService, "scheduling-kit/BrowserService", BrowserServiceShape>;
+export declare class BrowserService extends BrowserService_base {
+}
+/**
+ * Create a live BrowserService layer backed by Playwright Chromium.
+ * The browser is launched once when the layer is created and closed
+ * when the layer scope ends.
+ */
+export declare const BrowserServiceLive: (config?: Partial<BrowserConfig>) => Layer.Layer<BrowserService, BrowserError>;
+/**
+ * A mock BrowserService for unit tests.
+ * Does not launch a real browser.
+ */
+export declare const BrowserServiceTest: (config?: Partial<BrowserConfig>) => Layer.Layer<BrowserService>;
+export {};
+//# sourceMappingURL=browser-service.d.ts.map

package/dist/middleware/browser-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-service.d.ts","sourceRoot":"","sources":["../../src/middleware/browser-service.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AACvD,OAAO,KAAK,EAAW,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAM3C,MAAM,WAAW,aAAa;IAC7B,8CAA8C;IAC9C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,mDAAmD;IACnD,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,iEAAiE;IACjE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,wBAAwB;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,iDAAiD;IACjD,QAAQ,CAAC,mBAAmB,EAAE,OAAO,CAAC;IACtC,wCAAwC;IACxC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,0DAA0D;IAC1D,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,qEAAqE;IACrE,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACxC;AAED,eAAO,MAAM,oBAAoB,EAAE,aAQlC,CAAC;AAMF,MAAM,WAAW,mBAAmB;IACnC,gEAAgE;IAChE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,YAAY,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IACrE,0DAA0D;IAC1D,QAAQ,CAAC,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAC5E,gCAAgC;IAChC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;CAC/B;;AAED,qBAAa,cAAe,SAAQ,mBAGjC;CAAG;AAMN;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAC9B,SAAQ,OAAO,CAAC,aAAa,CAAM,KACjC,KAAK,CAAC,KAAK,CAAC,cAAc,EAAE,YAAY,CAqF1C,CAAC;AAMF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,GAC9B,SAAQ,OAAO,CAAC,aAAa,CAAM,KACjC,KAAK,CAAC,KAAK,CAAC,cAAc,CAW5B,CAAC"}

package/dist/middleware/browser-service.js

@@ -0,0 +1,105 @@
+/**
+ * BrowserService Layer
+ *
+ * Effect TS Layer providing managed Playwright browser lifecycle.
+ * The browser and pages are acquired/released via Effect's Scope,
+ * ensuring proper cleanup even on errors or interruptions.
+ */
+import { Context, Effect, Layer } from 'effect';
+import { BrowserError } from './errors.js';
+export const defaultBrowserConfig = {
+    baseUrl: 'https://MassageIthaca.as.me',
+    headless: true,
+    timeout: 30000,
+    userAgent: 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36',
+    screenshotOnFailure: true,
+    screenshotDir: '/tmp/scheduling-kit-screenshots',
+};
+export class BrowserService extends Context.Tag('scheduling-kit/BrowserService')() {
+}
+// =============================================================================
+// LIVE IMPLEMENTATION
+// =============================================================================
+/**
+ * Create a live BrowserService layer backed by Playwright Chromium.
+ * The browser is launched once when the layer is created and closed
+ * when the layer scope ends.
+ */
+export const BrowserServiceLive = (config = {}) => {
+    const cfg = { ...defaultBrowserConfig, ...config };
+    return Layer.scoped(BrowserService, Effect.gen(function* () {
+        // Dynamic import - try playwright-core first (lighter, no bundled browsers),
+        // fall back to full playwright which includes its own Chromium
+        const chromium = yield* Effect.tryPromise({
+            try: async () => {
+                try {
+                    const pw = await import('playwright-core');
+                    return pw.chromium;
+                }
+                catch {
+                    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                    const pw = await import('playwright-core');
+                    return pw.chromium;
+                }
+            },
+            catch: () => new BrowserError({
+                reason: 'PLAYWRIGHT_MISSING',
+                cause: new Error('playwright-core or playwright is required for the wizard middleware. ' +
+                    'Install with: pnpm add playwright-core'),
+            }),
+        });
+        // Launch browser (released when scope ends)
+        const browser = yield* Effect.acquireRelease(Effect.tryPromise({
+            try: () => chromium.launch({
+                headless: cfg.headless,
+                executablePath: cfg.executablePath,
+                args: cfg.launchArgs ? [...cfg.launchArgs] : undefined,
+            }),
+            catch: (e) => new BrowserError({ reason: 'LAUNCH_FAILED', cause: e }),
+        }), (browser) => Effect.promise(() => browser.close()).pipe(Effect.ignoreLogged));
+        // Create a single managed page for the layer's lifetime.
+        // All step programs share this page within a scope.
+        const page = yield* Effect.acquireRelease(Effect.tryPromise({
+            try: async () => {
+                const p = await browser.newPage({ userAgent: cfg.userAgent });
+                p.setDefaultTimeout(cfg.timeout);
+                return p;
+            },
+            catch: (e) => new BrowserError({ reason: 'PAGE_FAILED', cause: e }),
+        }), (p) => Effect.promise(() => p.close()).pipe(Effect.ignoreLogged));
+        // acquirePage returns the singleton page — cleanup is handled by the
+        // layer scope above. The no-op release keeps the Scope type requirement
+        // so callers still need Effect.scoped.
+        const acquirePage = Effect.acquireRelease(Effect.succeed(page), () => Effect.void);
+        const screenshot = (label) => Effect.tryPromise({
+            try: async () => {
+                if (page.isClosed()) {
+                    throw new Error('No active page for screenshot');
+                }
+                const buffer = await page.screenshot({
+                    path: `${cfg.screenshotDir}/${label}-${Date.now()}.png`,
+                    fullPage: true,
+                });
+                return buffer;
+            },
+            catch: (e) => new BrowserError({ reason: 'SCREENSHOT_FAILED', cause: e }),
+        });
+        return { acquirePage, screenshot, config: cfg };
+    }));
+};
+// =============================================================================
+// TEST IMPLEMENTATION
+// =============================================================================
+/**
+ * A mock BrowserService for unit tests.
+ * Does not launch a real browser.
+ */
+export const BrowserServiceTest = (config = {}) => {
+    const cfg = { ...defaultBrowserConfig, ...config };
+    return Layer.succeed(BrowserService, {
+        acquirePage: Effect.die(new Error('BrowserServiceTest: acquirePage called - use a real browser for integration tests')),
+        screenshot: () => Effect.succeed(Buffer.from('mock-screenshot')),
+        config: cfg,
+    });
+};
+//# sourceMappingURL=browser-service.js.map

package/dist/middleware/browser-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-service.js","sourceRoot":"","sources":["../../src/middleware/browser-service.ts"],"names":[],"mappings":"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"}