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

package/dist/lib/validation/schema-loader.js

@@ -30,6 +30,7 @@ var schema_loader_exports = {};
 __export(schema_loader_exports, {
   SCHEMA_FILENAME_SUFFIX: () => SCHEMA_FILENAME_SUFFIX,
   _resetValidationLoader: () => _resetValidationLoader,
+  getCanonicalToolValidatorForVersion: () => getCanonicalToolValidatorForVersion,
   getMcpProfileInputSchema: () => getMcpProfileInputSchema,
   getMcpToolSchema: () => getMcpToolSchema,
   getMcpToolSummary: () => getMcpToolSummary,
@@ -434,6 +435,7 @@ function ensureInit(version) {
   (0, import_ajv_formats.default)(ajv);
   const state = {
     ajv,
+    canonicalValidators: /* @__PURE__ */ new Map(),
     fileIndex: buildFileIndex(root),
     validators: /* @__PURE__ */ new Map(),
     rawSchemas: /* @__PURE__ */ new Map(),
@@ -487,6 +489,13 @@ function getValidator(toolName, direction, version = import_version.ADCP_VERSION
   s.validators.set(cacheKey, compiled);
   return compiled;
 }
+function authoredToolSchemaFile(state, indexedFile) {
+  const bundledRoot = import_path.default.join(state.root, "bundled");
+  const relative = import_path.default.relative(bundledRoot, indexedFile);
+  if (relative.startsWith("..") || import_path.default.isAbsolute(relative)) return indexedFile;
+  const authoredFile = import_path.default.join(state.root, relative);
+  return (0, import_fs.existsSync)(authoredFile) ? authoredFile : indexedFile;
+}
 function getToolSchemaDocument(toolName, direction, version = import_version.ADCP_VERSION) {
   const state = ensureInit(version);
   const file = state.fileIndex.get(`${toolName}::${direction}`);
@@ -544,7 +553,7 @@ function getSchemaDocumentByRef(schemaRef, version = import_version.ADCP_VERSION
     schema: readDocument(normalized)
   };
 }
-function getSchemaValidatorByRef(schemaRef, version = import_version.ADCP_VERSION, keywords) {
+function getSchemaValidatorByRef(schemaRef, version = import_version.ADCP_VERSION, keywords, options = {}) {
   const bundleKey = resolveBundleKey(version);
   const root = resolveSchemaRoot(version);
   const normalized = normalizeSchemaRef(schemaRef);
@@ -558,17 +567,19 @@ function getSchemaValidatorByRef(schemaRef, version = import_version.ADCP_VERSIO
     }
     cache = entry.validators;
   }
-  const cacheKey = `${stateCacheKey(bundleKey, root)}\0schema-ref::${normalized}`;
+  const allErrors = options.allErrors ?? false;
+  const cacheKey = `${stateCacheKey(bundleKey, root)}\0schema-ref::${normalized}\0all-errors::${allErrors}`;
   const cached = cache.get(cacheKey);
   if (cached) return cached;
   const file = import_path.default.join(root, normalized);
   if (!(0, import_fs.existsSync)(file)) return void 0;
   const ajv = new import_ajv.default({
     strict: false,
-    // Schema-ref validators process remote webhook payloads. Fail on the
-    // first violation so deeply nested hostile input cannot amplify error
-    // collection into CPU or memory exhaustion.
-    allErrors: false,
+    // Schema-ref validators process remote webhook payloads. By default they
+    // fail on the first violation so deeply nested hostile input cannot
+    // amplify error collection into CPU or memory exhaustion. Canonical
+    // offline validators explicitly opt into complete developer diagnostics.
+    allErrors,
     allowUnionTypes: true
   });
   (0, import_ajv_formats.default)(ajv);
@@ -583,10 +594,10 @@ function getSchemaValidatorByRef(schemaRef, version = import_version.ADCP_VERSIO
     }
     if (schemaFile === file) continue;
     const schema = loadJson(schemaFile);
-    if (keywords && typeof schema.$id === "string") {
+    if ((keywords || allErrors) && typeof schema.$id === "string") {
       const previous = schema.$id === rawSchema.$id ? rawSchema : registeredIds.get(schema.$id);
       if (previous && !(0, import_node_util.isDeepStrictEqual)(previous, schema)) {
-        throw new import_errors.ConfigurationError("Schema keyword validation requires unambiguous schema identities", "schemaRoot");
+        throw new import_errors.ConfigurationError("Schema validation requires unambiguous schema identities", "schemaRoot");
       }
       if (schema.$id === rawSchema.$id) continue;
     }
@@ -602,6 +613,51 @@ function getSchemaValidatorByRef(schemaRef, version = import_version.ADCP_VERSIO
   cache.set(cacheKey, compiled);
   return compiled;
 }
+function getCanonicalToolValidatorForVersion(toolName, direction, version = import_version.ADCP_VERSION) {
+  const state = ensureInit(version);
+  const cacheKey = `${toolName}::${direction}`;
+  const cached = state.canonicalValidators.get(cacheKey);
+  if (cached) return cached;
+  const indexedFile = state.fileIndex.get(cacheKey);
+  if (!indexedFile) return void 0;
+  const file = authoredToolSchemaFile(state, indexedFile);
+  const rawSchema = loadJson(file);
+  const ajv = ensureCanonicalAjv(state);
+  const existing = typeof rawSchema.$id === "string" ? ajv.getSchema(rawSchema.$id) : void 0;
+  const fromBundled = file.includes(`${import_path.default.sep}bundled${import_path.default.sep}`);
+  const compiled = existing ?? ajv.compile(fromBundled ? stripNestedIds(rawSchema) : rawSchema);
+  state.canonicalValidators.set(cacheKey, compiled);
+  return compiled;
+}
+function ensureCanonicalAjv(state) {
+  if (state.canonicalAjv) return state.canonicalAjv;
+  const ajv = new import_ajv.default({
+    strict: false,
+    allErrors: true,
+    allowUnionTypes: true
+  });
+  (0, import_ajv_formats.default)(ajv);
+  const schemasById = /* @__PURE__ */ new Map();
+  for (const schemaFile of walkJsonFiles(state.root)) {
+    if (schemaFile.includes(`${import_path.default.sep}bundled${import_path.default.sep}`)) continue;
+    if ([...TRANSPORT_PROJECTION_DIRECTORIES].some((directory) => schemaFile.includes(`${import_path.default.sep}${directory}${import_path.default.sep}`))) {
+      continue;
+    }
+    const schema = loadJson(schemaFile);
+    if (typeof schema.$id !== "string") continue;
+    const previous = schemasById.get(schema.$id);
+    if (previous) {
+      if (!(0, import_node_util.isDeepStrictEqual)(previous, schema)) {
+        throw new import_errors.ConfigurationError("Canonical validation requires unambiguous schema identities", "schemaRoot");
+      }
+      continue;
+    }
+    schemasById.set(schema.$id, schema);
+  }
+  if (schemasById.size > 0) ajv.addSchema([...schemasById.values()]);
+  state.canonicalAjv = ajv;
+  return ajv;
+}
 function normalizeSchemaRef(schemaRef) {
   const trimmed = schemaRef.replace(/^\/+/, "");
   if (trimmed.length === 0) return void 0;
@@ -891,6 +947,7 @@ function cloneJsonValue(value) {
 0 && (module.exports = {
   SCHEMA_FILENAME_SUFFIX,
   _resetValidationLoader,
+  getCanonicalToolValidatorForVersion,
   getMcpProfileInputSchema,
   getMcpToolSchema,
   getMcpToolSummary,

package/dist/lib/validation/schema-loader.mjs

@@ -385,6 +385,7 @@ function ensureInit(version) {
   addFormats(ajv);
   const state = {
     ajv,
+    canonicalValidators: /* @__PURE__ */ new Map(),
     fileIndex: buildFileIndex(root),
     validators: /* @__PURE__ */ new Map(),
     rawSchemas: /* @__PURE__ */ new Map(),
@@ -438,6 +439,13 @@ function getValidator(toolName, direction, version = ADCP_VERSION) {
   s.validators.set(cacheKey, compiled);
   return compiled;
 }
+function authoredToolSchemaFile(state, indexedFile) {
+  const bundledRoot = path.join(state.root, "bundled");
+  const relative = path.relative(bundledRoot, indexedFile);
+  if (relative.startsWith("..") || path.isAbsolute(relative)) return indexedFile;
+  const authoredFile = path.join(state.root, relative);
+  return existsSync(authoredFile) ? authoredFile : indexedFile;
+}
 function getToolSchemaDocument(toolName, direction, version = ADCP_VERSION) {
   const state = ensureInit(version);
   const file = state.fileIndex.get(`${toolName}::${direction}`);
@@ -495,7 +503,7 @@ function getSchemaDocumentByRef(schemaRef, version = ADCP_VERSION) {
     schema: readDocument(normalized)
   };
 }
-function getSchemaValidatorByRef(schemaRef, version = ADCP_VERSION, keywords) {
+function getSchemaValidatorByRef(schemaRef, version = ADCP_VERSION, keywords, options = {}) {
   const bundleKey = resolveBundleKey(version);
   const root = resolveSchemaRoot(version);
   const normalized = normalizeSchemaRef(schemaRef);
@@ -509,17 +517,19 @@ function getSchemaValidatorByRef(schemaRef, version = ADCP_VERSION, keywords) {
     }
     cache = entry.validators;
   }
-  const cacheKey = `${stateCacheKey(bundleKey, root)}\0schema-ref::${normalized}`;
+  const allErrors = options.allErrors ?? false;
+  const cacheKey = `${stateCacheKey(bundleKey, root)}\0schema-ref::${normalized}\0all-errors::${allErrors}`;
   const cached = cache.get(cacheKey);
   if (cached) return cached;
   const file = path.join(root, normalized);
   if (!existsSync(file)) return void 0;
   const ajv = new Ajv({
     strict: false,
-    // Schema-ref validators process remote webhook payloads. Fail on the
-    // first violation so deeply nested hostile input cannot amplify error
-    // collection into CPU or memory exhaustion.
-    allErrors: false,
+    // Schema-ref validators process remote webhook payloads. By default they
+    // fail on the first violation so deeply nested hostile input cannot
+    // amplify error collection into CPU or memory exhaustion. Canonical
+    // offline validators explicitly opt into complete developer diagnostics.
+    allErrors,
     allowUnionTypes: true
   });
   addFormats(ajv);
@@ -534,10 +544,10 @@ function getSchemaValidatorByRef(schemaRef, version = ADCP_VERSION, keywords) {
     }
     if (schemaFile === file) continue;
     const schema = loadJson(schemaFile);
-    if (keywords && typeof schema.$id === "string") {
+    if ((keywords || allErrors) && typeof schema.$id === "string") {
       const previous = schema.$id === rawSchema.$id ? rawSchema : registeredIds.get(schema.$id);
       if (previous && !isDeepStrictEqual(previous, schema)) {
-        throw new ConfigurationError("Schema keyword validation requires unambiguous schema identities", "schemaRoot");
+        throw new ConfigurationError("Schema validation requires unambiguous schema identities", "schemaRoot");
       }
       if (schema.$id === rawSchema.$id) continue;
     }
@@ -553,6 +563,51 @@ function getSchemaValidatorByRef(schemaRef, version = ADCP_VERSION, keywords) {
   cache.set(cacheKey, compiled);
   return compiled;
 }
+function getCanonicalToolValidatorForVersion(toolName, direction, version = ADCP_VERSION) {
+  const state = ensureInit(version);
+  const cacheKey = `${toolName}::${direction}`;
+  const cached = state.canonicalValidators.get(cacheKey);
+  if (cached) return cached;
+  const indexedFile = state.fileIndex.get(cacheKey);
+  if (!indexedFile) return void 0;
+  const file = authoredToolSchemaFile(state, indexedFile);
+  const rawSchema = loadJson(file);
+  const ajv = ensureCanonicalAjv(state);
+  const existing = typeof rawSchema.$id === "string" ? ajv.getSchema(rawSchema.$id) : void 0;
+  const fromBundled = file.includes(`${path.sep}bundled${path.sep}`);
+  const compiled = existing ?? ajv.compile(fromBundled ? stripNestedIds(rawSchema) : rawSchema);
+  state.canonicalValidators.set(cacheKey, compiled);
+  return compiled;
+}
+function ensureCanonicalAjv(state) {
+  if (state.canonicalAjv) return state.canonicalAjv;
+  const ajv = new Ajv({
+    strict: false,
+    allErrors: true,
+    allowUnionTypes: true
+  });
+  addFormats(ajv);
+  const schemasById = /* @__PURE__ */ new Map();
+  for (const schemaFile of walkJsonFiles(state.root)) {
+    if (schemaFile.includes(`${path.sep}bundled${path.sep}`)) continue;
+    if ([...TRANSPORT_PROJECTION_DIRECTORIES].some((directory) => schemaFile.includes(`${path.sep}${directory}${path.sep}`))) {
+      continue;
+    }
+    const schema = loadJson(schemaFile);
+    if (typeof schema.$id !== "string") continue;
+    const previous = schemasById.get(schema.$id);
+    if (previous) {
+      if (!isDeepStrictEqual(previous, schema)) {
+        throw new ConfigurationError("Canonical validation requires unambiguous schema identities", "schemaRoot");
+      }
+      continue;
+    }
+    schemasById.set(schema.$id, schema);
+  }
+  if (schemasById.size > 0) ajv.addSchema([...schemasById.values()]);
+  state.canonicalAjv = ajv;
+  return ajv;
+}
 function normalizeSchemaRef(schemaRef) {
   const trimmed = schemaRef.replace(/^\/+/, "");
   if (trimmed.length === 0) return void 0;
@@ -841,6 +896,7 @@ function cloneJsonValue(value) {
 export {
   SCHEMA_FILENAME_SUFFIX,
   _resetValidationLoader,
+  getCanonicalToolValidatorForVersion,
   getMcpProfileInputSchema,
   getMcpToolSchema,
   getMcpToolSummary,

package/dist/lib/version.d.mts

@@ -1,7 +1,7 @@
 /**
  * AdCP SDK library version
  */
-export declare const LIBRARY_VERSION = "14.0.0-rc.37";
+export declare const LIBRARY_VERSION = "14.0.0-rc.39";
 /**
  * AdCP specification version this library is built for
  */
@@ -19,7 +19,7 @@ export declare const ADCP_MAJOR_VERSION = 3;
  * this list by hand; bumping the AdCP pin via `npm run sync-version`
  * extends it.
  */
-export declare const COMPATIBLE_ADCP_VERSIONS: readonly ["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", "3.0.2", "3.0.3", "3.0.4", "3.0.5", "3.0.6", "3.0.7", "3.0.8", "3.0.9", "3.0.10", "3.0.11", "3.0.12", "3.0.13", "3.0.14", "3.0.15", "3.0.16", "3.0.17", "3.0.18", "3.0.19", "3.0.20", "3.0.21", "3.0.22", "3.0.23", "3.0.24", "3.0.25", "3.1.0", "3.1", "3.1.1", "3.1.2", "3.1.3", "3.1.4", "3.1.5", "3.1.6", "3.1.7", "3.1.8", "3.1.9", "3.1.10", "3.1.11", "3.1.12", "3.1.13", "3.1.14", "3.1.15", "3.1.16", "3.1.17", "3.1.18", "3.2.0-rc.3", "3.2-rc.3"];
+export declare const COMPATIBLE_ADCP_VERSIONS: readonly ["v2.5", "v2.6", "v3", "3.0.0", "3.0", "3.0.1", "3.0.2", "3.0.3", "3.0.4", "3.0.5", "3.0.6", "3.0.7", "3.0.8", "3.0.9", "3.0.10", "3.0.11", "3.0.12", "3.0.13", "3.0.14", "3.0.15", "3.0.16", "3.0.17", "3.0.18", "3.0.19", "3.0.20", "3.0.21", "3.0.22", "3.0.23", "3.0.24", "3.0.25", "3.1.0", "3.1", "3.1.1", "3.1.2", "3.1.3", "3.1.4", "3.1.5", "3.1.6", "3.1.7", "3.1.8", "3.1.9", "3.1.10", "3.1.11", "3.1.12", "3.1.13", "3.1.14", "3.1.15", "3.1.16", "3.1.17", "3.1.18", "3.2.0-rc.3", "3.2-rc.3"];
 /**
  * String literal union of every AdCP version the SDK formally supports.
  *
@@ -33,10 +33,10 @@ export type AdcpVersion = (typeof COMPATIBLE_ADCP_VERSIONS)[number];
  * Full version information
  */
 export declare const VERSION_INFO: {
-    readonly library: "14.0.0-rc.37";
+    readonly library: "14.0.0-rc.39";
     readonly adcp: "3.2.0-rc.3";
-    readonly compatibleVersions: readonly ["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", "3.0.2", "3.0.3", "3.0.4", "3.0.5", "3.0.6", "3.0.7", "3.0.8", "3.0.9", "3.0.10", "3.0.11", "3.0.12", "3.0.13", "3.0.14", "3.0.15", "3.0.16", "3.0.17", "3.0.18", "3.0.19", "3.0.20", "3.0.21", "3.0.22", "3.0.23", "3.0.24", "3.0.25", "3.1.0", "3.1", "3.1.1", "3.1.2", "3.1.3", "3.1.4", "3.1.5", "3.1.6", "3.1.7", "3.1.8", "3.1.9", "3.1.10", "3.1.11", "3.1.12", "3.1.13", "3.1.14", "3.1.15", "3.1.16", "3.1.17", "3.1.18", "3.2.0-rc.3", "3.2-rc.3"];
-    readonly generatedAt: "2026-09-15T02:13:56.719Z";
+    readonly compatibleVersions: readonly ["v2.5", "v2.6", "v3", "3.0.0", "3.0", "3.0.1", "3.0.2", "3.0.3", "3.0.4", "3.0.5", "3.0.6", "3.0.7", "3.0.8", "3.0.9", "3.0.10", "3.0.11", "3.0.12", "3.0.13", "3.0.14", "3.0.15", "3.0.16", "3.0.17", "3.0.18", "3.0.19", "3.0.20", "3.0.21", "3.0.22", "3.0.23", "3.0.24", "3.0.25", "3.1.0", "3.1", "3.1.1", "3.1.2", "3.1.3", "3.1.4", "3.1.5", "3.1.6", "3.1.7", "3.1.8", "3.1.9", "3.1.10", "3.1.11", "3.1.12", "3.1.13", "3.1.14", "3.1.15", "3.1.16", "3.1.17", "3.1.18", "3.2.0-rc.3", "3.2-rc.3"];
+    readonly generatedAt: "2026-09-18T19:37:01.879Z";
 };
 /**
  * Get the AdCP specification version this library is built for

package/dist/lib/version.d.ts

@@ -1,7 +1,7 @@
 /**
  * AdCP SDK library version
  */
-export declare const LIBRARY_VERSION = "14.0.0-rc.37";
+export declare const LIBRARY_VERSION = "14.0.0-rc.39";
 /**
  * AdCP specification version this library is built for
  */
@@ -19,7 +19,7 @@ export declare const ADCP_MAJOR_VERSION = 3;
  * this list by hand; bumping the AdCP pin via `npm run sync-version`
  * extends it.
  */
-export declare const COMPATIBLE_ADCP_VERSIONS: readonly ["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", "3.0.2", "3.0.3", "3.0.4", "3.0.5", "3.0.6", "3.0.7", "3.0.8", "3.0.9", "3.0.10", "3.0.11", "3.0.12", "3.0.13", "3.0.14", "3.0.15", "3.0.16", "3.0.17", "3.0.18", "3.0.19", "3.0.20", "3.0.21", "3.0.22", "3.0.23", "3.0.24", "3.0.25", "3.1.0", "3.1", "3.1.1", "3.1.2", "3.1.3", "3.1.4", "3.1.5", "3.1.6", "3.1.7", "3.1.8", "3.1.9", "3.1.10", "3.1.11", "3.1.12", "3.1.13", "3.1.14", "3.1.15", "3.1.16", "3.1.17", "3.1.18", "3.2.0-rc.3", "3.2-rc.3"];
+export declare const COMPATIBLE_ADCP_VERSIONS: readonly ["v2.5", "v2.6", "v3", "3.0.0", "3.0", "3.0.1", "3.0.2", "3.0.3", "3.0.4", "3.0.5", "3.0.6", "3.0.7", "3.0.8", "3.0.9", "3.0.10", "3.0.11", "3.0.12", "3.0.13", "3.0.14", "3.0.15", "3.0.16", "3.0.17", "3.0.18", "3.0.19", "3.0.20", "3.0.21", "3.0.22", "3.0.23", "3.0.24", "3.0.25", "3.1.0", "3.1", "3.1.1", "3.1.2", "3.1.3", "3.1.4", "3.1.5", "3.1.6", "3.1.7", "3.1.8", "3.1.9", "3.1.10", "3.1.11", "3.1.12", "3.1.13", "3.1.14", "3.1.15", "3.1.16", "3.1.17", "3.1.18", "3.2.0-rc.3", "3.2-rc.3"];
 /**
  * String literal union of every AdCP version the SDK formally supports.
  *
@@ -33,10 +33,10 @@ export type AdcpVersion = (typeof COMPATIBLE_ADCP_VERSIONS)[number];
  * Full version information
  */
 export declare const VERSION_INFO: {
-    readonly library: "14.0.0-rc.37";
+    readonly library: "14.0.0-rc.39";
     readonly adcp: "3.2.0-rc.3";
-    readonly compatibleVersions: readonly ["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", "3.0.2", "3.0.3", "3.0.4", "3.0.5", "3.0.6", "3.0.7", "3.0.8", "3.0.9", "3.0.10", "3.0.11", "3.0.12", "3.0.13", "3.0.14", "3.0.15", "3.0.16", "3.0.17", "3.0.18", "3.0.19", "3.0.20", "3.0.21", "3.0.22", "3.0.23", "3.0.24", "3.0.25", "3.1.0", "3.1", "3.1.1", "3.1.2", "3.1.3", "3.1.4", "3.1.5", "3.1.6", "3.1.7", "3.1.8", "3.1.9", "3.1.10", "3.1.11", "3.1.12", "3.1.13", "3.1.14", "3.1.15", "3.1.16", "3.1.17", "3.1.18", "3.2.0-rc.3", "3.2-rc.3"];
-    readonly generatedAt: "2026-09-15T02:13:56.719Z";
+    readonly compatibleVersions: readonly ["v2.5", "v2.6", "v3", "3.0.0", "3.0", "3.0.1", "3.0.2", "3.0.3", "3.0.4", "3.0.5", "3.0.6", "3.0.7", "3.0.8", "3.0.9", "3.0.10", "3.0.11", "3.0.12", "3.0.13", "3.0.14", "3.0.15", "3.0.16", "3.0.17", "3.0.18", "3.0.19", "3.0.20", "3.0.21", "3.0.22", "3.0.23", "3.0.24", "3.0.25", "3.1.0", "3.1", "3.1.1", "3.1.2", "3.1.3", "3.1.4", "3.1.5", "3.1.6", "3.1.7", "3.1.8", "3.1.9", "3.1.10", "3.1.11", "3.1.12", "3.1.13", "3.1.14", "3.1.15", "3.1.16", "3.1.17", "3.1.18", "3.2.0-rc.3", "3.2-rc.3"];
+    readonly generatedAt: "2026-09-18T19:37:01.879Z";
 };
 /**
  * Get the AdCP specification version this library is built for

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.37";
+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.37",
+  library: "14.0.0-rc.39",
   adcp: "3.2.0-rc.3",
   compatibleVersions: COMPATIBLE_ADCP_VERSIONS,
-  generatedAt: "2026-09-15T02:13:56.719Z"
+  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.37";
+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.37",
+  library: "14.0.0-rc.39",
   adcp: "3.2.0-rc.3",
   compatibleVersions: COMPATIBLE_ADCP_VERSIONS,
-  generatedAt: "2026-09-15T02:13:56.719Z"
+  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) {