@adcp/sdk 17.0.0-beta.1 → 17.0.0-beta.2

package/dist/lib/v2/projection/legacy-metadata.d.ts

@@ -1,5 +1,24 @@
 import type { ProductFormatDeclaration } from '../../types/tools.generated';
 import type { V1FormatId, V2ProductFormatDeclaration } from './types';
+import type { VersionDrift } from '../../adapters/version/types';
+type Json = Record<string, unknown>;
+export interface LegacyPixelTracker {
+    asset: Json;
+    assetId: string;
+    lostFields: string[];
+}
+/** Apply the AdCP 3.1 pixel-tracker schema's normative 3.0 downgrade table. */
+export declare function downgradePixelTracker(value: unknown): LegacyPixelTracker | undefined;
+export declare function pixelTrackerDrift(path: string, tracker: LegacyPixelTracker): VersionDrift | undefined;
+/** Keep delivery advisories out of creative JSON sent to the seller. */
+export declare function rememberCreativeDeliveryDiagnostics(value: object, entries: readonly VersionDrift[]): void;
+export declare function transferCreativeDeliveryDiagnostics(source: object, target: object): void;
+/**
+ * Read advisories from a projected creative or a sync/create/update request.
+ * Pure projection callers can surface these alongside the returned wire object.
+ * SingleAgentClient includes them in the task's debug logs automatically.
+ */
+export declare function getCreativeDeliveryDiagnostics(value: unknown): VersionDrift[];
 /**
  * SDK-private projection metadata held out-of-band. WeakMaps keep seller
  * origin evidence and legacy routing identifiers absent from canonical objects

package/dist/lib/v2/projection/legacy-metadata.js

@@ -20,8 +20,12 @@ var legacy_metadata_exports = {};
 __export(legacy_metadata_exports, {
   concealLegacyFormatRefs: () => concealLegacyFormatRefs,
   concealSelectedFormatOptions: () => concealSelectedFormatOptions,
+  downgradePixelTracker: () => downgradePixelTracker,
+  getCreativeDeliveryDiagnostics: () => getCreativeDeliveryDiagnostics,
   isSynthesizedFormatOption: () => isSynthesizedFormatOption,
   legacyFormatRefsForDeclaration: () => legacyFormatRefsForDeclaration,
+  pixelTrackerDrift: () => pixelTrackerDrift,
+  rememberCreativeDeliveryDiagnostics: () => rememberCreativeDeliveryDiagnostics,
   rememberSellerDeclaredFormatOption: () => rememberSellerDeclaredFormatOption,
   rememberSellerFormatEvidence: () => rememberSellerFormatEvidence,
   rememberSynthesizedFormatOption: () => rememberSynthesizedFormatOption,
@@ -29,10 +33,90 @@ __export(legacy_metadata_exports, {
   sellerDeclaredFormatOption: () => sellerDeclaredFormatOption,
   sellerFormatEvidence: () => sellerFormatEvidence,
   structuredCloneWithLegacyCreativeMetadata: () => structuredCloneWithLegacyCreativeMetadata,
+  transferCreativeDeliveryDiagnostics: () => transferCreativeDeliveryDiagnostics,
   transferLegacyCreativeMetadata: () => transferLegacyCreativeMetadata
 });
 module.exports = __toCommonJS(legacy_metadata_exports);
 var import_jcs = require('../../utils/jcs.js');
+const diagnostics = /* @__PURE__ */ new WeakMap();
+function downgradePixelTracker(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return void 0;
+  const asset = value;
+  if (asset.asset_type !== "pixel_tracker" || typeof asset.url !== "string") return void 0;
+  if (asset.method !== void 0 && asset.method !== "img" && asset.method !== "js") return void 0;
+  let assetId;
+  const lostFields = [];
+  switch (asset.event) {
+    case "impression":
+      assetId = "impression_tracker";
+      break;
+    case "click":
+      assetId = "click_tracker";
+      break;
+    case "viewable_mrc_50":
+    case "viewable_mrc_100":
+    case "viewable_video_50":
+    case "audible_video_complete":
+      assetId = "viewability_tracker";
+      lostFields.push("event");
+      break;
+    case "custom":
+      if (typeof asset.custom_event_name !== "string" || asset.custom_event_name.length === 0) return void 0;
+      assetId = "impression_tracker";
+      lostFields.push("event", "custom_event_name");
+      break;
+    default:
+      return void 0;
+  }
+  if (asset.method === "js") lostFields.push("method");
+  const { event: _event, method: _method, custom_event_name: _custom, ...rest } = asset;
+  return { asset: { ...rest, asset_type: "url", url_type: "tracker_pixel" }, assetId, lostFields };
+}
+function pixelTrackerDrift(path, tracker) {
+  if (tracker.lostFields.length === 0) return void 0;
+  return {
+    type: "PIXEL_TRACKER_LOSSY_DOWNGRADE",
+    message: `${path} converted to a legacy URL tracker. ` + (tracker.lostFields.includes("event") ? "The original event variant or custom timing is not represented. " : "") + (tracker.lostFields.includes("method") ? "The URL is requested as an image; its JavaScript does not execute. " : "") + "AdCP 3.0 cannot preserve these tracker semantics.",
+    strippedFields: tracker.lostFields.map((field) => `${path}.${field}`)
+  };
+}
+function rememberCreativeDeliveryDiagnostics(value, entries) {
+  if (entries.length === 0) return;
+  const combined = [...diagnostics.get(value) ?? [], ...entries];
+  diagnostics.set(value, [...new Map(combined.map((entry) => [JSON.stringify(entry), entry])).values()]);
+}
+function transferCreativeDeliveryDiagnostics(source, target) {
+  const entries = diagnostics.get(source);
+  if (entries) rememberCreativeDeliveryDiagnostics(target, entries);
+}
+function getCreativeDeliveryDiagnostics(value) {
+  const result = [];
+  const append = (creative, prefix) => {
+    if (!creative || typeof creative !== "object") return;
+    for (const entry of diagnostics.get(creative) ?? []) {
+      result.push({
+        ...entry,
+        message: prefix ? `${prefix}: ${entry.message}` : entry.message,
+        strippedFields: entry.strippedFields?.map((field) => `${prefix}${prefix ? "." : ""}${field}`)
+      });
+    }
+  };
+  append(value, "");
+  if (!value || typeof value !== "object" || Array.isArray(value)) return result;
+  const request = value;
+  const creatives = (items, prefix) => {
+    if (Array.isArray(items)) items.forEach((item, index) => append(item, `${prefix}[${index}]`));
+  };
+  creatives(request.creatives, "creatives");
+  for (const field of ["packages", "new_packages"]) {
+    const packages = request[field];
+    if (!Array.isArray(packages)) continue;
+    packages.forEach((pkg, index) => {
+      if (pkg && typeof pkg === "object") creatives(pkg.creatives, `${field}[${index}].creatives`);
+    });
+  }
+  return result;
+}
 const legacyRefsByDeclaration = /* @__PURE__ */ new WeakMap();
 const selectedOptionsByRefs = /* @__PURE__ */ new WeakMap();
 const sellerDeclaredByDeclaration = /* @__PURE__ */ new WeakMap();
@@ -101,6 +185,7 @@ function concealSelectedFormatOptions(refs, declarations) {
   selectedOptionsByRefs.set(refs, declarations);
 }
 function transferLegacyCreativeMetadata(source, target) {
+  transferCreativeDeliveryDiagnostics(source, target);
   const refs = legacyRefsByDeclaration.get(source);
   if (refs) legacyRefsByDeclaration.set(target, refs);
   const selected = selectedOptionsByRefs.get(source);
@@ -114,6 +199,7 @@ function structuredCloneWithLegacyCreativeMetadata(value) {
   const clone = structuredClone(value);
   const visited = /* @__PURE__ */ new WeakMap();
   const snapshotMetadata = (source, target) => {
+    transferCreativeDeliveryDiagnostics(source, target);
     const declared = sellerDeclaredByDeclaration.get(source);
     if (declared !== void 0) sellerDeclaredByDeclaration.set(target, declared);
     const evidence = sellerEvidenceByDeclaration.get(source);
@@ -155,8 +241,12 @@ function structuredCloneWithLegacyCreativeMetadata(value) {
 0 && (module.exports = {
   concealLegacyFormatRefs,
   concealSelectedFormatOptions,
+  downgradePixelTracker,
+  getCreativeDeliveryDiagnostics,
   isSynthesizedFormatOption,
   legacyFormatRefsForDeclaration,
+  pixelTrackerDrift,
+  rememberCreativeDeliveryDiagnostics,
   rememberSellerDeclaredFormatOption,
   rememberSellerFormatEvidence,
   rememberSynthesizedFormatOption,
@@ -164,5 +254,6 @@ function structuredCloneWithLegacyCreativeMetadata(value) {
   sellerDeclaredFormatOption,
   sellerFormatEvidence,
   structuredCloneWithLegacyCreativeMetadata,
+  transferCreativeDeliveryDiagnostics,
   transferLegacyCreativeMetadata
 });

package/dist/lib/v2/projection/legacy-metadata.mjs

@@ -1,4 +1,83 @@
 import { canonicalize } from "../../utils/jcs.mjs";
+const diagnostics = /* @__PURE__ */ new WeakMap();
+function downgradePixelTracker(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return void 0;
+  const asset = value;
+  if (asset.asset_type !== "pixel_tracker" || typeof asset.url !== "string") return void 0;
+  if (asset.method !== void 0 && asset.method !== "img" && asset.method !== "js") return void 0;
+  let assetId;
+  const lostFields = [];
+  switch (asset.event) {
+    case "impression":
+      assetId = "impression_tracker";
+      break;
+    case "click":
+      assetId = "click_tracker";
+      break;
+    case "viewable_mrc_50":
+    case "viewable_mrc_100":
+    case "viewable_video_50":
+    case "audible_video_complete":
+      assetId = "viewability_tracker";
+      lostFields.push("event");
+      break;
+    case "custom":
+      if (typeof asset.custom_event_name !== "string" || asset.custom_event_name.length === 0) return void 0;
+      assetId = "impression_tracker";
+      lostFields.push("event", "custom_event_name");
+      break;
+    default:
+      return void 0;
+  }
+  if (asset.method === "js") lostFields.push("method");
+  const { event: _event, method: _method, custom_event_name: _custom, ...rest } = asset;
+  return { asset: { ...rest, asset_type: "url", url_type: "tracker_pixel" }, assetId, lostFields };
+}
+function pixelTrackerDrift(path, tracker) {
+  if (tracker.lostFields.length === 0) return void 0;
+  return {
+    type: "PIXEL_TRACKER_LOSSY_DOWNGRADE",
+    message: `${path} converted to a legacy URL tracker. ` + (tracker.lostFields.includes("event") ? "The original event variant or custom timing is not represented. " : "") + (tracker.lostFields.includes("method") ? "The URL is requested as an image; its JavaScript does not execute. " : "") + "AdCP 3.0 cannot preserve these tracker semantics.",
+    strippedFields: tracker.lostFields.map((field) => `${path}.${field}`)
+  };
+}
+function rememberCreativeDeliveryDiagnostics(value, entries) {
+  if (entries.length === 0) return;
+  const combined = [...diagnostics.get(value) ?? [], ...entries];
+  diagnostics.set(value, [...new Map(combined.map((entry) => [JSON.stringify(entry), entry])).values()]);
+}
+function transferCreativeDeliveryDiagnostics(source, target) {
+  const entries = diagnostics.get(source);
+  if (entries) rememberCreativeDeliveryDiagnostics(target, entries);
+}
+function getCreativeDeliveryDiagnostics(value) {
+  const result = [];
+  const append = (creative, prefix) => {
+    if (!creative || typeof creative !== "object") return;
+    for (const entry of diagnostics.get(creative) ?? []) {
+      result.push({
+        ...entry,
+        message: prefix ? `${prefix}: ${entry.message}` : entry.message,
+        strippedFields: entry.strippedFields?.map((field) => `${prefix}${prefix ? "." : ""}${field}`)
+      });
+    }
+  };
+  append(value, "");
+  if (!value || typeof value !== "object" || Array.isArray(value)) return result;
+  const request = value;
+  const creatives = (items, prefix) => {
+    if (Array.isArray(items)) items.forEach((item, index) => append(item, `${prefix}[${index}]`));
+  };
+  creatives(request.creatives, "creatives");
+  for (const field of ["packages", "new_packages"]) {
+    const packages = request[field];
+    if (!Array.isArray(packages)) continue;
+    packages.forEach((pkg, index) => {
+      if (pkg && typeof pkg === "object") creatives(pkg.creatives, `${field}[${index}].creatives`);
+    });
+  }
+  return result;
+}
 const legacyRefsByDeclaration = /* @__PURE__ */ new WeakMap();
 const selectedOptionsByRefs = /* @__PURE__ */ new WeakMap();
 const sellerDeclaredByDeclaration = /* @__PURE__ */ new WeakMap();
@@ -67,6 +146,7 @@ function concealSelectedFormatOptions(refs, declarations) {
   selectedOptionsByRefs.set(refs, declarations);
 }
 function transferLegacyCreativeMetadata(source, target) {
+  transferCreativeDeliveryDiagnostics(source, target);
   const refs = legacyRefsByDeclaration.get(source);
   if (refs) legacyRefsByDeclaration.set(target, refs);
   const selected = selectedOptionsByRefs.get(source);
@@ -80,6 +160,7 @@ function structuredCloneWithLegacyCreativeMetadata(value) {
   const clone = structuredClone(value);
   const visited = /* @__PURE__ */ new WeakMap();
   const snapshotMetadata = (source, target) => {
+    transferCreativeDeliveryDiagnostics(source, target);
     const declared = sellerDeclaredByDeclaration.get(source);
     if (declared !== void 0) sellerDeclaredByDeclaration.set(target, declared);
     const evidence = sellerEvidenceByDeclaration.get(source);
@@ -120,8 +201,12 @@ function structuredCloneWithLegacyCreativeMetadata(value) {
 export {
   concealLegacyFormatRefs,
   concealSelectedFormatOptions,
+  downgradePixelTracker,
+  getCreativeDeliveryDiagnostics,
   isSynthesizedFormatOption,
   legacyFormatRefsForDeclaration,
+  pixelTrackerDrift,
+  rememberCreativeDeliveryDiagnostics,
   rememberSellerDeclaredFormatOption,
   rememberSellerFormatEvidence,
   rememberSynthesizedFormatOption,
@@ -129,5 +214,6 @@ export {
   sellerDeclaredFormatOption,
   sellerFormatEvidence,
   structuredCloneWithLegacyCreativeMetadata,
+  transferCreativeDeliveryDiagnostics,
   transferLegacyCreativeMetadata
 };

package/dist/lib/v2/projection/v1-to-v2.d.mts

@@ -213,7 +213,7 @@ export declare function canonicalDeclarationFromBareId(id: string, options?: Bar
  */
 export declare function resolveCanonicalFormatKind(id: string, options?: BareFormatIdResolveOptions): CanonicalFormatKind | null;
 /**
- * Preserve index pairing only when the whole seller-authored alignment is credible.
+ * Preserve each compatible index pairing in a seller-authored dual emission.
  * AdCP 3.1.24 core/product.json defines this correspondence: "the format_options[i]
  * narrows the canonical that the named format in format_ids[i] resolves to via the
  * registry / explicit canonical field". Explicit routes remain authoritative.

package/dist/lib/v2/projection/v1-to-v2.d.ts

@@ -213,7 +213,7 @@ export declare function canonicalDeclarationFromBareId(id: string, options?: Bar
  */
 export declare function resolveCanonicalFormatKind(id: string, options?: BareFormatIdResolveOptions): CanonicalFormatKind | null;
 /**
- * Preserve index pairing only when the whole seller-authored alignment is credible.
+ * Preserve each compatible index pairing in a seller-authored dual emission.
  * AdCP 3.1.24 core/product.json defines this correspondence: "the format_options[i]
  * narrows the canonical that the named format in format_ids[i] resolves to via the
  * registry / explicit canonical field". Explicit routes remain authoritative.

package/dist/lib/v2/projection/v1-to-v2.js

@@ -430,19 +430,22 @@ function compatible(option, ref) {
 }
 function withDualEmissionLegacyRefs(formatOptions, formatIds) {
   if (!Array.isArray(formatIds) || formatIds.length !== formatOptions.length) return formatOptions;
-  const aligned = formatOptions.every((value, index) => {
+  if (formatOptions.some((value, index) => {
+    const explicit = (0, import_legacy_metadata.legacyFormatRefsForDeclaration)(value);
+    if (explicit.length === 0) return false;
+    const ref = record(formatIds[index]);
+    return !ref || typeof ref.agent_url !== "string" || typeof ref.id !== "string" || !explicit.some((existing) => sameIdentity(existing, ref));
+  }))
+    return formatOptions;
+  return formatOptions.map((value, index) => {
     const option = record(value);
     const ref = record(formatIds[index]);
     if (!option || typeof option.format_kind !== "string" || option.canonical_formats_only === true || !ref || typeof ref.agent_url !== "string" || ref.agent_url.length === 0 || typeof ref.id !== "string" || ref.id.length === 0) {
-      return false;
+      return value;
+    }
+    if ((0, import_legacy_metadata.legacyFormatRefsForDeclaration)(option).length > 0 || !compatible(option, ref)) {
+      return value;
     }
-    const typedRef = ref;
-    const explicit = (0, import_legacy_metadata.legacyFormatRefsForDeclaration)(option);
-    return explicit.length > 0 ? explicit.some((existing) => sameIdentity(existing, typedRef)) : compatible(option, typedRef);
-  });
-  if (!aligned) return formatOptions;
-  return formatOptions.map((value, index) => {
-    if ((0, import_legacy_metadata.legacyFormatRefsForDeclaration)(value).length > 0) return value;
     const paired = (0, import_legacy_metadata.concealLegacyFormatRefs)({
       ...value,
       v1_format_ref: [{ ...formatIds[index] }]

package/dist/lib/v2/projection/v1-to-v2.mjs

@@ -413,19 +413,22 @@ function compatible(option, ref) {
 }
 function withDualEmissionLegacyRefs(formatOptions, formatIds) {
   if (!Array.isArray(formatIds) || formatIds.length !== formatOptions.length) return formatOptions;
-  const aligned = formatOptions.every((value, index) => {
+  if (formatOptions.some((value, index) => {
+    const explicit = legacyFormatRefsForDeclaration(value);
+    if (explicit.length === 0) return false;
+    const ref = record(formatIds[index]);
+    return !ref || typeof ref.agent_url !== "string" || typeof ref.id !== "string" || !explicit.some((existing) => sameIdentity(existing, ref));
+  }))
+    return formatOptions;
+  return formatOptions.map((value, index) => {
     const option = record(value);
     const ref = record(formatIds[index]);
     if (!option || typeof option.format_kind !== "string" || option.canonical_formats_only === true || !ref || typeof ref.agent_url !== "string" || ref.agent_url.length === 0 || typeof ref.id !== "string" || ref.id.length === 0) {
-      return false;
+      return value;
+    }
+    if (legacyFormatRefsForDeclaration(option).length > 0 || !compatible(option, ref)) {
+      return value;
     }
-    const typedRef = ref;
-    const explicit = legacyFormatRefsForDeclaration(option);
-    return explicit.length > 0 ? explicit.some((existing) => sameIdentity(existing, typedRef)) : compatible(option, typedRef);
-  });
-  if (!aligned) return formatOptions;
-  return formatOptions.map((value, index) => {
-    if (legacyFormatRefsForDeclaration(value).length > 0) return value;
     const paired = concealLegacyFormatRefs({
       ...value,
       v1_format_ref: [{ ...formatIds[index] }]

package/dist/lib/validation/budget-allocation.d.mts

@@ -4,14 +4,14 @@ export declare const CanonicalBudgetAllocationSchema: z.ZodUnion<readonly [z.Zod
     mode: z.ZodLiteral<"fixed">;
 }, z.core.$loose>, z.ZodObject<{
     mode: z.ZodLiteral<"seller_optimized">;
-    optimization_goals: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+    optimization_goals: import("./nonempty-array.mjs").NonemptyArraySchema<z.ZodUnion<readonly [z.ZodObject<{
         kind: z.ZodLiteral<"metric">;
         metric: z.ZodUnion<readonly [z.ZodLiteral<"clicks">, z.ZodLiteral<"views">, z.ZodLiteral<"completed_views">, z.ZodLiteral<"viewed_seconds">, z.ZodLiteral<"viewable_rate">, z.ZodLiteral<"engagements">, z.ZodLiteral<"follows">, z.ZodLiteral<"saves">, z.ZodLiteral<"profile_visits">, z.ZodLiteral<"reach">]>;
         standard: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"mrc">, z.ZodLiteral<"groupm">]>>;
         vendor: z.ZodOptional<z.ZodObject<{
             domain: z.ZodString;
             brand_id: z.ZodOptional<z.ZodString>;
-            countries: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            countries: z.ZodOptional<import("./nonempty-array.mjs").NonemptyArraySchema<z.ZodString>>;
         }, z.core.$loose>>;
         reach_unit: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"individuals">, z.ZodLiteral<"households">, z.ZodLiteral<"devices">, z.ZodLiteral<"accounts">, z.ZodLiteral<"cookies">, z.ZodLiteral<"custom">]>>;
         target_frequency: z.ZodOptional<z.ZodObject<{
@@ -57,7 +57,7 @@ export declare const CanonicalBudgetAllocationSchema: z.ZodUnion<readonly [z.Zod
         vendor: z.ZodObject<{
             domain: z.ZodString;
             brand_id: z.ZodOptional<z.ZodString>;
-            countries: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            countries: z.ZodOptional<import("./nonempty-array.mjs").NonemptyArraySchema<z.ZodString>>;
         }, z.core.$loose>;
         metric_id: z.ZodString;
         target: z.ZodOptional<z.ZodObject<{

package/dist/lib/validation/budget-allocation.d.ts

@@ -4,14 +4,14 @@ export declare const CanonicalBudgetAllocationSchema: z.ZodUnion<readonly [z.Zod
     mode: z.ZodLiteral<"fixed">;
 }, z.core.$loose>, z.ZodObject<{
     mode: z.ZodLiteral<"seller_optimized">;
-    optimization_goals: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+    optimization_goals: import("./nonempty-array").NonemptyArraySchema<z.ZodUnion<readonly [z.ZodObject<{
         kind: z.ZodLiteral<"metric">;
         metric: z.ZodUnion<readonly [z.ZodLiteral<"clicks">, z.ZodLiteral<"views">, z.ZodLiteral<"completed_views">, z.ZodLiteral<"viewed_seconds">, z.ZodLiteral<"viewable_rate">, z.ZodLiteral<"engagements">, z.ZodLiteral<"follows">, z.ZodLiteral<"saves">, z.ZodLiteral<"profile_visits">, z.ZodLiteral<"reach">]>;
         standard: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"mrc">, z.ZodLiteral<"groupm">]>>;
         vendor: z.ZodOptional<z.ZodObject<{
             domain: z.ZodString;
             brand_id: z.ZodOptional<z.ZodString>;
-            countries: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            countries: z.ZodOptional<import("./nonempty-array").NonemptyArraySchema<z.ZodString>>;
         }, z.core.$loose>>;
         reach_unit: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"individuals">, z.ZodLiteral<"households">, z.ZodLiteral<"devices">, z.ZodLiteral<"accounts">, z.ZodLiteral<"cookies">, z.ZodLiteral<"custom">]>>;
         target_frequency: z.ZodOptional<z.ZodObject<{
@@ -57,7 +57,7 @@ export declare const CanonicalBudgetAllocationSchema: z.ZodUnion<readonly [z.Zod
         vendor: z.ZodObject<{
             domain: z.ZodString;
             brand_id: z.ZodOptional<z.ZodString>;
-            countries: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            countries: z.ZodOptional<import("./nonempty-array").NonemptyArraySchema<z.ZodString>>;
         }, z.core.$loose>;
         metric_id: z.ZodString;
         target: z.ZodOptional<z.ZodObject<{

package/dist/lib/validation/compact-schema.d.mts

@@ -0,0 +1,27 @@
+/**
+ * Convert a mostly dereferenced bundled JSON Schema into a serializable schema
+ * that stores repeated schema nodes once under `$defs`.
+ *
+ * The upstream `bundled/` tree expands shared definitions at every use site,
+ * growing to hundreds of megabytes. This serializer replaces repeated schema
+ * nodes with private local refs while leaving annotation/default/example data
+ * alone. Public schema readers expand these private refs; validation can keep
+ * them to compile small referenced functions instead of multi-megabyte code.
+ */
+type JsonObject = Record<string, unknown>;
+export declare const COMPACT_DEFINITIONS_KEY = "x-adcp-compact-definitions";
+/**
+ * Compact an acyclic schema object graph. Repeated schemas become private local
+ * `$defs` refs. The archive reader expands those private refs before exposing
+ * a schema, preserving the original document and AJV diagnostic paths.
+ */
+export declare function compactBundledSchema(root: JsonObject, options?: {
+    maxInlineSchemaBytes?: number;
+}): JsonObject;
+/**
+ * Prepare a self-contained bundled schema for bounded AJV compilation. Nested
+ * IDs in these dereferenced bundles are source annotations, not ref scopes.
+ * Walk schema positions only so IDs in enum/default/example data stay intact.
+ */
+export declare function compactSchemaForValidation(schema: JsonObject): JsonObject;
+export {};

package/dist/lib/validation/compact-schema.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Convert a mostly dereferenced bundled JSON Schema into a serializable schema
+ * that stores repeated schema nodes once under `$defs`.
+ *
+ * The upstream `bundled/` tree expands shared definitions at every use site,
+ * growing to hundreds of megabytes. This serializer replaces repeated schema
+ * nodes with private local refs while leaving annotation/default/example data
+ * alone. Public schema readers expand these private refs; validation can keep
+ * them to compile small referenced functions instead of multi-megabyte code.
+ */
+type JsonObject = Record<string, unknown>;
+export declare const COMPACT_DEFINITIONS_KEY = "x-adcp-compact-definitions";
+/**
+ * Compact an acyclic schema object graph. Repeated schemas become private local
+ * `$defs` refs. The archive reader expands those private refs before exposing
+ * a schema, preserving the original document and AJV diagnostic paths.
+ */
+export declare function compactBundledSchema(root: JsonObject, options?: {
+    maxInlineSchemaBytes?: number;
+}): JsonObject;
+/**
+ * Prepare a self-contained bundled schema for bounded AJV compilation. Nested
+ * IDs in these dereferenced bundles are source annotations, not ref scopes.
+ * Walk schema positions only so IDs in enum/default/example data stay intact.
+ */
+export declare function compactSchemaForValidation(schema: JsonObject): JsonObject;
+export {};