@almadar/runtime 6.8.0 → 6.9.0

package/dist/OrbitalServerRuntime.js

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

package/dist/{chunk-WOXI5KCA.js → chunk-TNK77RLG.js}

@@ -1703,7 +1703,7 @@ function picsumUrl(entityName, fieldName, width = 400, height = 400) {
   return `https://picsum.photos/seed/${encodeURIComponent(seed)}/${width}/${height}`;
 }
 var SEED_REFERENCE_TIMESTAMP = "2024-01-01T00:00:00.000Z";
-var MockPersistenceAdapter = class {
+var MockPersistenceAdapter = class _MockPersistenceAdapter {
   stores = /* @__PURE__ */ new Map();
   schemas = /* @__PURE__ */ new Map();
   idCounters = /* @__PURE__ */ new Map();
@@ -1764,6 +1764,51 @@ var MockPersistenceAdapter = class {
       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 {
       updatedAt: SEED_REFERENCE_TIMESTAMP
     };
     for (const field of fields) {
+      if (!field.name) continue;
       if (field.name === "id" || field.name === "createdAt" || field.name === "updatedAt") {
         continue;
       }
@@ -1822,18 +1868,26 @@ var MockPersistenceAdapter = class {
     }
     return item;
   }
+  /** Max nesting depth for recursive array/object schemas (e.g. a Comment
+   *  entity whose `replies: [Comment]` field references itself). Without
+   *  this guard, generateArrayValue → generateObjectValue → generateArray…
+   *  recurses until stack overflow on every recursive type. Three levels
+   *  is enough to render a useful thread depth (parent → reply → sub-reply)
+   *  in catalog/preview without blowing the fixture. */
+  static MAX_NESTED_DEPTH = 3;
   /**
    * Generate a mock value for a field based on its schema.
    */
-  generateFieldValue(entityName, field, index) {
+  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
     });
@@ -1841,7 +1895,7 @@ var MockPersistenceAdapter = class {
     if (isNumeric && field.default !== void 0) {
       return field.default;
     }
-    switch (fieldTypeLc) {
+    switch (field.type) {
       case "string":
         return this.generateStringValue(entityName, field, index);
       case "number":
@@ -1858,12 +1912,11 @@ var MockPersistenceAdapter = class {
         }
         return null;
       case "relation":
-        return null;
-      // Relations need special handling
+        return field.relation?.cardinality === "one" ? "" : [];
       case "array":
-        return this.generateArrayValue(entityName, field, index);
+        return this.generateArrayValue(entityName, field, index, depth);
       case "object":
-        return this.generateObjectValue(entityName, field, index);
+        return this.generateObjectValue(entityName, field, index, depth);
       default:
         return this.generateStringValue(entityName, field, index);
     }
@@ -1877,16 +1930,18 @@ var MockPersistenceAdapter = class {
    * with no element schema), falls back to an empty array — the historical
    * behavior.
    */
-  generateArrayValue(entityName, field, index) {
-    if (!field.items) return [];
+  generateArrayValue(entityName, field, index, depth = 0) {
+    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));
+      out.push(this.generateFieldValue(entityName, elementField, index * 10 + i, depth + 1));
     }
     return out;
   }
@@ -1896,12 +1951,13 @@ var MockPersistenceAdapter = class {
    * `generateFieldValue` per property so nested objects-of-arrays-of-objects
    * compose correctly.
    */
-  generateObjectValue(entityName, field, index) {
+  generateObjectValue(entityName, field, index, depth = 0) {
     if (!field.properties) return null;
+    if (depth >= _MockPersistenceAdapter.MAX_NESTED_DEPTH) return null;
     const out = {};
     for (const [propName, propField] of Object.entries(field.properties)) {
       const childField = { ...propField, name: propName };
-      out[propName] = this.generateFieldValue(entityName, childField, index);
+      out[propName] = this.generateFieldValue(entityName, childField, index, depth + 1);
     }
     return out;
   }
@@ -1913,9 +1969,11 @@ var MockPersistenceAdapter = class {
    * 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();
@@ -1932,11 +1990,11 @@ var MockPersistenceAdapter = class {
       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", () => ({
@@ -3626,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;
@@ -4068,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) });
@@ -4083,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", {
@@ -4365,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 });
       }
     }
@@ -5443,5 +5475,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-WOXI5KCA.js.map
-//# sourceMappingURL=chunk-WOXI5KCA.js.map
+//# sourceMappingURL=chunk-TNK77RLG.js.map
+//# sourceMappingURL=chunk-TNK77RLG.js.map