@adcp/sdk 9.1.2 → 9.2.2

package/dist/lib/v2/projection/augment-response.js.map

@@ -1 +1 @@
-{"version":3,"file":"augment-response.js","sourceRoot":"","sources":["../../../../src/lib/v2/projection/augment-response.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;GAkBG;;AAmCH,0EA8BC;AAaD,8CAoBC;AA/FD,yCAAkD;AAuBlD;;;;;;;;GAQG;AACH,SAAgB,+BAA+B,CAC7C,OAAU;IAEV,0EAA0E;IAC1E,MAAM,QAAQ,GAAI,OAAmD,CAAC,cAAc,CAAC;IACrF,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5B,OAAO;YACL,OAAO,EAAE,OAAgC;YACzC,WAAW,EAAE,EAAE;SAChB,CAAC;IACJ,CAAC;IACD,8CAA8C;IAC9C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QACvC,iEAAiE;QACjE,4DAA4D;QAC5D,OAAO;YACL,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,cAAc,EAAE,EAAE,EAAE;YAC3C,WAAW,EAAE,EAAE;SAChB,CAAC;IACJ,CAAC;IACD,MAAM,EAAE,EAAE,EAAE,WAAW,EAAE,GAAG,IAAA,+BAAoB,EAAC,OAAO,CAAC,CAAC;IAC1D,oEAAoE;IACpE,sBAAsB;IACtB,OAAO;QACL,OAAO,EAAE;YACP,GAAG,OAAO;YACV,cAAc,EAAE,EAAE,CAAC,cAAc;SAClC;QACD,WAAW;KACZ,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAgB,iBAAiB,CAC/B,QAAW;IAEX,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE,CAAC;QACvC,OAAO;YACL,QAAQ,EAAE,EAAE,GAAG,QAAQ,EAAE,QAAQ,EAAE,EAAE,EAAuD;YAC5F,WAAW,EAAE,EAAE;SAChB,CAAC;IACJ,CAAC;IACD,MAAM,GAAG,GAAoC,EAAE,CAAC;IAChD,MAAM,WAAW,GAA2B,EAAE,CAAC;IAC/C,KAAK,MAAM,CAAC,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;QAClC,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,EAAE,GAAG,+BAA+B,CAAC,CAAC,CAAC,CAAC;QACvE,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAClB,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACzB,CAAC;IACD,OAAO;QACL,QAAQ,EAAE,EAAE,GAAG,QAAQ,EAAE,QAAQ,EAAE,GAAG,EAAuD;QAC7F,WAAW;KACZ,CAAC;AACJ,CAAC"}
+{"version":3,"file":"augment-response.js","sourceRoot":"","sources":["../../../../src/lib/v2/projection/augment-response.ts"],"names":[],"mappings":"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"}

package/dist/lib/v2/projection/index.d.ts

@@ -1,19 +1,29 @@
 /**
  * v1 ↔ v2 Product projection layer (AdCP 3.1).
  *
- * Three public surfaces:
+ * Public surfaces:
  *
  *   - `projectV1ProductToV2` / `projectV2ProductToV1` — the symmetric
  *     core projections. Read a Product on one side, return a Product
  *     on the other plus structured diagnostics (`source: 'sdk'`,
  *     normative spec codes + SDK-local codes).
  *
+ *   - `resolveCanonicalFormatKind` / `canonicalDeclarationFromBareId` —
+ *     resolve a single bare format-id string (no surrounding Product,
+ *     no `agent_url`) to its canonical `format_kind` or full declaration.
+ *     Registry- and catalog-backed; fails closed to `null`.
+ *
  *   - `withFormatOptions` / `augmentProductWithFormatOptions` —
  *     buyer-side response augmentation. Adds `format_options[]` to a
  *     v1-shaped get_products response so canonical-format-aware buyers
  *     can read the canonical model regardless of the seller's wire
  *     version. Additive — `format_ids[]` is preserved.
  *
+ *   - `toCanonicalOnlyProduct` / `toCanonicalOnlyResponse` — the
+ *     read-side narrowing for a fully-migrated consumer. Returns
+ *     `format_options[]` with `format_ids[]` dropped, surfacing a
+ *     diagnostic for any ref that couldn't be carried over.
+ *
  *   - Catalog + registry primitives (`lookupV1Format`,
  *     `findCatalogEntryByCanonicalAndSize`, registry exports) for
  *     callers wiring projection into their own code paths.
@@ -22,11 +32,11 @@
  * adopters migrating from local format metadata and `product_card.format_id`
  * conventions to canonical creative formats.
  */
-export { projectV1ProductToV2 } from './v1-to-v2';
-export type { V1ToV2Result } from './v1-to-v2';
+export { projectV1ProductToV2, canonicalDeclarationFromBareId, resolveCanonicalFormatKind } from './v1-to-v2';
+export type { V1ToV2Result, BareFormatIdResolveOptions } from './v1-to-v2';
 export { projectV2ProductToV1 } from './v2-to-v1';
 export type { V2ToV1Result } from './v2-to-v1';
-export { augmentProductWithFormatOptions, withFormatOptions, type V2AugmentedProduct } from './augment-response';
+export { augmentProductWithFormatOptions, withFormatOptions, toCanonicalOnlyProduct, toCanonicalOnlyResponse, type V2AugmentedProduct, type CanonicalOnlyProduct, } from './augment-response';
 export { CanonicalFormat, audioDaastFormatDeclaration, audioHostedFormatDeclaration, agentPlacementFormatDeclaration, canonicalFormatDeclaration, customFormatDeclaration, displayTagFormatDeclaration, formatRef, formatRefs, html5FormatDeclaration, imageCarouselFormatDeclaration, imageFormatDeclaration, nativeInFeedFormatDeclaration, productCard, productCardDetailed, responsiveCreativeFormatDeclaration, sponsoredPlacementFormatDeclaration, videoHostedFormatDeclaration, videoVastFormatDeclaration, type CanonicalFormatDeclaration, type CanonicalFormatDeclarationFields, type CanonicalFormatKind, type CanonicalFormatParams, type FormatReferenceInput, type ProductCardDetailedFields, type ProductCardFields, } from './builders';
 export { packageRefsForFormatOptions, packageRefsForCapabilities, legacyFormatIdsFromOptions, tryLegacyFormatIdsFromOptions, legacyFormatIdsForFormatOption, legacyFormatIdsForCapability, FormatOptionRefsLookupError, CapabilityIdsLookupError, type PackageFormatRefs, type PackageCapabilityRefs, type FormatOptionRef, type FormatOptionSelector, type FormatOptionRefsLookupErrorCode, type CapabilityIdsLookupErrorCode, } from './write-side';
 export type { V1FormatId, V2ProductFormatDeclaration, V2Product, V1Product, ProjectionDiagnostic } from './types';

package/dist/lib/v2/projection/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/v2/projection/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,OAAO,EAAE,+BAA+B,EAAE,iBAAiB,EAAE,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAEjH,OAAO,EACL,eAAe,EACf,2BAA2B,EAC3B,4BAA4B,EAC5B,+BAA+B,EAC/B,0BAA0B,EAC1B,uBAAuB,EACvB,2BAA2B,EAC3B,SAAS,EACT,UAAU,EACV,sBAAsB,EACtB,8BAA8B,EAC9B,sBAAsB,EACtB,6BAA6B,EAC7B,WAAW,EACX,mBAAmB,EACnB,mCAAmC,EACnC,mCAAmC,EACnC,4BAA4B,EAC5B,0BAA0B,EAC1B,KAAK,0BAA0B,EAC/B,KAAK,gCAAgC,EACrC,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,yBAAyB,EAC9B,KAAK,iBAAiB,GACvB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,2BAA2B,EAC3B,0BAA0B,EAC1B,0BAA0B,EAC1B,6BAA6B,EAC7B,8BAA8B,EAC9B,4BAA4B,EAC5B,2BAA2B,EAC3B,wBAAwB,EACxB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,+BAA+B,EACpC,KAAK,4BAA4B,GAClC,MAAM,cAAc,CAAC;AAEtB,YAAY,EAAE,UAAU,EAAE,0BAA0B,EAAE,SAAS,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAElH,OAAO,EACL,WAAW,EACX,cAAc,EACd,kCAAkC,EAClC,oBAAoB,EACpB,kBAAkB,EAClB,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,GAC5B,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/v2/projection/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,EAAE,oBAAoB,EAAE,8BAA8B,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAC9G,YAAY,EAAE,YAAY,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAE3E,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,OAAO,EACL,+BAA+B,EAC/B,iBAAiB,EACjB,sBAAsB,EACtB,uBAAuB,EACvB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,GAC1B,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,eAAe,EACf,2BAA2B,EAC3B,4BAA4B,EAC5B,+BAA+B,EAC/B,0BAA0B,EAC1B,uBAAuB,EACvB,2BAA2B,EAC3B,SAAS,EACT,UAAU,EACV,sBAAsB,EACtB,8BAA8B,EAC9B,sBAAsB,EACtB,6BAA6B,EAC7B,WAAW,EACX,mBAAmB,EACnB,mCAAmC,EACnC,mCAAmC,EACnC,4BAA4B,EAC5B,0BAA0B,EAC1B,KAAK,0BAA0B,EAC/B,KAAK,gCAAgC,EACrC,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,yBAAyB,EAC9B,KAAK,iBAAiB,GACvB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,2BAA2B,EAC3B,0BAA0B,EAC1B,0BAA0B,EAC1B,6BAA6B,EAC7B,8BAA8B,EAC9B,4BAA4B,EAC5B,2BAA2B,EAC3B,wBAAwB,EACxB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,+BAA+B,EACpC,KAAK,4BAA4B,GAClC,MAAM,cAAc,CAAC;AAEtB,YAAY,EAAE,UAAU,EAAE,0BAA0B,EAAE,SAAS,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAElH,OAAO,EACL,WAAW,EACX,cAAc,EACd,kCAAkC,EAClC,oBAAoB,EACpB,kBAAkB,EAClB,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,GAC5B,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/lib/v2/projection/index.js

@@ -2,19 +2,29 @@
 /**
  * v1 ↔ v2 Product projection layer (AdCP 3.1).
  *
- * Three public surfaces:
+ * Public surfaces:
  *
  *   - `projectV1ProductToV2` / `projectV2ProductToV1` — the symmetric
  *     core projections. Read a Product on one side, return a Product
  *     on the other plus structured diagnostics (`source: 'sdk'`,
  *     normative spec codes + SDK-local codes).
  *
+ *   - `resolveCanonicalFormatKind` / `canonicalDeclarationFromBareId` —
+ *     resolve a single bare format-id string (no surrounding Product,
+ *     no `agent_url`) to its canonical `format_kind` or full declaration.
+ *     Registry- and catalog-backed; fails closed to `null`.
+ *
  *   - `withFormatOptions` / `augmentProductWithFormatOptions` —
  *     buyer-side response augmentation. Adds `format_options[]` to a
  *     v1-shaped get_products response so canonical-format-aware buyers
  *     can read the canonical model regardless of the seller's wire
  *     version. Additive — `format_ids[]` is preserved.
  *
+ *   - `toCanonicalOnlyProduct` / `toCanonicalOnlyResponse` — the
+ *     read-side narrowing for a fully-migrated consumer. Returns
+ *     `format_options[]` with `format_ids[]` dropped, surfacing a
+ *     diagnostic for any ref that couldn't be carried over.
+ *
  *   - Catalog + registry primitives (`lookupV1Format`,
  *     `findCatalogEntryByCanonicalAndSize`, registry exports) for
  *     callers wiring projection into their own code paths.
@@ -24,14 +34,18 @@
  * conventions to canonical creative formats.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isCanonicalV1Translatable = exports._resetCatalogCache = exports.parseSizedIdTemplate = exports.findCatalogEntryByCanonicalAndSize = exports.lookupV1Format = exports.loadCatalog = exports.CapabilityIdsLookupError = exports.FormatOptionRefsLookupError = exports.legacyFormatIdsForCapability = exports.legacyFormatIdsForFormatOption = exports.tryLegacyFormatIdsFromOptions = exports.legacyFormatIdsFromOptions = exports.packageRefsForCapabilities = exports.packageRefsForFormatOptions = exports.videoVastFormatDeclaration = exports.videoHostedFormatDeclaration = exports.sponsoredPlacementFormatDeclaration = exports.responsiveCreativeFormatDeclaration = exports.productCardDetailed = exports.productCard = exports.nativeInFeedFormatDeclaration = exports.imageFormatDeclaration = exports.imageCarouselFormatDeclaration = exports.html5FormatDeclaration = exports.formatRefs = exports.formatRef = exports.displayTagFormatDeclaration = exports.customFormatDeclaration = exports.canonicalFormatDeclaration = exports.agentPlacementFormatDeclaration = exports.audioHostedFormatDeclaration = exports.audioDaastFormatDeclaration = exports.CanonicalFormat = exports.withFormatOptions = exports.augmentProductWithFormatOptions = exports.projectV2ProductToV1 = exports.projectV1ProductToV2 = void 0;
+exports.isCanonicalV1Translatable = exports._resetCatalogCache = exports.parseSizedIdTemplate = exports.findCatalogEntryByCanonicalAndSize = exports.lookupV1Format = exports.loadCatalog = exports.CapabilityIdsLookupError = exports.FormatOptionRefsLookupError = exports.legacyFormatIdsForCapability = exports.legacyFormatIdsForFormatOption = exports.tryLegacyFormatIdsFromOptions = exports.legacyFormatIdsFromOptions = exports.packageRefsForCapabilities = exports.packageRefsForFormatOptions = exports.videoVastFormatDeclaration = exports.videoHostedFormatDeclaration = exports.sponsoredPlacementFormatDeclaration = exports.responsiveCreativeFormatDeclaration = exports.productCardDetailed = exports.productCard = exports.nativeInFeedFormatDeclaration = exports.imageFormatDeclaration = exports.imageCarouselFormatDeclaration = exports.html5FormatDeclaration = exports.formatRefs = exports.formatRef = exports.displayTagFormatDeclaration = exports.customFormatDeclaration = exports.canonicalFormatDeclaration = exports.agentPlacementFormatDeclaration = exports.audioHostedFormatDeclaration = exports.audioDaastFormatDeclaration = exports.CanonicalFormat = exports.toCanonicalOnlyResponse = exports.toCanonicalOnlyProduct = exports.withFormatOptions = exports.augmentProductWithFormatOptions = exports.projectV2ProductToV1 = exports.resolveCanonicalFormatKind = exports.canonicalDeclarationFromBareId = exports.projectV1ProductToV2 = void 0;
 var v1_to_v2_1 = require("./v1-to-v2");
 Object.defineProperty(exports, "projectV1ProductToV2", { enumerable: true, get: function () { return v1_to_v2_1.projectV1ProductToV2; } });
+Object.defineProperty(exports, "canonicalDeclarationFromBareId", { enumerable: true, get: function () { return v1_to_v2_1.canonicalDeclarationFromBareId; } });
+Object.defineProperty(exports, "resolveCanonicalFormatKind", { enumerable: true, get: function () { return v1_to_v2_1.resolveCanonicalFormatKind; } });
 var v2_to_v1_1 = require("./v2-to-v1");
 Object.defineProperty(exports, "projectV2ProductToV1", { enumerable: true, get: function () { return v2_to_v1_1.projectV2ProductToV1; } });
 var augment_response_1 = require("./augment-response");
 Object.defineProperty(exports, "augmentProductWithFormatOptions", { enumerable: true, get: function () { return augment_response_1.augmentProductWithFormatOptions; } });
 Object.defineProperty(exports, "withFormatOptions", { enumerable: true, get: function () { return augment_response_1.withFormatOptions; } });
+Object.defineProperty(exports, "toCanonicalOnlyProduct", { enumerable: true, get: function () { return augment_response_1.toCanonicalOnlyProduct; } });
+Object.defineProperty(exports, "toCanonicalOnlyResponse", { enumerable: true, get: function () { return augment_response_1.toCanonicalOnlyResponse; } });
 var builders_1 = require("./builders");
 Object.defineProperty(exports, "CanonicalFormat", { enumerable: true, get: function () { return builders_1.CanonicalFormat; } });
 Object.defineProperty(exports, "audioDaastFormatDeclaration", { enumerable: true, get: function () { return builders_1.audioDaastFormatDeclaration; } });

package/dist/lib/v2/projection/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/v2/projection/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;;;AAEH,uCAAkD;AAAzC,gHAAA,oBAAoB,OAAA;AAG7B,uCAAkD;AAAzC,gHAAA,oBAAoB,OAAA;AAG7B,uDAAiH;AAAxG,mIAAA,+BAA+B,OAAA;AAAE,qHAAA,iBAAiB,OAAA;AAE3D,uCA2BoB;AA1BlB,2GAAA,eAAe,OAAA;AACf,uHAAA,2BAA2B,OAAA;AAC3B,wHAAA,4BAA4B,OAAA;AAC5B,2HAAA,+BAA+B,OAAA;AAC/B,sHAAA,0BAA0B,OAAA;AAC1B,mHAAA,uBAAuB,OAAA;AACvB,uHAAA,2BAA2B,OAAA;AAC3B,qGAAA,SAAS,OAAA;AACT,sGAAA,UAAU,OAAA;AACV,kHAAA,sBAAsB,OAAA;AACtB,0HAAA,8BAA8B,OAAA;AAC9B,kHAAA,sBAAsB,OAAA;AACtB,yHAAA,6BAA6B,OAAA;AAC7B,uGAAA,WAAW,OAAA;AACX,+GAAA,mBAAmB,OAAA;AACnB,+HAAA,mCAAmC,OAAA;AACnC,+HAAA,mCAAmC,OAAA;AACnC,wHAAA,4BAA4B,OAAA;AAC5B,sHAAA,0BAA0B,OAAA;AAU5B,2CAesB;AAdpB,yHAAA,2BAA2B,OAAA;AAC3B,wHAAA,0BAA0B,OAAA;AAC1B,wHAAA,0BAA0B,OAAA;AAC1B,2HAAA,6BAA6B,OAAA;AAC7B,4HAAA,8BAA8B,OAAA;AAC9B,0HAAA,4BAA4B,OAAA;AAC5B,yHAAA,2BAA2B,OAAA;AAC3B,sHAAA,wBAAwB,OAAA;AAW1B,qCAQmB;AAPjB,sGAAA,WAAW,OAAA;AACX,yGAAA,cAAc,OAAA;AACd,6HAAA,kCAAkC,OAAA;AAClC,+GAAA,oBAAoB,OAAA;AACpB,6GAAA,kBAAkB,OAAA;AAKpB,+DAAmE;AAA1D,iIAAA,yBAAyB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/v2/projection/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;;;AAEH,uCAA8G;AAArG,gHAAA,oBAAoB,OAAA;AAAE,0HAAA,8BAA8B,OAAA;AAAE,sHAAA,0BAA0B,OAAA;AAGzF,uCAAkD;AAAzC,gHAAA,oBAAoB,OAAA;AAG7B,uDAO4B;AAN1B,mIAAA,+BAA+B,OAAA;AAC/B,qHAAA,iBAAiB,OAAA;AACjB,0HAAA,sBAAsB,OAAA;AACtB,2HAAA,uBAAuB,OAAA;AAKzB,uCA2BoB;AA1BlB,2GAAA,eAAe,OAAA;AACf,uHAAA,2BAA2B,OAAA;AAC3B,wHAAA,4BAA4B,OAAA;AAC5B,2HAAA,+BAA+B,OAAA;AAC/B,sHAAA,0BAA0B,OAAA;AAC1B,mHAAA,uBAAuB,OAAA;AACvB,uHAAA,2BAA2B,OAAA;AAC3B,qGAAA,SAAS,OAAA;AACT,sGAAA,UAAU,OAAA;AACV,kHAAA,sBAAsB,OAAA;AACtB,0HAAA,8BAA8B,OAAA;AAC9B,kHAAA,sBAAsB,OAAA;AACtB,yHAAA,6BAA6B,OAAA;AAC7B,uGAAA,WAAW,OAAA;AACX,+GAAA,mBAAmB,OAAA;AACnB,+HAAA,mCAAmC,OAAA;AACnC,+HAAA,mCAAmC,OAAA;AACnC,wHAAA,4BAA4B,OAAA;AAC5B,sHAAA,0BAA0B,OAAA;AAU5B,2CAesB;AAdpB,yHAAA,2BAA2B,OAAA;AAC3B,wHAAA,0BAA0B,OAAA;AAC1B,wHAAA,0BAA0B,OAAA;AAC1B,2HAAA,6BAA6B,OAAA;AAC7B,4HAAA,8BAA8B,OAAA;AAC9B,0HAAA,4BAA4B,OAAA;AAC5B,yHAAA,2BAA2B,OAAA;AAC3B,sHAAA,wBAAwB,OAAA;AAW1B,qCAQmB;AAPjB,sGAAA,WAAW,OAAA;AACX,yGAAA,cAAc,OAAA;AACd,6HAAA,kCAAkC,OAAA;AAClC,+GAAA,oBAAoB,OAAA;AACpB,6GAAA,kBAAkB,OAAA;AAKpB,+DAAmE;AAA1D,iIAAA,yBAAyB,OAAA"}

package/dist/lib/v2/projection/types.d.ts

@@ -223,5 +223,41 @@ export type ProjectionDiagnostic = (ProjectionDiagnosticBase & {
             };
         };
     };
+}) | (ProjectionDiagnosticBase & {
+    /**
+     * SDK-local code: canonical-only projection (`toCanonicalOnlyProduct`
+     * / `toCanonicalOnlyResponse`) dropped a legacy `format_id` that no
+     * `format_options[].v1_format_ref` covers. Emitted only on the
+     * v2-native pass-through path — a seller that sent `format_options[]`
+     * directly but also carried a `format_ids[]` entry with no canonical
+     * representation. Without it, canonical-only mode would silently
+     * discard a format the buyer could still have acted on via the v1
+     * path.
+     *
+     * On the v1 → v2 projection path an unmappable ref is already
+     * surfaced as `FORMAT_PROJECTION_FAILED`; this code covers the gap
+     * the projection path can't see (no projection runs when the seller
+     * is already v2-native).
+     */
+    code: 'LEGACY_FORMAT_ID_DROPPED_UNMAPPED';
+    error: {
+        details: {
+            product_id: string;
+            /**
+             * The full ref that was dropped, including the dimensional
+             * discriminators (`width` / `height` / `duration_ms`) when the
+             * input carried them — so a buyer can tell which variant of a
+             * multi-size/multi-duration family was lost and re-acquire it on
+             * the v1 path. Omitted keys mean the input ref carried no value.
+             */
+            dropped_format_id: {
+                agent_url: string;
+                id: string;
+                width?: number;
+                height?: number;
+                duration_ms?: number;
+            };
+        };
+    };
 });
 //# sourceMappingURL=types.d.ts.map

package/dist/lib/v2/projection/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/lib/v2/projection/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/lib/v2/projection/types.ts"],"names":[],"mappings":"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"}

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

@@ -45,7 +45,7 @@
  *     is the most adopter-relevant piece for actual creative
  *     submission flows and lands in a follow-up.
  */
-import type { V1Product, V2Product, ProjectionDiagnostic } from './types';
+import type { V1Product, V2Product, V2ProductFormatDeclaration, ProjectionDiagnostic, CanonicalFormatKind } from './types';
 export interface V1ToV2Result {
     v2: V2Product;
     diagnostics: ProjectionDiagnostic[];
@@ -59,6 +59,109 @@ export interface V1ToV2Result {
  * a v2-only buyer (the spec requires `format_options` to have
  * `minItems: 1` when present). The function always returns a Product
  * shape so adopters can inspect what got dropped via diagnostics.
+ *
+ * @see canonicalDeclarationFromBareId — resolve a single bare format-id
+ * string (no surrounding Product) to a declaration or `format_kind`.
  */
 export declare function projectV1ProductToV2(v1: V1Product): V1ToV2Result;
+export interface BareFormatIdResolveOptions {
+    /**
+     * `agent_url` to attach when lifting the bare `id` to a structured
+     * {@link V1FormatId} for resolution. Defaults to the canonical AAO host
+     * (`https://creative.adcontextprotocol.org/`) — the publisher of every
+     * AAO catalog id, and the source of essentially all bare ids persisted
+     * before the `{ agent_url, id }` convention. Override only when the bare
+     * id was minted under a different agent's catalog — for an AAO catalog id,
+     * leave this unset; passing a non-AAO `agentUrl` won't match the AAO-keyed
+     * catalog and resolves to `null`.
+     */
+    agentUrl?: string;
+    /**
+     * Asset-type disambiguator for an under-specified bare id. The AAO
+     * catalog names per-asset-type variants `<base>_<suffix>` (e.g.
+     * `display_300x250` → `display_300x250_image` / `_html` / `_generative`).
+     * A size-only bare id like `display_300x250` is genuinely ambiguous and
+     * resolves to `null` on its own; pass the asset type you already hold
+     * (an adopter's `format_type`) and the resolver retries the disambiguated
+     * catalog variant `<id>_<suffix>`.
+     *
+     * The vocabulary is the catalog asset type where it differs from the
+     * variant suffix (`javascript` → `_js`), otherwise the suffix itself
+     * (`image`, `html`, `generative`, `js`). Canonical-kind aliases are also
+     * accepted (`html5` → `html`, `display_tag` → `js`) for callers already
+     * holding a kind-like local value.
+     *
+     * Only consulted when the bare id does NOT resolve on its own (a real
+     * catalog id is authoritative). Still fails closed: if `<id>_<suffix>`
+     * is not a catalog entry, returns `null` — the hint narrows, it never
+     * fabricates.
+     */
+    assetType?: string;
+    /**
+     * @deprecated Use `assetType`. Kept as a backwards-compatible alias for
+     * callers who adopted the initial helper surface before issue #2289.
+     */
+    assetTypeHint?: string;
+}
+/**
+ * Resolve a bare v1 format-id string to its full v2
+ * `ProductFormatDeclaration`, or `null` when the id has no canonical
+ * mapping.
+ *
+ * Adopters migrating off legacy format storage routinely hold a bare id
+ * (`display_300x250_image`, `video_standard_30s`) persisted before the
+ * `{ agent_url, id }` structured-ref convention. This lifts that bare id
+ * to a structured ref (via `agentUrl`, default the AAO host) and runs the
+ * exact resolution the v1 → v2 product projection uses — in the registry
+ * spec's `v1-canonical-mapping.json` resolution order:
+ *
+ *   - AAO catalog `canonical:` annotation — the authoritative
+ *     seller-asserted mapping (registry resolution-order step 2).
+ *   - Registry `format_id_glob` literal match (registry resolution-order
+ *     step 3) — future-proof; 3.1 ships zero literal globs, so this fires
+ *     only when a future registry adds platform-specific literals.
+ *
+ * Fails closed: returns `null` — never a guess — when neither path
+ * resolves the id. That covers an unknown id, an under-specified id
+ * (`display_300x250`, which the catalog only carries as `_image` /
+ * `_html` / `_generative` variants), and a catalog entry the AAO has not
+ * yet annotated with a `canonical:`. Structural matching never
+ * contributes a kind: a bare id absent from the catalog carries no asset
+ * shape to match on, and a catalog entry lacking a `canonical:` fails
+ * closed before the structural step is reached.
+ *
+ * For an under-specified bare id, pass `assetType` (the asset type you
+ * already hold, such as an adopter's `format_type`) and the resolver retries
+ * the disambiguated catalog variant
+ * `<id>_<suffix>` — so the SDK owns the `_image` / `_html` suffix
+ * convention instead of every adopter re-deriving it. The hint is
+ * consulted only when the bare id doesn't resolve on its own, and still
+ * fails closed when the disambiguated id isn't a catalog entry.
+ *
+ * The returned declaration carries `v1_format_ref: [{ agent_url, id }]`
+ * (the resolved id — the disambiguated `<id>_<suffix>` when a hint
+ * applied), so adopters lift a bare id to a structured ref in one step
+ * (the pre-projection step the migration docs encourage).
+ *
+ * Like the rest of the projection layer, this requires the bundled AAO
+ * catalog + canonical-mapping registry; it throws (rather than returning
+ * `null`) only when those are missing from the install — a corrupted
+ * `@adcp/sdk` package, not a normal unresolved-id outcome.
+ *
+ * For just the `format_kind`, use {@link resolveCanonicalFormatKind}. For
+ * the structured diagnostic explaining *why* an id did not resolve, run
+ * it through {@link projectV1ProductToV2} inside a one-format product.
+ */
+export declare function canonicalDeclarationFromBareId(id: string, options?: BareFormatIdResolveOptions): V2ProductFormatDeclaration | null;
+/**
+ * Resolve a bare v1 format-id string to its canonical `format_kind`, or
+ * `null` when the id has no canonical mapping. Registry- and
+ * catalog-backed: the single source of truth that replaces hand-rolled
+ * `inferFormatKindFromFormatId` heuristics adopters maintain locally.
+ *
+ * Thin projection of {@link canonicalDeclarationFromBareId} down to the
+ * `format_kind`; see it for the resolution order, fail-closed semantics,
+ * the `agentUrl` default, and the `assetType` disambiguator.
+ */
+export declare function resolveCanonicalFormatKind(id: string, options?: BareFormatIdResolveOptions): CanonicalFormatKind | null;
 //# sourceMappingURL=v1-to-v2.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"v1-to-v2.d.ts","sourceRoot":"","sources":["../../../../src/lib/v2/projection/v1-to-v2.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAc,SAAS,EAA8B,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAOlH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,SAAS,CAAC;IACd,WAAW,EAAE,oBAAoB,EAAE,CAAC;CACrC;AAwID;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,SAAS,GAAG,YAAY,CAoBhE"}
+{"version":3,"file":"v1-to-v2.d.ts","sourceRoot":"","sources":["../../../../src/lib/v2/projection/v1-to-v2.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AAEH,OAAO,KAAK,EACV,SAAS,EAET,SAAS,EACT,0BAA0B,EAC1B,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,SAAS,CAAC;AAQjB,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,SAAS,CAAC;IACd,WAAW,EAAE,oBAAoB,EAAE,CAAC;CACrC;AAwID;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,SAAS,GAAG,YAAY,CAoBhE;AAED,MAAM,WAAW,0BAA0B;IACzC;;;;;;;;;OASG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;;;;;;;;;;;;;;;;OAmBG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,wBAAgB,8BAA8B,CAC5C,EAAE,EAAE,MAAM,EACV,OAAO,CAAC,EAAE,0BAA0B,GACnC,0BAA0B,GAAG,IAAI,CAwBnC;AAkBD;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CACxC,EAAE,EAAE,MAAM,EACV,OAAO,CAAC,EAAE,0BAA0B,GACnC,mBAAmB,GAAG,IAAI,CAE5B"}

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

@@ -48,8 +48,11 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.projectV1ProductToV2 = projectV1ProductToV2;
+exports.canonicalDeclarationFromBareId = canonicalDeclarationFromBareId;
+exports.resolveCanonicalFormatKind = resolveCanonicalFormatKind;
 const registry_1 = require("./registry");
 const catalog_1 = require("./catalog");
+const constants_1 = require("./constants");
 const version_1 = require("../../version");
 const SDK_ID = `@adcp/sdk@${version_1.LIBRARY_VERSION}`;
 /**
@@ -185,6 +188,9 @@ function projectFormatId(fid, productId, field) {
  * a v2-only buyer (the spec requires `format_options` to have
  * `minItems: 1` when present). The function always returns a Product
  * shape so adopters can inspect what got dropped via diagnostics.
+ *
+ * @see canonicalDeclarationFromBareId — resolve a single bare format-id
+ * string (no surrounding Product) to a declaration or `format_kind`.
  */
 function projectV1ProductToV2(v1) {
     const format_options = [];
@@ -206,4 +212,105 @@ function projectV1ProductToV2(v1) {
     };
     return { v2: v2Product, diagnostics };
 }
+/**
+ * Resolve a bare v1 format-id string to its full v2
+ * `ProductFormatDeclaration`, or `null` when the id has no canonical
+ * mapping.
+ *
+ * Adopters migrating off legacy format storage routinely hold a bare id
+ * (`display_300x250_image`, `video_standard_30s`) persisted before the
+ * `{ agent_url, id }` structured-ref convention. This lifts that bare id
+ * to a structured ref (via `agentUrl`, default the AAO host) and runs the
+ * exact resolution the v1 → v2 product projection uses — in the registry
+ * spec's `v1-canonical-mapping.json` resolution order:
+ *
+ *   - AAO catalog `canonical:` annotation — the authoritative
+ *     seller-asserted mapping (registry resolution-order step 2).
+ *   - Registry `format_id_glob` literal match (registry resolution-order
+ *     step 3) — future-proof; 3.1 ships zero literal globs, so this fires
+ *     only when a future registry adds platform-specific literals.
+ *
+ * Fails closed: returns `null` — never a guess — when neither path
+ * resolves the id. That covers an unknown id, an under-specified id
+ * (`display_300x250`, which the catalog only carries as `_image` /
+ * `_html` / `_generative` variants), and a catalog entry the AAO has not
+ * yet annotated with a `canonical:`. Structural matching never
+ * contributes a kind: a bare id absent from the catalog carries no asset
+ * shape to match on, and a catalog entry lacking a `canonical:` fails
+ * closed before the structural step is reached.
+ *
+ * For an under-specified bare id, pass `assetType` (the asset type you
+ * already hold, such as an adopter's `format_type`) and the resolver retries
+ * the disambiguated catalog variant
+ * `<id>_<suffix>` — so the SDK owns the `_image` / `_html` suffix
+ * convention instead of every adopter re-deriving it. The hint is
+ * consulted only when the bare id doesn't resolve on its own, and still
+ * fails closed when the disambiguated id isn't a catalog entry.
+ *
+ * The returned declaration carries `v1_format_ref: [{ agent_url, id }]`
+ * (the resolved id — the disambiguated `<id>_<suffix>` when a hint
+ * applied), so adopters lift a bare id to a structured ref in one step
+ * (the pre-projection step the migration docs encourage).
+ *
+ * Like the rest of the projection layer, this requires the bundled AAO
+ * catalog + canonical-mapping registry; it throws (rather than returning
+ * `null`) only when those are missing from the install — a corrupted
+ * `@adcp/sdk` package, not a normal unresolved-id outcome.
+ *
+ * For just the `format_kind`, use {@link resolveCanonicalFormatKind}. For
+ * the structured diagnostic explaining *why* an id did not resolve, run
+ * it through {@link projectV1ProductToV2} inside a one-format product.
+ */
+function canonicalDeclarationFromBareId(id, options) {
+    if (!id)
+        return null;
+    const agentUrl = options?.agentUrl ?? constants_1.AAO_CANONICAL_AGENT_URL;
+    // A real catalog id is authoritative — resolve it directly first.
+    const direct = projectFormatId({ agent_url: agentUrl, id }, `<bare:${id}>`, `bareFormatId(${id})`).decl;
+    if (direct)
+        return direct;
+    // Under-specified bare id + an asset-type hint: retry the disambiguated
+    // catalog variant `<id>_<suffix>`. Fails closed if that isn't a catalog
+    // entry either — the hint narrows, it never fabricates.
+    const assetType = options?.assetType ?? options?.assetTypeHint;
+    const suffix = assetType ? normalizeAssetTypeSuffix(assetType) : '';
+    if (suffix) {
+        const disambiguated = `${id}_${suffix}`;
+        const hinted = projectFormatId({ agent_url: agentUrl, id: disambiguated }, `<bare:${disambiguated}>`, `bareFormatId(${disambiguated})`).decl;
+        if (hinted)
+            return hinted;
+    }
+    return null;
+}
+/**
+ * Map an `assetType` to the AAO catalog's `<base>_<suffix>` suffix.
+ * Catalog asset type `javascript` and canonical-kind names that differ from
+ * their suffix (`html5`, `display_tag`) are aliased. Any other value is passed
+ * through lowercased so a future asset type or suffix resolves without a code
+ * change — an unknown value simply misses the catalog and the caller fails
+ * closed.
+ */
+function normalizeAssetTypeSuffix(hint) {
+    const h = hint.trim().toLowerCase();
+    if (h === 'html5')
+        return 'html';
+    if (h === 'javascript')
+        return 'js';
+    if (h === 'display_tag')
+        return 'js';
+    return h;
+}
+/**
+ * Resolve a bare v1 format-id string to its canonical `format_kind`, or
+ * `null` when the id has no canonical mapping. Registry- and
+ * catalog-backed: the single source of truth that replaces hand-rolled
+ * `inferFormatKindFromFormatId` heuristics adopters maintain locally.
+ *
+ * Thin projection of {@link canonicalDeclarationFromBareId} down to the
+ * `format_kind`; see it for the resolution order, fail-closed semantics,
+ * the `agentUrl` default, and the `assetType` disambiguator.
+ */
+function resolveCanonicalFormatKind(id, options) {
+    return canonicalDeclarationFromBareId(id, options)?.format_kind ?? null;
+}
 //# sourceMappingURL=v1-to-v2.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"v1-to-v2.js","sourceRoot":"","sources":["../../../../src/lib/v2/projection/v1-to-v2.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"v1-to-v2.js","sourceRoot":"","sources":["../../../../src/lib/v2/projection/v1-to-v2.ts"],"names":[],"mappings":"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"}

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

@@ -31,6 +31,7 @@ exports.getRegisteredSchemaIds = getRegisteredSchemaIds;
 exports.hasSchemaBundle = hasSchemaBundle;
 exports._resetValidationLoader = _resetValidationLoader;
 exports.schemaAllowsTopLevelField = schemaAllowsTopLevelField;
+exports.getSchemaDefaultByPath = getSchemaDefaultByPath;
 const ajv_1 = __importDefault(require("ajv"));
 const ajv_formats_1 = __importDefault(require("ajv-formats"));
 const async_hooks_1 = require("async_hooks");
@@ -948,4 +949,60 @@ function schemaAllowsTopLevelField(toolName, field, version = version_1.ADCP_VER
         return true;
     }
 }
+/**
+ * Resolve a JSON Schema `default` value by walking a dot-separated property
+ * path through a schema's nested `properties` maps.
+ *
+ * This intentionally does not instantiate AJV's `useDefaults` mutation mode.
+ * Callers decide when a schema default is semantically meaningful for their
+ * runtime object; this helper only reports what the bundled schema declares.
+ *
+ * Fails closed (`undefined`) when the schema is unavailable, the path is not a
+ * concrete properties path, or the target schema node has no `default`.
+ *
+ * @internal — not part of the public API surface; may change without a major bump.
+ */
+function getSchemaDefaultByPath(schemaRef, dottedPath, version = version_1.ADCP_VERSION) {
+    try {
+        const s = ensureInit(version);
+        const normalized = normalizeSchemaRef(schemaRef);
+        if (!normalized)
+            return undefined;
+        const cacheKey = `schema-ref::${normalized}`;
+        const file = path_1.default.join(s.root, normalized);
+        if (!(0, fs_1.existsSync)(file))
+            return undefined;
+        let schema = s.rawSchemas.get(cacheKey);
+        if (!schema) {
+            schema = loadJson(file);
+            s.rawSchemas.set(cacheKey, schema);
+        }
+        const node = resolveSchemaPropertyPath(schema, dottedPath);
+        if (!node || !Object.prototype.hasOwnProperty.call(node, 'default'))
+            return undefined;
+        return cloneJsonValue(node.default);
+    }
+    catch {
+        return undefined;
+    }
+}
+function resolveSchemaPropertyPath(schema, dottedPath) {
+    let current = schema;
+    for (const key of dottedPath.split('.')) {
+        if (!current || typeof current !== 'object')
+            return undefined;
+        const props = current.properties;
+        if (!props || typeof props !== 'object')
+            return undefined;
+        if (!Object.prototype.hasOwnProperty.call(props, key))
+            return undefined;
+        current = props[key];
+    }
+    return current && typeof current === 'object' ? current : undefined;
+}
+function cloneJsonValue(value) {
+    if (value === null || typeof value !== 'object')
+        return value;
+    return JSON.parse(JSON.stringify(value));
+}
 //# sourceMappingURL=schema-loader.js.map