@almadar/runtime 6.8.1 → 6.9.1

package/dist/OrbitalServerRuntime.js

@@ -1,4 +1,4 @@
-export { InMemoryPersistence, OrbitalServerRuntime, collectDeclaredConfigDefaults, createOrbitalServerRuntime } from './chunk-L3FDWEQL.js';
+export { InMemoryPersistence, OrbitalServerRuntime, collectDeclaredConfigDefaults, createOrbitalServerRuntime } from './chunk-6W74ZCFQ.js';
 import './chunk-PZ5AY32C.js';
 //# sourceMappingURL=OrbitalServerRuntime.js.map
 //# sourceMappingURL=OrbitalServerRuntime.js.map

package/dist/{chunk-L3FDWEQL.js → chunk-6W74ZCFQ.js}

@@ -1764,6 +1764,51 @@ var MockPersistenceAdapter = class _MockPersistenceAdapter {
       const count = seedCount ?? this.config.defaultSeedCount ?? 6;
       this.seed(schema.name, schema.fields, count);
     }
+    this.linkRelationFields();
+  }
+  /**
+   * Walk every row of every registered entity and fill in `type: "relation"`
+   * fields with real IDs from the target entity's store. Without this pass,
+   * relation fields stay as placeholder `[]` / `""` and `populateRelations`
+   * in OrbitalServerRuntime has nothing to hydrate — catalog/preview demos
+   * of nested-tree atoms (e.g. std-thread-comments-linear with ThreadPost.
+   * replies → [ThreadPost]) render empty reply cards.
+   *
+   * For self-referential relations, each row gets 2–4 sibling IDs (excluding
+   * self). For cross-entity relations, IDs are picked from the target store.
+   * The runtime caps recursion at depth=2 in `populateRelations`, so
+   * grandparent-of-self cycles render two levels deep then stop.
+   */
+  linkRelationFields() {
+    for (const [normalizedName, schema] of this.schemas) {
+      const store = this.stores.get(normalizedName);
+      if (!store) continue;
+      const relationFields = schema.fields.filter(
+        (f) => f.type === "relation"
+      );
+      if (relationFields.length === 0) continue;
+      for (const row of store.values()) {
+        for (const field of relationFields) {
+          const targetStore = this.stores.get(field.relation.entity.toLowerCase());
+          if (!targetStore || targetStore.size === 0) continue;
+          const selfId = row["id"];
+          const sameStore = targetStore === store;
+          const eligible = [];
+          for (const id of targetStore.keys()) {
+            if (sameStore && id === selfId) continue;
+            eligible.push(id);
+          }
+          if (eligible.length === 0) continue;
+          const cardinality = field.relation.cardinality ?? "many";
+          if (cardinality === "one" || cardinality === "many-to-one") {
+            row[field.name] = faker.helpers.arrayElement(eligible);
+          } else {
+            const pickCount = Math.min(eligible.length, faker.number.int({ min: 2, max: 4 }));
+            row[field.name] = faker.helpers.shuffle(eligible.slice()).slice(0, pickCount);
+          }
+        }
+      }
+    }
   }
   /**
    * Seed an entity with pre-authored instance data.
@@ -1815,6 +1860,7 @@ var MockPersistenceAdapter = class _MockPersistenceAdapter {
       updatedAt: SEED_REFERENCE_TIMESTAMP
     };
     for (const field of fields) {
+      if (!field.name) continue;
       if (field.name === "id" || field.name === "createdAt" || field.name === "updatedAt") {
         continue;
       }
@@ -1834,13 +1880,14 @@ var MockPersistenceAdapter = class _MockPersistenceAdapter {
    */
   generateFieldValue(entityName, field, index, depth = 0) {
     const fieldTypeLc = field.type.toLowerCase();
+    const values = "values" in field ? field.values : void 0;
     mockLog.debug("field:generate", {
       entityName,
       fieldName: field.name,
       fieldType: fieldTypeLc,
-      hasValues: !!field.values?.length,
-      valuesCount: field.values?.length ?? 0,
-      values: field.values?.length ? field.values.join(",") : null,
+      hasValues: !!values?.length,
+      valuesCount: values?.length ?? 0,
+      values: values?.length ? values.join(",") : null,
       format: field.format ?? null,
       hasDefault: field.default !== void 0
     });
@@ -1848,7 +1895,7 @@ var MockPersistenceAdapter = class _MockPersistenceAdapter {
     if (isNumeric && field.default !== void 0) {
       return field.default;
     }
-    switch (fieldTypeLc) {
+    switch (field.type) {
       case "string":
         return this.generateStringValue(entityName, field, index);
       case "number":
@@ -1865,8 +1912,7 @@ var MockPersistenceAdapter = class _MockPersistenceAdapter {
         }
         return null;
       case "relation":
-        return null;
-      // Relations need special handling
+        return field.relation?.cardinality === "one" ? "" : [];
       case "array":
         return this.generateArrayValue(entityName, field, index, depth);
       case "object":
@@ -1885,14 +1931,15 @@ var MockPersistenceAdapter = class _MockPersistenceAdapter {
    * behavior.
    */
   generateArrayValue(entityName, field, index, depth = 0) {
-    if (!field.items) return [];
+    if (field.type !== "array" || !field.items) return [];
     if (depth >= _MockPersistenceAdapter.MAX_NESTED_DEPTH) return [];
     const count = faker.number.int({ min: 3, max: 5 });
     const out = [];
+    const elementName = field.name ?? "item";
     for (let i = 0; i < count; i++) {
       const elementField = {
         ...field.items,
-        name: `${field.name}[${i}]`
+        name: `${elementName}[${i}]`
       };
       out.push(this.generateFieldValue(entityName, elementField, index * 10 + i, depth + 1));
     }
@@ -1922,9 +1969,11 @@ var MockPersistenceAdapter = class _MockPersistenceAdapter {
    * declare `format: "email"`; if they need an enum, they declare `values: [...]`.
    */
   generateStringValue(entityName, field, _index) {
-    if (field.values && field.values.length > 0) {
-      return faker.helpers.arrayElement(field.values);
+    const values = "values" in field ? field.values : void 0;
+    if (values && values.length > 0) {
+      return faker.helpers.arrayElement(values);
     }
+    const fieldName = field.name ?? "field";
     switch (field.format) {
       case "email":
         return faker.internet.email();
@@ -1941,11 +1990,11 @@ var MockPersistenceAdapter = class _MockPersistenceAdapter {
       case "image":
       case "avatar":
       case "thumbnail":
-        return picsumUrl(entityName, field.name);
+        return picsumUrl(entityName, fieldName);
     }
-    const lname = field.name.toLowerCase();
+    const lname = fieldName.toLowerCase();
     if (lname === "image" || lname === "imageurl" || lname === "image_url" || lname === "photo" || lname === "photourl" || lname === "photo_url" || lname === "avatar" || lname === "avatarurl" || lname === "avatar_url" || lname === "thumbnail" || lname === "thumbnailurl" || lname === "thumbnail_url" || lname === "picture" || lname === "pictureurl" || lname === "cover" || lname === "coverurl" || lname === "banner" || lname === "bannerurl") {
-      return picsumUrl(entityName, field.name);
+      return picsumUrl(entityName, fieldName);
     }
     const value = faker.lorem.words(2);
     mockLog.debug("field:fallback-lorem", () => ({
@@ -3635,32 +3684,6 @@ function needsPreprocessing(schema) {
   }
   return false;
 }
-function mapFieldForMock(f) {
-  const rec = f;
-  const out = {
-    name: f.name,
-    type: rec["type"]
-  };
-  if (typeof rec["required"] === "boolean") out.required = rec["required"];
-  if (Array.isArray(rec["values"])) out.values = rec["values"];
-  if (rec["default"] !== void 0) out.default = rec["default"];
-  if (typeof rec["format"] === "string") out.format = rec["format"];
-  const items = rec["items"];
-  if (items && typeof items === "object" && "type" in items) {
-    out.items = mapFieldForMock({ name: "", ...items });
-  }
-  const properties = rec["properties"];
-  if (properties && typeof properties === "object" && !Array.isArray(properties)) {
-    const propsOut = {};
-    for (const [k, v] of Object.entries(properties)) {
-      if (v && typeof v === "object" && "type" in v) {
-        propsOut[k] = mapFieldForMock({ name: k, ...v });
-      }
-    }
-    if (Object.keys(propsOut).length > 0) out.properties = propsOut;
-  }
-  return out;
-}
 var OrbitalServerRuntime = class {
   orbitals = /* @__PURE__ */ new Map();
   eventBus;
@@ -4077,7 +4100,7 @@ var OrbitalServerRuntime = class {
       if (entity?.name && entity.fields) {
         const fields = entity.fields.filter(
           (f) => typeof f.name === "string" && f.name.length > 0
-        ).map((f) => mapFieldForMock(f));
+        );
         this.persistence.registerEntity({ name: entity.name, fields });
         if (this.config.debug) {
           persistLog.debug("mock:seeded", { entity: entity.name, count: this.persistence.count(entity.name) });
@@ -4092,7 +4115,7 @@ var OrbitalServerRuntime = class {
         if (!auxEntity.name || !auxEntity.fields) continue;
         const auxFields = auxEntity.fields.filter(
           (f) => typeof f.name === "string" && f.name.length > 0
-        ).map((f) => mapFieldForMock(f));
+        );
         this.persistence.registerEntity({ name: auxEntity.name, fields: auxFields });
         if (this.config.debug) {
           persistLog.debug("mock:seeded-auxiliary", {
@@ -4374,7 +4397,7 @@ var OrbitalServerRuntime = class {
       if (entity?.name && entity.fields) {
         const fields = entity.fields.filter(
           (f) => typeof f.name === "string" && f.name.length > 0
-        ).map((f) => mapFieldForMock(f));
+        );
         this.persistence.registerEntity({ name: entity.name, fields });
       }
     }
@@ -5233,12 +5256,20 @@ var OrbitalServerRuntime = class {
         }
       }
       const populatedFieldName = includeField.endsWith("Id") ? includeField.slice(0, -2) : includeField;
+      const isSelfRef = relatedEntityType === entityType;
+      const hydrateClone = (id) => {
+        const related = relatedEntities.get(id);
+        if (!related) return void 0;
+        const copy = { ...related };
+        if (isSelfRef) copy[foreignKeyField] = [];
+        return copy;
+      };
       for (const entity of entities) {
         const fkValue = entity[foreignKeyField];
         if (cardinality === "one" || cardinality === "many-to-one") {
           if (typeof fkValue === "string" && relatedEntities.has(fkValue)) {
             Object.defineProperty(entity, populatedFieldName, {
-              value: relatedEntities.get(fkValue),
+              value: hydrateClone(fkValue),
               writable: true,
               enumerable: true,
               configurable: true
@@ -5248,14 +5279,14 @@ var OrbitalServerRuntime = class {
           if (Array.isArray(fkValue)) {
             const fkIds = fkValue.filter((id) => typeof id === "string");
             Object.defineProperty(entity, populatedFieldName, {
-              value: fkIds.map((id) => relatedEntities.get(id)).filter(Boolean),
+              value: fkIds.map(hydrateClone).filter(Boolean),
               writable: true,
               enumerable: true,
               configurable: true
             });
           } else if (typeof fkValue === "string" && relatedEntities.has(fkValue)) {
             Object.defineProperty(entity, populatedFieldName, {
-              value: [relatedEntities.get(fkValue)],
+              value: [hydrateClone(fkValue)],
               writable: true,
               enumerable: true,
               configurable: true
@@ -5452,5 +5483,5 @@ function buildMatcher(src, listenerOrbital) {
 }
 
 export { EffectExecutor, EventBus, HANDLER_MANIFEST, InMemoryPersistence, MockPersistenceAdapter, OrbitalServerRuntime, StateMachineManager, buildEmitsFromTraits, collectDeclaredConfigDefaults, containsBindings, createContextFromBindings, createInitialTraitState, createMockPersistence, createOrbitalServerRuntime, createTestExecutor, createUnifiedLoader, extractBindings, findInitialState, findTransition, formatPayloadValidationError, getIsolatedCollectionName, getNamespacedEvent, interpolateProps, interpolateValue, isBrowser, isElectron, isNamespacedEvent, isNode, normalizeEventKey, parseNamespacedEvent, preprocessSchema, processEvent, validateEventPayload, validatePayloadShapes };
-//# sourceMappingURL=chunk-L3FDWEQL.js.map
-//# sourceMappingURL=chunk-L3FDWEQL.js.map
+//# sourceMappingURL=chunk-6W74ZCFQ.js.map
+//# sourceMappingURL=chunk-6W74ZCFQ.js.map