Add heuristic fallback filter for legacy proxy auth (v1.5.0)

When CSDL is unavailable (OrganizationServiceProxy auth), apply
filterEntityFallback instead of dropping all entities: filters Virtual
attributes, suppresses scalar-shadowed and null nav props, and deduplicates
polymorphic ManyToOne relationships. Bump changelog to v1.5.0.

Author: Mosh-K

CHANGELOG.md

@@ -1,14 +1,15 @@
 # Changelog
 
-## [Unreleased]
+## [1.5.0] - 2026-05-08
 ### Changed
 - Attributes and navigation properties are now filtered against the OData CSDL `$metadata`, ensuring generated typings reflect only what is accessible on the wire
 - Virtual attributes (shadow fields, `yomi*` names, metadata-only columns) are now excluded via CSDL rather than SDK-side heuristics
 - File-type columns are now typed as GUIDs, reflecting their actual wire format
+- When CSDL is unavailable (legacy proxy auth), heuristic filters are applied instead
 ### Fixed
 - Duplicate ManyToOne navigation properties (collapsed by the CSDL) no longer generate duplicate interface members
 
-## [1.4.0] - 2026-04-28
+## [1.4.0] - 2026-04-28 (unreleased)
 ### Changed
 - WebEntities internal interfaces reorganized into sub-namespaces under `_`: `Scalars`, `Read`, `Write`, `Binds`, and `Lookup`, replacing the previous flat layout
 - Lookup value properties (`_*_value`) now include the lookup field's logical name in their JSDoc comment
@@ -57,7 +58,7 @@
 ### Added
 - Initial public release
 
-[1.4.0]: https://github.com/Mosh-K/XrmTypeScript/releases/tag/v1.4.0
+[1.5.0]: https://github.com/Mosh-K/XrmTypeScript/releases/tag/v1.5.0
 [1.3.0]: https://github.com/Mosh-K/XrmTypeScript/releases/tag/v1.3.0
 [1.2.0]: https://github.com/Mosh-K/XrmTypeScript/releases/tag/v1.2.0
 [1.1.0]: https://github.com/Mosh-K/XrmTypeScript/releases/tag/v1.1.0

src/Generation/Setup.fs

@@ -76,12 +76,18 @@ let interpretCrmData (gSettings: XdtGenerationSettings) (rawState: RawState) =
 
   let entityMetadata =
     let csdlMap = rawState.csdlData |> Array.map (fun e -> e.Name, e) |> Map.ofArray
-    rawState.metadata
-    |> Array.Parallel.map (interpretEntity infoMap gSettings.labelMapping)
-    |> Array.Parallel.choose (fun e ->
-      match Map.tryFind e.logicalName csdlMap with
-      | Some c -> Some (filterEntity c e)
-      | None -> None)
+    let interpreted = rawState.metadata |> Array.Parallel.map (interpretEntity infoMap gSettings.labelMapping)
+    printfn "Done!"
+    if csdlMap.IsEmpty then
+      printf "CSDL unavailable, applying heuristic filters..."
+      interpreted |> Array.Parallel.map filterEntityFallback
+    else
+      printf "Filtering entities against OData CSDL metadata..."
+      interpreted
+      |> Array.Parallel.choose (fun e ->
+        match Map.tryFind e.logicalName csdlMap with
+        | Some c -> Some (filterEntity c e)
+        | None -> None)
 
   let bpfControls = interpretBpfs rawState.bpfData
 

src/Interpretation/FilterByCsdl.fs

@@ -36,3 +36,39 @@ let filterEntity (entityInfo: CsdlEntityInfo) (entity: XrmEntity) : XrmEntity =
             then r.Entity2NavigationPropertyName
             else r.Entity1NavigationPropertyName
           Set.contains navProp csdlNavProps) }
+
+/// True when an attribute on the entity claims the same OData property name as the given
+/// navigation property name. Lookup-style attributes (specialType = EntityReference) are
+/// renamed to `_<name>_value` in the OData CSDL so they don't shadow; everything else
+/// (Uniqueidentifier, File, Image, plain scalars) keeps its natural name and forces
+/// Dataverse to drop the navigation property from the wire.
+let private isShadowedByScalar (attrMap: Map<string, XrmAttribute>) navPropName =
+  Map.tryFind navPropName attrMap
+  |> Option.exists (fun a -> a.specialType <> SpecialType.EntityReference)
+
+let filterEntityFallback (entity: XrmEntity) : XrmEntity =
+  let filteredAttrs =
+    entity.attributes |> List.filter (fun a -> a.colType <> XrmAttributeType.Virtual)
+  let attrMap =
+    filteredAttrs |> List.map (fun a -> a.logicalName, a) |> Map.ofList
+
+  { entity with
+      attributes = filteredAttrs
+
+      manyToOneRelationships =
+        entity.manyToOneRelationships
+        |> List.filter (fun rel ->
+          not (isNull rel.ReferencingEntityNavigationPropertyName)
+          && not (isShadowedByScalar attrMap rel.ReferencingEntityNavigationPropertyName))
+        |> List.distinctBy (fun r -> r.ReferencingEntityNavigationPropertyName)
+
+      oneToManyRelationships =
+        entity.oneToManyRelationships
+        |> List.filter (fun rel -> not (isNull rel.ReferencedEntityNavigationPropertyName))
+
+      manyToManyRelationships =
+        entity.manyToManyRelationships
+        |> List.filter (fun rel ->
+          (entity.logicalName = rel.Entity1LogicalName || entity.logicalName = rel.Entity2LogicalName) // Filter intersect tables
+          && not (isNull rel.Entity1NavigationPropertyName)
+          && not (isNull rel.Entity2NavigationPropertyName)) }