@happyvertical/smrt-events 0.55.6 → 0.55.8

package/dist/smrt-knowledge.json

@@ -3,12 +3,12 @@
   "sensitiveFieldsExcluded": true,
   "generatedAt": "1970-01-01T00:00:00.000Z",
   "packageName": "@happyvertical/smrt-events",
-  "packageVersion": "0.55.6",
+  "packageVersion": "0.55.8",
   "sourceManifestPath": "dist/manifest.json",
   "agentDocPath": "AGENTS.md",
   "sourceHashes": {
-    "manifest": "227f731505a41fa6038dbe1b314e58665166266e46463538f502247704dd8f0d",
-    "packageJson": "55a0204a7f4311901d6a3e2b2b1faf75c12b33748efd5926d1132e721975d47d",
+    "manifest": "52a6a3c16c1e1011a0b63607b416cb93113b33d228240f8c649a42d46814d7bb",
+    "packageJson": "fca5791ba7c76ce146aa777eceaf3c482234cdb6a0283f22567a81f2320a911c",
     "agents": "fd92563513c75d3b1f4107a239a7030bbcb8ac45e0e13e87afdbbebc84b0d4be"
   },
   "exports": [
@@ -1667,53 +1667,61 @@
           "type": "text",
           "required": false,
           "columnType": "TEXT",
-          "default": ""
+          "default": "",
+          "description": "What the event is called."
         },
         {
           "name": "seriesId",
           "type": "foreignKey",
           "required": false,
           "related": "EventSeries",
-          "columnType": "UUID"
+          "columnType": "UUID",
+          "description": "The series this event is part of, if any."
         },
         {
           "name": "typeId",
           "type": "foreignKey",
           "required": false,
           "related": "EventType",
-          "columnType": "UUID"
+          "columnType": "UUID",
+          "description": "The kind of event."
         },
         {
           "name": "placeId",
           "type": "crossPackageRef",
           "required": false,
           "related": "@happyvertical/smrt-places:Place",
-          "columnType": "UUID"
+          "columnType": "UUID",
+          "description": "Where it takes place."
         },
         {
           "name": "description",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "What the event is about."
         },
         {
           "name": "startDate",
           "type": "datetime",
           "required": false,
-          "columnType": "TIMESTAMP"
+          "columnType": "TIMESTAMP",
+          "description": "When it starts."
         },
         {
           "name": "endDate",
           "type": "datetime",
           "required": false,
-          "columnType": "TIMESTAMP"
+          "columnType": "TIMESTAMP",
+          "description": "When it ends."
         },
         {
           "name": "allDay",
           "type": "boolean",
           "required": false,
           "columnType": "BOOLEAN",
-          "default": false
+          "default": false,
+          "description": "Whether the event lasts all day."
         },
         {
           "name": "timeZone",
@@ -1726,7 +1734,8 @@
           "type": "text",
           "required": false,
           "columnType": "TEXT",
-          "default": "scheduled"
+          "default": "scheduled",
+          "description": "scheduled, in progress, completed, cancelled or postponed."
         },
         {
           "name": "round",
@@ -2414,21 +2423,24 @@
           "type": "foreignKey",
           "required": false,
           "related": "Event",
-          "columnType": "UUID"
+          "columnType": "UUID",
+          "description": "The event the person takes part in."
         },
         {
           "name": "profileId",
           "type": "crossPackageRef",
           "required": false,
           "related": "@happyvertical/smrt-profiles:Profile",
-          "columnType": "UUID"
+          "columnType": "UUID",
+          "description": "The person taking part."
         },
         {
           "name": "role",
           "type": "text",
           "required": false,
           "columnType": "TEXT",
-          "default": ""
+          "default": "",
+          "description": "What they do there, for example speaker or attendee."
         },
         {
           "name": "placement",
@@ -2794,45 +2806,52 @@
           "type": "text",
           "required": false,
           "columnType": "TEXT",
-          "default": ""
+          "default": "",
+          "description": "What the series is called."
         },
         {
           "name": "typeId",
           "type": "foreignKey",
           "required": false,
           "related": "EventType",
-          "columnType": "UUID"
+          "columnType": "UUID",
+          "description": "The kind of event in this series."
         },
         {
           "name": "organizerId",
           "type": "crossPackageRef",
           "required": false,
           "related": "@happyvertical/smrt-profiles:Profile",
-          "columnType": "UUID"
+          "columnType": "UUID",
+          "description": "Who runs the series."
         },
         {
           "name": "description",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "What the series is about."
         },
         {
           "name": "startDate",
           "type": "datetime",
           "required": false,
-          "columnType": "TIMESTAMP"
+          "columnType": "TIMESTAMP",
+          "description": "When the series begins."
         },
         {
           "name": "endDate",
           "type": "datetime",
           "required": false,
-          "columnType": "TIMESTAMP"
+          "columnType": "TIMESTAMP",
+          "description": "When the series ends."
         },
         {
           "name": "recurrence",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "How often it repeats."
         },
         {
           "name": "metadata",
@@ -3232,14 +3251,16 @@
           "type": "text",
           "required": true,
           "columnType": "TEXT",
-          "default": ""
+          "default": "",
+          "description": "What this kind of event is called, for example workshop."
         },
         {
           "name": "description",
           "type": "text",
           "required": false,
           "columnType": "TEXT",
-          "default": ""
+          "default": "",
+          "description": "What this kind of event is for."
         },
         {
           "name": "schema",
@@ -5024,5 +5045,161 @@
     "polymorphicAssociations": 0,
     "uuidColumns": 40
   },
-  "agentDoc": "# @happyvertical/smrt-events\n\nInfinite-nesting event hierarchy with series, types, participants, and role/placement management.\n\n## Models\n\n- **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`.\n- **EventAsset**: dedicated owned-asset join in `event_assets` with `relationship` and `sortOrder`.\n- **EventType**: classification with JSON schema for custom fields per type.\n- **Event.allDay / Event.timeZone**: whole-day flag (`endDate` is the exclusive midnight after the last day) and IANA zone (empty = inherit). Manifest fields; consumers migrate with `db:migrate`.\n- **EventSeries**: recurrence patterns (daily/weekly/monthly/yearly). `expandRecurrence()` (`src/recurrence.ts`) / `EventSeries.getOccurrences()` expand them into instants, keeping the start's wall-clock time in the zone. Do all date math on calendar dates and convert through `Intl` at the end — never `Date#setDate`/`getDay` on host-local time (tests pin `TZ=UTC`, so host leaks only show in production).\n- **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']`.\n\n## Gotchas\n\n- **No depth limit** on event hierarchy — deep nesting can cause N+1 queries\n- **Placement is numeric**: used for both team ordering (0=home, 1=away) and rankings — context-dependent\n- **GroupId not enforced at DB level**: for logical grouping only (e.g., team members in a game)\n- **Optional tenancy** with nullable tenantId\n- **Event physical foreign keys**: `parentId`, `seriesId`, and `typeId` retain\n  PostgreSQL/SQLite constraints. DuckDB/JSON omit only those explicitly scoped\n  physical constraints because DuckDB cannot enforce Event's self-reference or\n  generated `ON UPDATE CASCADE`; UUID fields, indexes, relationship loading,\n  and application-side delete enforcement remain active on every engine.\n- **Metadata stored as JSON string** with get/set/update helpers\n- **Owned asset helpers**: use `Event.getAssets()` / `addAsset()` / `removeAsset()` or the matching `EventCollection` wrappers instead of generic `AssetAssociation`\n"
+  "agentDoc": "# @happyvertical/smrt-events\n\nInfinite-nesting event hierarchy with series, types, participants, and role/placement management.\n\n## Models\n\n- **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`.\n- **EventAsset**: dedicated owned-asset join in `event_assets` with `relationship` and `sortOrder`.\n- **EventType**: classification with JSON schema for custom fields per type.\n- **Event.allDay / Event.timeZone**: whole-day flag (`endDate` is the exclusive midnight after the last day) and IANA zone (empty = inherit). Manifest fields; consumers migrate with `db:migrate`.\n- **EventSeries**: recurrence patterns (daily/weekly/monthly/yearly). `expandRecurrence()` (`src/recurrence.ts`) / `EventSeries.getOccurrences()` expand them into instants, keeping the start's wall-clock time in the zone. Do all date math on calendar dates and convert through `Intl` at the end — never `Date#setDate`/`getDay` on host-local time (tests pin `TZ=UTC`, so host leaks only show in production).\n- **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']`.\n\n## Gotchas\n\n- **No depth limit** on event hierarchy — deep nesting can cause N+1 queries\n- **Placement is numeric**: used for both team ordering (0=home, 1=away) and rankings — context-dependent\n- **GroupId not enforced at DB level**: for logical grouping only (e.g., team members in a game)\n- **Optional tenancy** with nullable tenantId\n- **Event physical foreign keys**: `parentId`, `seriesId`, and `typeId` retain\n  PostgreSQL/SQLite constraints. DuckDB/JSON omit only those explicitly scoped\n  physical constraints because DuckDB cannot enforce Event's self-reference or\n  generated `ON UPDATE CASCADE`; UUID fields, indexes, relationship loading,\n  and application-side delete enforcement remain active on every engine.\n- **Metadata stored as JSON string** with get/set/update helpers\n- **Owned asset helpers**: use `Event.getAssets()` / `addAsset()` / `removeAsset()` or the matching `EventCollection` wrappers instead of generic `AssetAssociation`\n",
+  "recipes": [
+    {
+      "id": "events.calendar",
+      "className": "CalendarRecipe",
+      "label": "Events",
+      "summary": "Schedule events, group them in series and track who takes part.",
+      "synonyms": [
+        "calendar",
+        "schedule",
+        "meetings",
+        "bookings",
+        "attendees"
+      ],
+      "models": [
+        "@happyvertical/smrt-events:Event",
+        "@happyvertical/smrt-events:EventType",
+        "@happyvertical/smrt-events:EventSeries",
+        "@happyvertical/smrt-events:EventParticipant"
+      ],
+      "nav": [
+        {
+          "label": "Events",
+          "model": "@happyvertical/smrt-events:Event",
+          "icon": "calendar",
+          "description": "Everything on your calendar, with who and when."
+        },
+        {
+          "label": "Event types",
+          "model": "@happyvertical/smrt-events:EventType",
+          "icon": "tag",
+          "description": "The kinds of events you run, such as workshops or classes."
+        },
+        {
+          "label": "Event series",
+          "model": "@happyvertical/smrt-events:EventSeries",
+          "icon": "repeat",
+          "description": "Repeating schedules, like a class every Tuesday evening."
+        }
+      ],
+      "requires": [],
+      "section": {
+        "id": "calendar",
+        "label": "Calendar",
+        "icon": "calendar",
+        "description": "Events and what is scheduled when."
+      },
+      "options": {
+        "@happyvertical/smrt-events:Event": {
+          "fields": {
+            "parentId": {
+              "visibility": "hidden"
+            },
+            "round": {
+              "visibility": "hidden"
+            },
+            "metadata": {
+              "visibility": "hidden"
+            },
+            "externalId": {
+              "visibility": "hidden"
+            },
+            "source": {
+              "visibility": "hidden"
+            },
+            "timeZone": {
+              "visibility": "hidden"
+            }
+          }
+        },
+        "@happyvertical/smrt-events:EventType": {
+          "fields": {
+            "schema": {
+              "visibility": "hidden"
+            },
+            "participantSchema": {
+              "visibility": "hidden"
+            }
+          }
+        },
+        "@happyvertical/smrt-events:EventSeries": {
+          "fields": {
+            "metadata": {
+              "visibility": "hidden"
+            },
+            "externalId": {
+              "visibility": "hidden"
+            },
+            "source": {
+              "visibility": "hidden"
+            }
+          }
+        },
+        "@happyvertical/smrt-events:EventParticipant": {
+          "fields": {
+            "groupId": {
+              "visibility": "hidden"
+            },
+            "placement": {
+              "visibility": "hidden"
+            },
+            "metadata": {
+              "visibility": "hidden"
+            },
+            "externalId": {
+              "visibility": "hidden"
+            },
+            "source": {
+              "visibility": "hidden"
+            }
+          }
+        }
+      },
+      "help": {
+        "markdown": "## Overview\n\nEvents is your calendar. Each event has a time and a type, can belong to a\nseries, and lists who takes part.\n\n## Tasks\n\n### Schedule an event\n\n1. Create a new event.\n2. Enter the **{field:name}**, the **{field:startDate}** and the\n   **{field:endDate}**.\n3. Pick the **{field:typeId}**, and the **{field:seriesId}** if it repeats.\n4. Add the people taking part with their **{field:role}**.\n\n### Keep it current\n\n1. Update **{field:status}** as the event goes ahead, finishes or is postponed.\n",
+        "fieldRefs": [
+          "endDate",
+          "name",
+          "role",
+          "seriesId",
+          "startDate",
+          "status",
+          "typeId"
+        ]
+      },
+      "surfaces": [
+        {
+          "kind": "route",
+          "path": "/events/meeting",
+          "export": "@happyvertical/smrt-events/svelte#MeetingView",
+          "label": "Meeting view"
+        }
+      ],
+      "runtime": "both",
+      "demo": {
+        "mode": "server",
+        "reasons": [
+          "Needs a server because its package does not build for a browser: node:crypto; and its package depends on @happyvertical/smrt-places, @happyvertical/smrt-profiles, @happyvertical/smrt-tenancy, which do not build for a browser (#3617, #3624, #3626, #3627)."
+        ]
+      }
+    }
+  ],
+  "browser": {
+    "status": "server-only",
+    "issues": [
+      "#3617",
+      "#3624",
+      "#3626",
+      "#3627"
+    ],
+    "reason": "node:crypto",
+    "via": [
+      "@happyvertical/smrt-places",
+      "@happyvertical/smrt-profiles",
+      "@happyvertical/smrt-tenancy"
+    ]
+  }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@happyvertical/smrt-events",
-  "version": "0.55.6",
+  "version": "0.55.8",
   "smrtJsdoc": "strict",
   "description": "Hierarchical event management with participant tracking and SMRT framework support",
   "type": "module",
@@ -45,22 +45,22 @@
     }
   },
   "dependencies": {
-    "@happyvertical/ai": "^0.102.4",
-    "@happyvertical/files": "^0.102.4",
+    "@happyvertical/ai": "^0.103.1",
+    "@happyvertical/files": "^0.103.1",
     "@happyvertical/icalendar": "^0.100.2",
-    "@happyvertical/logger": "^0.102.4",
-    "@happyvertical/smrt-assets": "0.55.6",
-    "@happyvertical/smrt-core": "0.55.6",
-    "@happyvertical/smrt-places": "0.55.6",
-    "@happyvertical/smrt-profiles": "0.55.6",
-    "@happyvertical/smrt-tenancy": "0.55.6",
-    "@happyvertical/smrt-types": "0.55.6",
-    "@happyvertical/smrt-ui": "0.55.6",
-    "@happyvertical/sql": "^0.102.4",
-    "@happyvertical/utils": "^0.102.4"
+    "@happyvertical/logger": "^0.103.1",
+    "@happyvertical/smrt-assets": "0.55.8",
+    "@happyvertical/smrt-core": "0.55.8",
+    "@happyvertical/smrt-places": "0.55.8",
+    "@happyvertical/smrt-profiles": "0.55.8",
+    "@happyvertical/smrt-tenancy": "0.55.8",
+    "@happyvertical/smrt-types": "0.55.8",
+    "@happyvertical/smrt-ui": "0.55.8",
+    "@happyvertical/sql": "^0.103.1",
+    "@happyvertical/utils": "^0.103.1"
   },
   "devDependencies": {
-    "@happyvertical/smrt-vitest": "0.55.6",
+    "@happyvertical/smrt-vitest": "0.55.8",
     "@sveltejs/package": "^2.5.8",
     "@sveltejs/vite-plugin-svelte": "^7.3.0",
     "@types/node": "24.13.6",