massively improves the jspg validator by removing mathmatical functions like allOf, anyOf, ref, etc to effectively use discriminators and OOP with types to determine valid pathing an nno intersections, unions, or guesswork; added cases to replace the former conditionals

2026-04-08 13:08:24 -04:00
parent e4286ac6a9
commit 7c8df22709
30 changed files with 2526 additions and 4816 deletions
--- a/fixtures/paths.json
+++ b/fixtures/paths.json
@ -148,6 +148,10 @@
            {
              "code": "REQUIRED_FIELD_MISSING",
              "details": { "path": "ad_hoc_objects/1/name" }
+            },
+            {
+              "code": "STRICT_PROPERTY_VIOLATION",
+              "details": { "path": "ad_hoc_objects/1/age" }
            }
          ]
        }
@ -210,5 +214,154 @@
        }
      }
    ]
+  },
+  {
+    "description": "Polymorphic Structure Pathing",
+    "database": {
+      "types": [
+        {
+          "name": "widget",
+          "variations": ["widget"],
+          "schemas": [
+            {
+              "$id": "widget",
+              "type": "object",
+              "properties": {
+                "id": { "type": "string" },
+                "type": { "type": "string" }
+              }
+            },
+            {
+              "$id": "stock.widget",
+              "type": "widget",
+              "properties": {
+                "kind": { "type": "string" },
+                "amount": { "type": "integer" },
+                "details": {
+                  "type": "object",
+                  "properties": {
+                    "nested_metric": { "type": "number" }
+                  },
+                  "required": ["nested_metric"]
+                }
+              },
+              "required": ["amount", "details"]
+            }
+          ]
+        }
+      ],
+      "schemas": [
+        {
+          "$id": "polymorphic_pathing",
+          "type": "object",
+          "properties": {
+            "metadata_bubbles": {
+              "type": "array",
+              "items": {
+                "oneOf": [
+                  {
+                    "$id": "contact_metadata",
+                    "type": "object",
+                    "properties": {
+                      "type": { "const": "contact" },
+                      "phone": { "type": "string" }
+                    },
+                    "required": ["phone"]
+                  },
+                  {
+                    "$id": "invoice_metadata",
+                    "type": "object",
+                    "properties": {
+                      "type": { "const": "invoice" },
+                      "invoice_id": { "type": "integer" }
+                    },
+                    "required": ["invoice_id"]
+                  }
+                ]
+              }
+            },
+            "table_families": {
+              "type": "array",
+              "items": {
+                "$family": "widget"
+              }
+            }
+          }
+        }
+      ]
+    },
+    "tests": [
+      {
+        "description": "oneOf tags natively bubble specific schema paths into deep array roots",
+        "data": {
+          "metadata_bubbles": [
+            { "type": "invoice", "invoice_id": 100 },
+            { "type": "contact", "phone": 12345, "rogue_field": "x" }
+          ]
+        },
+        "schema_id": "polymorphic_pathing",
+        "action": "validate",
+        "expect": {
+          "success": false,
+          "errors": [
+            {
+              "code": "INVALID_TYPE",
+              "details": { "path": "metadata_bubbles/1/phone" }
+            },
+            {
+              "code": "STRICT_PROPERTY_VIOLATION",
+              "details": { "path": "metadata_bubbles/1/rogue_field" }
+            }
+          ]
+        }
+      },
+      {
+        "description": "families mechanically map physical variants directly onto topological uuid array paths",
+        "data": {
+          "table_families": [
+            {
+              "id": "widget-1",
+              "type": "widget",
+              "kind": "stock",
+              "amount": 500,
+              "details": { "nested_metric": 42.0 }
+            },
+            {
+              "id": "widget-2",
+              "type": "widget",
+              "kind": "stock",
+              "amount": "not_an_int",
+              "details": {
+                 "stray_child": true
+              },
+              "unexpected_root_prop": "hi"
+            }
+          ]
+        },
+        "schema_id": "polymorphic_pathing",
+        "action": "validate",
+        "expect": {
+          "success": false,
+          "errors": [
+            {
+              "code": "INVALID_TYPE",
+              "details": { "path": "table_families/widget-2/amount" }
+            },
+            {
+              "code": "REQUIRED_FIELD_MISSING",
+              "details": { "path": "table_families/widget-2/details/nested_metric" }
+            },
+            {
+              "code": "STRICT_PROPERTY_VIOLATION",
+              "details": { "path": "table_families/widget-2/details/stray_child" }
+            },
+            {
+              "code": "STRICT_PROPERTY_VIOLATION",
+              "details": { "path": "table_families/widget-2/unexpected_root_prop" }
+            }
+          ]
+        }
+      }
+    ]
  }
 ]