@land-catalyst/batch-data-sdk 1.2.8 → 1.2.10

package/dist/builders/builders.d.ts

@@ -16,7 +16,7 @@
  *   .build();
  * ```
  */
-import { StringFilter, NumericRangeFilter, DateRangeFilter, GeoLocationDistance, GeoLocationBoundingBox, GeoLocationPolygon, AddressSearchCriteria, AssessmentSearchCriteria, BuildingSearchCriteria, CompAddressSearchCriteria, DemographicsSearchCriteria, ForeclosureSearchCriteria, GeneralSearchCriteria, IdsSearchCriteria, IntelSearchCriteria, InvoluntaryLienSearchCriteria, LegalSearchCriteria, ListingSearchCriteria, LotSearchCriteria, OpenLienSearchCriteria, OwnerSearchCriteria, PermitSearchCriteria, PropertyOwnerProfileSearchCriteria, SaleSearchCriteria, TaxSearchCriteria, ValuationSearchCriteria, OrSearchCriteria, SearchCriteria, DeliveryConfig, EventHubConfig, PropertySubscriptionRequest, QuickListValueWithNot, PropertyLookupRequest, PropertyLookupRequestItem, PropertyLookupRequestAddress, PropertyLookupOptions, PropertyPermitRequest, PropertyCountRequest, PropertySearchRequest, PropertySearchAsyncRequest, PropertyLookupAsyncRequest, GeoPoint } from "../core/types";
+import { StringFilter, NumericRangeFilter, DateRangeFilter, GeoLocationDistance, GeoLocationBoundingBox, GeoLocationPolygon, AddressSearchCriteria, AssessmentSearchCriteria, BuildingSearchCriteria, CompAddressSearchCriteria, DemographicsSearchCriteria, ForeclosureSearchCriteria, GeneralSearchCriteria, IdsSearchCriteria, IntelSearchCriteria, InvoluntaryLienSearchCriteria, LegalSearchCriteria, ListingSearchCriteria, LotSearchCriteria, OpenLienSearchCriteria, OwnerSearchCriteria, PermitSearchCriteria, PropertyOwnerProfileSearchCriteria, SaleSearchCriteria, TaxSearchCriteria, ValuationSearchCriteria, OrSearchCriteria, SearchCriteria, DeliveryConfig, EventHubConfig, PropertySubscriptionRequest, QuickListValueWithNot, PropertyLookupRequest, PropertyLookupRequestItem, PropertyLookupRequestAddress, PropertyLookupOptions, PropertyPermitRequest, PropertyCountRequest, PropertySearchRequest, PropertySearchAsyncRequest, PropertyLookupAsyncRequest, GeoPoint, AirConditioningSource, BasementType, BuildingClass, BuildingCondition, BuildingQuality, ConstructionType, Driveway, ExteriorWalls, FloorCover, Garage, HeatSource, HeatingFuelType, InteriorWalls, Patio, Pool, Porch, RoofCover, RoofType, Sewer, Style, WaterService, Features, HomeownerRenter, BusinessOwner, Gender, Investments, DemographicsValue, ReligiousAffiliation, ForeclosureStatus, PropertyTypeCategory, PropertyTypeDetail, LienType, LienTypeCode, LoanType, OwnerStatusType, LastSaleDocumentType, ZoningCode } from "../core/types";
 import type { PropertyFieldMetadata } from "../property-field/metadata";
 /**
  * Base interface for all builders
@@ -147,18 +147,19 @@ declare abstract class BaseBuilder<T> implements Builder<T> {
 }
 /**
  * Base builder for string filters
+ * @template T - Optional union type of allowed string values. Defaults to `string` for backward compatibility.
  */
-export declare class StringFilterBuilder implements Builder<StringFilter> {
+export declare class StringFilterBuilder<T extends string = string> implements Builder<StringFilter<T>> {
     private filter;
-    static from(filter: StringFilter): StringFilterBuilder;
-    equals(value: string): this;
+    static from<T extends string = string>(filter: StringFilter<T>): StringFilterBuilder<T>;
+    equals(value: T): this;
     contains(value: string): this;
     startsWith(value: string): this;
     endsWith(value: string): this;
-    inList(values: string[]): this;
-    notInList(values: string[]): this;
-    matches(patterns: string[]): this;
-    build(): StringFilter;
+    inList(values: T[]): this;
+    notInList(values: T[]): this;
+    matches(patterns: T[]): this;
+    build(): StringFilter<T>;
 }
 /**
  * Base builder for numeric range filters
@@ -286,36 +287,36 @@ export declare class AssessmentSearchCriteriaBuilder extends BaseBuilder<Assessm
 export declare class BuildingSearchCriteriaBuilder extends BaseBuilder<BuildingSearchCriteria> {
     protected criteria: BuildingSearchCriteria;
     static from(criteria: BuildingSearchCriteria): BuildingSearchCriteriaBuilder;
-    airConditioningSource(filter: StringFilter): this;
-    airConditioningSource(configurator: (builder: StringFilterBuilder) => void): this;
-    basementType(filter: StringFilter): this;
-    basementType(configurator: (builder: StringFilterBuilder) => void): this;
+    airConditioningSource(filter: StringFilter<AirConditioningSource>): this;
+    airConditioningSource(configurator: (builder: StringFilterBuilder<AirConditioningSource>) => void): this;
+    basementType(filter: StringFilter<BasementType>): this;
+    basementType(configurator: (builder: StringFilterBuilder<BasementType>) => void): this;
     totalBuildingAreaSquareFeet(filter: NumericRangeFilter): this;
     totalBuildingAreaSquareFeet(configurator: (builder: NumericRangeFilterBuilder) => void): this;
-    buildingClass(filter: StringFilter): this;
-    buildingClass(configurator: (builder: StringFilterBuilder) => void): this;
-    buildingCondition(filter: StringFilter): this;
-    buildingCondition(configurator: (builder: StringFilterBuilder) => void): this;
-    buildingQuality(filter: StringFilter): this;
-    buildingQuality(configurator: (builder: StringFilterBuilder) => void): this;
+    buildingClass(filter: StringFilter<BuildingClass>): this;
+    buildingClass(configurator: (builder: StringFilterBuilder<BuildingClass>) => void): this;
+    buildingCondition(filter: StringFilter<BuildingCondition>): this;
+    buildingCondition(configurator: (builder: StringFilterBuilder<BuildingCondition>) => void): this;
+    buildingQuality(filter: StringFilter<BuildingQuality>): this;
+    buildingQuality(configurator: (builder: StringFilterBuilder<BuildingQuality>) => void): this;
     buildingType(filter: StringFilter): this;
     buildingType(configurator: (builder: StringFilterBuilder) => void): this;
-    driveway(filter: StringFilter): this;
-    driveway(configurator: (builder: StringFilterBuilder) => void): this;
-    exteriorWalls(filter: StringFilter): this;
-    exteriorWalls(configurator: (builder: StringFilterBuilder) => void): this;
-    floorCover(filter: StringFilter): this;
-    floorCover(configurator: (builder: StringFilterBuilder) => void): this;
+    driveway(filter: StringFilter<Driveway>): this;
+    driveway(configurator: (builder: StringFilterBuilder<Driveway>) => void): this;
+    exteriorWalls(filter: StringFilter<ExteriorWalls>): this;
+    exteriorWalls(configurator: (builder: StringFilterBuilder<ExteriorWalls>) => void): this;
+    floorCover(filter: StringFilter<FloorCover>): this;
+    floorCover(configurator: (builder: StringFilterBuilder<FloorCover>) => void): this;
     garageParkingSpaceCount(filter: NumericRangeFilter): this;
     garageParkingSpaceCount(configurator: (builder: NumericRangeFilterBuilder) => void): this;
-    garage(filter: StringFilter): this;
-    garage(configurator: (builder: StringFilterBuilder) => void): this;
-    heatSource(filter: StringFilter): this;
-    heatSource(configurator: (builder: StringFilterBuilder) => void): this;
-    heatingFuelType(filter: StringFilter): this;
-    heatingFuelType(configurator: (builder: StringFilterBuilder) => void): this;
-    interiorWalls(filter: StringFilter): this;
-    interiorWalls(configurator: (builder: StringFilterBuilder) => void): this;
+    garage(filter: StringFilter<Garage>): this;
+    garage(configurator: (builder: StringFilterBuilder<Garage>) => void): this;
+    heatSource(filter: StringFilter<HeatSource>): this;
+    heatSource(configurator: (builder: StringFilterBuilder<HeatSource>) => void): this;
+    heatingFuelType(filter: StringFilter<HeatingFuelType>): this;
+    heatingFuelType(configurator: (builder: StringFilterBuilder<HeatingFuelType>) => void): this;
+    interiorWalls(filter: StringFilter<InteriorWalls>): this;
+    interiorWalls(configurator: (builder: StringFilterBuilder<InteriorWalls>) => void): this;
     buildingCount(filter: NumericRangeFilter): this;
     buildingCount(configurator: (builder: NumericRangeFilterBuilder) => void): this;
     bathroomCount(filter: NumericRangeFilter): this;
@@ -324,34 +325,34 @@ export declare class BuildingSearchCriteriaBuilder extends BaseBuilder<BuildingS
     calculatedBathroomCount(configurator: (builder: NumericRangeFilterBuilder) => void): this;
     bedroomCount(filter: NumericRangeFilter): this;
     bedroomCount(configurator: (builder: NumericRangeFilterBuilder) => void): this;
-    patio(filter: StringFilter): this;
-    patio(configurator: (builder: StringFilterBuilder) => void): this;
+    patio(filter: StringFilter<Patio>): this;
+    patio(configurator: (builder: StringFilterBuilder<Patio>) => void): this;
     storyCount(filter: NumericRangeFilter): this;
     storyCount(configurator: (builder: NumericRangeFilterBuilder) => void): this;
-    features(filter: StringFilter): this;
-    features(configurator: (builder: StringFilterBuilder) => void): this;
+    features(filter: StringFilter<Features>): this;
+    features(configurator: (builder: StringFilterBuilder<Features>) => void): this;
     residentialUnitCount(filter: NumericRangeFilter): this;
     residentialUnitCount(configurator: (builder: NumericRangeFilterBuilder) => void): this;
-    pool(filter: StringFilter): this;
-    pool(configurator: (builder: StringFilterBuilder) => void): this;
-    porch(filter: StringFilter): this;
-    porch(configurator: (builder: StringFilterBuilder) => void): this;
-    roofCover(filter: StringFilter): this;
-    roofCover(configurator: (builder: StringFilterBuilder) => void): this;
-    roofType(filter: StringFilter): this;
-    roofType(configurator: (builder: StringFilterBuilder) => void): this;
-    sewer(filter: StringFilter): this;
-    sewer(configurator: (builder: StringFilterBuilder) => void): this;
-    style(filter: StringFilter): this;
-    style(configurator: (builder: StringFilterBuilder) => void): this;
+    pool(filter: StringFilter<Pool>): this;
+    pool(configurator: (builder: StringFilterBuilder<Pool>) => void): this;
+    porch(filter: StringFilter<Porch>): this;
+    porch(configurator: (builder: StringFilterBuilder<Porch>) => void): this;
+    roofCover(filter: StringFilter<RoofCover>): this;
+    roofCover(configurator: (builder: StringFilterBuilder<RoofCover>) => void): this;
+    roofType(filter: StringFilter<RoofType>): this;
+    roofType(configurator: (builder: StringFilterBuilder<RoofType>) => void): this;
+    sewer(filter: StringFilter<Sewer>): this;
+    sewer(configurator: (builder: StringFilterBuilder<Sewer>) => void): this;
+    style(filter: StringFilter<Style>): this;
+    style(configurator: (builder: StringFilterBuilder<Style>) => void): this;
     roomCount(filter: NumericRangeFilter): this;
     roomCount(configurator: (builder: NumericRangeFilterBuilder) => void): this;
     unitCount(filter: NumericRangeFilter): this;
     unitCount(configurator: (builder: NumericRangeFilterBuilder) => void): this;
-    constructionType(filter: StringFilter): this;
-    constructionType(configurator: (builder: StringFilterBuilder) => void): this;
-    waterService(filter: StringFilter): this;
-    waterService(configurator: (builder: StringFilterBuilder) => void): this;
+    constructionType(filter: StringFilter<ConstructionType>): this;
+    constructionType(configurator: (builder: StringFilterBuilder<ConstructionType>) => void): this;
+    waterService(filter: StringFilter<WaterService>): this;
+    waterService(configurator: (builder: StringFilterBuilder<WaterService>) => void): this;
     yearBuilt(filter: NumericRangeFilter): this;
     yearBuilt(configurator: (builder: NumericRangeFilterBuilder) => void): this;
     build(): BuildingSearchCriteria;
@@ -385,18 +386,18 @@ export declare class DemographicsSearchCriteriaBuilder extends BaseBuilder<Demog
     netWorth(configurator: (builder: NumericRangeFilterBuilder) => void): this;
     discretionaryIncome(filter: NumericRangeFilter): this;
     discretionaryIncome(configurator: (builder: NumericRangeFilterBuilder) => void): this;
-    homeownerRenter(filter: StringFilter): this;
-    homeownerRenter(configurator: (builder: StringFilterBuilder) => void): this;
-    businessOwner(filter: StringFilter): this;
-    businessOwner(configurator: (builder: StringFilterBuilder) => void): this;
-    gender(filter: StringFilter): this;
-    gender(configurator: (builder: StringFilterBuilder) => void): this;
+    homeownerRenter(filter: StringFilter<HomeownerRenter>): this;
+    homeownerRenter(configurator: (builder: StringFilterBuilder<HomeownerRenter>) => void): this;
+    businessOwner(filter: StringFilter<BusinessOwner>): this;
+    businessOwner(configurator: (builder: StringFilterBuilder<BusinessOwner>) => void): this;
+    gender(filter: StringFilter<Gender>): this;
+    gender(configurator: (builder: StringFilterBuilder<Gender>) => void): this;
     hasChildren(value: boolean): this;
-    investments(filter: StringFilter): this;
-    investments(configurator: (builder: StringFilterBuilder) => void): this;
-    demographics(filter: StringFilter): this;
-    demographics(configurator: (builder: StringFilterBuilder) => void): this;
-    religiousAffiliation(filter: StringFilter): this;
+    investments(filter: StringFilter<Investments>): this;
+    investments(configurator: (builder: StringFilterBuilder<Investments>) => void): this;
+    demographics(filter: StringFilter<DemographicsValue>): this;
+    demographics(configurator: (builder: StringFilterBuilder<DemographicsValue>) => void): this;
+    religiousAffiliation(filter: StringFilter<ReligiousAffiliation>): this;
     religiousAffiliation(configurator: (builder: StringFilterBuilder) => void): this;
 }
 /**
@@ -405,8 +406,8 @@ export declare class DemographicsSearchCriteriaBuilder extends BaseBuilder<Demog
 export declare class ForeclosureSearchCriteriaBuilder {
     private criteria;
     static from(criteria: ForeclosureSearchCriteria): ForeclosureSearchCriteriaBuilder;
-    status(filter: StringFilter): this;
-    status(configurator: (builder: StringFilterBuilder) => void): this;
+    status(filter: StringFilter<ForeclosureStatus>): this;
+    status(configurator: (builder: StringFilterBuilder<ForeclosureStatus>) => void): this;
     recordingDate(filter: DateRangeFilter): this;
     recordingDate(configurator: (builder: DateRangeFilterBuilder) => void): this;
     auctionDate(filter: DateRangeFilter): this;
@@ -425,9 +426,9 @@ export declare class ForeclosureSearchCriteriaBuilder {
 export declare class GeneralSearchCriteriaBuilder {
     private criteria;
     static from(criteria: GeneralSearchCriteria): GeneralSearchCriteriaBuilder;
-    propertyTypeCategory(filter: StringFilter): this;
+    propertyTypeCategory(filter: StringFilter<PropertyTypeCategory>): this;
     propertyTypeCategory(configurator: (builder: StringFilterBuilder) => void): this;
-    propertyTypeDetail(filter: StringFilter): this;
+    propertyTypeDetail(filter: StringFilter<PropertyTypeDetail>): this;
     propertyTypeDetail(configurator: (builder: StringFilterBuilder) => void): this;
     build(): GeneralSearchCriteria;
 }
@@ -469,10 +470,10 @@ export declare class IntelSearchCriteriaBuilder {
 export declare class InvoluntaryLienSearchCriteriaBuilder {
     private criteria;
     static from(criteria: InvoluntaryLienSearchCriteria): InvoluntaryLienSearchCriteriaBuilder;
-    lienType(filter: StringFilter): this;
-    lienType(configurator: (builder: StringFilterBuilder) => void): this;
-    lienTypeCode(filter: StringFilter): this;
-    lienTypeCode(configurator: (builder: StringFilterBuilder) => void): this;
+    lienType(filter: StringFilter<LienType>): this;
+    lienType(configurator: (builder: StringFilterBuilder<LienType>) => void): this;
+    lienTypeCode(filter: StringFilter<LienTypeCode>): this;
+    lienTypeCode(configurator: (builder: StringFilterBuilder<LienTypeCode>) => void): this;
     documentType(filter: StringFilter): this;
     documentType(configurator: (builder: StringFilterBuilder) => void): this;
     documentTypeCode(filter: StringFilter): this;
@@ -531,8 +532,8 @@ export declare class LotSearchCriteriaBuilder {
     lotFrontageFeet(configurator: (builder: NumericRangeFilterBuilder) => void): this;
     lotSizeSquareFeet(filter: NumericRangeFilter): this;
     lotSizeSquareFeet(configurator: (builder: NumericRangeFilterBuilder) => void): this;
-    zoningCode(filter: StringFilter): this;
-    zoningCode(configurator: (builder: StringFilterBuilder) => void): this;
+    zoningCode(filter: StringFilter<ZoningCode>): this;
+    zoningCode(configurator: (builder: StringFilterBuilder<ZoningCode>) => void): this;
     build(): LotSearchCriteria;
 }
 /**
@@ -541,8 +542,8 @@ export declare class LotSearchCriteriaBuilder {
 export declare class OpenLienSearchCriteriaBuilder {
     private criteria;
     static from(criteria: OpenLienSearchCriteria): OpenLienSearchCriteriaBuilder;
-    allLoanTypes(filter: StringFilter): this;
-    juniorLoanTypes(filter: StringFilter): this;
+    allLoanTypes(filter: StringFilter<LoanType>): this;
+    juniorLoanTypes(filter: StringFilter<LoanType>): this;
     totalOpenLienCount(filter: NumericRangeFilter): this;
     totalOpenLienBalance(filter: NumericRangeFilter): this;
     firstLoanLtv(filter: NumericRangeFilter): this;
@@ -550,10 +551,10 @@ export declare class OpenLienSearchCriteriaBuilder {
     secondLoanInterestRate(filter: NumericRangeFilter): this;
     thirdLoanInterestRate(filter: NumericRangeFilter): this;
     fourthLoanInterestRate(filter: NumericRangeFilter): this;
-    firstLoanType(filter: StringFilter): this;
-    secondLoanType(filter: StringFilter): this;
-    thirdLoanType(filter: StringFilter): this;
-    fourthLoanType(filter: StringFilter): this;
+    firstLoanType(filter: StringFilter<LoanType>): this;
+    secondLoanType(filter: StringFilter<LoanType>): this;
+    thirdLoanType(filter: StringFilter<LoanType>): this;
+    fourthLoanType(filter: StringFilter<LoanType>): this;
     firstLoanRecordingDate(filter: DateRangeFilter): this;
     lastLoanRecordingDate(filter: DateRangeFilter): this;
     build(): OpenLienSearchCriteria;
@@ -571,7 +572,7 @@ export declare class OwnerSearchCriteriaBuilder {
     mailingCity(filter: StringFilter): this;
     mailingState(filter: StringFilter): this;
     mailingZip(filter: StringFilter): this;
-    ownerStatusType(filter: StringFilter): this;
+    ownerStatusType(filter: StringFilter<OwnerStatusType>): this;
     lengthOfResidenceMonths(filter: NumericRangeFilter): this;
     lengthOfResidenceYears(filter: NumericRangeFilter): this;
     ownershipStartDate(filter: DateRangeFilter): this;
@@ -613,7 +614,8 @@ export declare class SaleSearchCriteriaBuilder {
     static from(criteria: SaleSearchCriteria): SaleSearchCriteriaBuilder;
     lastSalePrice(filter: NumericRangeFilter): this;
     lastSaleDate(filter: DateRangeFilter): this;
-    lastSaleDocumentType(filter: StringFilter): this;
+    lastSaleDocumentType(filter: StringFilter<LastSaleDocumentType>): this;
+    lastSaleDocumentType(configurator: (builder: StringFilterBuilder) => void): this;
     lastSalePricePerSquareFoot(filter: NumericRangeFilter): this;
     flipLength(filter: NumericRangeFilter): this;
     flipLengthCategory(filter: NumericRangeFilter): this;

package/dist/builders/builders.js

@@ -20,6 +20,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PropertyPermitRequestBuilder = exports.PropertyLookupAsyncRequestBuilder = exports.PropertySearchAsyncRequestBuilder = exports.PropertySearchRequestBuilder = exports.PropertyCountRequestBuilder = exports.PropertyLookupRequestBuilder = exports.AsyncPropertyLookupOptionsBuilder = exports.PropertyLookupOptionsBuilder = exports.PropertyLookupRequestItemBuilder = exports.PropertySubscriptionBuilder = exports.DeliveryConfigBuilder = exports.SearchCriteriaBuilder = exports.OrSearchCriteriaBuilder = exports.ValuationSearchCriteriaBuilder = exports.TaxSearchCriteriaBuilder = exports.SaleSearchCriteriaBuilder = exports.PropertyOwnerProfileSearchCriteriaBuilder = exports.PermitSearchCriteriaBuilder = exports.OwnerSearchCriteriaBuilder = exports.OpenLienSearchCriteriaBuilder = exports.LotSearchCriteriaBuilder = exports.ListingSearchCriteriaBuilder = exports.LegalSearchCriteriaBuilder = exports.InvoluntaryLienSearchCriteriaBuilder = exports.IntelSearchCriteriaBuilder = exports.IdsSearchCriteriaBuilder = exports.GeneralSearchCriteriaBuilder = exports.ForeclosureSearchCriteriaBuilder = exports.DemographicsSearchCriteriaBuilder = exports.CompAddressSearchCriteriaBuilder = exports.BuildingSearchCriteriaBuilder = exports.AssessmentSearchCriteriaBuilder = exports.AddressSearchCriteriaBuilder = exports.GeoLocationFactory = exports.DateRangeFilterBuilder = exports.NumericRangeFilterBuilder = exports.StringFilterBuilder = void 0;
 const metadata_1 = require("../property-field/metadata");
+const utils_1 = require("../property-field/utils");
 /**
  * Abstract base class for builders that store nested builders
  * Handles the common pattern of storing builder instances and building them all at once
@@ -88,9 +89,7 @@ class BaseBuilder {
      * ```
      */
     getSearchCriteriaFieldMetadata(searchCriteriaPath) {
-        // Dynamic import to avoid circular dependency
-        const { getSearchCriteriaFieldMetadata, } = require("../property-field/utils");
-        return getSearchCriteriaFieldMetadata(searchCriteriaPath);
+        return (0, utils_1.getSearchCriteriaFieldMetadata)(searchCriteriaPath);
     }
     /**
      * Get SearchCriteria field metadata inferred from Property field metadata
@@ -167,6 +166,7 @@ class BaseBuilder {
 }
 /**
  * Base builder for string filters
+ * @template T - Optional union type of allowed string values. Defaults to `string` for backward compatibility.
  */
 class StringFilterBuilder {
     constructor() {
@@ -439,10 +439,26 @@ class BuildingSearchCriteriaBuilder extends BaseBuilder {
         return builder;
     }
     airConditioningSource(filterOrConfigurator) {
-        return this.setPropertyWithBuilderClass("airConditioningSource", filterOrConfigurator, StringFilterBuilder);
+        if (typeof filterOrConfigurator === "function") {
+            const builder = new StringFilterBuilder();
+            filterOrConfigurator(builder);
+            this.criteria.airConditioningSource = builder.build();
+        }
+        else {
+            this.criteria.airConditioningSource = filterOrConfigurator;
+        }
+        return this;
     }
     basementType(filterOrConfigurator) {
-        return this.setPropertyWithBuilderClass("basementType", filterOrConfigurator, StringFilterBuilder);
+        if (typeof filterOrConfigurator === "function") {
+            const builder = new StringFilterBuilder();
+            filterOrConfigurator(builder);
+            this.criteria.basementType = builder.build();
+        }
+        else {
+            this.criteria.basementType = filterOrConfigurator;
+        }
+        return this;
     }
     totalBuildingAreaSquareFeet(filterOrConfigurator) {
         return this.setPropertyWithBuilderClass("totalBuildingAreaSquareFeet", filterOrConfigurator, NumericRangeFilterBuilder);
@@ -886,26 +902,74 @@ class DemographicsSearchCriteriaBuilder extends BaseBuilder {
         return this.setPropertyWithBuilderClass("discretionaryIncome", filterOrConfigurator, NumericRangeFilterBuilder);
     }
     homeownerRenter(filterOrConfigurator) {
-        return this.setPropertyWithBuilderClass("homeownerRenter", filterOrConfigurator, StringFilterBuilder);
+        if (typeof filterOrConfigurator === "function") {
+            const builder = new StringFilterBuilder();
+            filterOrConfigurator(builder);
+            this.criteria.homeownerRenter = builder.build();
+        }
+        else {
+            this.criteria.homeownerRenter = filterOrConfigurator;
+        }
+        return this;
     }
     businessOwner(filterOrConfigurator) {
-        return this.setPropertyWithBuilderClass("businessOwner", filterOrConfigurator, StringFilterBuilder);
+        if (typeof filterOrConfigurator === "function") {
+            const builder = new StringFilterBuilder();
+            filterOrConfigurator(builder);
+            this.criteria.businessOwner = builder.build();
+        }
+        else {
+            this.criteria.businessOwner = filterOrConfigurator;
+        }
+        return this;
     }
     gender(filterOrConfigurator) {
-        return this.setPropertyWithBuilderClass("gender", filterOrConfigurator, StringFilterBuilder);
+        if (typeof filterOrConfigurator === "function") {
+            const builder = new StringFilterBuilder();
+            filterOrConfigurator(builder);
+            this.criteria.gender = builder.build();
+        }
+        else {
+            this.criteria.gender = filterOrConfigurator;
+        }
+        return this;
     }
     hasChildren(value) {
         this.criteria.hasChildren = { equals: value };
         return this;
     }
     investments(filterOrConfigurator) {
-        return this.setPropertyWithBuilderClass("investments", filterOrConfigurator, StringFilterBuilder);
+        if (typeof filterOrConfigurator === "function") {
+            const builder = new StringFilterBuilder();
+            filterOrConfigurator(builder);
+            this.criteria.investments = builder.build();
+        }
+        else {
+            this.criteria.investments = filterOrConfigurator;
+        }
+        return this;
     }
     demographics(filterOrConfigurator) {
-        return this.setPropertyWithBuilderClass("demographics", filterOrConfigurator, StringFilterBuilder);
+        if (typeof filterOrConfigurator === "function") {
+            const builder = new StringFilterBuilder();
+            filterOrConfigurator(builder);
+            this.criteria.demographics = builder.build();
+        }
+        else {
+            this.criteria.demographics = filterOrConfigurator;
+        }
+        return this;
     }
     religiousAffiliation(filterOrConfigurator) {
-        return this.setPropertyWithBuilderClass("religiousAffiliation", filterOrConfigurator, StringFilterBuilder);
+        if (typeof filterOrConfigurator === "function") {
+            const builder = new StringFilterBuilder();
+            filterOrConfigurator(builder);
+            this.criteria.religiousAffiliation = builder.build();
+        }
+        else {
+            this.criteria.religiousAffiliation = filterOrConfigurator;
+        }
+        return this;
     }
 }
 exports.DemographicsSearchCriteriaBuilder = DemographicsSearchCriteriaBuilder;
@@ -1681,8 +1745,19 @@ class SaleSearchCriteriaBuilder {
         this.criteria.lastSaleDate = filter;
         return this;
     }
-    lastSaleDocumentType(filter) {
-        this.criteria.lastSaleDocumentType = filter;
+    lastSaleDocumentType(filterOrConfigurator) {
+        if (typeof filterOrConfigurator === "function") {
+            const builder = new StringFilterBuilder();
+            filterOrConfigurator(builder);
+            // Type assertion needed because StringFilterBuilder returns StringFilter<string>
+            // but criteria expects StringFilter<LastSaleDocumentType>
+            this.criteria.lastSaleDocumentType = builder.build();
+        }
+        else {
+            // Type assertion needed because StringFilter<string> is not assignable to StringFilter<LastSaleDocumentType>
+            // but at runtime they're compatible
+            this.criteria.lastSaleDocumentType = filterOrConfigurator;
+        }
         return this;
     }
     lastSalePricePerSquareFoot(filter) {

package/dist/client/client.d.ts

@@ -144,6 +144,16 @@ export declare class BatchDataClient implements IBatchDataClient {
     protected readonly logger: ILogger;
     private readonly webhooks?;
     constructor(options: BatchDataClientOptions);
+    /**
+     * Obfuscate sensitive headers (like Authorization) for logging
+     * @param headers Headers object to obfuscate
+     * @returns Headers with sensitive values obfuscated
+     */
+    private obfuscateHeaders;
+    /**
+     * Set up debug logging interceptors for request/response logging
+     */
+    private setupDebugLogging;
     /**
      * Set up axios interceptors from middleware configuration
      * @param middleware The middleware configuration
@@ -254,6 +264,13 @@ export declare class BatchDataClient implements IBatchDataClient {
      * @param options.take Number of properties to return (0 for count-only)
      * @param options.skip Number of properties to skip for pagination
      * @returns Property search API response
+     *
+     * @remarks
+     * The returned PropertySearchResponse includes all possible fields that may be returned
+     * by the API. The actual fields present in the response depend on your subscription level
+     * and the data available for each property. Fields are optional and may be empty objects
+     * (e.g., foreclosure: {}) or undefined if not available. The type system ensures type
+     * safety while allowing for varying response structures based on subscription tier.
      */
     searchProperties(request: PropertySearchRequest): Promise<PropertySearchResponse>;
     /**

package/dist/client/client.js

@@ -32,11 +32,100 @@ class BatchDataClient {
                 Authorization: `Bearer ${options.apiKey}`,
             },
         });
+        // Set up debug logging interceptors
+        this.setupDebugLogging();
         // Set up middleware/interceptors if provided
         if (options.middleware) {
             this.setupMiddleware(options.middleware);
         }
     }
+    /**
+     * Obfuscate sensitive headers (like Authorization) for logging
+     * @param headers Headers object to obfuscate
+     * @returns Headers with sensitive values obfuscated
+     */
+    obfuscateHeaders(headers) {
+        if (!headers)
+            return headers;
+        const obfuscated = { ...headers };
+        // Obfuscate Authorization header
+        if (obfuscated.Authorization || obfuscated.authorization) {
+            const authHeader = (obfuscated.Authorization ||
+                obfuscated.authorization);
+            if (typeof authHeader === "string" && authHeader.startsWith("Bearer ")) {
+                const token = authHeader.substring(7);
+                if (token.length > 8) {
+                    // Show first 4 and last 4 characters, obfuscate the middle
+                    const obfuscatedToken = `${token.substring(0, 4)}${"*".repeat(Math.min(token.length - 8, 20))}${token.substring(token.length - 4)}`;
+                    obfuscated.Authorization = `Bearer ${obfuscatedToken}`;
+                    if (obfuscated.authorization) {
+                        obfuscated.authorization = obfuscated.Authorization;
+                    }
+                }
+                else {
+                    obfuscated.Authorization = "Bearer ***";
+                    if (obfuscated.authorization) {
+                        obfuscated.authorization = "Bearer ***";
+                    }
+                }
+            }
+        }
+        return obfuscated;
+    }
+    /**
+     * Set up debug logging interceptors for request/response logging
+     */
+    setupDebugLogging() {
+        // Request interceptor - log full request details
+        this.axiosInstance.interceptors.request.use((config) => {
+            const obfuscatedHeaders = this.obfuscateHeaders(config.headers);
+            this.logger.debug("HTTP Request", {
+                method: config.method?.toUpperCase(),
+                url: config.url,
+                baseURL: config.baseURL,
+                headers: obfuscatedHeaders,
+                params: config.params,
+                data: config.data,
+            });
+            return config;
+        }, (error) => {
+            this.logger.error("Request interceptor error", error);
+            return Promise.reject(error);
+        });
+        // Response interceptor - log full response details
+        this.axiosInstance.interceptors.response.use((response) => {
+            const obfuscatedHeaders = this.obfuscateHeaders(response.headers);
+            this.logger.debug("HTTP Response", {
+                status: response.status,
+                statusText: response.statusText,
+                headers: obfuscatedHeaders,
+                data: response.data,
+                config: {
+                    method: response.config.method?.toUpperCase(),
+                    url: response.config.url,
+                    baseURL: response.config.baseURL,
+                },
+            });
+            return response;
+        }, (error) => {
+            // Log error response if available
+            if (error.response) {
+                const obfuscatedHeaders = this.obfuscateHeaders(error.response.headers);
+                this.logger.debug("HTTP Error Response", {
+                    status: error.response.status,
+                    statusText: error.response.statusText,
+                    headers: obfuscatedHeaders,
+                    data: error.response.data,
+                    config: {
+                        method: error.config?.method?.toUpperCase(),
+                        url: error.config?.url,
+                        baseURL: error.config?.baseURL,
+                    },
+                });
+            }
+            return Promise.reject(error);
+        });
+    }
     /**
      * Set up axios interceptors from middleware configuration
      * @param middleware The middleware configuration
@@ -304,6 +393,13 @@ class BatchDataClient {
      * @param options.take Number of properties to return (0 for count-only)
      * @param options.skip Number of properties to skip for pagination
      * @returns Property search API response
+     *
+     * @remarks
+     * The returned PropertySearchResponse includes all possible fields that may be returned
+     * by the API. The actual fields present in the response depend on your subscription level
+     * and the data available for each property. Fields are optional and may be empty objects
+     * (e.g., foreclosure: {}) or undefined if not available. The type system ensures type
+     * safety while allowing for varying response structures based on subscription tier.
      */
     async searchProperties(request) {
         const url = `${this.v1BaseUrl}/property/search`;