@land-catalyst/batch-data-sdk 1.3.0 → 1.3.2

package/dist/builders/builders.js

@@ -2276,7 +2276,9 @@ class PropertySubscriptionBuilder extends RequestWithSearchCriteriaBuilder {
     static from(request) {
         const builder = new PropertySubscriptionBuilder();
         builder.searchCriteria(request.searchCriteria);
-        builder.deliveryConfig(request.deliveryConfig);
+        if (request.deliveryConfig) {
+            builder.deliveryConfig(request.deliveryConfig);
+        }
         if (request.options) {
             builder.options(request.options);
         }
@@ -2297,12 +2299,11 @@ class PropertySubscriptionBuilder extends RequestWithSearchCriteriaBuilder {
     }
     build() {
         this.validateSearchCriteria();
-        if (!this.criteria.deliveryConfig) {
-            throw new Error("Delivery configuration is required");
-        }
         const request = {
             searchCriteria: this.criteria.searchCriteria,
-            deliveryConfig: this.criteria.deliveryConfig,
+            ...(this.criteria.deliveryConfig && {
+                deliveryConfig: this.criteria.deliveryConfig,
+            }),
         };
         return this.buildOptionsIntoRequest(request);
     }

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 } 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.).
@@ -98,6 +98,10 @@ export interface AsyncWebhookConfiguration {
      */
     propertySubscription?: AsyncWebhookUrls;
 }
+/**
+ * Event Hub configuration for async API requests
+ * Allows specifying Event Hub config per endpoint type, with fallback to defaults
+ */
 /**
  * BatchData API Client Options
  */
@@ -129,6 +133,22 @@ export interface BatchDataClientOptions {
      * Allows specifying webhook URLs per endpoint type, with fallback to defaults
      */
     webhooks?: AsyncWebhookConfiguration;
+    /**
+     * Optional default delivery configuration for property subscriptions
+     * If provided, this will be used when a subscription request doesn't specify deliveryConfig
+     *
+     * @example
+     * ```typescript
+     * const client = new BatchDataClient({
+     *   apiKey: "...",
+     *   defaultDeliveryConfig: {
+     *     type: "webhook",
+     *     url: "https://example.com/webhook",
+     *   }
+     * });
+     * ```
+     */
+    defaultDeliveryConfig?: DeliveryConfig;
     /**
      * Optional default PropertyLookupOptions to apply to all requests
      * These defaults are merged with request-specific options, with request options taking precedence
@@ -178,6 +198,7 @@ export declare class BatchDataClient implements IBatchDataClient {
     protected readonly axiosInstance: AxiosInstance;
     protected readonly logger: ILogger;
     private readonly webhooks?;
+    private readonly defaultDeliveryConfig?;
     private readonly defaultOptions?;
     private readonly maxTake?;
     constructor(options: BatchDataClientOptions);
@@ -231,14 +252,14 @@ export declare class BatchDataClient implements IBatchDataClient {
      */
     private applyDefaultOptions;
     /**
-     * Apply default webhook URLs to a property subscription request if they're not already set.
-     * This helper ensures that if webhook URLs are configured in the client,
-     * they will be used for property subscriptions that don't explicitly specify webhook URLs.
+     * 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 webhook URLs applied (if needed)
+     * @returns The request with delivery config applied (if needed)
+     * @throws Error if deliveryConfig is not set and no default is available
      */
-    private applyPropertySubscriptionWebhooks;
+    private applyDeliveryConfigDefaults;
     /**
      * Add a request middleware function that executes before requests are sent.
      * Useful for adding headers, logging, metrics, etc.

package/dist/client/client.js

@@ -24,6 +24,7 @@ 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.defaultDeliveryConfig = options.defaultDeliveryConfig;
         this.defaultOptions = options.defaultOptions;
         this.maxTake = options.maxTake;
         this.axiosInstance = axios_1.default.create({
@@ -288,53 +289,23 @@ class BatchDataClient {
         };
     }
     /**
-     * Apply default webhook URLs to a property subscription request if they're not already set.
-     * This helper ensures that if webhook URLs are configured in the client,
-     * they will be used for property subscriptions that don't explicitly specify webhook URLs.
+     * 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 webhook URLs applied (if needed)
-     */
-    applyPropertySubscriptionWebhooks(request) {
-        // 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;
-        }
-        // If no webhook URLs are configured, return original request
-        if (!webhookUrl && !errorWebhookUrl) {
-            return request;
-        }
-        // If deliveryConfig is not set or is not a webhook type, create/update it
-        const deliveryConfig = request.deliveryConfig || {
-            type: "webhook",
-        };
-        // Only apply defaults if deliveryConfig is a webhook type
-        if (deliveryConfig.type === "webhook") {
-            // Apply webhook URL if not already set
-            if (!deliveryConfig.url && webhookUrl) {
-                deliveryConfig.url = webhookUrl;
-            }
-            // Apply error webhook URL if not already set
-            if (!deliveryConfig.errorUrl && errorWebhookUrl) {
-                deliveryConfig.errorUrl = errorWebhookUrl;
+     * @returns The request with delivery config applied (if needed)
+     * @throws Error if deliveryConfig is not set and no default is available
+     */
+    applyDeliveryConfigDefaults(request) {
+        // If deliveryConfig is not set, use defaultDeliveryConfig
+        if (!request.deliveryConfig) {
+            if (this.defaultDeliveryConfig) {
+                return { ...request, deliveryConfig: this.defaultDeliveryConfig };
             }
+            throw new Error("Property subscription requires delivery configuration. " +
+                "Please provide deliveryConfig in the request, or configure defaultDeliveryConfig in BatchDataClient options.");
         }
-        // Return a new request object with updated deliveryConfig
-        return {
-            ...request,
-            deliveryConfig: {
-                ...deliveryConfig,
-            },
-        };
+        return request;
     }
     /**
      * Add a request middleware function that executes before requests are sent.
@@ -449,8 +420,8 @@ class BatchDataClient {
      */
     async createPropertySubscription(request) {
         const url = `${this.v2BaseUrl}/property-subscription`;
-        // Apply default webhook URLs if configured
-        let requestWithDefaults = this.applyPropertySubscriptionWebhooks(request);
+        // Apply default delivery config (Event Hub preferred over webhooks)
+        let requestWithDefaults = this.applyDeliveryConfigDefaults(request);
         // Apply defaults and limits (including maxTake)
         requestWithDefaults =
             this.applySearchRequestDefaultsAndLimits(requestWithDefaults);

package/dist/core/types.d.ts

@@ -479,7 +479,7 @@ export interface DeliveryConfig {
  * Property subscription request payload
  */
 export interface PropertySubscriptionRequest extends RequestWithSearchCriteria {
-    deliveryConfig: DeliveryConfig;
+    deliveryConfig?: DeliveryConfig;
 }
 /**
  * Property subscription response

package/package.json

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