@land-catalyst/batch-data-sdk 1.3.1 → 1.3.3

package/dist/client/client.d.ts

@@ -1,7 +1,7 @@
 import { AxiosInstance, AxiosResponse, AxiosError, InternalAxiosRequestConfig } from "axios";
 import { IBatchDataClient } from "./client.interface";
 import { ILogger } from "../core/logger.interface";
-import { PropertySubscriptionRequest, PropertySubscriptionResponse, PropertyCountRequest, PropertySearchRequest, PropertySearchResponse, PropertyLookupOptions, AddressVerifyRequest, AddressVerifyResponse, AddressAutocompleteRequest, AddressAutocompleteResponse, AddressGeocodeRequest, AddressGeocodeResponse, AddressReverseGeocodeRequest, AddressReverseGeocodeResponse, PropertyLookupRequest, PropertyLookupResponse, PropertyLookupAsyncRequest, PropertyLookupAsyncResponse, PropertySearchAsyncRequest, PropertySearchAsyncResponse, PropertySkipTraceRequest, PropertySkipTraceResponse, PropertySkipTraceAsyncRequest, PropertySkipTraceAsyncResponse, PhoneVerificationRequest, PhoneVerificationResponse, PhoneVerificationAsyncRequest, PhoneVerificationAsyncResponse, PhoneDNCRequest, PhoneDNCResponse, PhoneDNCAsyncRequest, PhoneDNCAsyncResponse, PhoneTCPARequest, PhoneTCPAResponse, PhoneTCPAAsyncRequest, PhoneTCPAAsyncResponse, GetPropertySubscriptionsResponse, GetPropertySubscriptionDetailResponse, DeletePropertySubscriptionResponse, PropertyPermitRequest, PropertyPermitResponse, PropertySkipTraceV3Request, PropertySkipTraceV3Response, PropertySkipTraceV3AsyncRequest, PropertySkipTraceV3AsyncResponse, EventHubConfig, DeliveryConfig } from "../core/types";
+import { PropertySubscriptionRequest, PropertySubscriptionResponse, PropertyCountRequest, PropertySearchRequest, PropertySearchResponse, PropertyLookupOptions, AddressVerifyRequest, AddressVerifyResponse, AddressAutocompleteRequest, AddressAutocompleteResponse, AddressGeocodeRequest, AddressGeocodeResponse, AddressReverseGeocodeRequest, AddressReverseGeocodeResponse, PropertyLookupRequest, PropertyLookupResponse, PropertyLookupAsyncRequest, PropertyLookupAsyncResponse, PropertySearchAsyncRequest, PropertySearchAsyncResponse, PropertySkipTraceRequest, PropertySkipTraceResponse, PropertySkipTraceAsyncRequest, PropertySkipTraceAsyncResponse, PhoneVerificationRequest, PhoneVerificationResponse, PhoneVerificationAsyncRequest, PhoneVerificationAsyncResponse, PhoneDNCRequest, PhoneDNCResponse, PhoneDNCAsyncRequest, PhoneDNCAsyncResponse, PhoneTCPARequest, PhoneTCPAResponse, PhoneTCPAAsyncRequest, PhoneTCPAAsyncResponse, GetPropertySubscriptionsResponse, GetPropertySubscriptionDetailResponse, DeletePropertySubscriptionResponse, PropertyPermitRequest, PropertyPermitResponse, PropertySkipTraceV3Request, PropertySkipTraceV3Response, PropertySkipTraceV3AsyncRequest, PropertySkipTraceV3AsyncResponse, DeliveryConfig } from "../core/types";
 /**
  * Middleware function that executes before an HTTP request is sent.
  * Can modify the request config or perform side effects (logging, metrics, etc.).
@@ -102,16 +102,6 @@ export interface AsyncWebhookConfiguration {
  * Event Hub configuration for async API requests
  * Allows specifying Event Hub config per endpoint type, with fallback to defaults
  */
-export interface AsyncEventHubConfiguration {
-    /**
-     * Default Event Hub config used as fallback for all async endpoints
-     */
-    default?: EventHubConfig;
-    /**
-     * Event Hub config for property subscription requests
-     */
-    propertySubscription?: EventHubConfig;
-}
 /**
  * BatchData API Client Options
  */
@@ -143,15 +133,9 @@ export interface BatchDataClientOptions {
      * Allows specifying webhook URLs per endpoint type, with fallback to defaults
      */
     webhooks?: AsyncWebhookConfiguration;
-    /**
-     * Optional Event Hub configuration for async requests
-     * Allows specifying Event Hub config per endpoint type, with fallback to defaults
-     */
-    eventHubs?: AsyncEventHubConfiguration;
     /**
      * Optional default delivery configuration for property subscriptions
      * If provided, this will be used when a subscription request doesn't specify deliveryConfig
-     * Takes precedence over webhooks and eventHubs configurations
      *
      * @example
      * ```typescript
@@ -214,7 +198,6 @@ export declare class BatchDataClient implements IBatchDataClient {
     protected readonly axiosInstance: AxiosInstance;
     protected readonly logger: ILogger;
     private readonly webhooks?;
-    private readonly eventHubs?;
     private readonly defaultDeliveryConfig?;
     private readonly defaultOptions?;
     private readonly maxTake?;
@@ -269,20 +252,12 @@ export declare class BatchDataClient implements IBatchDataClient {
      */
     private applyDefaultOptions;
     /**
-     * Get delivery config from fallbacks (defaultDeliveryConfig first, then Event Hub preferred over webhooks).
-     * Returns undefined if no fallback configs are available.
-     *
-     * @returns Delivery config from fallbacks, or undefined if none available
-     */
-    private createDeliveryConfigFromFallbacks;
-    /**
-     * Apply default delivery configuration (Event Hub or webhook) to a property subscription request.
-     * Event Hub takes precedence over webhooks if both are configured.
-     * If deliveryConfig is not set, it will be created based on available configs (Event Hub preferred).
+     * Apply default delivery configuration to a property subscription request.
+     * If deliveryConfig is not set in the request, use defaultDeliveryConfig if available.
      *
      * @param request The property subscription request to modify
      * @returns The request with delivery config applied (if needed)
-     * @throws Error if deliveryConfig type is explicitly set but required config is missing
+     * @throws Error if deliveryConfig is not set and no default is available
      */
     private applyDeliveryConfigDefaults;
     /**

package/dist/client/client.js

@@ -24,7 +24,6 @@ class BatchDataClient {
         this.v3BaseUrl = options.v3BaseUrl || "https://api.batchdata.com/api/v3";
         this.logger = options.logger || new logger_interface_1.ConsoleLogger();
         this.webhooks = options.webhooks;
-        this.eventHubs = options.eventHubs;
         this.defaultDeliveryConfig = options.defaultDeliveryConfig;
         this.defaultOptions = options.defaultOptions;
         this.maxTake = options.maxTake;
@@ -290,108 +289,21 @@ class BatchDataClient {
         };
     }
     /**
-     * Get delivery config from fallbacks (defaultDeliveryConfig first, then Event Hub preferred over webhooks).
-     * Returns undefined if no fallback configs are available.
-     *
-     * @returns Delivery config from fallbacks, or undefined if none available
-     */
-    createDeliveryConfigFromFallbacks() {
-        // Explicit defaultDeliveryConfig takes highest precedence
-        if (this.defaultDeliveryConfig) {
-            return this.defaultDeliveryConfig;
-        }
-        // Determine which Event Hub config to use (property subscription-specific first, then default)
-        const eventHubConfig = this.eventHubs?.propertySubscription ?? this.eventHubs?.default;
-        // Determine which webhook URLs to use
-        let webhookUrl;
-        let errorWebhookUrl;
-        // First, try property subscription-specific webhook config
-        if (this.webhooks?.propertySubscription) {
-            webhookUrl = this.webhooks.propertySubscription.url;
-            errorWebhookUrl = this.webhooks.propertySubscription.errorUrl;
-        }
-        // Fall back to default webhook config
-        if (!webhookUrl && this.webhooks?.default) {
-            webhookUrl = this.webhooks.default.url;
-            errorWebhookUrl = errorWebhookUrl || this.webhooks.default.errorUrl;
-        }
-        // Event Hub takes precedence over webhooks
-        if (eventHubConfig) {
-            return {
-                type: "event-hub",
-                eventHub: eventHubConfig,
-            };
-        }
-        if (webhookUrl || errorWebhookUrl) {
-            return {
-                type: "webhook",
-                ...(webhookUrl && { url: webhookUrl }),
-                ...(errorWebhookUrl && { errorUrl: errorWebhookUrl }),
-            };
-        }
-        return undefined;
-    }
-    /**
-     * Apply default delivery configuration (Event Hub or webhook) to a property subscription request.
-     * Event Hub takes precedence over webhooks if both are configured.
-     * If deliveryConfig is not set, it will be created based on available configs (Event Hub preferred).
+     * Apply default delivery configuration to a property subscription request.
+     * If deliveryConfig is not set in the request, use defaultDeliveryConfig if available.
      *
      * @param request The property subscription request to modify
      * @returns The request with delivery config applied (if needed)
-     * @throws Error if deliveryConfig type is explicitly set but required config is missing
+     * @throws Error if deliveryConfig is not set and no default is available
      */
     applyDeliveryConfigDefaults(request) {
-        const fallbackConfig = this.createDeliveryConfigFromFallbacks();
-        // If deliveryConfig is not set, create it from fallbacks
+        // If deliveryConfig is not set, use defaultDeliveryConfig
         if (!request.deliveryConfig) {
-            if (fallbackConfig) {
-                return { ...request, deliveryConfig: fallbackConfig };
+            if (this.defaultDeliveryConfig) {
+                return { ...request, deliveryConfig: this.defaultDeliveryConfig };
             }
-            // If no fallback config is available, throw an error
             throw new Error("Property subscription requires delivery configuration. " +
-                "Please provide deliveryConfig in the request, or configure webhooks or eventHubs in BatchDataClient options.");
-        }
-        const deliveryConfig = request.deliveryConfig;
-        // If type is event-hub, use request's eventHub or fallback's eventHub
-        if (deliveryConfig.type === "event-hub") {
-            const eventHubConfig = deliveryConfig.eventHub ??
-                (fallbackConfig?.type === "event-hub"
-                    ? fallbackConfig.eventHub
-                    : undefined);
-            if (!eventHubConfig) {
-                throw new Error("Property subscription requires Event Hub configuration, but none is available. " +
-                    "Please provide eventHub in deliveryConfig, or configure eventHubs in BatchDataClient options.");
-            }
-            if (!deliveryConfig.eventHub) {
-                return {
-                    ...request,
-                    deliveryConfig: {
-                        ...deliveryConfig,
-                        eventHub: eventHubConfig,
-                    },
-                };
-            }
-        }
-        // If type is webhook, use request's URLs or fallback's URLs
-        if (deliveryConfig.type === "webhook") {
-            const webhookUrl = deliveryConfig.url ??
-                (fallbackConfig?.type === "webhook" ? fallbackConfig.url : undefined);
-            const errorWebhookUrl = deliveryConfig.errorUrl ??
-                (fallbackConfig?.type === "webhook"
-                    ? fallbackConfig.errorUrl
-                    : undefined);
-            if ((!deliveryConfig.url && webhookUrl) ||
-                (!deliveryConfig.errorUrl && errorWebhookUrl)) {
-                return {
-                    ...request,
-                    deliveryConfig: {
-                        ...deliveryConfig,
-                        ...(webhookUrl && !deliveryConfig.url && { url: webhookUrl }),
-                        ...(errorWebhookUrl &&
-                            !deliveryConfig.errorUrl && { errorUrl: errorWebhookUrl }),
-                    },
-                };
-            }
+                "Please provide deliveryConfig in the request, or configure defaultDeliveryConfig in BatchDataClient options.");
         }
         return request;
     }

package/dist/index.d.ts

@@ -12,6 +12,7 @@ export * from "./client/client.interface";
 export * from "./core/logger.interface";
 export * from "./property-field/metadata";
 export * from "./property-field/utils";
+export * from "./property-field/display";
 export * from "./property-field/search-criteria-filter-context";
 export type { SearchCriteriaFilterContext, SearchCriteriaFilterType, } from "./property-field/search-criteria-filter-context";
 export * from "./property-field/search-criteria-ai-context";

package/dist/index.js

@@ -28,5 +28,6 @@ __exportStar(require("./client/client.interface"), exports);
 __exportStar(require("./core/logger.interface"), exports);
 __exportStar(require("./property-field/metadata"), exports);
 __exportStar(require("./property-field/utils"), exports);
+__exportStar(require("./property-field/display"), exports);
 __exportStar(require("./property-field/search-criteria-filter-context"), exports);
 __exportStar(require("./property-field/search-criteria-ai-context"), exports);

package/dist/property-field/display.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Property Field Display Utilities
+ *
+ * Utilities for formatting property field values for display in the UI.
+ * These helpers take raw property data and field metadata and produce
+ * human-readable formatted strings.
+ */
+import type { Property } from "../core/types";
+import { type PropertyFieldMetadata, type PropertyFieldType } from "./metadata";
+/**
+ * Display field entry for rendering property data
+ */
+export interface PropertyDisplayField {
+    /** The field path (e.g., "building.yearBuilt") */
+    fieldPath: string;
+    /** Human-readable label */
+    label: string;
+    /** Formatted display value */
+    value: string;
+    /** The field's data type */
+    dataType: PropertyFieldType;
+}
+/**
+ * Format a property field value based on its metadata
+ *
+ * @param value The raw field value
+ * @param metadata The field's metadata
+ * @returns Formatted display string, or empty string for null/undefined
+ *
+ * @example
+ * ```typescript
+ * const meta = getPropertyFieldMetadata("valuation.estimatedValue");
+ * formatPropertyFieldValue(450000, meta); // "$450,000"
+ *
+ * const yearMeta = getPropertyFieldMetadata("building.yearBuilt");
+ * formatPropertyFieldValue(1985, yearMeta); // "1985"
+ * ```
+ */
+export declare function formatPropertyFieldValue(value: unknown, metadata: PropertyFieldMetadata): string;
+/**
+ * Get the display label for a property field path
+ *
+ * @param fieldPath The field path (e.g., "building.yearBuilt")
+ * @returns Human-readable label (e.g., "Year Built")
+ *
+ * @example
+ * ```typescript
+ * getPropertyFieldDisplayLabel("building.yearBuilt"); // "Year Built"
+ * getPropertyFieldDisplayLabel("owner.mailingAddress.city"); // "City"
+ * ```
+ */
+export declare function getPropertyFieldDisplayLabel(fieldPath: string): string;
+/**
+ * Get the display name for a property response group
+ *
+ * @param groupName The group name (e.g., "building", "propertyOwnerProfile")
+ * @returns Human-readable display name (e.g., "Building", "Owner Portfolio")
+ *
+ * @example
+ * ```typescript
+ * getPropertyGroupDisplayName("building"); // "Building"
+ * getPropertyGroupDisplayName("propertyOwnerProfile"); // "Owner Portfolio"
+ * ```
+ */
+export declare function getPropertyGroupDisplayName(groupName: string): string;
+/**
+ * Get all displayable fields for a property within a specific group
+ *
+ * Returns formatted field data for rendering in the UI. Fields with
+ * null/undefined values are excluded.
+ *
+ * @param property The property object (can be raw BatchData JSON)
+ * @param groupName The response group name (e.g., "building", "valuation")
+ * @returns Array of display field objects with label, formatted value, etc.
+ *
+ * @example
+ * ```typescript
+ * const buildingFields = getPropertyFieldsForDisplay(property, "building");
+ * // Returns:
+ * // [
+ * //   { fieldPath: "building.yearBuilt", label: "Year Built", value: "1985", dataType: "number" },
+ * //   { fieldPath: "building.bedrooms", label: "Bedrooms", value: "3", dataType: "number" },
+ * //   ...
+ * // ]
+ * ```
+ */
+export declare function getPropertyFieldsForDisplay(property: Property | Record<string, unknown>, groupName: string): PropertyDisplayField[];
+/**
+ * Get all response groups that have displayable data in a property
+ *
+ * @param property The property object
+ * @returns Array of group names that have at least one displayable field
+ *
+ * @example
+ * ```typescript
+ * const groups = getPropertyGroupsWithData(property);
+ * // Returns: ["address", "building", "valuation", "owner", ...]
+ * ```
+ */
+export declare function getPropertyGroupsWithData(property: Property | Record<string, unknown>): string[];

package/dist/property-field/display.js

@@ -0,0 +1,338 @@
+"use strict";
+/**
+ * Property Field Display Utilities
+ *
+ * Utilities for formatting property field values for display in the UI.
+ * These helpers take raw property data and field metadata and produce
+ * human-readable formatted strings.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatPropertyFieldValue = formatPropertyFieldValue;
+exports.getPropertyFieldDisplayLabel = getPropertyFieldDisplayLabel;
+exports.getPropertyGroupDisplayName = getPropertyGroupDisplayName;
+exports.getPropertyFieldsForDisplay = getPropertyFieldsForDisplay;
+exports.getPropertyGroupsWithData = getPropertyGroupsWithData;
+const metadata_1 = require("./metadata");
+const utils_1 = require("./utils");
+/**
+ * Group display name mappings
+ */
+const GROUP_DISPLAY_NAMES = {
+    address: "Address",
+    assessment: "Assessment",
+    building: "Building",
+    deedHistory: "Deed History",
+    demographics: "Demographics",
+    foreclosure: "Foreclosure",
+    general: "General",
+    ids: "Identifiers",
+    intel: "Intel",
+    involuntaryLien: "Involuntary Liens",
+    legal: "Legal",
+    listing: "Listing",
+    lot: "Lot",
+    meta: "Meta",
+    mortgageHistory: "Mortgage History",
+    openLien: "Open Liens",
+    owner: "Owner",
+    permit: "Permits",
+    propertyOwnerProfile: "Owner Portfolio",
+    quickLists: "Quick Lists",
+    sale: "Sale History",
+    tax: "Tax",
+    valuation: "Valuation",
+};
+/**
+ * Convert a field name to a display label
+ * Handles camelCase and common abbreviations
+ */
+function fieldNameToLabel(name) {
+    // Handle common abbreviations
+    const abbrevs = {
+        sqft: "Sq Ft",
+        apn: "APN",
+        adu: "ADU",
+        avm: "AVM",
+        hoa: "HOA",
+        id: "ID",
+        mls: "MLS",
+        url: "URL",
+    };
+    const lower = name.toLowerCase();
+    if (abbrevs[lower]) {
+        return abbrevs[lower];
+    }
+    // Split camelCase and capitalize
+    return name
+        .replace(/([A-Z])/g, " $1")
+        .replace(/^./, (c) => c.toUpperCase())
+        .trim();
+}
+/**
+ * Format a number as currency (USD)
+ */
+function formatCurrency(value) {
+    return new Intl.NumberFormat("en-US", {
+        style: "currency",
+        currency: "USD",
+        minimumFractionDigits: 0,
+        maximumFractionDigits: 0,
+    }).format(value);
+}
+/**
+ * Format a number with commas
+ */
+function formatNumber(value) {
+    return new Intl.NumberFormat("en-US").format(value);
+}
+/**
+ * Format a date string
+ */
+function formatDate(value) {
+    try {
+        const date = typeof value === "string" ? new Date(value) : value;
+        if (isNaN(date.getTime()))
+            return String(value);
+        return date.toLocaleDateString("en-US", {
+            year: "numeric",
+            month: "short",
+            day: "numeric",
+        });
+    }
+    catch {
+        return String(value);
+    }
+}
+/**
+ * Check if a field name suggests currency formatting
+ */
+function isCurrencyField(fieldPath, name) {
+    const lower = (fieldPath + name).toLowerCase();
+    return (lower.includes("value") ||
+        lower.includes("price") ||
+        lower.includes("assessment") ||
+        lower.includes("amount") ||
+        lower.includes("equity") ||
+        lower.includes("balance") ||
+        lower.includes("cost"));
+}
+/**
+ * Check if a field name suggests year formatting
+ */
+function isYearField(name) {
+    const lower = name.toLowerCase();
+    return lower.includes("year") && !lower.includes("years");
+}
+/**
+ * Check if a field name suggests square footage formatting
+ */
+function isSqftField(name) {
+    const lower = name.toLowerCase();
+    return (lower.includes("sqft") ||
+        lower.includes("area") ||
+        lower.includes("squarefeet"));
+}
+/**
+ * Check if a field name suggests acreage formatting
+ */
+function isAcresField(name) {
+    const lower = name.toLowerCase();
+    return lower.includes("acre") || lower.includes("acreage");
+}
+/**
+ * Format a property field value based on its metadata
+ *
+ * @param value The raw field value
+ * @param metadata The field's metadata
+ * @returns Formatted display string, or empty string for null/undefined
+ *
+ * @example
+ * ```typescript
+ * const meta = getPropertyFieldMetadata("valuation.estimatedValue");
+ * formatPropertyFieldValue(450000, meta); // "$450,000"
+ *
+ * const yearMeta = getPropertyFieldMetadata("building.yearBuilt");
+ * formatPropertyFieldValue(1985, yearMeta); // "1985"
+ * ```
+ */
+function formatPropertyFieldValue(value, metadata) {
+    // Handle null/undefined
+    if (value == null) {
+        return "";
+    }
+    const { dataType, name, fieldPath, possibleValuesRef } = metadata;
+    // Handle boolean
+    if (dataType === "boolean") {
+        return value ? "Yes" : "No";
+    }
+    // Handle date
+    if (dataType === "date") {
+        return formatDate(value);
+    }
+    // Handle array[string]
+    if (dataType === "array[string]") {
+        if (Array.isArray(value)) {
+            return value.filter((v) => v != null).join(", ");
+        }
+        return String(value);
+    }
+    // Handle array[number]
+    if (dataType === "array[number]") {
+        if (Array.isArray(value)) {
+            return value
+                .filter((v) => v != null)
+                .map(formatNumber)
+                .join(", ");
+        }
+        return String(value);
+    }
+    // Handle number with formatting rules
+    if (dataType === "number" && typeof value === "number") {
+        // Year - plain integer
+        if (isYearField(name)) {
+            return String(Math.round(value));
+        }
+        // Currency fields
+        if (isCurrencyField(fieldPath, name)) {
+            return formatCurrency(value);
+        }
+        // Square footage
+        if (isSqftField(name)) {
+            return `${formatNumber(Math.round(value))} sq ft`;
+        }
+        // Acreage
+        if (isAcresField(name)) {
+            return `${value.toFixed(2)} acres`;
+        }
+        // Default number formatting
+        if (Number.isInteger(value)) {
+            return formatNumber(value);
+        }
+        return value.toFixed(2);
+    }
+    // Handle string with possibleValues lookup
+    if (dataType === "string" && typeof value === "string") {
+        // If there's a possibleValuesRef, the value itself is usually the display value
+        // in POSSIBLE_VALUES_CONSTANTS (they're already human-readable)
+        if (possibleValuesRef) {
+            const possibleValues = metadata_1.POSSIBLE_VALUES_CONSTANTS[possibleValuesRef];
+            if (possibleValues?.includes(value)) {
+                return value; // Already display-friendly
+            }
+        }
+        return value;
+    }
+    // Handle object - just return stringified for now
+    if (dataType === "object" && typeof value === "object") {
+        return JSON.stringify(value);
+    }
+    // Default: convert to string
+    return String(value);
+}
+/**
+ * Get the display label for a property field path
+ *
+ * @param fieldPath The field path (e.g., "building.yearBuilt")
+ * @returns Human-readable label (e.g., "Year Built")
+ *
+ * @example
+ * ```typescript
+ * getPropertyFieldDisplayLabel("building.yearBuilt"); // "Year Built"
+ * getPropertyFieldDisplayLabel("owner.mailingAddress.city"); // "City"
+ * ```
+ */
+function getPropertyFieldDisplayLabel(fieldPath) {
+    const metadata = metadata_1.PROPERTY_FIELD_METADATA[fieldPath];
+    if (metadata) {
+        return fieldNameToLabel(metadata.name);
+    }
+    // Fallback: use the last part of the path
+    const parts = fieldPath.split(".");
+    const last = parts[parts.length - 1] || fieldPath;
+    return fieldNameToLabel(last);
+}
+/**
+ * Get the display name for a property response group
+ *
+ * @param groupName The group name (e.g., "building", "propertyOwnerProfile")
+ * @returns Human-readable display name (e.g., "Building", "Owner Portfolio")
+ *
+ * @example
+ * ```typescript
+ * getPropertyGroupDisplayName("building"); // "Building"
+ * getPropertyGroupDisplayName("propertyOwnerProfile"); // "Owner Portfolio"
+ * ```
+ */
+function getPropertyGroupDisplayName(groupName) {
+    return GROUP_DISPLAY_NAMES[groupName] || fieldNameToLabel(groupName);
+}
+/**
+ * Get all displayable fields for a property within a specific group
+ *
+ * Returns formatted field data for rendering in the UI. Fields with
+ * null/undefined values are excluded.
+ *
+ * @param property The property object (can be raw BatchData JSON)
+ * @param groupName The response group name (e.g., "building", "valuation")
+ * @returns Array of display field objects with label, formatted value, etc.
+ *
+ * @example
+ * ```typescript
+ * const buildingFields = getPropertyFieldsForDisplay(property, "building");
+ * // Returns:
+ * // [
+ * //   { fieldPath: "building.yearBuilt", label: "Year Built", value: "1985", dataType: "number" },
+ * //   { fieldPath: "building.bedrooms", label: "Bedrooms", value: "3", dataType: "number" },
+ * //   ...
+ * // ]
+ * ```
+ */
+function getPropertyFieldsForDisplay(property, groupName) {
+    const groupFields = (0, utils_1.getPropertyGroupFields)(groupName);
+    const results = [];
+    for (const metadata of groupFields) {
+        // Skip array element placeholders ([n] patterns)
+        if (metadata.isArrayElement)
+            continue;
+        const value = (0, utils_1.getPropertyFieldValue)(property, metadata.fieldPath);
+        // Skip null/undefined values
+        if (value == null)
+            continue;
+        // Skip empty strings
+        if (typeof value === "string" && value.trim() === "")
+            continue;
+        // Skip empty arrays
+        if (Array.isArray(value) && value.length === 0)
+            continue;
+        const formatted = formatPropertyFieldValue(value, metadata);
+        // Skip if formatting returned empty
+        if (!formatted)
+            continue;
+        results.push({
+            fieldPath: metadata.fieldPath,
+            label: getPropertyFieldDisplayLabel(metadata.fieldPath),
+            value: formatted,
+            dataType: metadata.dataType,
+        });
+    }
+    return results;
+}
+/**
+ * Get all response groups that have displayable data in a property
+ *
+ * @param property The property object
+ * @returns Array of group names that have at least one displayable field
+ *
+ * @example
+ * ```typescript
+ * const groups = getPropertyGroupsWithData(property);
+ * // Returns: ["address", "building", "valuation", "owner", ...]
+ * ```
+ */
+function getPropertyGroupsWithData(property) {
+    const allGroups = Object.keys(GROUP_DISPLAY_NAMES);
+    return allGroups.filter((group) => {
+        const fields = getPropertyFieldsForDisplay(property, group);
+        return fields.length > 0;
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@land-catalyst/batch-data-sdk",
-  "version": "1.3.1",
+  "version": "1.3.3",
   "description": "TypeScript SDK for BatchData.io Property API - Types, Builders, and Utilities",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",