@getmicdrop/svelte-components 5.17.1 → 5.17.4

package/dist/config.d.ts

@@ -1,3 +1,105 @@
 export const API_BASE_URL: any;
 export const PUBLIC_GOOGLE_MAPS_API_KEY: any;
+export namespace STRING_LIMITS {
+    let EVENT_TITLE_MIN: number;
+    let EVENT_TITLE_MAX: number;
+    let EVENT_DESCRIPTION_MAX: number;
+    let VENUE_NAME_MIN: number;
+    let VENUE_NAME_MAX: number;
+    let VENUE_DESCRIPTION_MAX: number;
+    let PERFORMER_NAME_MIN: number;
+    let PERFORMER_NAME_MAX: number;
+    let PERFORMER_BIO_MAX: number;
+    let TICKET_NAME_MIN: number;
+    let TICKET_NAME_MAX: number;
+    let TICKET_DESCRIPTION_MAX: number;
+    let PROMO_CODE_MIN: number;
+    let PROMO_CODE_MAX: number;
+    let SHORT_TEXT_MAX: number;
+    let MEDIUM_TEXT_MAX: number;
+    let LONG_TEXT_MAX: number;
+    let EMAIL_MAX: number;
+    let PHONE_MAX: number;
+    let URL_MAX: number;
+    let ADDRESS_MAX: number;
+    let CITY_MAX: number;
+    let POSTAL_CODE_MAX: number;
+    let NOTES_MAX: number;
+}
+export namespace NUMBER_LIMITS {
+    let AGE_MIN: number;
+    let AGE_MAX: number;
+    let PERCENT_MIN: number;
+    let PERCENT_MAX: number;
+    let CURRENCY_MIN: number;
+    let CURRENCY_MAX: number;
+    let QUANTITY_MIN: number;
+    let QUANTITY_MAX: number;
+    let YEAR_MIN: number;
+    let YEAR_MAX: number;
+    let RATING_MIN: number;
+    let RATING_MAX: number;
+}
+export namespace FILE_LIMITS {
+    let MAX_SIZE: number;
+    let MAX_IMAGE_SIZE: number;
+    let MAX_CSV_SIZE: number;
+    let MAX_FILENAME_LENGTH: number;
+}
+export namespace PATTERNS {
+    let EMAIL: RegExp;
+    let PHONE: RegExp;
+    let ZIP_CODE: RegExp;
+    let ALPHANUMERIC: RegExp;
+    let SLUG: RegExp;
+    let PROMO_CODE: RegExp;
+    let URL: RegExp;
+    let TIME_24H: RegExp;
+    let CURRENCY: RegExp;
+}
+export namespace PASSWORD {
+    let MIN_LENGTH: number;
+    let MAX_LENGTH: number;
+    let REQUIRE_UPPERCASE: boolean;
+    let REQUIRE_LOWERCASE: boolean;
+    let REQUIRE_NUMBER: boolean;
+    let REQUIRE_SPECIAL: boolean;
+}
+export namespace ORDER {
+    let MIN_TICKETS: number;
+    let MAX_TICKETS: number;
+    let DEFAULT_MAX_TICKETS: number;
+    let CART_TIMEOUT_MINUTES: number;
+}
+export namespace TICKET_PRICING {
+    let MIN_PRICE: number;
+    let MAX_PRICE: number;
+    let PRICE_PRECISION: number;
+}
+export namespace CAPACITY {
+    let MIN_CAPACITY: number;
+    let MAX_CAPACITY: number;
+    let DEFAULT_CAPACITY: number;
+}
+export namespace PROMO_CODE {
+    let MIN_CODE_LENGTH: number;
+    let MAX_CODE_LENGTH: number;
+    let MAX_DISCOUNT_PERCENT: number;
+    let MAX_DISCOUNT_FIXED: number;
+    let DEFAULT_USAGE_LIMIT: number;
+}
+export namespace PERFORMER {
+    let MIN_SET_TIME: number;
+    let MAX_SET_TIME: number;
+    let DEFAULT_SET_TIME: number;
+    let MAX_PER_EVENT: number;
+    let MAX_TIER: number;
+}
+export namespace SCHEDULE {
+    let MIN_EVENT_DURATION: number;
+    let MAX_EVENT_DURATION: number;
+    let DEFAULT_EVENT_DURATION: number;
+    let DEFAULT_DOORS_BEFORE: number;
+    let MAX_ADVANCE_DAYS: number;
+}
 //# sourceMappingURL=config.d.ts.map

package/dist/config.js

@@ -3,4 +3,150 @@ export const API_BASE_URL =
 
 export const PUBLIC_GOOGLE_MAPS_API_KEY =
   import.meta.env.VITE_PUBLIC_GOOGLE_MAPS_API_KEY ||
-  'AIzaSyCFB0-9qay7P0jZZDw93SsTnyLtZDlch7Q';
+  'AIzaSyCFB0-9qay7P0jZZDw93SsTnyLtZDlch7Q';
+
+/**
+ * String length limits for validation schemas
+ */
+export const STRING_LIMITS = {
+  EVENT_TITLE_MIN: 1,
+  EVENT_TITLE_MAX: 200,
+  EVENT_DESCRIPTION_MAX: 5000,
+  VENUE_NAME_MIN: 1,
+  VENUE_NAME_MAX: 200,
+  VENUE_DESCRIPTION_MAX: 3000,
+  PERFORMER_NAME_MIN: 1,
+  PERFORMER_NAME_MAX: 100,
+  PERFORMER_BIO_MAX: 2000,
+  TICKET_NAME_MIN: 1,
+  TICKET_NAME_MAX: 100,
+  TICKET_DESCRIPTION_MAX: 500,
+  PROMO_CODE_MIN: 3,
+  PROMO_CODE_MAX: 20,
+  SHORT_TEXT_MAX: 100,
+  MEDIUM_TEXT_MAX: 500,
+  LONG_TEXT_MAX: 2000,
+  EMAIL_MAX: 254,
+  PHONE_MAX: 20,
+  URL_MAX: 2048,
+  ADDRESS_MAX: 200,
+  CITY_MAX: 100,
+  POSTAL_CODE_MAX: 20,
+  NOTES_MAX: 1000,
+};
+
+/**
+ * Number limits for validation schemas
+ */
+export const NUMBER_LIMITS = {
+  AGE_MIN: 0,
+  AGE_MAX: 21,
+  PERCENT_MIN: 0,
+  PERCENT_MAX: 100,
+  CURRENCY_MIN: 0,
+  CURRENCY_MAX: 1000000,
+  QUANTITY_MIN: 0,
+  QUANTITY_MAX: 100000,
+  YEAR_MIN: 1900,
+  YEAR_MAX: 2100,
+  RATING_MIN: 1,
+  RATING_MAX: 5,
+};
+
+/**
+ * File validation limits
+ */
+export const FILE_LIMITS = {
+  MAX_SIZE: 10 * 1024 * 1024,
+  MAX_IMAGE_SIZE: 5 * 1024 * 1024,
+  MAX_CSV_SIZE: 50 * 1024 * 1024,
+  MAX_FILENAME_LENGTH: 255,
+};
+
+/**
+ * Input patterns (regex)
+ */
+export const PATTERNS = {
+  EMAIL: /^[^\s@]+@[^\s@]+\.[^\s@]+$/,
+  PHONE: /^\+?1?[-.\s]?\(?[0-9]{3}\)?[-.\s]?[0-9]{3}[-.\s]?[0-9]{4}$/,
+  ZIP_CODE: /^\d{5}(-\d{4})?$/,
+  ALPHANUMERIC: /^[a-zA-Z0-9]+$/,
+  SLUG: /^[a-z0-9]+(?:-[a-z0-9]+)*$/,
+  PROMO_CODE: /^[A-Z0-9_]+$/,
+  URL: /^https?:\/\/.+/,
+  TIME_24H: /^([01]?[0-9]|2[0-3]):[0-5][0-9]$/,
+  CURRENCY: /^\d+(\.\d{1,2})?$/,
+};
+
+/**
+ * Password requirements
+ */
+export const PASSWORD = {
+  MIN_LENGTH: 8,
+  MAX_LENGTH: 128,
+  REQUIRE_UPPERCASE: true,
+  REQUIRE_LOWERCASE: true,
+  REQUIRE_NUMBER: true,
+  REQUIRE_SPECIAL: false,
+};
+
+/**
+ * Order limits
+ */
+export const ORDER = {
+  MIN_TICKETS: 1,
+  MAX_TICKETS: 50,
+  DEFAULT_MAX_TICKETS: 10,
+  CART_TIMEOUT_MINUTES: 15,
+};
+
+/**
+ * Ticket pricing limits
+ */
+export const TICKET_PRICING = {
+  MIN_PRICE: 0,
+  MAX_PRICE: 10000,
+  PRICE_PRECISION: 2,
+};
+
+/**
+ * Event capacity limits
+ */
+export const CAPACITY = {
+  MIN_CAPACITY: 1,
+  MAX_CAPACITY: 100000,
+  DEFAULT_CAPACITY: 100,
+};
+
+/**
+ * Promo code limits
+ */
+export const PROMO_CODE = {
+  MIN_CODE_LENGTH: 3,
+  MAX_CODE_LENGTH: 20,
+  MAX_DISCOUNT_PERCENT: 100,
+  MAX_DISCOUNT_FIXED: 1000,
+  DEFAULT_USAGE_LIMIT: 100,
+};
+
+/**
+ * Performer/roster limits
+ */
+export const PERFORMER = {
+  MIN_SET_TIME: 5,
+  MAX_SET_TIME: 180,
+  DEFAULT_SET_TIME: 15,
+  MAX_PER_EVENT: 50,
+  MAX_TIER: 5,
+};
+
+/**
+ * Schedule/timeline limits
+ */
+export const SCHEDULE = {
+  MIN_EVENT_DURATION: 15,
+  MAX_EVENT_DURATION: 24 * 60,
+  DEFAULT_EVENT_DURATION: 120,
+  DEFAULT_DOORS_BEFORE: 30,
+  MAX_ADVANCE_DAYS: 365,
+};

package/dist/datetime/README.md

@@ -0,0 +1,323 @@
+# DateTime Module
+
+Centralized date/time handling for the MicDrop platform. This module eliminates timezone bugs by enforcing consistent patterns across the application.
+
+## Golden Rules
+
+1. **Backend is King** - All API requests send/receive UTC ISO strings (`2023-12-25T20:00:00Z`)
+2. **Display is Local** - All UI components receive UTC strings + Timezone ID
+3. **No `new Date()` in components** - Use these helpers instead
+4. **Timezone is always required** - Every function requires explicit timezone parameter
+
+## Quick Start
+
+```typescript
+import * as datetime from '$lib/datetime';
+
+// Get timezone from venue (throws if missing)
+const tz = datetime.getVenueTimezone(venue);
+
+// Format for display
+const time = datetime.formatEventTime(event.startTime, tz); // "7:00 PM"
+const date = datetime.formatEventDate(event.startTime, tz); // "Dec 25, 2023"
+const full = datetime.formatEventDateTime(event.startTime, tz); // "Dec 25, 2023 at 7:00 PM"
+
+// Parse form input to UTC for API
+const utc = datetime.combineDateAndTime('2023-12-25', '19:00', tz);
+
+// Parse API response for form
+const { date, time } = datetime.parseDateTimeFromAPI(event.startTime, tz);
+```
+
+## Module Structure
+
+```
+src/lib/datetime/
+├── index.ts           # Clean exports
+├── types.ts           # Type definitions
+├── constants.ts       # Duration constants, format strings
+├── timezone.ts        # Timezone utilities
+├── format.ts          # Formatting functions
+├── parse.ts           # Parsing functions
+├── __tests__/         # Comprehensive tests
+│   ├── timezone.test.ts
+│   ├── format.test.ts
+│   ├── parse.test.ts
+│   └── integration.test.ts
+└── README.md          # This file
+```
+
+## API Reference
+
+### Timezone Utilities
+
+```typescript
+// Validate timezone
+isValidTimezone('America/Los_Angeles'); // true
+isValidTimezone('PST'); // false (abbreviations not valid)
+
+// Get venue timezone (throws if missing)
+const tz = getVenueTimezone(venue);
+
+// Get user's browser timezone
+const userTz = getUserTimezone();
+
+// Get timezone offset string
+getTimezoneOffset('America/Los_Angeles'); // "PST (UTC-8)"
+
+// Normalize legacy timezone abbreviations
+normalizeTimezone('PST'); // "America/Los_Angeles"
+
+// Check if DST is active
+isDST('America/Los_Angeles', new Date()); // true/false
+```
+
+### Format Functions
+
+All format functions require timezone - no defaults!
+
+```typescript
+// Time only
+formatEventTime('2023-12-26T03:00:00Z', 'America/Los_Angeles');
+// "7:00 PM"
+
+// Date only
+formatEventDate('2023-12-26T03:00:00Z', 'America/Los_Angeles');
+// "Dec 25, 2023"
+
+// Full datetime
+formatEventDateTime('2023-12-26T03:00:00Z', 'America/Los_Angeles');
+// "Dec 25, 2023 at 7:00 PM"
+
+// Time range
+formatTimeRange(startUtc, endUtc, 'America/Los_Angeles');
+// "7:00 PM - 10:00 PM"
+
+// Date range
+formatDateRange(startUtc, endUtc, 'America/Los_Angeles');
+// "Dec 25 - 27, 2023"
+
+// Relative time
+formatRelativeTime(utcIso, 'America/Los_Angeles');
+// "2 hours ago" or "in 3 days"
+
+// Date parts
+getDateParts('2023-12-25T20:00:00Z', 'America/Los_Angeles');
+// { day: 'Mon', month: 'Dec', date: 25, year: 2023 }
+
+// Get hour (0-23)
+getHourInTimezone('2023-12-25T20:00:00Z', 'America/Los_Angeles');
+// 12
+
+// Get date string
+getDateInTimezone('2023-12-25T20:00:00Z', 'America/Los_Angeles');
+// "2023-12-25"
+```
+
+### Parse Functions
+
+```typescript
+// Local datetime to UTC
+parseLocalToUTC('2023-12-25T19:00:00', 'America/Los_Angeles');
+// "2023-12-26T03:00:00.000Z"
+
+// UTC to local datetime
+parseUTCToLocal('2023-12-26T03:00:00Z', 'America/Los_Angeles');
+// "2023-12-25T19:00:00"
+
+// Combine date and time
+combineDateAndTime('2023-12-25', '19:00', 'America/Los_Angeles');
+// "2023-12-26T03:00:00.000Z"
+
+// Parse API response for form
+parseDateTimeFromAPI('2023-12-26T03:00:00Z', 'America/Los_Angeles');
+// { date: '2023-12-25', time: '19:00' }
+
+// Start of day in UTC
+parseStartOfDay('2023-12-25', 'America/Los_Angeles');
+// "2023-12-25T08:00:00.000Z"
+
+// End of day in UTC
+parseEndOfDay('2023-12-25', 'America/Los_Angeles');
+// "2023-12-26T07:59:59.000Z"
+```
+
+### Next-Day Time Handling
+
+For overnight events (e.g., 10 PM - 2 AM):
+
+```typescript
+// Check for next-day prefix
+isNextDayTime('+1_02:00'); // true
+isNextDayTime('14:00'); // false
+
+// Strip prefix
+stripNextDayPrefix('+1_02:00'); // '02:00'
+
+// Convert to minutes
+parseTimeToMinutes('22:00'); // 1320
+parseTimeToMinutes('+1_02:00'); // 1560 (26 hours)
+
+// Convert back
+minutesToTimeString(1320); // '22:00'
+minutesToTimeString(1560, true); // '+1_02:00'
+```
+
+### Constants
+
+```typescript
+import {
+  DURATIONS,
+  DATE_FORMATS,
+  EVENT_DEFAULTS,
+  COMMON_US_TIMEZONES,
+} from '$lib/datetime';
+
+// Durations in milliseconds
+DURATIONS.MINUTE; // 60000
+DURATIONS.HOUR; // 3600000
+DURATIONS.DAY; // 86400000
+
+// Event defaults
+EVENT_DEFAULTS.DEFAULT_DURATION_MINUTES; // 120
+EVENT_DEFAULTS.MIN_DURATION_MINUTES; // 15
+EVENT_DEFAULTS.DEFAULT_DOORS_BEFORE_MINUTES; // 30
+
+// Common US timezones for selects
+COMMON_US_TIMEZONES;
+// [{ id: 'America/Los_Angeles', label: 'Pacific Time (PT)', abbr: 'PT' }, ...]
+```
+
+## Common Patterns
+
+### Event Form
+
+```typescript
+// Populating form from API response
+function populateForm(event: Event) {
+  const tz = datetime.getVenueTimezone(event.venue);
+  const start = datetime.parseDateTimeFromAPI(event.startTime, tz);
+  const end = datetime.parseDateTimeFromAPI(event.endTime, tz);
+
+  return {
+    date: start.date,
+    startTime: start.time,
+    endTime: end.time,
+  };
+}
+
+// Submitting form to API
+function submitForm(form: FormData, venue: Venue) {
+  const tz = datetime.getVenueTimezone(venue);
+
+  return {
+    startTime: datetime.combineDateAndTime(form.date, form.startTime, tz),
+    endTime: datetime.combineDateAndTime(form.date, form.endTime, tz),
+  };
+}
+```
+
+### Calendar Display
+
+```typescript
+// Display events in venue timezone
+function renderEvent(event: Event, venue: Venue) {
+  const tz = datetime.getVenueTimezone(venue);
+
+  return {
+    time: datetime.formatEventTime(event.startTime, tz),
+    date: datetime.formatEventDate(event.startTime, tz),
+    dateRange: datetime.formatTimeRange(event.startTime, event.endTime, tz),
+    dateParts: datetime.getDateParts(event.startTime, tz),
+  };
+}
+```
+
+### Grouping Events by Date
+
+```typescript
+function groupByDate(events: Event[], timezone: TimezoneId) {
+  const groups: Record<string, Event[]> = {};
+
+  for (const event of events) {
+    const dateKey = datetime.getDateInTimezone(event.startTime, timezone);
+    groups[dateKey] = groups[dateKey] || [];
+    groups[dateKey].push(event);
+  }
+
+  return groups;
+}
+```
+
+## Error Handling
+
+All functions throw `DateTimeError` for invalid inputs:
+
+```typescript
+import { DateTimeError, DateTimeErrorCode } from '$lib/datetime';
+
+try {
+  const tz = datetime.getVenueTimezone(venue);
+} catch (e) {
+  if (e instanceof DateTimeError) {
+    console.error(e.code); // DateTimeErrorCode.MISSING_TIMEZONE
+    console.error(e.message); // "Venue timezone is required"
+    console.error(e.details); // { venue: {...} }
+  }
+}
+```
+
+Error codes:
+
+- `INVALID_TIMEZONE` - Timezone string is not a valid IANA identifier
+- `INVALID_ISO_STRING` - ISO date string is malformed
+- `INVALID_DATE` - Date string is invalid
+- `INVALID_TIME` - Time string is invalid
+- `MISSING_TIMEZONE` - Required timezone is missing
+- `PARSE_ERROR` - General parsing error
+
+## Migration from Legacy Code
+
+### From `src/lib/utils/timezone.js`
+
+```typescript
+// Before
+import { localToUTC, utcToLocal, formatForDisplay } from '$lib/utils/timezone';
+
+// After
+import {
+  parseLocalToUTC,
+  parseUTCToLocal,
+  formatEventDateTime,
+} from '$lib/datetime';
+```
+
+### From `src/lib/utils/utils.js`
+
+```typescript
+// Before
+import { formatDateTime, formatTimeRange, getDay } from '$lib/utils/utils';
+
+// After
+import {
+  formatEventDateTime,
+  formatTimeRange,
+  formatDayOfWeek,
+} from '$lib/datetime';
+```
+
+## Testing
+
+Run tests:
+
+```bash
+npm run test -- src/lib/datetime
+```
+
+Run with coverage:
+
+```bash
+npm run test:coverage -- src/lib/datetime
+```
+
+Target: 100% coverage for this critical module.

package/dist/forms/createFormStore.svelte.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=createFormStore.svelte.spec.d.ts.map

package/dist/forms/createFormStore.svelte.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createFormStore.svelte.spec.d.ts","sourceRoot":"","sources":["../../src/lib/forms/createFormStore.svelte.spec.ts"],"names":[],"mappings":""}