@land-catalyst/batch-data-sdk 1.1.19 → 1.2.0

package/README.md

@@ -366,6 +366,23 @@ const subscription = new PropertySubscriptionBuilder()
   .build();
 ```
 
+### Property Subscription with Event Hub
+
+```typescript
+const subscription = new PropertySubscriptionBuilder()
+  .searchCriteria((c) => c.query("Phoenix, AZ").orQuickLists(["on-market"]))
+  .deliveryConfig((dc) =>
+    dc.eventHub({
+      fullyQualifiedNamespace: "mynamespace.servicebus.windows.net",
+      clientId: "12345678-1234-1234-1234-123456789abc",
+      tenantId: "87654321-4321-4321-4321-cba987654321",
+      clientSecret: "your-client-secret",
+      eventHubName: "property-events",
+    })
+  )
+  .build();
+```
+
 ### Property Lookup by Address
 
 ```typescript
@@ -903,7 +920,8 @@ if (response.results?.quicklistCounts) {
 - `PropertySubscriptionResponse` - Subscription creation response
 - `PropertySearchResponse` - Property search API response
 - `Property` - Individual property object with all nested data
-- `DeliveryConfig` - Webhook or Kinesis delivery configuration
+- `DeliveryConfig` - Webhook, Kinesis, or Event Hub delivery configuration
+- `EventHubConfig` - Azure Event Hub configuration
 
 ### Builders
 

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, 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, PropertySearchRequest, PropertySearchAsyncRequest, PropertyLookupAsyncRequest, GeoPoint } from "../core/types";
 import type { PropertyFieldMetadata } from "../property-field/metadata";
 /**
  * Base interface for all builders
@@ -735,6 +735,7 @@ export declare class DeliveryConfigBuilder {
     static from(config: DeliveryConfig): DeliveryConfigBuilder;
     webhook(url: string, headers?: Record<string, string>, errorUrl?: string): this;
     kinesis(streamName: string, region: string, iamAccessKeyId: string, iamSecretAccessKey: string): this;
+    eventHub(config: EventHubConfig): this;
     build(): DeliveryConfig;
 }
 /**

package/dist/builders/builders.js

@@ -90,7 +90,7 @@ class BaseBuilder {
     getSearchCriteriaFieldMetadata(searchCriteriaPath) {
         // Dynamic import to avoid circular dependency
         // eslint-disable-next-line @typescript-eslint/no-require-imports
-        const { getSearchCriteriaFieldMetadata } = require("../property-field/utils");
+        const { getSearchCriteriaFieldMetadata, } = require("../property-field/utils");
         return getSearchCriteriaFieldMetadata(searchCriteriaPath);
     }
     /**
@@ -2095,9 +2095,14 @@ class DeliveryConfigBuilder {
         this.config.iamSecretAccessKey = iamSecretAccessKey;
         return this;
     }
+    eventHub(config) {
+        this.config.type = "event-hub";
+        this.config.eventHub = config;
+        return this;
+    }
     build() {
         if (!this.config.type) {
-            throw new Error("Delivery type (webhook or kinesis) is required");
+            throw new Error("Delivery type (webhook, kinesis, or event-hub) is required");
         }
         if (this.config.type === "webhook" && !this.config.url) {
             throw new Error("URL is required for webhook delivery");
@@ -2110,6 +2115,19 @@ class DeliveryConfigBuilder {
                 throw new Error("Stream name, region, IAM access key ID, and secret access key are required for Kinesis delivery");
             }
         }
+        if (this.config.type === "event-hub") {
+            if (!this.config.eventHub) {
+                throw new Error("Event Hub configuration is required for event-hub delivery");
+            }
+            const { fullyQualifiedNamespace, clientId, tenantId, clientSecret, eventHubName, } = this.config.eventHub;
+            if (!fullyQualifiedNamespace ||
+                !clientId ||
+                !tenantId ||
+                !clientSecret ||
+                !eventHubName) {
+                throw new Error("Fully qualified namespace, client ID, tenant ID, client secret, and event hub name are required for Event Hub delivery");
+            }
+        }
         return this.config;
     }
 }

package/dist/core/types.d.ts

@@ -379,10 +379,20 @@ export interface SearchCriteria {
     or?: OrSearchCriteria[];
 }
 /**
- * Delivery configuration for webhook or Kinesis
+ * Event Hub configuration for Azure Event Hubs
+ */
+export interface EventHubConfig {
+    fullyQualifiedNamespace: string;
+    clientId: string;
+    tenantId: string;
+    clientSecret: string;
+    eventHubName: string;
+}
+/**
+ * Delivery configuration for webhook, Kinesis, or Event Hub
  */
 export interface DeliveryConfig {
-    type: "webhook" | "kinesis";
+    type: "webhook" | "kinesis" | "event-hub";
     streamName?: string;
     region?: string;
     iamAccessKeyId?: string;
@@ -390,6 +400,7 @@ export interface DeliveryConfig {
     url?: string;
     errorUrl?: string;
     headers?: Record<string, string>;
+    eventHub?: EventHubConfig;
 }
 /**
  * Property subscription request payload

package/package.json

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