@land-catalyst/batch-data-sdk 1.2.6 → 1.2.9

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, 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;
@@ -813,6 +815,17 @@ export declare class PropertyLookupRequestBuilder extends BaseBuilder<PropertyLo
     options(configurator: (builder: PropertyLookupOptionsBuilder) => void): this;
     build(): PropertyLookupRequest;
 }
+/**
+ * Builder for property count requests
+ *
+ * Used specifically for count-only requests that should never fetch property data.
+ */
+export declare class PropertyCountRequestBuilder extends BaseBuilder<PropertyCountRequest> {
+    static from(request: PropertyCountRequest): PropertyCountRequestBuilder;
+    searchCriteria(criteria: SearchCriteria): this;
+    searchCriteria(configurator: (builder: SearchCriteriaBuilder) => void): this;
+    build(): PropertyCountRequest;
+}
 /**
  * Builder for property search requests
  */

package/dist/builders/builders.js

@@ -18,8 +18,9 @@
  * ```
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PropertyPermitRequestBuilder = exports.PropertyLookupAsyncRequestBuilder = exports.PropertySearchAsyncRequestBuilder = exports.PropertySearchRequestBuilder = 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;
+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) {
@@ -2421,6 +2496,40 @@ class PropertyLookupRequestBuilder extends BaseBuilder {
     }
 }
 exports.PropertyLookupRequestBuilder = PropertyLookupRequestBuilder;
+/**
+ * Builder for property count requests
+ *
+ * Used specifically for count-only requests that should never fetch property data.
+ */
+class PropertyCountRequestBuilder extends BaseBuilder {
+    static from(request) {
+        const builder = new PropertyCountRequestBuilder();
+        builder.searchCriteria(request.searchCriteria);
+        return builder;
+    }
+    searchCriteria(criteriaOrConfigurator) {
+        if (typeof criteriaOrConfigurator === "function") {
+            const builder = new SearchCriteriaBuilder("");
+            criteriaOrConfigurator(builder);
+            this.criteria.searchCriteria = builder.build();
+            this.builders.searchCriteria = undefined;
+        }
+        else {
+            this.criteria.searchCriteria = criteriaOrConfigurator;
+            this.builders.searchCriteria = undefined;
+        }
+        return this;
+    }
+    build() {
+        if (!this.criteria.searchCriteria) {
+            throw new Error("Search criteria is required");
+        }
+        return {
+            searchCriteria: this.criteria.searchCriteria,
+        };
+    }
+}
+exports.PropertyCountRequestBuilder = PropertyCountRequestBuilder;
 /**
  * Builder for property search requests
  */

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, PropertySearchRequest, PropertySearchResponse, 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 } from "../core/types";
+import { PropertySubscriptionRequest, PropertySubscriptionResponse, PropertyCountRequest, PropertySearchRequest, PropertySearchResponse, 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 } 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.).
@@ -258,10 +258,14 @@ export declare class BatchDataClient implements IBatchDataClient {
     searchProperties(request: PropertySearchRequest): Promise<PropertySearchResponse>;
     /**
      * Get the count of properties matching the search criteria
-     * @param searchCriteria Search criteria to match properties
+     *
+     * Uses PropertyCountRequest to ensure no property data is fetched (count-only).
+     * This prevents accidental charges for property data retrieval.
+     *
+     * @param searchRequest Count request with search criteria (no options allowed)
      * @returns Number of matching properties, or null if the endpoint is unavailable
      */
-    getPropertyCount(searchRequest: PropertySearchRequest): Promise<number | null>;
+    getPropertyCount(searchRequest: PropertyCountRequest): Promise<number | null>;
     /**
      * Verify and normalize addresses (v1 API)
      * POST /api/v1/address/verify

package/dist/client/client.interface.d.ts

@@ -1,4 +1,4 @@
-import { PropertySubscriptionRequest, PropertySubscriptionResponse, PropertySearchRequest, PropertySearchResponse, 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 } from "../core/types";
+import { PropertySubscriptionRequest, PropertySubscriptionResponse, PropertyCountRequest, PropertySearchRequest, PropertySearchResponse, 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 } from "../core/types";
 /**
  * BatchData API Client Interface
  *
@@ -26,10 +26,14 @@ export interface IBatchDataClient {
     searchProperties(request: PropertySearchRequest): Promise<PropertySearchResponse>;
     /**
      * Get the count of properties matching the search criteria
-     * @param searchCriteria Search criteria to match properties
+     *
+     * Uses PropertyCountRequest to ensure no property data is fetched (count-only).
+     * This prevents accidental charges for property data retrieval.
+     *
+     * @param searchRequest Count request with search criteria (no options allowed)
      * @returns Number of matching properties, or null if the endpoint is unavailable
      */
-    getPropertyCount(searchRequest: PropertySearchRequest): Promise<number | null>;
+    getPropertyCount(searchRequest: PropertyCountRequest): Promise<number | null>;
     /**
      * Verify and normalize addresses (v1 API)
      * POST /api/v1/address/verify

package/dist/client/client.js

@@ -321,14 +321,17 @@ class BatchDataClient {
     }
     /**
      * Get the count of properties matching the search criteria
-     * @param searchCriteria Search criteria to match properties
+     *
+     * Uses PropertyCountRequest to ensure no property data is fetched (count-only).
+     * This prevents accidental charges for property data retrieval.
+     *
+     * @param searchRequest Count request with search criteria (no options allowed)
      * @returns Number of matching properties, or null if the endpoint is unavailable
      */
     async getPropertyCount(searchRequest) {
-        const { searchCriteria, options } = searchRequest;
-        const lookupOptions = options
-            ? builders_1.PropertyLookupOptionsBuilder.from(options).take(0)
-            : new builders_1.PropertyLookupOptionsBuilder();
+        const { searchCriteria } = searchRequest;
+        // Always use take(0) to ensure no property data is fetched
+        const lookupOptions = new builders_1.PropertyLookupOptionsBuilder().take(0);
         const response = await this.searchProperties({
             searchCriteria,
             options: lookupOptions.build(),