@happyvertical/smrt-events 0.30.0

package/AGENTS.md

@@ -0,0 +1,20 @@
+# @happyvertical/smrt-events
+
+Infinite-nesting event hierarchy with series, types, participants, and role/placement management.
+
+## Models
+
+- **Event** (STI, extends `SmrtHierarchical`): self-referencing parent-child via `parentId` (UUID). Links to `seriesId`, `typeId`, `placeId`. Status: scheduled/in_progress/completed/cancelled/postponed. Hierarchy traversal (`getParent()`, `getChildren()`, `getAncestors()`, `getDescendants()`, `getHierarchy()`, `moveTo()`) is provided by `SmrtHierarchical`; `getRootEvent()` and `isRoot()` remain on `Event`.
+- **EventAsset**: dedicated owned-asset join in `event_assets` with `relationship` and `sortOrder`.
+- **EventType**: classification with JSON schema for custom fields per type.
+- **EventSeries**: recurrence patterns (daily/weekly/monthly/yearly).
+- **EventParticipant**: junction with `role` (home/away/speaker/panelist/etc.), `placement` (numeric — team ordering and rankings), `groupId` (team grouping within event). `conflictColumns: ['event_id', 'profile_id', 'role']`.
+
+## Gotchas
+
+- **No depth limit** on event hierarchy — deep nesting can cause N+1 queries
+- **Placement is numeric**: used for both team ordering (0=home, 1=away) and rankings — context-dependent
+- **GroupId not enforced at DB level**: for logical grouping only (e.g., team members in a game)
+- **Optional tenancy** with nullable tenantId
+- **Metadata stored as JSON string** with get/set/update helpers
+- **Owned asset helpers**: use `Event.getAssets()` / `addAsset()` / `removeAsset()` or the matching `EventCollection` wrappers instead of generic `AssetAssociation`

package/CLAUDE.md

@@ -0,0 +1 @@
+@AGENTS.md

package/LICENSE

@@ -0,0 +1,7 @@
+Copyright <2025> <Happy Vertical Corporation>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,151 @@
+# @happyvertical/smrt-events
+
+Infinite-nesting event hierarchy with series, participant tracking, and recurrence patterns. Events can model anything from conferences with sessions to sports games with periods and goals.
+
+## Installation
+
+```bash
+pnpm add @happyvertical/smrt-events
+```
+
+## Usage
+
+### Hierarchical events with participants
+
+```typescript
+import { EventCollection, EventSeriesCollection, EventParticipantCollection } from '@happyvertical/smrt-events';
+
+const events = await EventCollection.create();
+
+// Create a game with nested periods
+const game = await events.create({
+  name: 'Lakers vs Warriors',
+  slug: 'lakers-warriors-2024-01-20',
+  startDate: new Date('2024-01-20T19:30:00'),
+  endDate: new Date('2024-01-20T22:00:00'),
+  status: 'scheduled',
+  placeId: 'arena-id', // plain string FK to smrt-places
+});
+
+const quarter = await events.create({
+  name: '1st Quarter',
+  parentId: game.id, // infinite nesting (via SmrtHierarchical)
+  startDate: new Date('2024-01-20T19:30:00'),
+});
+
+// Hierarchy traversal
+const hierarchy = await quarter.getHierarchy();
+console.log(hierarchy.ancestors.map(e => e.name)); // ['Lakers vs Warriors']
+
+// Add participants with roles and placement
+const participants = await EventParticipantCollection.create();
+await participants.create({
+  eventId: game.id,
+  profileId: 'lakers-id', // plain string FK to smrt-profiles
+  role: 'home',
+  placement: 0,
+});
+
+// Recurring series
+const series = await EventSeriesCollection.create();
+await series.create({
+  name: 'Weekly Standup',
+  slug: 'weekly-standup-2024',
+  recurrence: { frequency: 'weekly', interval: 1, byDay: ['MO', 'WE', 'FR'] },
+});
+```
+
+### Owned assets
+
+```typescript
+import { AssetCollection } from '@happyvertical/smrt-assets';
+
+const assets = await AssetCollection.create();
+const hero = await assets.create({
+  name: 'launch-poster.jpg',
+  sourceUri: 'file:///tmp/launch-poster.jpg',
+  mimeType: 'image/jpeg',
+});
+
+await game.addAsset(hero, 'hero');
+await events.addAsset(game.id!, hero, 'gallery', 1);
+
+const heroAssets = await game.getAssets('hero');
+const galleryAssets = await events.getAssets(game.id!, 'gallery');
+```
+
+## API
+
+### Models
+
+| Export | Description |
+|--------|------------|
+| `Event` | Hierarchical event with status lifecycle, STI enabled. Links to series, type, place via string IDs |
+| `EventSeries` | Recurring event group with recurrence patterns (daily/weekly/monthly/yearly) |
+| `EventType` | Classification with JSON schema for custom fields per type |
+| `EventParticipant` | Junction linking profiles to events with role, placement, and groupId |
+| `EventAsset` | Dedicated owned-asset join stored in `event_assets` with `relationship` and `sortOrder` |
+
+### Collections
+
+| Export | Description |
+|--------|------------|
+| `EventCollection` | CRUD + hierarchy traversal for events |
+| `EventAssetCollection` | Direct access to `event_assets` rows plus asset helper wrappers |
+| `EventSeriesCollection` | CRUD for event series |
+| `EventTypeCollection` | CRUD for event types |
+| `EventParticipantCollection` | CRUD for participants (conflictColumns: event_id, profile_id, role) |
+
+### Types
+
+| Export | Description |
+|--------|------------|
+| `EventOptions`, `EventSeriesOptions`, `EventTypeOptions`, `EventParticipantOptions` | Creation option types for each model |
+| `EventStatus` | `'scheduled' \| 'in_progress' \| 'completed' \| 'cancelled' \| 'postponed'` |
+| `ParticipantRole` | Role values (speaker, home, away, organizer, etc.) |
+| `RecurrenceFrequency` | `'daily' \| 'weekly' \| 'monthly' \| 'yearly'` |
+| `RecurrencePattern` | Recurrence definition with count, until, byDay, byMonth filters |
+| `EventSearchFilters`, `EventSeriesSearchFilters`, `ParticipantSearchFilters` | Query filter types |
+
+### Utilities
+
+| Export | Description |
+|--------|------------|
+| `formatEventDateRange` | Format start/end dates as human-readable string |
+| `generateEventSlug` | Create URL-friendly slug from name + date |
+| `checkSchedulingConflict` | Detect overlapping time ranges |
+| `calculateDuration` | Duration in milliseconds between two dates |
+| `formatDuration` | Human-readable duration (e.g., "2h 30m") |
+| `isEventNow` | Check if event is currently in progress |
+| `getEventStatusFromDates` | Auto-detect status from start/end dates |
+| `sortEventsByDate` | Sort events chronologically |
+| `validateEventStatus` | Validate status transition is allowed |
+| `calculateNextOccurrence` | Next date for a recurrence pattern |
+| `parseRecurrencePattern` | Parse recurrence from string or object |
+
+### UI Metadata
+
+| Export | Description |
+|--------|------------|
+| `EVENTS_MODULE_META` | Module metadata for UI registration |
+| `EVENTS_UI_SLOTS` | UI slot definitions for the events module |
+
+### Instance Methods (Event)
+
+`getParent()`, `getChildren()`, `getAncestors()`, `getDescendants()`, `getRootEvent()`, `getHierarchy()` -- hierarchy traversal on any Event instance.
+
+Owned asset helpers are available on both `Event` and `EventCollection` via
+`getAssets()`, `addAsset()`, and `removeAsset()`. Common relationships include
+`hero`, `gallery`, `attachment`, and `thumbnail`.
+
+## Dependencies
+
+| Package | Purpose |
+|---------|---------|
+| `@happyvertical/smrt-core` | SmrtObject/SmrtCollection base classes |
+| `@happyvertical/smrt-tenancy` | Optional tenant scoping |
+| `@happyvertical/smrt-places` | Place references (cross-package string FKs) |
+| `@happyvertical/smrt-profiles` | Participant profile references (cross-package string FKs) |
+| `@happyvertical/smrt-types` | Shared TypeScript types |
+| `@happyvertical/sql` | Database operations |
+| `@happyvertical/ai` | AI integration |

package/dist/__smrt-register__.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=__smrt-register__.d.ts.map

package/dist/__smrt-register__.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"__smrt-register__.d.ts","sourceRoot":"","sources":["../src/__smrt-register__.ts"],"names":[],"mappings":""}

package/dist/collections/EventAssetCollection.d.ts

@@ -0,0 +1,16 @@
+import { Asset } from '@happyvertical/smrt-assets';
+import { SmrtCollectionOptions, SmrtJunction } from '@happyvertical/smrt-core';
+import { EventAsset } from '../models/EventAsset';
+export interface EventAssetCollectionOptions extends SmrtCollectionOptions {
+}
+export declare class EventAssetCollection extends SmrtJunction<EventAsset> {
+    static readonly _itemClass: typeof EventAsset;
+    protected leftField: string;
+    protected rightField: string;
+    private eventCollectionPromise;
+    private getEventCollection;
+    getAssets(eventId: string, relationship?: string): Promise<Asset[]>;
+    addAsset(eventId: string, asset: Asset, relationship?: string, sortOrder?: number): Promise<void>;
+    removeAsset(eventId: string, assetId: string, relationship?: string): Promise<void>;
+}
+//# sourceMappingURL=EventAssetCollection.d.ts.map

package/dist/collections/EventAssetCollection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventAssetCollection.d.ts","sourceRoot":"","sources":["../../src/collections/EventAssetCollection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,4BAA4B,CAAC;AAMxD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAE,YAAY,EAAQ,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAGlD,MAAM,WAAW,2BAA4B,SAAQ,qBAAqB;CAAG;AAE7E,qBAKa,oBAAqB,SAAQ,YAAY,CAAC,UAAU,CAAC;IAChE,MAAM,CAAC,QAAQ,CAAC,UAAU,oBAAc;IACxC,SAAS,CAAC,SAAS,SAAa;IAChC,SAAS,CAAC,UAAU,SAAa;IAEjC,OAAO,CAAC,sBAAsB,CAAyC;YAEzD,kBAAkB;IAS1B,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAQnE,QAAQ,CACZ,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,KAAK,EACZ,YAAY,SAAe,EAC3B,SAAS,SAAI,GACZ,OAAO,CAAC,IAAI,CAAC;IAWV,WAAW,CACf,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,IAAI,CAAC;CASjB"}

package/dist/collections/EventCollection.d.ts

@@ -0,0 +1,108 @@
+import { Asset } from '@happyvertical/smrt-assets';
+import { SmrtCollection } from '@happyvertical/smrt-core';
+import { Event } from '../models/Event';
+import { EventSearchFilters, EventStatus } from '../types';
+export declare class EventCollection extends SmrtCollection<Event> {
+    static readonly _itemClass: typeof Event;
+    /**
+     * Get events by series
+     *
+     * @param seriesId - EventSeries ID
+     * @returns Array of Event instances
+     */
+    getBySeriesId(seriesId: string): Promise<Event[]>;
+    /**
+     * Get events at a specific place
+     *
+     * @param placeId - Place ID
+     * @returns Array of Event instances
+     */
+    getByPlace(placeId: string): Promise<Event[]>;
+    /**
+     * Get events by date range
+     *
+     * @param startDate - Start of date range
+     * @param endDate - End of date range
+     * @returns Array of Event instances
+     */
+    getByDateRange(startDate: Date, endDate: Date): Promise<Event[]>;
+    /**
+     * Get upcoming events
+     *
+     * @param limit - Maximum number of events to return
+     * @returns Array of Event instances starting in the future
+     */
+    getUpcoming(limit?: number): Promise<Event[]>;
+    /**
+     * Get events by status
+     *
+     * @param status - Event status to filter by
+     * @returns Array of Event instances
+     */
+    getByStatus(status: EventStatus): Promise<Event[]>;
+    /**
+     * Get events by type
+     *
+     * @param typeId - EventType ID
+     * @returns Array of Event instances
+     */
+    getByType(typeId: string): Promise<Event[]>;
+    /**
+     * Get root events (no parent)
+     *
+     * @returns Array of Event instances with no parent
+     */
+    getRootEvents(): Promise<Event[]>;
+    /**
+     * Get children of a parent event
+     *
+     * @param parentId - Parent event ID
+     * @returns Array of child Event instances
+     */
+    getByParent(parentId: string): Promise<Event[]>;
+    /**
+     * Get full event tree (hierarchy)
+     *
+     * @param eventId - Root event ID
+     * @returns Object with root event and nested children
+     */
+    getEventTree(eventId: string): Promise<Event | null>;
+    getAssets(eventId: string, relationship?: string): Promise<Asset[]>;
+    addAsset(eventId: string, asset: Asset, relationship?: string, sortOrder?: number): Promise<void>;
+    removeAsset(eventId: string, assetId: string, relationship?: string): Promise<void>;
+    /**
+     * Search events with filters
+     *
+     * @param query - Search query for name/description
+     * @param filters - Additional filter criteria
+     * @returns Array of matching Event instances
+     */
+    search(query: string, filters?: EventSearchFilters): Promise<Event[]>;
+    /**
+     * Get events in progress
+     *
+     * @returns Array of Event instances currently in progress
+     */
+    getInProgress(): Promise<Event[]>;
+    /**
+     * Find all events for a specific tenant
+     *
+     * @param tenantId - Tenant ID to filter by
+     * @returns Array of Event instances for the tenant
+     */
+    findByTenant(tenantId: string): Promise<Event[]>;
+    /**
+     * Find all global events (no tenant association)
+     *
+     * @returns Array of Event instances with no tenant
+     */
+    findGlobal(): Promise<Event[]>;
+    /**
+     * Find events for a tenant including global events
+     *
+     * @param tenantId - Tenant ID to filter by
+     * @returns Array of Event instances for the tenant and global events
+     */
+    findWithGlobals(tenantId: string): Promise<Event[]>;
+}
+//# sourceMappingURL=EventCollection.d.ts.map

package/dist/collections/EventCollection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventCollection.d.ts","sourceRoot":"","sources":["../../src/collections/EventCollection.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,4BAA4B,CAAC;AAMxD,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AACxC,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEhE,qBAAa,eAAgB,SAAQ,cAAc,CAAC,KAAK,CAAC;IACxD,MAAM,CAAC,QAAQ,CAAC,UAAU,eAAS;IAEnC;;;;;OAKG;IACG,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAIvD;;;;;OAKG;IACG,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAInD;;;;;;OAMG;IACG,cAAc,CAAC,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAStE;;;;;OAKG;IACG,WAAW,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAcnD;;;;;OAKG;IACG,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAIxD;;;;;OAKG;IACG,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAIjD;;;;OAIG;IACG,aAAa,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;IAKvC;;;;;OAKG;IACG,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAIrD;;;;;OAKG;IACG,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;IAOpD,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAInE,QAAQ,CACZ,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,KAAK,EACZ,YAAY,SAAe,EAC3B,SAAS,SAAI,GACZ,OAAO,CAAC,IAAI,CAAC;IAWV,WAAW,CACf,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,IAAI,CAAC;IAUhB;;;;;;OAMG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAmD3E;;;;OAIG;IACG,aAAa,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;IASvC;;;;;OAKG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAItD;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;IAIpC;;;;;OAKG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;CAM1D"}

package/dist/collections/EventParticipantCollection.d.ts

@@ -0,0 +1,42 @@
+import { SmrtJunction } from '@happyvertical/smrt-core';
+import { EventParticipant } from '../models/EventParticipant';
+import { ParticipantSearchFilters } from '../types';
+export declare class EventParticipantCollection extends SmrtJunction<EventParticipant> {
+    static readonly _itemClass: typeof EventParticipant;
+    protected leftField: string;
+    protected rightField: string;
+    protected sortField: string | null;
+    protected positionField: string | null;
+    /**
+     * Get participants ordered by placement (nulls last).
+     */
+    getByPlacement(eventId: string): Promise<EventParticipant[]>;
+    /**
+     * Get participants by group within an event.
+     */
+    getByGroup(eventId: string, groupId: string): Promise<EventParticipant[]>;
+    /**
+     * Get the home participant(s) — placement = 0.
+     */
+    getHome(eventId: string): Promise<EventParticipant[]>;
+    /**
+     * Get the away participant(s) — placement = 1.
+     */
+    getAway(eventId: string): Promise<EventParticipant[]>;
+    /**
+     * Search participants with optional filters.
+     */
+    search(filters: ParticipantSearchFilters): Promise<EventParticipant[]>;
+    /**
+     * Get participation statistics for a profile, optionally filtered by event type.
+     */
+    getParticipantStats(profileId: string, eventTypeId?: string): Promise<{
+        totalEvents: number;
+        byRole: Record<string, number>;
+        byPlacement: Record<number, number>;
+    }>;
+    findByTenant(tenantId: string): Promise<EventParticipant[]>;
+    findGlobal(): Promise<EventParticipant[]>;
+    findWithGlobals(tenantId: string): Promise<EventParticipant[]>;
+}
+//# sourceMappingURL=EventParticipantCollection.d.ts.map

package/dist/collections/EventParticipantCollection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventParticipantCollection.d.ts","sourceRoot":"","sources":["../../src/collections/EventParticipantCollection.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAQ,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAC;AAIzD,qBACa,0BAA2B,SAAQ,YAAY,CAAC,gBAAgB,CAAC;IAC5E,MAAM,CAAC,QAAQ,CAAC,UAAU,0BAAoB;IAC9C,SAAS,CAAC,SAAS,SAAa;IAChC,SAAS,CAAC,UAAU,SAAe;IAGnC,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAQ;IAC1C,SAAS,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAQ;IAM9C;;OAEG;IACG,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAWlE;;OAEG;IACG,UAAU,CACd,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAI9B;;OAEG;IACG,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAI3D;;OAEG;IACG,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAI3D;;OAEG;IACG,MAAM,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAqB5E;;OAEG;IACG,mBAAmB,CACvB,SAAS,EAAE,MAAM,EACjB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC;QACT,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC/B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACrC,CAAC;IAqCI,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAI3D,UAAU,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAIzC,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;CAMrE"}

package/dist/collections/EventSeriesCollection.d.ts

@@ -0,0 +1,62 @@
+import { SmrtCollection } from '@happyvertical/smrt-core';
+import { EventSeries } from '../models/EventSeries';
+import { EventSeriesSearchFilters } from '../types';
+export declare class EventSeriesCollection extends SmrtCollection<EventSeries> {
+    static readonly _itemClass: typeof EventSeries;
+    /**
+     * Get series by organizer
+     *
+     * @param organizerId - Profile ID of the organizer
+     * @returns Array of EventSeries instances
+     */
+    getByOrganizer(organizerId: string): Promise<EventSeries[]>;
+    /**
+     * Get currently active series
+     *
+     * @returns Array of EventSeries instances active today
+     */
+    getActive(): Promise<EventSeries[]>;
+    /**
+     * Get upcoming series
+     *
+     * @param limit - Maximum number of series to return
+     * @returns Array of EventSeries instances starting in the future
+     */
+    getUpcoming(limit?: number): Promise<EventSeries[]>;
+    /**
+     * Get series by type
+     *
+     * @param typeId - EventType ID
+     * @returns Array of EventSeries instances
+     */
+    getByType(typeId: string): Promise<EventSeries[]>;
+    /**
+     * Search series with filters
+     *
+     * @param query - Search query for name/description
+     * @param filters - Additional filter criteria
+     * @returns Array of matching EventSeries instances
+     */
+    search(query: string, filters?: EventSeriesSearchFilters): Promise<EventSeries[]>;
+    /**
+     * Find all event series for a specific tenant
+     *
+     * @param tenantId - Tenant ID to filter by
+     * @returns Array of EventSeries instances for the tenant
+     */
+    findByTenant(tenantId: string): Promise<EventSeries[]>;
+    /**
+     * Find all global event series (no tenant association)
+     *
+     * @returns Array of EventSeries instances with no tenant
+     */
+    findGlobal(): Promise<EventSeries[]>;
+    /**
+     * Find event series for a tenant including global series
+     *
+     * @param tenantId - Tenant ID to filter by
+     * @returns Array of EventSeries instances for the tenant and global series
+     */
+    findWithGlobals(tenantId: string): Promise<EventSeries[]>;
+}
+//# sourceMappingURL=EventSeriesCollection.d.ts.map

package/dist/collections/EventSeriesCollection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventSeriesCollection.d.ts","sourceRoot":"","sources":["../../src/collections/EventSeriesCollection.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAC;AAEzD,qBAAa,qBAAsB,SAAQ,cAAc,CAAC,WAAW,CAAC;IACpE,MAAM,CAAC,QAAQ,CAAC,UAAU,qBAAe;IAEzC;;;;;OAKG;IACG,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAIjE;;;;OAIG;IACG,SAAS,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAWzC;;;;;OAKG;IACG,WAAW,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAczD;;;;;OAKG;IACG,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAIvD;;;;;;OAMG;IACG,MAAM,CACV,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,wBAAwB,GACjC,OAAO,CAAC,WAAW,EAAE,CAAC;IAsCzB;;;;;OAKG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAI5D;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAI1C;;;;;OAKG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;CAMhE"}

package/dist/collections/EventTypeCollection.d.ts

@@ -0,0 +1,53 @@
+import { SmrtCollection } from '@happyvertical/smrt-core';
+import { EventType } from '../models/EventType';
+export declare class EventTypeCollection extends SmrtCollection<EventType> {
+    static readonly _itemClass: typeof EventType;
+    /**
+     * Get or create an event type by slug
+     *
+     * @param slug - EventType slug (e.g., 'basketball-game', 'concert')
+     * @param name - Optional display name (defaults to capitalized slug)
+     * @returns EventType instance
+     */
+    getOrCreate(slug: string, name?: string): Promise<EventType>;
+    /**
+     * Get an event type by slug
+     *
+     * @param slug - EventType slug to search for
+     * @returns EventType instance or null if not found
+     */
+    getBySlug(slug: string): Promise<EventType | null>;
+    /**
+     * Initialize default event types
+     *
+     * Creates common event types if they don't exist:
+     * - Sports: game, period, goal, assist, penalty
+     * - Entertainment: concert, performance, song
+     * - Professional: conference, session, presentation, workshop
+     * - Community: meeting, agenda-item, motion, vote
+     *
+     * @returns Array of created/existing event types
+     */
+    initializeDefaults(): Promise<EventType[]>;
+    /**
+     * Find all event types for a specific tenant
+     *
+     * @param tenantId - Tenant ID to filter by
+     * @returns Array of EventType instances for the tenant
+     */
+    findByTenant(tenantId: string): Promise<EventType[]>;
+    /**
+     * Find all global event types (no tenant association)
+     *
+     * @returns Array of EventType instances with no tenant
+     */
+    findGlobal(): Promise<EventType[]>;
+    /**
+     * Find event types for a tenant including global types
+     *
+     * @param tenantId - Tenant ID to filter by
+     * @returns Array of EventType instances for the tenant and global types
+     */
+    findWithGlobals(tenantId: string): Promise<EventType[]>;
+}
+//# sourceMappingURL=EventTypeCollection.d.ts.map

package/dist/collections/EventTypeCollection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventTypeCollection.d.ts","sourceRoot":"","sources":["../../src/collections/EventTypeCollection.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEhD,qBAAa,mBAAoB,SAAQ,cAAc,CAAC,SAAS,CAAC;IAChE,MAAM,CAAC,QAAQ,CAAC,UAAU,mBAAa;IAEvC;;;;;;OAMG;IACG,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAkBlE;;;;;OAKG;IACG,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAIxD;;;;;;;;;;OAUG;IACG,kBAAkB,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IA0DhD;;;;;OAKG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAI1D;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAIxC;;;;;OAKG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;CAM9D"}

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+export { EventAssetCollection } from './collections/EventAssetCollection';
+export { EventCollection } from './collections/EventCollection';
+export { EventParticipantCollection } from './collections/EventParticipantCollection';
+export { EventSeriesCollection } from './collections/EventSeriesCollection';
+export { EventTypeCollection } from './collections/EventTypeCollection';
+export { Event } from './models/Event';
+export type { EventAssetOptions } from './models/EventAsset';
+export { EventAsset } from './models/EventAsset';
+export { EventParticipant } from './models/EventParticipant';
+export { EventSeries } from './models/EventSeries';
+export { EventType } from './models/EventType';
+export type { EventOptions, EventParticipantOptions, EventSearchFilters, EventSeriesOptions, EventSeriesSearchFilters, EventStatus, EventTypeOptions, ParticipantRole, ParticipantSearchFilters, RecurrenceFrequency, RecurrencePattern, } from './types';
+export { EVENTS_MODULE_META, EVENTS_UI_SLOTS } from './ui';
+export { calculateDuration, calculateNextOccurrence, checkSchedulingConflict, formatDuration, formatEventDateRange, generateEventSlug, getEventStatusFromDates, isEventNow, parseRecurrencePattern, sortEventsByDate, validateEventStatus, } from './utils';
+//# 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;;;;;;GAMG;AAKH,OAAO,wBAAwB,CAAC;AAEhC,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,0BAA0B,EAAE,MAAM,0CAA0C,CAAC;AACtF,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAE5E,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AACxE,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,YAAY,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEnD,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAG/C,YAAY,EACV,YAAY,EACZ,uBAAuB,EACvB,kBAAkB,EAClB,kBAAkB,EAClB,wBAAwB,EACxB,WAAW,EACX,gBAAgB,EAChB,eAAe,EACf,wBAAwB,EACxB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,MAAM,CAAC;AAE3D,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,uBAAuB,EACvB,cAAc,EACd,oBAAoB,EACpB,iBAAiB,EACjB,uBAAuB,EACvB,UAAU,EACV,sBAAsB,EACtB,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,SAAS,CAAC"}