entitymodeler 0.1.0 → 0.1.1

package/bin/em.mjs

@@ -12729,6 +12729,10 @@ function relationalPlan(m) {
     if (!child || !parent || !pk) continue;
     let fk = resolveForeignKey(m, r, byName);
     if (!fk) fk = addColumn(child, ends.child === ends.parent ? `parent_${pk.name}` : keyColumnName(parent, pk), pk, `${parent.display_name} (${r.forward_label})`, `relationship ${r.name}`);
+    if (r.required) {
+      const column = child.columns.find((c) => c.name === fk);
+      if (column) column.notNull = true;
+    }
     if (r.cardinality === "1:1" && !child.pk.includes(fk)) child.unique.push(fk);
     for (const ra of r.attributes || []) addRelationshipColumn(child, ra, r, false);
     foreignKeys.push({ name: fkName(`fk_${r.name}`), table: child.name, column: fk, refTable: parent.name, refColumn: pk.name, kind: "relationship", relationship: r.name });
@@ -13224,6 +13228,7 @@ function deriveLogical(src, o) {
       }
       delete r.foreign_key;
       if (!child || !a) continue;
+      if (a.required) r.required = true;
       child.attributes = child.attributes.filter((x) => x !== a);
       rep.droppedColumns.push(`${child.name}.${a.name} (foreign key \u2192 ${r.name})`);
     }
@@ -13388,14 +13393,18 @@ function derivePhysical(src, o) {
         child.attributes.push({ ...rest, name: uniqueName(ra.name, child.attributes.map((a) => a.name)), is_primary_key: false, is_label: false, description: ra.description || `${r.forward_label || r.name}: ${ra.label || ra.name}` });
       }
       if (r.attributes?.length) r.attributes = [];
+      const required = r.required;
+      delete r.required;
       const existing = r.foreign_key && child.attributes.some((a) => a.name === r.foreign_key) ? r.foreign_key : inferForeignKey(m, r);
       if (existing) {
         r.foreign_key = existing;
+        const column = child.attributes.find((a) => a.name === existing);
+        if (required && column) column.required = true;
         continue;
       }
       const name = uniqueName(ends.child === ends.parent ? `parent_${pk.name}` : keyColumnName(parent, pk), child.attributes.map((a) => a.name));
       const at = child.attributes.findIndex((a) => !a.is_primary_key);
-      const col = { name, label: toLabel(name), type: pk.type, description: `${parent.display_name} (${r.forward_label || r.name})` };
+      const col = { name, label: toLabel(name), type: pk.type, ...required ? { required } : {}, description: `${parent.display_name} (${r.forward_label || r.name})` };
       child.attributes.splice(at === -1 ? child.attributes.length : at, 0, col);
       r.foreign_key = name;
       fkAdded++;
@@ -14928,6 +14937,7 @@ function validateModel(m) {
     for (const end of ["source", "target"])
       if (!entityByName.has(r[end])) push("error", "rel.endpoint", `Relationship "${r.name}" ${end} entity "${r[end]}" does not exist.`, t);
     if (!r.forward_label) push("warning", "rel.fwd", `Relationship "${r.name}" has no forward label.`, t);
+    if (r.required && !relationshipEnds(r)) push("warning", "rel.reqnn", `Relationship "${r.name}" is N:N, so "required" is ignored (a junction table is used).`, t);
     if (r.foreign_key) {
       const ends = relationshipEnds(r);
       if (!ends) push("warning", "rel.fknn", `Relationship "${r.name}" is N:N, so its foreign key "${r.foreign_key}" is ignored (a junction table is used).`, t);
@@ -16522,6 +16532,7 @@ function diffViews(A, B, dir, a = { id: "a", name: "Before" }, b = { id: "b", na
     if (relKey(ra, "a") !== relKey(rb, "b")) d.push(`ends ${ra.source} \u2192 ${ra.target} became ${rb.source} \u2192 ${rb.target}`);
     if (ra.cardinality !== rb.cardinality) d.push(`cardinality ${ra.cardinality} \u2192 ${rb.cardinality}`);
     if ((ra.foreign_key || "") !== (rb.foreign_key || "")) d.push(`foreign key ${ra.foreign_key || "(none)"} \u2192 ${rb.foreign_key || "(none)"}`);
+    if (!!ra.required !== !!rb.required) d.push(rb.required ? "optional \u2192 required" : "required \u2192 optional");
     if (ra.forward_label !== rb.forward_label) d.push(`label "${ra.forward_label}" \u2192 "${rb.forward_label}"`);
     const raAttrs = new Map((ra.attributes || []).map((x) => [x.name, x]));
     const rbAttrs = new Map((rb.attributes || []).map((x) => [x.name, x]));
@@ -17076,8 +17087,8 @@ update_entity {entity, set:{display_name?, description?, entity_type?, color_cod
 rename_entity {entity, to}   delete_entity {entity}
 add_attribute {entity, attribute:{name, type?, label?, description?, is_primary_key?, is_label?, required?, pii?, example?, is_array?, reference?:{entity, output_attribute}, struct_type?}, after?}
 update_attribute {entity, attribute, set:{\u2026}}   rename_attribute {entity, attribute, to}   delete_attribute {entity, attribute}   move_attribute {entity, attribute, after: name|null}
-add_relationship {relationship:{source, target, name?, cardinality?: "1:1"|"1:N"|"N:1"|"N:N", forward_label?, reverse_label?, bidirectional?, foreign_key?, description?, attributes?: Attribute[]}}
-update_relationship {relationship, set:{\u2026}} \u2014 set.attributes replaces the relationship's own attributes (facts about the link, e.g. an enrollment's grade; simple types only): junction-table columns for N:N, child-table columns otherwise   rename_relationship {relationship, to}   delete_relationship {relationship}
+add_relationship {relationship:{source, target, name?, cardinality?: "1:1"|"1:N"|"N:1"|"N:N", forward_label?, reverse_label?, bidirectional?, foreign_key?, required?, description?, attributes?: Attribute[]}}
+update_relationship {relationship, set:{\u2026}} \u2014 set.required: true means the child can't exist without the parent (NOT NULL foreign key); set.attributes replaces the relationship's own attributes (facts about the link, e.g. an enrollment's grade; simple types only): junction-table columns for N:N, child-table columns otherwise   rename_relationship {relationship, to}   delete_relationship {relationship}
 set_reference_values {entity, values:[{attr: "value"}\u2026], source?}
 add_note {text}   set_hidden {entities:[\u2026], hidden}   update_model {set:{title?, description?, organization?, version?, author?, status?}}
 update_tab {tab, set:{name?, kind?, dialect?, description?}}   make_primary {tab}   delete_tab {tab}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "entitymodeler",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "EntityModel.com: data modeling CLI and MCP server for Claude and other agents.",
   "license": "MIT",
   "homepage": "https://entitymodel.com",