@almadar/runtime 1.0.0 → 1.0.1

package/dist/{OrbitalServerRuntime-COj7K1yM.d.ts → OrbitalServerRuntime-W9FnSt1J.d.ts}

@@ -1,5 +1,5 @@
 import { Router } from 'express';
-import { I as IEventBus, R as RuntimeEvent, e as EventListener, U as Unsubscribe, E as EffectHandlers, d as Effect, T as TraitState } from './types-JFCKD0FU.js';
+import { I as IEventBus, R as RuntimeEvent, e as EventListener, U as Unsubscribe, E as EffectHandlers, d as Effect, T as TraitState } from './types-LiBPiu-u.js';
 import { OrbitalSchema, Orbital, Trait } from '@almadar/core';
 
 /**
@@ -689,6 +689,17 @@ declare class OrbitalServerRuntime {
      * Execute effects from a transition
      */
     private executeEffects;
+    /**
+     * Populate relation fields on entities
+     *
+     * For each field in `include`, find the relation field configuration and
+     * fetch the related entity, attaching it to the parent entity.
+     *
+     * @param entities - Entities to populate
+     * @param entityType - Entity type name
+     * @param include - Relation field names to populate
+     */
+    private populateRelations;
     /**
      * Create Express router for orbital API endpoints
      *

package/dist/OrbitalServerRuntime.d.ts

@@ -1,4 +1,4 @@
 import 'express';
-export { n as EffectResult, L as LoaderConfig, O as OrbitalEventRequest, c as OrbitalEventResponse, o as OrbitalServerRuntime, d as OrbitalServerRuntimeConfig, P as PersistenceAdapter, R as RuntimeOrbital, h as RuntimeOrbitalSchema, i as RuntimeTrait, q as RuntimeTraitTick, r as createOrbitalServerRuntime } from './OrbitalServerRuntime-COj7K1yM.js';
-import './types-JFCKD0FU.js';
+export { n as EffectResult, L as LoaderConfig, O as OrbitalEventRequest, c as OrbitalEventResponse, o as OrbitalServerRuntime, d as OrbitalServerRuntimeConfig, P as PersistenceAdapter, R as RuntimeOrbital, h as RuntimeOrbitalSchema, i as RuntimeTrait, q as RuntimeTraitTick, r as createOrbitalServerRuntime } from './OrbitalServerRuntime-W9FnSt1J.js';
+import './types-LiBPiu-u.js';
 import '@almadar/core';

package/dist/OrbitalServerRuntime.js

@@ -2988,12 +2988,16 @@ var OrbitalServerRuntime = class {
       },
       fetch: async (fetchEntityType, options) => {
         try {
+          let result = null;
           if (options?.id) {
             const entity = await this.persistence.getById(fetchEntityType, options.id);
             if (entity) {
+              if (options?.include && options.include.length > 0) {
+                await this.populateRelations([entity], fetchEntityType, options.include);
+              }
               fetchedData[fetchEntityType] = [entity];
+              result = entity;
             }
-            return entity;
           } else {
             let entities = await this.persistence.list(fetchEntityType);
             if (options?.offset && options.offset > 0) {
@@ -3002,9 +3006,13 @@ var OrbitalServerRuntime = class {
             if (options?.limit && options.limit > 0) {
               entities = entities.slice(0, options.limit);
             }
+            if (options?.include && options.include.length > 0) {
+              await this.populateRelations(entities, fetchEntityType, options.include);
+            }
             fetchedData[fetchEntityType] = entities;
-            return entities;
+            result = entities;
           }
+          return result;
         } catch (error) {
           console.error(`[OrbitalRuntime] Fetch error for ${fetchEntityType}:`, error);
           return null;
@@ -3053,6 +3061,84 @@ var OrbitalServerRuntime = class {
     await executor.executeAll(effects);
   }
   // ==========================================================================
+  // Relation Population
+  // ==========================================================================
+  /**
+   * Populate relation fields on entities
+   *
+   * For each field in `include`, find the relation field configuration and
+   * fetch the related entity, attaching it to the parent entity.
+   *
+   * @param entities - Entities to populate
+   * @param entityType - Entity type name
+   * @param include - Relation field names to populate
+   */
+  async populateRelations(entities, entityType, include) {
+    let entityFields;
+    for (const [, registered] of this.orbitals) {
+      if (registered.schema.entity.name === entityType) {
+        entityFields = registered.schema.entity.fields;
+        break;
+      }
+    }
+    if (!entityFields) {
+      if (this.config.debug) {
+        console.warn(`[OrbitalRuntime] No entity definition found for ${entityType}`);
+      }
+      return;
+    }
+    for (const includeField of include) {
+      const relationField = entityFields.find((f) => {
+        if (f.type !== "relation") return false;
+        return f.name === includeField || f.name === `${includeField}Id` || f.name.replace(/Id$/, "") === includeField;
+      });
+      if (!relationField?.relation?.entity) {
+        if (this.config.debug) {
+          console.warn(`[OrbitalRuntime] No relation field found for '${includeField}' on ${entityType}`);
+        }
+        continue;
+      }
+      const foreignKeyField = relationField.name;
+      const relatedEntityType = relationField.relation.entity;
+      const cardinality = relationField.relation.cardinality || "one";
+      const foreignKeyIds = /* @__PURE__ */ new Set();
+      for (const entity of entities) {
+        const fkValue = entity[foreignKeyField];
+        if (fkValue && typeof fkValue === "string") {
+          foreignKeyIds.add(fkValue);
+        }
+      }
+      if (foreignKeyIds.size === 0) continue;
+      const relatedEntities = /* @__PURE__ */ new Map();
+      for (const fkId of foreignKeyIds) {
+        try {
+          const related = await this.persistence.getById(relatedEntityType, fkId);
+          if (related) {
+            relatedEntities.set(fkId, related);
+          }
+        } catch (error) {
+          if (this.config.debug) {
+            console.error(`[OrbitalRuntime] Error fetching related ${relatedEntityType}:`, error);
+          }
+        }
+      }
+      const populatedFieldName = includeField.endsWith("Id") ? includeField.slice(0, -2) : includeField;
+      for (const entity of entities) {
+        const fkValue = entity[foreignKeyField];
+        if (fkValue && relatedEntities.has(fkValue)) {
+          if (cardinality === "one") {
+            entity[populatedFieldName] = relatedEntities.get(fkValue);
+          } else {
+            entity[populatedFieldName] = [relatedEntities.get(fkValue)];
+          }
+        }
+      }
+      if (this.config.debug) {
+        console.log(`[OrbitalRuntime] Populated '${populatedFieldName}' on ${entities.length} ${entityType} entities`);
+      }
+    }
+  }
+  // ==========================================================================
   // Express Router
   // ==========================================================================
   /**