@happyvertical/smrt-events 0.42.7 → 0.43.1

package/dist/smrt-knowledge.json

@@ -3,13 +3,13 @@
   "sensitiveFieldsExcluded": true,
   "generatedAt": "1970-01-01T00:00:00.000Z",
   "packageName": "@happyvertical/smrt-events",
-  "packageVersion": "0.42.7",
+  "packageVersion": "0.43.1",
   "sourceManifestPath": "dist/manifest.json",
   "agentDocPath": "AGENTS.md",
   "sourceHashes": {
-    "manifest": "8812cf84641856dac76dfaef4cfed1549c2224251c802f7a2029913bef140520",
-    "packageJson": "11845fcbc4feca79259fc97519ad344a8dfb587da7776bfd1317b442f4d4abbd",
-    "agents": "297e9ee2a72287267bf9774c77587203db5215951075847172ebb012345f599e"
+    "manifest": "eaf1a919c3092fedccf0527bef2fdf7bf59e62ce475020ec3f92205e44649ec4",
+    "packageJson": "21186a724b16c35ac045f3e9e4daf0586b298e34d4168da2576d32857ca57c65",
+    "agents": "c020c54c72cc890a8fccc8d784f0fde9edde4b62df91a038b401de97c2ce47cf"
   },
   "exports": [
     ".",
@@ -867,7 +867,8 @@
         "toPlainObject",
         "toPublicJSON",
         "updateMetadata",
-        "updateStatus"
+        "updateStatus",
+        "withDatabase"
       ],
       "methodSignatures": [
         {
@@ -1252,6 +1253,15 @@
             "newStatus: EventStatus"
           ],
           "returns": "Promise<void>"
+        },
+        {
+          "name": "withDatabase",
+          "async": true,
+          "params": [
+            "db: DatabaseInterface",
+            "operation: Function"
+          ],
+          "returns": "Promise<T>"
         }
       ],
       "tenant": {
@@ -1878,7 +1888,8 @@
         "toJSON",
         "toPlainObject",
         "toPublicJSON",
-        "updateMetadata"
+        "updateMetadata",
+        "withDatabase"
       ],
       "methodSignatures": [
         {
@@ -2192,6 +2203,15 @@
             "updates: Record<string>"
           ],
           "returns": "void"
+        },
+        {
+          "name": "withDatabase",
+          "async": true,
+          "params": [
+            "db: DatabaseInterface",
+            "operation: Function"
+          ],
+          "returns": "Promise<T>"
         }
       ],
       "tenant": {
@@ -2424,7 +2444,8 @@
         "summarizeAiUsage",
         "toJSON",
         "toPlainObject",
-        "toPublicJSON"
+        "toPublicJSON",
+        "withDatabase"
       ],
       "methodSignatures": [
         {
@@ -2721,6 +2742,15 @@
             "options?: PublicJsonOptions"
           ],
           "returns": "Record<string>"
+        },
+        {
+          "name": "withDatabase",
+          "async": true,
+          "params": [
+            "db: DatabaseInterface",
+            "operation: Function"
+          ],
+          "returns": "Promise<T>"
         }
       ],
       "tenant": {
@@ -3213,5 +3243,5 @@
     "polymorphicAssociations": 0,
     "uuidColumns": 25
   },
-  "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- **EventSeries**: recurrence patterns (daily/weekly/monthly/yearly).\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- **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- **EventSeries**: recurrence patterns (daily/weekly/monthly/yearly).\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"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@happyvertical/smrt-events",
-  "version": "0.42.7",
+  "version": "0.43.1",
   "description": "Hierarchical event management with participant tracking and SMRT framework support",
   "type": "module",
   "main": "./dist/index.js",
@@ -49,13 +49,13 @@
     "@happyvertical/logger": "^0.88.0",
     "@happyvertical/sql": "^0.88.0",
     "@happyvertical/utils": "^0.88.0",
-    "@happyvertical/smrt-profiles": "0.42.7",
-    "@happyvertical/smrt-assets": "0.42.7",
-    "@happyvertical/smrt-places": "0.42.7",
-    "@happyvertical/smrt-types": "0.42.7",
-    "@happyvertical/smrt-ui": "0.42.7",
-    "@happyvertical/smrt-core": "0.42.7",
-    "@happyvertical/smrt-tenancy": "0.42.7"
+    "@happyvertical/smrt-assets": "0.43.1",
+    "@happyvertical/smrt-core": "0.43.1",
+    "@happyvertical/smrt-profiles": "0.43.1",
+    "@happyvertical/smrt-tenancy": "0.43.1",
+    "@happyvertical/smrt-types": "0.43.1",
+    "@happyvertical/smrt-ui": "0.43.1",
+    "@happyvertical/smrt-places": "0.43.1"
   },
   "devDependencies": {
     "@sveltejs/package": "^2.5.8",
@@ -67,7 +67,7 @@
     "typescript": "5.9.3",
     "vite": "8.1.4",
     "vitest": "4.1.10",
-    "@happyvertical/smrt-vitest": "0.42.7"
+    "@happyvertical/smrt-vitest": "0.43.1"
   },
   "keywords": [
     "events",