@adcp/sdk 14.0.0 → 14.2.0

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

@@ -4,12 +4,8 @@ import type { WholesaleFeedSyncConfig, WholesaleFeedSyncEvents, WholesaleFeedSyn
 type Product = LegacyWholesaleProduct;
 type Signal = LegacyWholesaleSignal;
 /**
- * In-memory mirror of an AdCP agent's wholesale product and signal feeds.
- *
- * Discovers the agent's wholesale-feed capabilities at `start()`, picks the
- * highest-capability sync strategy the agent supports, and maintains a
- * local index for zero-latency lookups. Falls back gracefully to manual
- * bootstrap when the agent does not advertise conditional-fetch tokens.
+ * In-memory wholesale product/signal mirror. `start()` discovers capabilities;
+ * versioned sellers use auto-poll, others require manual refresh.
  *
  * @example
  * ```ts
@@ -63,11 +59,10 @@ export declare class WholesaleFeedSync extends EventEmitter<WholesaleFeedSyncEve
     private probeTimer;
     private capabilityTimer;
     private lifecycleEpoch;
+    private mirrorRevision;
     /**
-     * Read-only view of the in-memory product index. The `mode` reflects the
-     * sync strategy for product events specifically — in mixed-capability
-     * agents (products-feed + signals-wholesale-only, or vice versa) this
-     * may differ from `signals.mode`.
+     * Product index view. `mode` identifies the product sync strategy and may
+     * differ from `signals.mode` for agents with mixed feed capabilities.
      */
     readonly products: {
         list: () => Product[];
@@ -86,30 +81,17 @@ export declare class WholesaleFeedSync extends EventEmitter<WholesaleFeedSyncEve
         readonly mode: WholesaleFeedSyncMode;
         _mode: WholesaleFeedSyncMode;
         /**
-         * `true` when the agent supports `discovery_mode: 'wholesale'` on
-         * `get_signals` (i.e., signals are browsable). When `false`, the
-         * agent only supports brief-mode discovery — `signals.list()` will
-         * be empty until adopters call into the agent with their own briefs.
+         * True when `get_signals` supports `discovery_mode: 'wholesale'`.
+         * Otherwise `list()` is empty; use client brief discovery instead.
          */
         queryable: boolean;
     };
-    /**
-     * One-shot console warning when adopters call `signals.list()` or
-     * `signals.search()` against an agent that doesn't support wholesale
-     * signal enumeration. Without this, empty results read as "no signals
-     * match" rather than "the agent doesn't browse, only briefs."
-     */
     private warnIfSignalsNotQueryable;
     constructor(config: WholesaleFeedSyncConfig);
     /**
-     * Probe the agent's capabilities, pick a sync mode, and bootstrap the
-     * in-memory replica via wholesale enumeration. In `'auto-poll'` mode
-     * starts the conditional wholesale-feed version probe loop.
-     *
-     * Safe to call repeatedly — concurrent calls await the in-flight
-     * bootstrap and return when it completes (no duplicate bootstrap, no
-     * silent drop). Sequential calls re-probe capabilities and re-bootstrap,
-     * equivalent to calling `refresh()` after a mode upgrade.
+     * Discover capabilities, bootstrap the mirror, and schedule auto-poll probes
+     * for versioned sellers. Concurrent calls share the bootstrap; sequential
+     * calls re-probe capabilities and refresh the mirror.
      */
     start(): Promise<void>;
     private startInner;
@@ -139,10 +121,12 @@ export declare class WholesaleFeedSync extends EventEmitter<WholesaleFeedSyncEve
     get lastSyncedAt(): Date | undefined;
     get lastEventAt(): Date | undefined;
     private resolveMode;
+    private bootstrapWithRetries;
     private bootstrap;
-    /** Returns `true` when the seller short-circuited with `unchanged: true`. */
+    private handleBootstrapFailure;
     private bootstrapProducts;
     private bootstrapSignals;
+    private bootstrapFeed;
     private recoverFromBulkChange;
     private recoverFromVersionMismatch;
     private scheduleProbe;

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

@@ -4,12 +4,8 @@ import type { WholesaleFeedSyncConfig, WholesaleFeedSyncEvents, WholesaleFeedSyn
 type Product = LegacyWholesaleProduct;
 type Signal = LegacyWholesaleSignal;
 /**
- * In-memory mirror of an AdCP agent's wholesale product and signal feeds.
- *
- * Discovers the agent's wholesale-feed capabilities at `start()`, picks the
- * highest-capability sync strategy the agent supports, and maintains a
- * local index for zero-latency lookups. Falls back gracefully to manual
- * bootstrap when the agent does not advertise conditional-fetch tokens.
+ * In-memory wholesale product/signal mirror. `start()` discovers capabilities;
+ * versioned sellers use auto-poll, others require manual refresh.
  *
  * @example
  * ```ts
@@ -63,11 +59,10 @@ export declare class WholesaleFeedSync extends EventEmitter<WholesaleFeedSyncEve
     private probeTimer;
     private capabilityTimer;
     private lifecycleEpoch;
+    private mirrorRevision;
     /**
-     * Read-only view of the in-memory product index. The `mode` reflects the
-     * sync strategy for product events specifically — in mixed-capability
-     * agents (products-feed + signals-wholesale-only, or vice versa) this
-     * may differ from `signals.mode`.
+     * Product index view. `mode` identifies the product sync strategy and may
+     * differ from `signals.mode` for agents with mixed feed capabilities.
      */
     readonly products: {
         list: () => Product[];
@@ -86,30 +81,17 @@ export declare class WholesaleFeedSync extends EventEmitter<WholesaleFeedSyncEve
         readonly mode: WholesaleFeedSyncMode;
         _mode: WholesaleFeedSyncMode;
         /**
-         * `true` when the agent supports `discovery_mode: 'wholesale'` on
-         * `get_signals` (i.e., signals are browsable). When `false`, the
-         * agent only supports brief-mode discovery — `signals.list()` will
-         * be empty until adopters call into the agent with their own briefs.
+         * True when `get_signals` supports `discovery_mode: 'wholesale'`.
+         * Otherwise `list()` is empty; use client brief discovery instead.
          */
         queryable: boolean;
     };
-    /**
-     * One-shot console warning when adopters call `signals.list()` or
-     * `signals.search()` against an agent that doesn't support wholesale
-     * signal enumeration. Without this, empty results read as "no signals
-     * match" rather than "the agent doesn't browse, only briefs."
-     */
     private warnIfSignalsNotQueryable;
     constructor(config: WholesaleFeedSyncConfig);
     /**
-     * Probe the agent's capabilities, pick a sync mode, and bootstrap the
-     * in-memory replica via wholesale enumeration. In `'auto-poll'` mode
-     * starts the conditional wholesale-feed version probe loop.
-     *
-     * Safe to call repeatedly — concurrent calls await the in-flight
-     * bootstrap and return when it completes (no duplicate bootstrap, no
-     * silent drop). Sequential calls re-probe capabilities and re-bootstrap,
-     * equivalent to calling `refresh()` after a mode upgrade.
+     * Discover capabilities, bootstrap the mirror, and schedule auto-poll probes
+     * for versioned sellers. Concurrent calls share the bootstrap; sequential
+     * calls re-probe capabilities and refresh the mirror.
      */
     start(): Promise<void>;
     private startInner;
@@ -139,10 +121,12 @@ export declare class WholesaleFeedSync extends EventEmitter<WholesaleFeedSyncEve
     get lastSyncedAt(): Date | undefined;
     get lastEventAt(): Date | undefined;
     private resolveMode;
+    private bootstrapWithRetries;
     private bootstrap;
-    /** Returns `true` when the seller short-circuited with `unchanged: true`. */
+    private handleBootstrapFailure;
     private bootstrapProducts;
     private bootstrapSignals;
+    private bootstrapFeed;
     private recoverFromBulkChange;
     private recoverFromVersionMismatch;
     private scheduleProbe;