@nuxt-customer-portal/planning 0.4.0

package/shared/types.ts

@@ -0,0 +1,110 @@
+import type { PlanningPolicy } from '@nuxt-customer-portal/products/shared/planning'
+
+export type { PlanningPolicy, ProductPlanning } from '@nuxt-customer-portal/products/shared/planning'
+export interface Interval {
+  start: string
+  end: string
+}
+export interface AvailabilityWindow {
+  id: string
+  userId: string
+  timezone: string
+  date: string
+  endDate: string | null
+  startTime: string
+  endTime: string
+  recurring: boolean
+  productIds: string[] | null
+  exceptions: string[]
+}
+export interface Slot extends Interval {
+  providerUserId: string
+  providerName: string
+}
+export interface AppointmentSnapshot {
+  organizerEmail?: string
+  title: string
+  durationMinutes: number
+  graceMinutes: number
+  timezone: string
+  customerTimezone: string
+  policy: PlanningPolicy
+  currency: string
+  unitAmount: number
+  meetingProvider: 'none' | 'zoom'
+  customerNotificationRevision?: number
+  zoomLinkNotificationPending?: boolean
+  locale: 'en' | 'nl'
+}
+export interface Reservation {
+  id: string
+  store_id: string
+  user_id: string
+  product_id: string
+  token_hash: string
+  start_at: Date
+  end_at: Date
+  blocked_until: Date
+  confirmed_at: Date | null
+  expires_at: Date
+  status: 'reserved' | 'confirmed' | 'expired' | 'cancelled' | 'superseded'
+  order_id: string | null
+  replaces_id: string | null
+  snapshot: AppointmentSnapshot
+}
+export interface Appointment {
+  id: string
+  store_id: string
+  reservation_id: string
+  order_line_id: string
+  order_id: string
+  user_id: string
+  product_id: string
+  start_at: Date
+  end_at: Date
+  status: 'confirmed' | 'cancelled'
+  changes: number
+  revision: number
+  snapshot: AppointmentSnapshot
+  meeting_id: string | null
+  meeting_url: string | null
+  calendar_event_id: string | null
+  calendar_id: string | null
+  calendar_user_id: string | null
+  conflict: boolean
+  effects_error: string | null
+}
+export interface ProviderSettings {
+  userId: string
+  name: string
+  enabled: boolean
+  timezone: string
+  graceMinutes: number
+  availabilityCalendarTitle: string
+  busyCalendarIds: string[]
+  writeCalendarId: string | null
+  googleConnected: boolean
+  zoomConnected: boolean
+}
+
+export interface PlanningDashboardAppointment {
+  id: string
+  title: string
+  start: string
+  end: string
+  meetingProvider: 'none' | 'zoom'
+  meetingUrl: string | null
+  providerName: string
+  providerTimezone: string
+  customerName: string
+  customerTimezone: string
+  conflict: boolean
+}
+
+export interface PlanningDashboardDto {
+  access: { staff: boolean; canManage: boolean }
+  upcomingCount: number
+  todayCount: number
+  conflictCount: number
+  appointments: PlanningDashboardAppointment[]
+}

package/shared/validation.ts

@@ -0,0 +1,77 @@
+import { z } from 'zod'
+import { isValidTimezone } from '@nuxt-customer-portal/core/shared/timezone'
+
+export { planningPolicySchema } from '@nuxt-customer-portal/products/shared/planning'
+export const timezoneSchema = z.string().max(100).refine(isValidTimezone, 'Choose an IANA timezone')
+const date = z
+  .string()
+  .regex(/^\d{4}-\d{2}-\d{2}$/)
+  .refine((v) => Number.isFinite(Date.parse(v)) && new Date(v).toISOString().slice(0, 10) === v, 'Invalid date')
+const time = z.string().regex(/^(?:[01]\d|2[0-3]):[0-5]\d$/)
+export const availabilitySchema = z
+  .object({
+    date,
+    endDate: date.nullable().default(null),
+    startTime: time,
+    endTime: z
+      .string()
+      .transform((value) => (value === '00:00' ? '24:00' : value))
+      .pipe(z.union([time, z.literal('24:00')])),
+    recurring: z.boolean().default(false),
+    productIds: z.array(z.string().min(1).max(100)).min(1).max(100).nullable().default(null),
+    exceptions: z.array(date).max(365).default([])
+  })
+  .superRefine((v, c) => {
+    if (v.endTime <= v.startTime) {
+      c.addIssue({ code: 'custom', path: ['endTime'], message: 'End must follow start on the same day' })
+    }
+    if (v.endDate && v.endDate < v.date) {
+      c.addIssue({ code: 'custom', path: ['endDate'], message: 'End date must follow start date' })
+    }
+  })
+export const providerSettingsSchema = z.object({
+  timezone: timezoneSchema,
+  graceMinutes: z.number().int().min(0).max(1440),
+  availabilityCalendarTitle: z.string().trim().min(1).max(100),
+  busyCalendarIds: z.array(z.string().min(1).max(500)).min(1).max(20),
+  writeCalendarId: z.string().min(1).max(500)
+})
+export const availabilityQuerySchema = z
+  .object({
+    from: z.iso.datetime({ offset: true }),
+    to: z.iso.datetime({ offset: true }),
+    providerUserId: z.string().max(100).optional()
+  })
+  .refine(
+    (v) => Date.parse(v.to) > Date.parse(v.from) && Date.parse(v.to) - Date.parse(v.from) <= 31 * 86400000,
+    'Request at most 31 days'
+  )
+export const holdSchema = z.object({
+  productId: z.string().min(1).max(100),
+  providerUserId: z.string().min(1).max(100),
+  start: z.iso.datetime({ offset: true }),
+  customerTimezone: timezoneSchema,
+  currency: z.string().regex(/^[A-Z]{3}$/),
+  locale: z.enum(['en', 'nl']).default('en'),
+  replacesId: z.uuid().optional(),
+  previousHoldToken: z.string().min(32).max(200).optional()
+})
+export const holdCredentialSchema = z.object({ holdToken: z.string().min(32).max(200) })
+
+export const availabilityEditSchema = availabilitySchema.safeExtend({ occurrenceDate: date.optional() })
+
+export const appointmentListSchema = z.object({
+  search: z.string().trim().max(200).default(''),
+  status: z.enum(['all', 'confirmed', 'cancelled']).default('all'),
+  conflicts: z.enum(['all', 'conflicts']).default('all'),
+  host: z.string().trim().min(1).max(100).default('all'),
+  sortBy: z.enum(['start', 'title']).default('start'),
+  sortOrder: z.enum(['asc', 'desc']).default('desc'),
+  page: z.coerce.number().int().min(1).max(100000).default(1)
+})
+export const staffRescheduleSchema = z.object({
+  providerUserId: z.string().min(1).max(100),
+  start: z.iso.datetime({ offset: true }),
+  customerTimezone: timezoneSchema,
+  revision: z.number().int().min(0)
+})