@adcp/sdk 14.0.0-rc.38 → 14.0.0-rc.39

package/dist/lib/version.js

@@ -31,18 +31,13 @@ __export(version_exports, {
   toReleasePrecisionVersion: () => toReleasePrecisionVersion
 });
 module.exports = __toCommonJS(version_exports);
-const LIBRARY_VERSION = "14.0.0-rc.38";
+const LIBRARY_VERSION = "14.0.0-rc.39";
 const ADCP_VERSION = "3.2.0-rc.3";
 const ADCP_MAJOR_VERSION = 3;
 const COMPATIBLE_ADCP_VERSIONS = [
   "v2.5",
   "v2.6",
   "v3",
-  "3.0.0-beta.1",
-  "3.0-beta.1",
-  "3.0-beta",
-  "3.0.0-beta.3",
-  "3.0-beta.3",
   "3.0.0",
   "3.0",
   "3.0.1",
@@ -94,10 +89,10 @@ const COMPATIBLE_ADCP_VERSIONS = [
   "3.2-rc.3"
 ];
 const VERSION_INFO = {
-  library: "14.0.0-rc.38",
+  library: "14.0.0-rc.39",
   adcp: "3.2.0-rc.3",
   compatibleVersions: COMPATIBLE_ADCP_VERSIONS,
-  generatedAt: "2026-09-15T06:38:17.041Z"
+  generatedAt: "2026-09-18T19:37:01.879Z"
 };
 function getAdcpVersion() {
   return ADCP_VERSION;

package/dist/lib/version.mjs

@@ -1,15 +1,10 @@
-const LIBRARY_VERSION = "14.0.0-rc.38";
+const LIBRARY_VERSION = "14.0.0-rc.39";
 const ADCP_VERSION = "3.2.0-rc.3";
 const ADCP_MAJOR_VERSION = 3;
 const COMPATIBLE_ADCP_VERSIONS = [
   "v2.5",
   "v2.6",
   "v3",
-  "3.0.0-beta.1",
-  "3.0-beta.1",
-  "3.0-beta",
-  "3.0.0-beta.3",
-  "3.0-beta.3",
   "3.0.0",
   "3.0",
   "3.0.1",
@@ -61,10 +56,10 @@ const COMPATIBLE_ADCP_VERSIONS = [
   "3.2-rc.3"
 ];
 const VERSION_INFO = {
-  library: "14.0.0-rc.38",
+  library: "14.0.0-rc.39",
   adcp: "3.2.0-rc.3",
   compatibleVersions: COMPATIBLE_ADCP_VERSIONS,
-  generatedAt: "2026-09-15T06:38:17.041Z"
+  generatedAt: "2026-09-18T19:37:01.879Z"
 };
 function getAdcpVersion() {
   return ADCP_VERSION;

package/dist/lib/wholesale-feed-sync/index.d.mts

@@ -2,3 +2,4 @@ export { WholesaleFeedSync } from './sync.mjs';
 export { normalizeWholesaleFeedWebhookNotification, parseWholesaleFeedWebhookNotification, WholesaleFeedWebhookNotificationError, } from './webhook-notification.mjs';
 export type { WholesaleFeedSyncClient, WholesaleFeedSyncConfig, WholesaleFeedSyncEvents, WholesaleFeedSyncMode, WholesaleFeedSyncState, ProductFilter, ResolvedCapabilities, SignalFilter, } from './types.mjs';
 export type { NormalizedWholesaleFeedWebhookNotification, WholesaleFeedWebhookAffectedEntityType, WholesaleFeedWebhookCacheScope, WholesaleFeedWebhookNotificationErrorCode, WholesaleFeedWebhookNotificationErrorDetails, WholesaleFeedWebhookNotificationType, } from './webhook-notification.mjs';
+export type { LegacyWholesaleFeedEvent, LegacyWholesaleFeedWebhook, LegacyWholesaleProduct, LegacyWholesaleSignal, } from './protocol-types.mjs';

package/dist/lib/wholesale-feed-sync/index.d.ts

@@ -2,3 +2,4 @@ export { WholesaleFeedSync } from './sync';
 export { normalizeWholesaleFeedWebhookNotification, parseWholesaleFeedWebhookNotification, WholesaleFeedWebhookNotificationError, } from './webhook-notification';
 export type { WholesaleFeedSyncClient, WholesaleFeedSyncConfig, WholesaleFeedSyncEvents, WholesaleFeedSyncMode, WholesaleFeedSyncState, ProductFilter, ResolvedCapabilities, SignalFilter, } from './types';
 export type { NormalizedWholesaleFeedWebhookNotification, WholesaleFeedWebhookAffectedEntityType, WholesaleFeedWebhookCacheScope, WholesaleFeedWebhookNotificationErrorCode, WholesaleFeedWebhookNotificationErrorDetails, WholesaleFeedWebhookNotificationType, } from './webhook-notification';
+export type { LegacyWholesaleFeedEvent, LegacyWholesaleFeedWebhook, LegacyWholesaleProduct, LegacyWholesaleSignal, } from './protocol-types';

package/dist/lib/wholesale-feed-sync/protocol-types.d.mts

@@ -0,0 +1,42 @@
+import type { GetProductsResponse, GetSignalsResponse, WholesaleFeedEvent as CurrentWholesaleFeedEvent, WholesaleFeedWebhook as CurrentWholesaleFeedWebhook } from '../types/index.mjs';
+export type LegacyWholesaleProduct = NonNullable<GetProductsResponse['products']>[number];
+export type LegacyWholesaleSignal = NonNullable<GetSignalsResponse['signals']>[number];
+type EventOf<K extends CurrentWholesaleFeedEvent['event_type']> = Extract<CurrentWholesaleFeedEvent, {
+    event_type: K;
+}>;
+type WithPayload<TEvent, TPayload> = Omit<TEvent, 'payload'> & {
+    payload: TPayload;
+};
+type LegacyProductPayload<K extends 'product.created' | 'product.updated'> = Omit<EventOf<K>['payload'], 'product' | 'canonical_product'> & {
+    product: LegacyWholesaleProduct;
+    canonical_product?: never;
+};
+type LegacyPricingPayload = Omit<EventOf<'product.priced'>['payload'], 'pricing_options' | 'canonical_pricing_options'> & {
+    pricing_options: NonNullable<LegacyWholesaleProduct['pricing_options']>;
+    canonical_pricing_options?: never;
+};
+/**
+ * Wholesale-feed event shape supported by this legacy `get_products` mirror.
+ *
+ * AdCP 3.2 also defines canonical `list_products` payloads. This sync engine
+ * intentionally accepts the legacy view only until it implements canonical
+ * product storage and repair semantics.
+ */
+export type LegacyWholesaleFeedEvent = WithPayload<EventOf<'product.created'>, LegacyProductPayload<'product.created'>> | WithPayload<EventOf<'product.updated'>, LegacyProductPayload<'product.updated'>> | WithPayload<EventOf<'product.priced'>, LegacyPricingPayload> | Exclude<CurrentWholesaleFeedEvent, {
+    event_type: 'product.created' | 'product.updated' | 'product.priced';
+}>;
+/**
+ * Historical beta envelopes omitted `product_payload_view`; current 3.2
+ * legacy-view envelopes set it to `legacy`. Both forms map to the same mirror.
+ */
+type LegacyWebhookBase = Omit<CurrentWholesaleFeedWebhook, 'event' | 'notification_type' | 'product_payload_view'>;
+type LegacyWebhookFor<TEvent extends LegacyWholesaleFeedEvent> = TEvent extends LegacyWholesaleFeedEvent ? LegacyWebhookBase & {
+    event: TEvent;
+    notification_type: TEvent['event_type'];
+} & (TEvent['event_type'] extends `product.${string}` ? {
+    product_payload_view?: 'legacy';
+} : {
+    product_payload_view?: never;
+}) : never;
+export type LegacyWholesaleFeedWebhook = LegacyWebhookFor<LegacyWholesaleFeedEvent>;
+export {};

package/dist/lib/wholesale-feed-sync/protocol-types.d.ts

@@ -0,0 +1,42 @@
+import type { GetProductsResponse, GetSignalsResponse, WholesaleFeedEvent as CurrentWholesaleFeedEvent, WholesaleFeedWebhook as CurrentWholesaleFeedWebhook } from '../types';
+export type LegacyWholesaleProduct = NonNullable<GetProductsResponse['products']>[number];
+export type LegacyWholesaleSignal = NonNullable<GetSignalsResponse['signals']>[number];
+type EventOf<K extends CurrentWholesaleFeedEvent['event_type']> = Extract<CurrentWholesaleFeedEvent, {
+    event_type: K;
+}>;
+type WithPayload<TEvent, TPayload> = Omit<TEvent, 'payload'> & {
+    payload: TPayload;
+};
+type LegacyProductPayload<K extends 'product.created' | 'product.updated'> = Omit<EventOf<K>['payload'], 'product' | 'canonical_product'> & {
+    product: LegacyWholesaleProduct;
+    canonical_product?: never;
+};
+type LegacyPricingPayload = Omit<EventOf<'product.priced'>['payload'], 'pricing_options' | 'canonical_pricing_options'> & {
+    pricing_options: NonNullable<LegacyWholesaleProduct['pricing_options']>;
+    canonical_pricing_options?: never;
+};
+/**
+ * Wholesale-feed event shape supported by this legacy `get_products` mirror.
+ *
+ * AdCP 3.2 also defines canonical `list_products` payloads. This sync engine
+ * intentionally accepts the legacy view only until it implements canonical
+ * product storage and repair semantics.
+ */
+export type LegacyWholesaleFeedEvent = WithPayload<EventOf<'product.created'>, LegacyProductPayload<'product.created'>> | WithPayload<EventOf<'product.updated'>, LegacyProductPayload<'product.updated'>> | WithPayload<EventOf<'product.priced'>, LegacyPricingPayload> | Exclude<CurrentWholesaleFeedEvent, {
+    event_type: 'product.created' | 'product.updated' | 'product.priced';
+}>;
+/**
+ * Historical beta envelopes omitted `product_payload_view`; current 3.2
+ * legacy-view envelopes set it to `legacy`. Both forms map to the same mirror.
+ */
+type LegacyWebhookBase = Omit<CurrentWholesaleFeedWebhook, 'event' | 'notification_type' | 'product_payload_view'>;
+type LegacyWebhookFor<TEvent extends LegacyWholesaleFeedEvent> = TEvent extends LegacyWholesaleFeedEvent ? LegacyWebhookBase & {
+    event: TEvent;
+    notification_type: TEvent['event_type'];
+} & (TEvent['event_type'] extends `product.${string}` ? {
+    product_payload_view?: 'legacy';
+} : {
+    product_payload_view?: never;
+}) : never;
+export type LegacyWholesaleFeedWebhook = LegacyWebhookFor<LegacyWholesaleFeedEvent>;
+export {};

package/dist/lib/wholesale-feed-sync/protocol-types.js

@@ -0,0 +1,16 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var protocol_types_exports = {};
+module.exports = __toCommonJS(protocol_types_exports);

package/dist/lib/wholesale-feed-sync/sync.d.mts

@@ -1,8 +1,8 @@
 import { EventEmitter } from 'node:events';
-import type * as V31Beta from '../types/v3-1-beta/index.mjs';
+import type { LegacyWholesaleFeedWebhook, LegacyWholesaleProduct, LegacyWholesaleSignal } from './protocol-types.mjs';
 import type { WholesaleFeedSyncConfig, WholesaleFeedSyncEvents, WholesaleFeedSyncMode, WholesaleFeedSyncState, ProductFilter, ResolvedCapabilities, SignalFilter } from './types.mjs';
-type Product = V31Beta.Product;
-type Signal = NonNullable<V31Beta.GetSignalsResponse['signals']>[number];
+type Product = LegacyWholesaleProduct;
+type Signal = LegacyWholesaleSignal;
 /**
  * In-memory mirror of an AdCP agent's wholesale product and signal feeds.
  *
@@ -16,7 +16,7 @@ type Signal = NonNullable<V31Beta.GetSignalsResponse['signals']>[number];
  * import { AdCPClient } from '@adcp/sdk';
  * import { WholesaleFeedSync } from '@adcp/sdk/wholesale-feed-sync';
  *
- * const client = new AdCPClient({ agentUrl, adcpVersion: '3.1-beta' });
+ * const client = new AdCPClient({ agentUrl });
  * const sync = new WholesaleFeedSync({ client });
  *
  * sync.on('product.priced', ({ event }) => {
@@ -123,12 +123,12 @@ export declare class WholesaleFeedSync extends EventEmitter<WholesaleFeedSyncEve
      */
     refresh(): Promise<void>;
     /**
-     * Apply one beta-3 account-level wholesale feed webhook to the local mirror.
+     * Apply one legacy-view account-level wholesale feed webhook to the local mirror.
      * Call this from your HTTP webhook receiver after signature/auth validation.
      * Stale or out-of-order deliveries repair through conditional wholesale
      * reads instead of applying a suspect delta.
      */
-    applyWebhook(webhook: V31Beta.WholesaleFeedWebhook): Promise<void>;
+    applyWebhook(webhook: LegacyWholesaleFeedWebhook): Promise<void>;
     get state(): WholesaleFeedSyncState;
     get mode(): WholesaleFeedSyncMode;
     get capabilities(): Readonly<ResolvedCapabilities>;

package/dist/lib/wholesale-feed-sync/sync.d.ts

@@ -1,8 +1,8 @@
 import { EventEmitter } from 'node:events';
-import type * as V31Beta from '../types/v3-1-beta';
+import type { LegacyWholesaleFeedWebhook, LegacyWholesaleProduct, LegacyWholesaleSignal } from './protocol-types';
 import type { WholesaleFeedSyncConfig, WholesaleFeedSyncEvents, WholesaleFeedSyncMode, WholesaleFeedSyncState, ProductFilter, ResolvedCapabilities, SignalFilter } from './types';
-type Product = V31Beta.Product;
-type Signal = NonNullable<V31Beta.GetSignalsResponse['signals']>[number];
+type Product = LegacyWholesaleProduct;
+type Signal = LegacyWholesaleSignal;
 /**
  * In-memory mirror of an AdCP agent's wholesale product and signal feeds.
  *
@@ -16,7 +16,7 @@ type Signal = NonNullable<V31Beta.GetSignalsResponse['signals']>[number];
  * import { AdCPClient } from '@adcp/sdk';
  * import { WholesaleFeedSync } from '@adcp/sdk/wholesale-feed-sync';
  *
- * const client = new AdCPClient({ agentUrl, adcpVersion: '3.1-beta' });
+ * const client = new AdCPClient({ agentUrl });
  * const sync = new WholesaleFeedSync({ client });
  *
  * sync.on('product.priced', ({ event }) => {
@@ -123,12 +123,12 @@ export declare class WholesaleFeedSync extends EventEmitter<WholesaleFeedSyncEve
      */
     refresh(): Promise<void>;
     /**
-     * Apply one beta-3 account-level wholesale feed webhook to the local mirror.
+     * Apply one legacy-view account-level wholesale feed webhook to the local mirror.
      * Call this from your HTTP webhook receiver after signature/auth validation.
      * Stale or out-of-order deliveries repair through conditional wholesale
      * reads instead of applying a suspect delta.
      */
-    applyWebhook(webhook: V31Beta.WholesaleFeedWebhook): Promise<void>;
+    applyWebhook(webhook: LegacyWholesaleFeedWebhook): Promise<void>;
     get state(): WholesaleFeedSyncState;
     get mode(): WholesaleFeedSyncMode;
     get capabilities(): Readonly<ResolvedCapabilities>;

package/dist/lib/wholesale-feed-sync/sync.js

@@ -24,6 +24,7 @@ module.exports = __toCommonJS(sync_exports);
 var import_node_events = require("node:events");
 var import_node_util = require("node:util");
 var import_node_crypto = require("node:crypto");
+var import_webhook_notification = require('./webhook-notification.js');
 const DEFAULT_PROBE_INTERVAL_MS = 6e5;
 const DEFAULT_CAPABILITY_REFRESH_INTERVAL_MS = 864e5;
 const DEFAULT_BOOTSTRAP_PAGE_LIMIT = 100;
@@ -206,12 +207,13 @@ class WholesaleFeedSync extends import_node_events.EventEmitter {
     await this.bootstrap({ emitDiffs: true, epoch });
   }
   /**
-   * Apply one beta-3 account-level wholesale feed webhook to the local mirror.
+   * Apply one legacy-view account-level wholesale feed webhook to the local mirror.
    * Call this from your HTTP webhook receiver after signature/auth validation.
    * Stale or out-of-order deliveries repair through conditional wholesale
    * reads instead of applying a suspect delta.
    */
   async applyWebhook(webhook) {
+    (0, import_webhook_notification.assertLegacyWholesaleFeedRepresentation)(webhook);
     const epoch = this.lifecycleEpoch;
     const event = webhook.event;
     if (!event || webhook.notification_type !== event.event_type) {

package/dist/lib/wholesale-feed-sync/sync.mjs

@@ -1,6 +1,7 @@
 import { EventEmitter } from "node:events";
 import { isDeepStrictEqual } from "node:util";
 import { randomUUID } from "node:crypto";
+import { assertLegacyWholesaleFeedRepresentation } from "./webhook-notification.mjs";
 const DEFAULT_PROBE_INTERVAL_MS = 6e5;
 const DEFAULT_CAPABILITY_REFRESH_INTERVAL_MS = 864e5;
 const DEFAULT_BOOTSTRAP_PAGE_LIMIT = 100;
@@ -183,12 +184,13 @@ class WholesaleFeedSync extends EventEmitter {
     await this.bootstrap({ emitDiffs: true, epoch });
   }
   /**
-   * Apply one beta-3 account-level wholesale feed webhook to the local mirror.
+   * Apply one legacy-view account-level wholesale feed webhook to the local mirror.
    * Call this from your HTTP webhook receiver after signature/auth validation.
    * Stale or out-of-order deliveries repair through conditional wholesale
    * reads instead of applying a suspect delta.
    */
   async applyWebhook(webhook) {
+    assertLegacyWholesaleFeedRepresentation(webhook);
     const epoch = this.lifecycleEpoch;
     const event = webhook.event;
     if (!event || webhook.notification_type !== event.event_type) {

package/dist/lib/wholesale-feed-sync/types.d.mts

@@ -1,5 +1,6 @@
 import type { SingleAgentClient } from '../core/SingleAgentClient.mjs';
-import type * as V31Beta from '../types/v3-1-beta/index.mjs';
+import type { AccountReference } from '../types/index.mjs';
+import type { LegacyWholesaleFeedEvent } from './protocol-types.mjs';
 /**
  * Operating mode for a {@link WholesaleFeedSync} instance, resolved from the
  * agent's capability stanza at `start()` time.
@@ -34,7 +35,7 @@ export interface WholesaleFeedSyncClient {
 /**
  * Configuration for a {@link WholesaleFeedSync} instance.
  *
- * The SDK's primary version pin (`ADCP_VERSION`) stays at GA; the wholesale
+ * The SDK's primary version pin (`ADCP_VERSION`) provides the wholesale
  * feed surfaces activate when the agent declares `wholesale_feed_versioning`
  * and/or `wholesale_feed_webhooks` in its `get_adcp_capabilities` response.
  * Against pre-3.1 agents the sync still works in `'manual'` mode — bootstrap
@@ -44,12 +45,12 @@ export interface WholesaleFeedSyncConfig {
     /** Pre-configured client (or stub) for tool calls against the target agent. */
     client: WholesaleFeedSyncClient;
     /**
-     * Account scope for wholesale product/signal reads. Beta 3 wholesale-feed
+     * Account scope for wholesale product/signal reads. Wholesale-feed
      * webhooks are account-anchored; pass the same account used when registering
      * `notification_configs[]` so repair reads reconcile the correct public or
      * account overlay.
      */
-    account?: V31Beta.AccountReference;
+    account?: AccountReference;
     /**
      * Expected inbound webhook subscription scope. Set this when routing a
      * validated webhook receiver into a WholesaleFeedSync instance so misrouted
@@ -155,43 +156,43 @@ export interface WholesaleFeedSyncEvents {
         to: WholesaleFeedSyncState;
     }];
     event: [{
-        event: V31Beta.WholesaleFeedEvent;
+        event: LegacyWholesaleFeedEvent;
         synthetic?: boolean;
     }];
     'product.created': [{
-        event: V31Beta.WholesaleFeedEvent;
+        event: LegacyWholesaleFeedEvent;
         synthetic?: boolean;
     }];
     'product.updated': [{
-        event: V31Beta.WholesaleFeedEvent;
+        event: LegacyWholesaleFeedEvent;
         synthetic?: boolean;
     }];
     'product.priced': [{
-        event: V31Beta.WholesaleFeedEvent;
+        event: LegacyWholesaleFeedEvent;
         synthetic?: boolean;
     }];
     'product.removed': [{
-        event: V31Beta.WholesaleFeedEvent;
+        event: LegacyWholesaleFeedEvent;
         synthetic?: boolean;
     }];
     'signal.created': [{
-        event: V31Beta.WholesaleFeedEvent;
+        event: LegacyWholesaleFeedEvent;
         synthetic?: boolean;
     }];
     'signal.updated': [{
-        event: V31Beta.WholesaleFeedEvent;
+        event: LegacyWholesaleFeedEvent;
         synthetic?: boolean;
     }];
     'signal.priced': [{
-        event: V31Beta.WholesaleFeedEvent;
+        event: LegacyWholesaleFeedEvent;
         synthetic?: boolean;
     }];
     'signal.removed': [{
-        event: V31Beta.WholesaleFeedEvent;
+        event: LegacyWholesaleFeedEvent;
         synthetic?: boolean;
     }];
     'wholesale_feed.bulk_change': [{
-        event: V31Beta.WholesaleFeedEvent;
+        event: LegacyWholesaleFeedEvent;
         synthetic?: boolean;
     }];
 }

package/dist/lib/wholesale-feed-sync/types.d.ts

@@ -1,5 +1,6 @@
 import type { SingleAgentClient } from '../core/SingleAgentClient';
-import type * as V31Beta from '../types/v3-1-beta';
+import type { AccountReference } from '../types';
+import type { LegacyWholesaleFeedEvent } from './protocol-types';
 /**
  * Operating mode for a {@link WholesaleFeedSync} instance, resolved from the
  * agent's capability stanza at `start()` time.
@@ -34,7 +35,7 @@ export interface WholesaleFeedSyncClient {
 /**
  * Configuration for a {@link WholesaleFeedSync} instance.
  *
- * The SDK's primary version pin (`ADCP_VERSION`) stays at GA; the wholesale
+ * The SDK's primary version pin (`ADCP_VERSION`) provides the wholesale
  * feed surfaces activate when the agent declares `wholesale_feed_versioning`
  * and/or `wholesale_feed_webhooks` in its `get_adcp_capabilities` response.
  * Against pre-3.1 agents the sync still works in `'manual'` mode — bootstrap
@@ -44,12 +45,12 @@ export interface WholesaleFeedSyncConfig {
     /** Pre-configured client (or stub) for tool calls against the target agent. */
     client: WholesaleFeedSyncClient;
     /**
-     * Account scope for wholesale product/signal reads. Beta 3 wholesale-feed
+     * Account scope for wholesale product/signal reads. Wholesale-feed
      * webhooks are account-anchored; pass the same account used when registering
      * `notification_configs[]` so repair reads reconcile the correct public or
      * account overlay.
      */
-    account?: V31Beta.AccountReference;
+    account?: AccountReference;
     /**
      * Expected inbound webhook subscription scope. Set this when routing a
      * validated webhook receiver into a WholesaleFeedSync instance so misrouted
@@ -155,43 +156,43 @@ export interface WholesaleFeedSyncEvents {
         to: WholesaleFeedSyncState;
     }];
     event: [{
-        event: V31Beta.WholesaleFeedEvent;
+        event: LegacyWholesaleFeedEvent;
         synthetic?: boolean;
     }];
     'product.created': [{
-        event: V31Beta.WholesaleFeedEvent;
+        event: LegacyWholesaleFeedEvent;
         synthetic?: boolean;
     }];
     'product.updated': [{
-        event: V31Beta.WholesaleFeedEvent;
+        event: LegacyWholesaleFeedEvent;
         synthetic?: boolean;
     }];
     'product.priced': [{
-        event: V31Beta.WholesaleFeedEvent;
+        event: LegacyWholesaleFeedEvent;
         synthetic?: boolean;
     }];
     'product.removed': [{
-        event: V31Beta.WholesaleFeedEvent;
+        event: LegacyWholesaleFeedEvent;
         synthetic?: boolean;
     }];
     'signal.created': [{
-        event: V31Beta.WholesaleFeedEvent;
+        event: LegacyWholesaleFeedEvent;
         synthetic?: boolean;
     }];
     'signal.updated': [{
-        event: V31Beta.WholesaleFeedEvent;
+        event: LegacyWholesaleFeedEvent;
         synthetic?: boolean;
     }];
     'signal.priced': [{
-        event: V31Beta.WholesaleFeedEvent;
+        event: LegacyWholesaleFeedEvent;
         synthetic?: boolean;
     }];
     'signal.removed': [{
-        event: V31Beta.WholesaleFeedEvent;
+        event: LegacyWholesaleFeedEvent;
         synthetic?: boolean;
     }];
     'wholesale_feed.bulk_change': [{
-        event: V31Beta.WholesaleFeedEvent;
+        event: LegacyWholesaleFeedEvent;
         synthetic?: boolean;
     }];
 }

package/dist/lib/wholesale-feed-sync/webhook-notification.d.mts

@@ -1,8 +1,8 @@
 import { ADCPError } from '../errors/index.mjs';
-import type * as V31Beta from '../types/v3-1-beta/index.mjs';
-export type WholesaleFeedWebhookNotificationType = V31Beta.WholesaleFeedWebhook['notification_type'];
+import type { LegacyWholesaleFeedEvent, LegacyWholesaleFeedWebhook } from './protocol-types.mjs';
+export type WholesaleFeedWebhookNotificationType = LegacyWholesaleFeedWebhook['notification_type'];
 export type WholesaleFeedWebhookAffectedEntityType = 'product' | 'signal';
-export type WholesaleFeedWebhookCacheScope = V31Beta.WholesaleFeedWebhook['cache_scope'];
+export type WholesaleFeedWebhookCacheScope = LegacyWholesaleFeedWebhook['cache_scope'];
 export type WholesaleFeedWebhookNotificationErrorCode = 'wholesale_feed_webhook_body_malformed' | 'wholesale_feed_webhook_field_missing' | 'wholesale_feed_webhook_field_invalid' | 'wholesale_feed_webhook_notification_type_mismatch' | 'wholesale_feed_webhook_entity_type_mismatch' | 'wholesale_feed_webhook_cache_scope_mismatch' | 'wholesale_feed_webhook_bulk_change_invalid';
 export interface WholesaleFeedWebhookNotificationErrorDetails {
     field?: string;
@@ -38,8 +38,8 @@ export interface NormalizedWholesaleFeedWebhookNotification {
     eventCreatedAt: string;
     /** Present for `wholesale_feed.bulk_change` notifications. */
     affectedEntityType?: WholesaleFeedWebhookAffectedEntityType;
-    event: V31Beta.WholesaleFeedEvent;
-    webhook: V31Beta.WholesaleFeedWebhook;
+    event: LegacyWholesaleFeedEvent;
+    webhook: LegacyWholesaleFeedWebhook;
 }
 /**
  * Parse and normalize a canonical wholesale-feed webhook notification.
@@ -51,3 +51,5 @@ export interface NormalizedWholesaleFeedWebhookNotification {
  */
 export declare function parseWholesaleFeedWebhookNotification(input: unknown): NormalizedWholesaleFeedWebhookNotification;
 export declare const normalizeWholesaleFeedWebhookNotification: typeof parseWholesaleFeedWebhookNotification;
+/** Validate only the product representation contract, without consuming dedupe state. */
+export declare function assertLegacyWholesaleFeedRepresentation(webhook: Record<string, unknown>): void;

package/dist/lib/wholesale-feed-sync/webhook-notification.d.ts

@@ -1,8 +1,8 @@
 import { ADCPError } from '../errors';
-import type * as V31Beta from '../types/v3-1-beta';
-export type WholesaleFeedWebhookNotificationType = V31Beta.WholesaleFeedWebhook['notification_type'];
+import type { LegacyWholesaleFeedEvent, LegacyWholesaleFeedWebhook } from './protocol-types';
+export type WholesaleFeedWebhookNotificationType = LegacyWholesaleFeedWebhook['notification_type'];
 export type WholesaleFeedWebhookAffectedEntityType = 'product' | 'signal';
-export type WholesaleFeedWebhookCacheScope = V31Beta.WholesaleFeedWebhook['cache_scope'];
+export type WholesaleFeedWebhookCacheScope = LegacyWholesaleFeedWebhook['cache_scope'];
 export type WholesaleFeedWebhookNotificationErrorCode = 'wholesale_feed_webhook_body_malformed' | 'wholesale_feed_webhook_field_missing' | 'wholesale_feed_webhook_field_invalid' | 'wholesale_feed_webhook_notification_type_mismatch' | 'wholesale_feed_webhook_entity_type_mismatch' | 'wholesale_feed_webhook_cache_scope_mismatch' | 'wholesale_feed_webhook_bulk_change_invalid';
 export interface WholesaleFeedWebhookNotificationErrorDetails {
     field?: string;
@@ -38,8 +38,8 @@ export interface NormalizedWholesaleFeedWebhookNotification {
     eventCreatedAt: string;
     /** Present for `wholesale_feed.bulk_change` notifications. */
     affectedEntityType?: WholesaleFeedWebhookAffectedEntityType;
-    event: V31Beta.WholesaleFeedEvent;
-    webhook: V31Beta.WholesaleFeedWebhook;
+    event: LegacyWholesaleFeedEvent;
+    webhook: LegacyWholesaleFeedWebhook;
 }
 /**
  * Parse and normalize a canonical wholesale-feed webhook notification.
@@ -51,3 +51,5 @@ export interface NormalizedWholesaleFeedWebhookNotification {
  */
 export declare function parseWholesaleFeedWebhookNotification(input: unknown): NormalizedWholesaleFeedWebhookNotification;
 export declare const normalizeWholesaleFeedWebhookNotification: typeof parseWholesaleFeedWebhookNotification;
+/** Validate only the product representation contract, without consuming dedupe state. */
+export declare function assertLegacyWholesaleFeedRepresentation(webhook: Record<string, unknown>): void;

package/dist/lib/wholesale-feed-sync/webhook-notification.js

@@ -19,6 +19,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var webhook_notification_exports = {};
 __export(webhook_notification_exports, {
   WholesaleFeedWebhookNotificationError: () => WholesaleFeedWebhookNotificationError,
+  assertLegacyWholesaleFeedRepresentation: () => assertLegacyWholesaleFeedRepresentation,
   normalizeWholesaleFeedWebhookNotification: () => normalizeWholesaleFeedWebhookNotification,
   parseWholesaleFeedWebhookNotification: () => parseWholesaleFeedWebhookNotification
 });
@@ -57,6 +58,7 @@ function parseWholesaleFeedWebhookNotification(input) {
   const wholesaleFeedVersion = readRequiredString(webhook, "wholesale_feed_version");
   const previousWholesaleFeedVersion = readOptionalString(webhook, "previous_wholesale_feed_version");
   const cacheScope = readCacheScope(readRequiredString(webhook, "cache_scope"), "cache_scope");
+  assertLegacyWholesaleFeedRepresentation(webhook);
   const eventId = readRequiredString(event, "event.event_id");
   if (notificationId !== eventId) {
     throw new WholesaleFeedWebhookNotificationError(
@@ -225,11 +227,13 @@ function validatePayloadForEvent(notificationType, entityId, payload) {
     case "product.created":
     case "product.updated": {
       assertEntityIdMatchesPayload(entityId, readRequiredString(payload, "event.payload.product_id"), "product_id");
+      rejectCanonicalPayloadField(payload, "canonical_product");
       readRequiredRecord(payload, "event.payload.product");
       return void 0;
     }
     case "product.priced": {
       assertEntityIdMatchesPayload(entityId, readRequiredString(payload, "event.payload.product_id"), "product_id");
+      rejectCanonicalPayloadField(payload, "canonical_pricing_options");
       readRequiredNonEmptyArray(payload, "event.payload.pricing_options");
       return void 0;
     }
@@ -270,6 +274,46 @@ function validatePayloadForEvent(notificationType, entityId, payload) {
       return readBulkChangeAffectedEntityType(payload);
   }
 }
+function assertLegacyProductPayloadView(notificationType, productPayloadView) {
+  const isProductEvent = notificationType.startsWith("product.");
+  if (isProductEvent && (productPayloadView === void 0 || productPayloadView === "legacy")) return;
+  if (!isProductEvent && productPayloadView === void 0) return;
+  throw new WholesaleFeedWebhookNotificationError(
+    "wholesale_feed_webhook_field_invalid",
+    isProductEvent ? 'WholesaleFeedSync supports only product_payload_view "legacy".' : "Non-product wholesale-feed webhooks must omit product_payload_view.",
+    {
+      field: "product_payload_view",
+      expected: isProductEvent ? ["legacy"] : ["absent"],
+      actual: productPayloadView
+    }
+  );
+}
+function assertLegacyWholesaleFeedRepresentation(webhook) {
+  const notificationType = webhook.notification_type;
+  if (typeof notificationType !== "string" || !WHOLESALE_FEED_NOTIFICATION_TYPES.has(notificationType))
+    return;
+  const productPayloadView = readOptionalString(webhook, "product_payload_view");
+  assertLegacyProductPayloadView(notificationType, productPayloadView);
+  if (!notificationType.startsWith("product.")) return;
+  const event = webhook.event;
+  if (!event || typeof event !== "object" || Array.isArray(event)) return;
+  const payload = event.payload;
+  if (!payload || typeof payload !== "object" || Array.isArray(payload)) return;
+  const payloadRecord = payload;
+  if (notificationType === "product.created" || notificationType === "product.updated") {
+    rejectCanonicalPayloadField(payloadRecord, "canonical_product");
+  } else if (notificationType === "product.priced") {
+    rejectCanonicalPayloadField(payloadRecord, "canonical_pricing_options");
+  }
+}
+function rejectCanonicalPayloadField(payload, field) {
+  if (!Object.prototype.hasOwnProperty.call(payload, field)) return;
+  throw new WholesaleFeedWebhookNotificationError(
+    "wholesale_feed_webhook_field_invalid",
+    `WholesaleFeedSync legacy product view does not accept event.payload.${field}.`,
+    { field: `event.payload.${field}`, expected: "absent", actual: payload[field] }
+  );
+}
 function assertEntityIdMatchesPayload(entityId, payloadEntityId, payloadField) {
   if (entityId === payloadEntityId) return;
   throw new WholesaleFeedWebhookNotificationError(
@@ -302,6 +346,7 @@ function describeValue(value) {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   WholesaleFeedWebhookNotificationError,
+  assertLegacyWholesaleFeedRepresentation,
   normalizeWholesaleFeedWebhookNotification,
   parseWholesaleFeedWebhookNotification
 });