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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (622) hide show
  1. package/bin/adcp-storyboard-summary.js +286 -0
  2. package/bin/adcp.js +221 -10
  3. package/dist/lib/conformance/schemaLoader.d.mts +1 -1
  4. package/dist/lib/conformance/schemaLoader.d.ts +1 -1
  5. package/dist/lib/core/AgentClient.d.mts +6 -1
  6. package/dist/lib/core/AgentClient.d.ts +6 -1
  7. package/dist/lib/core/AgentClient.js +9 -0
  8. package/dist/lib/core/AgentClient.mjs +9 -0
  9. package/dist/lib/core/ConversationTypes.d.mts +29 -0
  10. package/dist/lib/core/ConversationTypes.d.ts +29 -0
  11. package/dist/lib/core/SingleAgentClient.d.mts +3 -1
  12. package/dist/lib/core/SingleAgentClient.d.ts +3 -1
  13. package/dist/lib/core/SingleAgentClient.js +9 -1
  14. package/dist/lib/core/SingleAgentClient.mjs +9 -1
  15. package/dist/lib/core/TaskExecutor.d.mts +13 -1
  16. package/dist/lib/core/TaskExecutor.d.ts +13 -1
  17. package/dist/lib/core/TaskExecutor.js +216 -18
  18. package/dist/lib/core/TaskExecutor.mjs +216 -19
  19. package/dist/lib/index.d.mts +5 -2
  20. package/dist/lib/index.d.ts +5 -2
  21. package/dist/lib/index.js +10 -1
  22. package/dist/lib/index.mjs +10 -1
  23. package/dist/lib/media-buy/action-assessment.d.mts +77 -0
  24. package/dist/lib/media-buy/action-assessment.d.ts +77 -0
  25. package/dist/lib/media-buy/action-assessment.js +300 -0
  26. package/dist/lib/media-buy/action-assessment.mjs +284 -0
  27. package/dist/lib/media-buy/action-constraints.d.mts +9 -0
  28. package/dist/lib/media-buy/action-constraints.d.ts +9 -0
  29. package/dist/lib/media-buy/action-constraints.js +170 -0
  30. package/dist/lib/media-buy/action-constraints.mjs +146 -0
  31. package/dist/lib/media-buy/action-contracts.d.mts +40 -0
  32. package/dist/lib/media-buy/action-contracts.d.ts +40 -0
  33. package/dist/lib/media-buy/action-contracts.js +304 -0
  34. package/dist/lib/media-buy/action-contracts.mjs +267 -0
  35. package/dist/lib/media-buy/action-metadata.generated.d.mts +37 -0
  36. package/dist/lib/media-buy/action-metadata.generated.d.ts +37 -0
  37. package/dist/lib/media-buy/action-metadata.generated.js +128 -0
  38. package/dist/lib/media-buy/action-metadata.generated.mjs +101 -0
  39. package/dist/lib/media-buy/action-types.d.mts +106 -0
  40. package/dist/lib/media-buy/action-types.d.ts +106 -0
  41. package/dist/lib/{types/v3-1-beta/tools.generated.js → media-buy/action-types.js} +2 -2
  42. package/dist/lib/media-buy/actions.d.mts +6 -0
  43. package/dist/lib/media-buy/actions.d.ts +6 -0
  44. package/dist/lib/media-buy/actions.js +38 -0
  45. package/dist/lib/media-buy/actions.mjs +9 -0
  46. package/dist/lib/media-buy/available-actions.d.mts +2 -1
  47. package/dist/lib/media-buy/available-actions.d.ts +2 -1
  48. package/dist/lib/media-buy/available-actions.js +4 -3
  49. package/dist/lib/media-buy/available-actions.mjs +4 -3
  50. package/dist/lib/media-buy/compatibility.js +3 -0
  51. package/dist/lib/media-buy/compatibility.mjs +3 -0
  52. package/dist/lib/media-buy/index.d.mts +4 -0
  53. package/dist/lib/media-buy/index.d.ts +4 -0
  54. package/dist/lib/media-buy/index.js +3 -1
  55. package/dist/lib/media-buy/index.mjs +1 -0
  56. package/dist/lib/media-buy/legacy-action-ids.d.mts +1 -0
  57. package/dist/lib/media-buy/legacy-action-ids.d.ts +1 -0
  58. package/dist/lib/media-buy/legacy-action-ids.js +50 -0
  59. package/dist/lib/media-buy/legacy-action-ids.mjs +26 -0
  60. package/dist/lib/media-buy/mutations.d.mts +70 -0
  61. package/dist/lib/media-buy/mutations.d.ts +70 -0
  62. package/dist/lib/media-buy/mutations.js +525 -0
  63. package/dist/lib/media-buy/mutations.mjs +498 -0
  64. package/dist/lib/media-buy/preflight.d.mts +20 -69
  65. package/dist/lib/media-buy/preflight.d.ts +20 -69
  66. package/dist/lib/media-buy/preflight.js +100 -336
  67. package/dist/lib/media-buy/preflight.mjs +111 -333
  68. package/dist/lib/media-buy/targeting-input.d.mts +7 -4
  69. package/dist/lib/media-buy/targeting-input.d.ts +7 -4
  70. package/dist/lib/media-buy/types.d.mts +55 -7
  71. package/dist/lib/media-buy/types.d.ts +55 -7
  72. package/dist/lib/protocols/rawResponseCapture.d.mts +12 -0
  73. package/dist/lib/protocols/rawResponseCapture.d.ts +12 -0
  74. package/dist/lib/protocols/rawResponseCapture.js +33 -3
  75. package/dist/lib/protocols/rawResponseCapture.mjs +32 -3
  76. package/dist/lib/registry/types.generated.d.mts +377 -9
  77. package/dist/lib/registry/types.generated.d.ts +377 -9
  78. package/dist/lib/reporting/content-mismatch.d.mts +126 -0
  79. package/dist/lib/reporting/content-mismatch.d.ts +126 -0
  80. package/dist/lib/reporting/content-mismatch.js +90 -0
  81. package/dist/lib/reporting/content-mismatch.mjs +66 -0
  82. package/dist/lib/reporting/evidence.d.mts +1 -0
  83. package/dist/lib/reporting/evidence.d.ts +1 -0
  84. package/dist/lib/reporting/evidence.js +32 -3
  85. package/dist/lib/reporting/evidence.mjs +31 -3
  86. package/dist/lib/reporting/index.d.mts +3 -1
  87. package/dist/lib/reporting/index.d.ts +3 -1
  88. package/dist/lib/reporting/index.js +3 -0
  89. package/dist/lib/reporting/index.mjs +2 -0
  90. package/dist/lib/reporting/ledger/handler.d.mts +51 -1
  91. package/dist/lib/reporting/ledger/handler.d.ts +51 -1
  92. package/dist/lib/reporting/ledger/handler.js +306 -38
  93. package/dist/lib/reporting/ledger/handler.mjs +304 -37
  94. package/dist/lib/reporting/ledger/health.d.mts +12 -0
  95. package/dist/lib/reporting/ledger/health.d.ts +12 -0
  96. package/dist/lib/reporting/ledger/health.js +15 -2
  97. package/dist/lib/reporting/ledger/health.mjs +13 -1
  98. package/dist/lib/reporting/ledger/index.d.mts +3 -0
  99. package/dist/lib/reporting/ledger/index.d.ts +3 -0
  100. package/dist/lib/reporting/ledger/index.js +7 -1
  101. package/dist/lib/reporting/ledger/index.mjs +3 -0
  102. package/dist/lib/reporting/ledger/lifecycle.d.mts +31 -4
  103. package/dist/lib/reporting/ledger/lifecycle.d.ts +31 -4
  104. package/dist/lib/reporting/ledger/lifecycle.js +244 -37
  105. package/dist/lib/reporting/ledger/lifecycle.mjs +244 -37
  106. package/dist/lib/reporting/ledger/managed-postgres.d.mts +231 -0
  107. package/dist/lib/reporting/ledger/managed-postgres.d.ts +231 -0
  108. package/dist/lib/reporting/ledger/managed-postgres.js +1797 -0
  109. package/dist/lib/reporting/ledger/managed-postgres.mjs +1776 -0
  110. package/dist/lib/reporting/ledger/managed.d.mts +355 -0
  111. package/dist/lib/reporting/ledger/managed.d.ts +355 -0
  112. package/dist/lib/reporting/ledger/managed.js +661 -0
  113. package/dist/lib/reporting/ledger/managed.mjs +633 -0
  114. package/dist/lib/reporting/ledger/notification-activity.d.mts +222 -0
  115. package/dist/lib/reporting/ledger/notification-activity.d.ts +222 -0
  116. package/dist/lib/reporting/ledger/notification-activity.js +1139 -0
  117. package/dist/lib/reporting/ledger/notification-activity.mjs +1110 -0
  118. package/dist/lib/reporting/ledger/postgres.d.mts +161 -1
  119. package/dist/lib/reporting/ledger/postgres.d.ts +161 -1
  120. package/dist/lib/reporting/ledger/postgres.js +1153 -21
  121. package/dist/lib/reporting/ledger/postgres.mjs +1152 -21
  122. package/dist/lib/reporting/ledger/producer.d.mts +8 -0
  123. package/dist/lib/reporting/ledger/producer.d.ts +8 -0
  124. package/dist/lib/reporting/ledger/producer.js +146 -52
  125. package/dist/lib/reporting/ledger/producer.mjs +146 -51
  126. package/dist/lib/reporting/ledger/types.d.mts +358 -1
  127. package/dist/lib/reporting/ledger/types.d.ts +358 -1
  128. package/dist/lib/reporting/ledger/types.js +3 -0
  129. package/dist/lib/reporting/ledger/types.mjs +2 -0
  130. package/dist/lib/reporting/reconciliation.d.mts +362 -2
  131. package/dist/lib/reporting/reconciliation.d.ts +362 -2
  132. package/dist/lib/reporting/reconciliation.js +1051 -7
  133. package/dist/lib/reporting/reconciliation.mjs +1053 -7
  134. package/dist/lib/reporting/service/conformance.d.mts +35 -0
  135. package/dist/lib/reporting/service/conformance.d.ts +35 -0
  136. package/dist/lib/reporting/service/conformance.js +89 -0
  137. package/dist/lib/reporting/service/conformance.mjs +68 -0
  138. package/dist/lib/reporting/service/index.d.mts +182 -0
  139. package/dist/lib/reporting/service/index.d.ts +182 -0
  140. package/dist/lib/reporting/service/index.js +793 -0
  141. package/dist/lib/reporting/service/index.mjs +787 -0
  142. package/dist/lib/reporting/source/index.d.mts +2 -1
  143. package/dist/lib/reporting/source/index.d.ts +2 -1
  144. package/dist/lib/reporting/source/index.js +16 -3
  145. package/dist/lib/reporting/source/index.mjs +12 -1
  146. package/dist/lib/reporting/source/inline.d.mts +88 -1
  147. package/dist/lib/reporting/source/inline.d.ts +88 -1
  148. package/dist/lib/reporting/source/inline.js +1161 -163
  149. package/dist/lib/reporting/source/inline.mjs +1166 -163
  150. package/dist/lib/reporting/source/manifest.js +12 -7
  151. package/dist/lib/reporting/source/manifest.mjs +12 -7
  152. package/dist/lib/reporting/source/source.d.mts +26 -0
  153. package/dist/lib/reporting/source/source.d.ts +26 -0
  154. package/dist/lib/reporting/source/source.js +71 -2
  155. package/dist/lib/reporting/source/source.mjs +65 -1
  156. package/dist/lib/schemas/index.d.mts +22 -1
  157. package/dist/lib/schemas/index.d.ts +22 -1
  158. package/dist/lib/schemas/index.js +7 -0
  159. package/dist/lib/schemas/index.mjs +7 -0
  160. package/dist/lib/schemas-data/v2.5/_provenance.json +1 -1
  161. package/dist/lib/server/create-adcp-server.d.mts +18 -0
  162. package/dist/lib/server/create-adcp-server.d.ts +18 -0
  163. package/dist/lib/server/create-adcp-server.js +52 -2
  164. package/dist/lib/server/create-adcp-server.mjs +52 -2
  165. package/dist/lib/server/decisioning/account.d.mts +1 -1
  166. package/dist/lib/server/decisioning/account.d.ts +1 -1
  167. package/dist/lib/server/decisioning/index.d.mts +1 -0
  168. package/dist/lib/server/decisioning/index.d.ts +1 -0
  169. package/dist/lib/server/decisioning/platform.d.mts +3 -0
  170. package/dist/lib/server/decisioning/platform.d.ts +3 -0
  171. package/dist/lib/server/decisioning/runtime/from-platform.js +88 -10
  172. package/dist/lib/server/decisioning/runtime/from-platform.mjs +88 -10
  173. package/dist/lib/server/decisioning/specialisms/reporting.d.mts +38 -0
  174. package/dist/lib/server/decisioning/specialisms/reporting.d.ts +38 -0
  175. package/dist/lib/{types/v3-1-beta/index.js → server/decisioning/specialisms/reporting.js} +2 -8
  176. package/dist/lib/server/decisioning/specialisms/reporting.mjs +0 -0
  177. package/dist/lib/server/index.d.mts +4 -2
  178. package/dist/lib/server/index.d.ts +4 -2
  179. package/dist/lib/server/index.js +5 -0
  180. package/dist/lib/server/index.mjs +4 -0
  181. package/dist/lib/server/media-buy-action-resolver.d.mts +63 -0
  182. package/dist/lib/server/media-buy-action-resolver.d.ts +63 -0
  183. package/dist/lib/server/media-buy-action-resolver.js +297 -0
  184. package/dist/lib/server/media-buy-action-resolver.mjs +285 -0
  185. package/dist/lib/server/media-buy-actions.d.mts +7 -8
  186. package/dist/lib/server/media-buy-actions.d.ts +7 -8
  187. package/dist/lib/server/media-buy-actions.js +57 -14
  188. package/dist/lib/server/media-buy-actions.mjs +63 -14
  189. package/dist/lib/server/notification-subscriptions/index.d.mts +2 -2
  190. package/dist/lib/server/notification-subscriptions/index.d.ts +2 -2
  191. package/dist/lib/server/notification-subscriptions/index.js +2 -0
  192. package/dist/lib/server/notification-subscriptions/index.mjs +2 -0
  193. package/dist/lib/server/notification-subscriptions/postgres-runtime.d.mts +3 -1
  194. package/dist/lib/server/notification-subscriptions/postgres-runtime.d.ts +3 -1
  195. package/dist/lib/server/notification-subscriptions/postgres-runtime.js +1 -0
  196. package/dist/lib/server/notification-subscriptions/postgres-runtime.mjs +1 -0
  197. package/dist/lib/server/notification-subscriptions/runtime.d.mts +12 -1
  198. package/dist/lib/server/notification-subscriptions/runtime.d.ts +12 -1
  199. package/dist/lib/server/notification-subscriptions/runtime.js +102 -16
  200. package/dist/lib/server/notification-subscriptions/runtime.mjs +101 -16
  201. package/dist/lib/server/notification-subscriptions/types.d.mts +104 -1
  202. package/dist/lib/server/notification-subscriptions/types.d.ts +104 -1
  203. package/dist/lib/server/webhook-emitter.d.mts +40 -5
  204. package/dist/lib/server/webhook-emitter.d.ts +40 -5
  205. package/dist/lib/server/webhook-emitter.js +23 -12
  206. package/dist/lib/server/webhook-emitter.mjs +23 -12
  207. package/dist/lib/storage/interfaces.d.mts +14 -2
  208. package/dist/lib/storage/interfaces.d.ts +14 -2
  209. package/dist/lib/testing/compliance/comply.d.mts +9 -3
  210. package/dist/lib/testing/compliance/comply.d.ts +9 -3
  211. package/dist/lib/testing/compliance/comply.js +158 -3
  212. package/dist/lib/testing/compliance/comply.mjs +159 -4
  213. package/dist/lib/testing/compliance/storyboard-tracks.js +7 -5
  214. package/dist/lib/testing/compliance/storyboard-tracks.mjs +7 -5
  215. package/dist/lib/testing/compliance/summary.js +10 -1
  216. package/dist/lib/testing/compliance/summary.mjs +10 -1
  217. package/dist/lib/testing/index.d.mts +1 -1
  218. package/dist/lib/testing/index.d.ts +1 -1
  219. package/dist/lib/testing/index.js +2 -0
  220. package/dist/lib/testing/index.mjs +3 -1
  221. package/dist/lib/testing/storyboard/agent-routing.d.mts +12 -43
  222. package/dist/lib/testing/storyboard/agent-routing.d.ts +12 -43
  223. package/dist/lib/testing/storyboard/agent-routing.js +75 -13
  224. package/dist/lib/testing/storyboard/agent-routing.mjs +70 -12
  225. package/dist/lib/testing/storyboard/index.d.mts +1 -0
  226. package/dist/lib/testing/storyboard/index.d.ts +1 -0
  227. package/dist/lib/testing/storyboard/index.js +3 -0
  228. package/dist/lib/testing/storyboard/index.mjs +2 -0
  229. package/dist/lib/testing/storyboard/junit.d.mts +1 -1
  230. package/dist/lib/testing/storyboard/junit.d.ts +1 -1
  231. package/dist/lib/testing/storyboard/junit.js +21 -2
  232. package/dist/lib/testing/storyboard/junit.mjs +21 -2
  233. package/dist/lib/testing/storyboard/probes.d.mts +130 -0
  234. package/dist/lib/testing/storyboard/probes.d.ts +130 -0
  235. package/dist/lib/testing/storyboard/probes.js +682 -10
  236. package/dist/lib/testing/storyboard/probes.mjs +683 -3
  237. package/dist/lib/testing/storyboard/request-signing/builder.d.mts +16 -5
  238. package/dist/lib/testing/storyboard/request-signing/builder.d.ts +16 -5
  239. package/dist/lib/testing/storyboard/request-signing/grader.d.mts +44 -1
  240. package/dist/lib/testing/storyboard/request-signing/grader.d.ts +44 -1
  241. package/dist/lib/testing/storyboard/request-signing/grader.js +46 -22
  242. package/dist/lib/testing/storyboard/request-signing/grader.mjs +43 -21
  243. package/dist/lib/testing/storyboard/request-signing/probe-dispatch.d.mts +86 -11
  244. package/dist/lib/testing/storyboard/request-signing/probe-dispatch.d.ts +86 -11
  245. package/dist/lib/testing/storyboard/request-signing/probe-dispatch.js +119 -25
  246. package/dist/lib/testing/storyboard/request-signing/probe-dispatch.mjs +117 -26
  247. package/dist/lib/testing/storyboard/request-signing/synthesize.js +22 -2
  248. package/dist/lib/testing/storyboard/request-signing/synthesize.mjs +22 -2
  249. package/dist/lib/testing/storyboard/runner.d.mts +103 -0
  250. package/dist/lib/testing/storyboard/runner.d.ts +103 -0
  251. package/dist/lib/testing/storyboard/runner.js +1090 -268
  252. package/dist/lib/testing/storyboard/runner.mjs +1096 -261
  253. package/dist/lib/testing/storyboard/seeding.d.mts +4 -1
  254. package/dist/lib/testing/storyboard/seeding.d.ts +4 -1
  255. package/dist/lib/testing/storyboard/seeding.js +55 -24
  256. package/dist/lib/testing/storyboard/seeding.mjs +55 -24
  257. package/dist/lib/testing/storyboard/test-kit.d.mts +37 -3
  258. package/dist/lib/testing/storyboard/test-kit.d.ts +37 -3
  259. package/dist/lib/testing/storyboard/test-kit.js +8 -2
  260. package/dist/lib/testing/storyboard/test-kit.mjs +7 -2
  261. package/dist/lib/testing/storyboard/types.d.mts +132 -10
  262. package/dist/lib/testing/storyboard/types.d.ts +132 -10
  263. package/dist/lib/testing/storyboard/types.js +17 -0
  264. package/dist/lib/testing/storyboard/types.mjs +16 -0
  265. package/dist/lib/testing/storyboard/validations.d.mts +1 -1
  266. package/dist/lib/testing/storyboard/validations.d.ts +1 -1
  267. package/dist/lib/testing/storyboard/validations.js +16 -0
  268. package/dist/lib/testing/storyboard/validations.mjs +16 -0
  269. package/dist/lib/testing/test-controller.d.mts +1 -1
  270. package/dist/lib/testing/test-controller.d.ts +1 -1
  271. package/dist/lib/types/buy-products.d.ts +71 -6
  272. package/dist/lib/types/control-media-buy.d.ts +25 -11
  273. package/dist/lib/types/core.generated.d.mts +69 -10
  274. package/dist/lib/types/core.generated.d.ts +69 -10
  275. package/dist/lib/types/create-media-buy.d.ts +71 -6
  276. package/dist/lib/types/forward-compat-error-codes.d.mts +7 -6
  277. package/dist/lib/types/forward-compat-error-codes.d.ts +7 -6
  278. package/dist/lib/types/index.d.mts +2 -2
  279. package/dist/lib/types/index.d.ts +2 -2
  280. package/dist/lib/types/schemas.generated.d.ts +8040 -8116
  281. package/dist/lib/types/schemas.generated.js +1074 -309
  282. package/dist/lib/types/schemas.generated.mjs +1068 -309
  283. package/dist/lib/types/tools.generated.d.mts +65 -6
  284. package/dist/lib/types/tools.generated.d.ts +65 -6
  285. package/dist/lib/types/update-media-buy.d.ts +71 -6
  286. package/dist/lib/utils/redact-secrets.d.mts +1 -1
  287. package/dist/lib/utils/redact-secrets.d.ts +1 -1
  288. package/dist/lib/utils/redact-secrets.js +1 -1
  289. package/dist/lib/utils/redact-secrets.mjs +1 -1
  290. package/dist/lib/v2/projection/cache-versions.d.mts +0 -1
  291. package/dist/lib/v2/projection/cache-versions.d.ts +0 -1
  292. package/dist/lib/v2/projection/cache-versions.js +1 -15
  293. package/dist/lib/v2/projection/cache-versions.mjs +1 -14
  294. package/dist/lib/v2/projection/canonical-properties.js +2 -2
  295. package/dist/lib/v2/projection/canonical-properties.mjs +3 -3
  296. package/dist/lib/v2/projection/registry.d.mts +1 -1
  297. package/dist/lib/v2/projection/registry.d.ts +1 -1
  298. package/dist/lib/v2/projection/registry.js +2 -2
  299. package/dist/lib/v2/projection/registry.mjs +3 -3
  300. package/dist/lib/validation/schema-loader.d.mts +9 -1
  301. package/dist/lib/validation/schema-loader.d.ts +9 -1
  302. package/dist/lib/validation/schema-loader.js +65 -8
  303. package/dist/lib/validation/schema-loader.mjs +64 -8
  304. package/dist/lib/version.d.mts +5 -5
  305. package/dist/lib/version.d.ts +5 -5
  306. package/dist/lib/version.js +3 -8
  307. package/dist/lib/version.mjs +3 -8
  308. package/dist/lib/wholesale-feed-sync/index.d.mts +1 -0
  309. package/dist/lib/wholesale-feed-sync/index.d.ts +1 -0
  310. package/dist/lib/wholesale-feed-sync/protocol-types.d.mts +42 -0
  311. package/dist/lib/wholesale-feed-sync/protocol-types.d.ts +42 -0
  312. package/dist/lib/wholesale-feed-sync/protocol-types.js +16 -0
  313. package/dist/lib/wholesale-feed-sync/protocol-types.mjs +0 -0
  314. package/dist/lib/wholesale-feed-sync/sync.d.mts +6 -6
  315. package/dist/lib/wholesale-feed-sync/sync.d.ts +6 -6
  316. package/dist/lib/wholesale-feed-sync/sync.js +3 -1
  317. package/dist/lib/wholesale-feed-sync/sync.mjs +3 -1
  318. package/dist/lib/wholesale-feed-sync/types.d.mts +15 -14
  319. package/dist/lib/wholesale-feed-sync/types.d.ts +15 -14
  320. package/dist/lib/wholesale-feed-sync/webhook-notification.d.mts +7 -5
  321. package/dist/lib/wholesale-feed-sync/webhook-notification.d.ts +7 -5
  322. package/dist/lib/wholesale-feed-sync/webhook-notification.js +45 -0
  323. package/dist/lib/wholesale-feed-sync/webhook-notification.mjs +44 -0
  324. package/docs/CLI.md +1 -1
  325. package/docs/TYPE-SUMMARY.md +118 -4
  326. package/docs/guides/ASYNC-API-REFERENCE.md +62 -1
  327. package/docs/guides/ASYNC-DEVELOPER-GUIDE.md +25 -0
  328. package/docs/guides/ASYNC-DOCUMENTATION-INDEX.md +3 -0
  329. package/docs/guides/BUYER-QUICKSTART-3.2.md +5 -0
  330. package/docs/guides/DURABLE-BUYER-WRITES.md +337 -0
  331. package/docs/guides/EXISTING-PLATFORM.md +80 -1
  332. package/docs/guides/MEDIA-BUY-3.2-COMPATIBILITY.md +57 -0
  333. package/docs/guides/MEDIA-BUY-ACTION-ASSESSMENT.md +300 -0
  334. package/docs/guides/REPORTING-LEDGER.md +654 -3
  335. package/docs/guides/REPORTING-RECONCILIATION.md +50 -0
  336. package/docs/guides/REPORTING-SOURCE-EXECUTOR.md +63 -1
  337. package/docs/guides/SELLER-QUICKSTART-3.2.md +2 -0
  338. package/docs/guides/VALIDATE-YOUR-AGENT.md +35 -0
  339. package/docs/guides/idempotency-crash-recovery.md +4 -0
  340. package/docs/llms.txt +4 -2
  341. package/docs/migration-14.x-rc-worksheet.md +60 -5
  342. package/docs/migration-7.9-to-7.10.md +7 -5
  343. package/examples/README.md +17 -0
  344. package/examples/durable-buyer-writes/caller.ts +745 -0
  345. package/examples/durable-buyer-writes/worker.ts +240 -0
  346. package/examples/reliable-reporting-service/README.md +100 -0
  347. package/examples/seller-3.2-starter.ts +7 -8
  348. package/examples/targeting-input-existing-platform.ts +153 -0
  349. package/package.json +41 -29
  350. package/skills/build-seller-agent/SKILL.md +2 -0
  351. package/skills/build-seller-agent/specialisms/signed-requests.md +11 -1
  352. package/skills/cross-cutting.md +28 -11
  353. package/compliance/cache/3.1.0-beta.7/domains/brand/index.yaml +0 -160
  354. package/compliance/cache/3.1.0-beta.7/domains/brand/scenarios/distributed_brand_resolution.yaml +0 -415
  355. package/compliance/cache/3.1.0-beta.7/domains/brand/scenarios/single_side_trust_extension.yaml +0 -454
  356. package/compliance/cache/3.1.0-beta.7/domains/creative/index.yaml +0 -339
  357. package/compliance/cache/3.1.0-beta.7/domains/creative/scenarios/billing_out_of_band.yaml +0 -153
  358. package/compliance/cache/3.1.0-beta.7/domains/creative/scenarios/creative_lifecycle_webhooks.yaml +0 -389
  359. package/compliance/cache/3.1.0-beta.7/domains/creative/scenarios/native_in_feed.yaml +0 -543
  360. package/compliance/cache/3.1.0-beta.7/domains/governance/index.yaml +0 -682
  361. package/compliance/cache/3.1.0-beta.7/domains/media-buy/index.yaml +0 -781
  362. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/audience_buy_flow.yaml +0 -380
  363. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/available_actions.yaml +0 -565
  364. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/billing_finality_delivery.yaml +0 -354
  365. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/canonical_formats.yaml +0 -711
  366. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/clicks_buy_flow.yaml +0 -264
  367. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/completed_views_buy_flow.yaml +0 -344
  368. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/create_media_buy_async.yaml +0 -234
  369. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/creative_fate_after_cancellation.yaml +0 -419
  370. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/creative_reception.yaml +0 -247
  371. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/delivery_reporting.yaml +0 -357
  372. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/dependency_impairment.yaml +0 -633
  373. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/dependency_impairment_cardinality.yaml +0 -800
  374. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/event_dedup_flow.yaml +0 -399
  375. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/frequency_cap_enforcement.yaml +0 -309
  376. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/governance_approved.yaml +0 -214
  377. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/governance_conditions.yaml +0 -199
  378. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/governance_denied.yaml +0 -204
  379. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/governance_denied_recovery.yaml +0 -252
  380. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/invalid_transitions.yaml +0 -289
  381. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/inventory_list_no_match.yaml +0 -148
  382. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/inventory_list_targeting.yaml +0 -276
  383. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/measurement_accountability.yaml +0 -244
  384. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/measurement_terms_rejected.yaml +0 -203
  385. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/pending_creatives_to_start.yaml +0 -274
  386. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/per_creative_conversion_attribution.yaml +0 -500
  387. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/performance_buy_flow.yaml +0 -428
  388. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/performance_buy_flow_roas.yaml +0 -470
  389. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/product_signal_targeting.yaml +0 -373
  390. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/proposal_finalize.yaml +0 -399
  391. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/proposal_finalize_asap_timing.yaml +0 -264
  392. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/proposal_not_found_errors.yaml +0 -257
  393. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/provenance_audit_observation.yaml +0 -333
  394. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/provenance_enforcement.yaml +0 -517
  395. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/provenance_truth_of_claim.yaml +0 -294
  396. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/reach_buy_flow.yaml +0 -823
  397. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/refine_finalize_exclusivity.yaml +0 -360
  398. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/refine_products.yaml +0 -148
  399. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/vendor_metric_accountability.yaml +0 -293
  400. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/vendor_metric_catalog_precondition.yaml +0 -307
  401. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/vendor_metric_optimization_flow.yaml +0 -576
  402. package/compliance/cache/3.1.0-beta.7/domains/media-buy/state-machine.yaml +0 -442
  403. package/compliance/cache/3.1.0-beta.7/domains/signals/index.yaml +0 -266
  404. package/compliance/cache/3.1.0-beta.7/domains/sponsored-intelligence/index.yaml +0 -256
  405. package/compliance/cache/3.1.0-beta.7/index.json +0 -356
  406. package/compliance/cache/3.1.0-beta.7/protocols/brand/index.yaml +0 -160
  407. package/compliance/cache/3.1.0-beta.7/protocols/brand/scenarios/distributed_brand_resolution.yaml +0 -415
  408. package/compliance/cache/3.1.0-beta.7/protocols/brand/scenarios/single_side_trust_extension.yaml +0 -454
  409. package/compliance/cache/3.1.0-beta.7/protocols/creative/index.yaml +0 -339
  410. package/compliance/cache/3.1.0-beta.7/protocols/creative/scenarios/billing_out_of_band.yaml +0 -153
  411. package/compliance/cache/3.1.0-beta.7/protocols/creative/scenarios/creative_lifecycle_webhooks.yaml +0 -389
  412. package/compliance/cache/3.1.0-beta.7/protocols/creative/scenarios/native_in_feed.yaml +0 -543
  413. package/compliance/cache/3.1.0-beta.7/protocols/governance/index.yaml +0 -682
  414. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/index.yaml +0 -781
  415. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/audience_buy_flow.yaml +0 -380
  416. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/available_actions.yaml +0 -565
  417. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/billing_finality_delivery.yaml +0 -354
  418. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/canonical_formats.yaml +0 -711
  419. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/clicks_buy_flow.yaml +0 -264
  420. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/completed_views_buy_flow.yaml +0 -344
  421. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/create_media_buy_async.yaml +0 -234
  422. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/creative_fate_after_cancellation.yaml +0 -419
  423. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/creative_reception.yaml +0 -247
  424. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/delivery_reporting.yaml +0 -357
  425. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/dependency_impairment.yaml +0 -633
  426. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/dependency_impairment_cardinality.yaml +0 -800
  427. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/event_dedup_flow.yaml +0 -399
  428. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/frequency_cap_enforcement.yaml +0 -309
  429. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/governance_approved.yaml +0 -214
  430. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/governance_conditions.yaml +0 -199
  431. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/governance_denied.yaml +0 -204
  432. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/governance_denied_recovery.yaml +0 -252
  433. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/invalid_transitions.yaml +0 -289
  434. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/inventory_list_no_match.yaml +0 -148
  435. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/inventory_list_targeting.yaml +0 -276
  436. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/measurement_accountability.yaml +0 -244
  437. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/measurement_terms_rejected.yaml +0 -203
  438. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/pending_creatives_to_start.yaml +0 -274
  439. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/per_creative_conversion_attribution.yaml +0 -500
  440. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/performance_buy_flow.yaml +0 -428
  441. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/performance_buy_flow_roas.yaml +0 -470
  442. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/product_signal_targeting.yaml +0 -373
  443. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/proposal_finalize.yaml +0 -399
  444. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/proposal_finalize_asap_timing.yaml +0 -264
  445. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/proposal_not_found_errors.yaml +0 -257
  446. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/provenance_audit_observation.yaml +0 -333
  447. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/provenance_enforcement.yaml +0 -517
  448. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/provenance_truth_of_claim.yaml +0 -294
  449. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/reach_buy_flow.yaml +0 -823
  450. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/refine_finalize_exclusivity.yaml +0 -360
  451. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/refine_products.yaml +0 -148
  452. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/vendor_metric_accountability.yaml +0 -293
  453. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/vendor_metric_catalog_precondition.yaml +0 -307
  454. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/vendor_metric_optimization_flow.yaml +0 -576
  455. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/state-machine.yaml +0 -442
  456. package/compliance/cache/3.1.0-beta.7/protocols/signals/index.yaml +0 -266
  457. package/compliance/cache/3.1.0-beta.7/protocols/sponsored-intelligence/index.yaml +0 -256
  458. package/compliance/cache/3.1.0-beta.7/specialisms/audience-sync/index.yaml +0 -313
  459. package/compliance/cache/3.1.0-beta.7/specialisms/brand-rights/index.yaml +0 -350
  460. package/compliance/cache/3.1.0-beta.7/specialisms/brand-rights/scenarios/governance_denied.yaml +0 -226
  461. package/compliance/cache/3.1.0-beta.7/specialisms/collection-lists/index.yaml +0 -359
  462. package/compliance/cache/3.1.0-beta.7/specialisms/content-standards/index.yaml +0 -572
  463. package/compliance/cache/3.1.0-beta.7/specialisms/creative-ad-server/index.yaml +0 -409
  464. package/compliance/cache/3.1.0-beta.7/specialisms/creative-generative/generative-seller.yaml +0 -807
  465. package/compliance/cache/3.1.0-beta.7/specialisms/creative-generative/index.yaml +0 -758
  466. package/compliance/cache/3.1.0-beta.7/specialisms/creative-template/index.yaml +0 -510
  467. package/compliance/cache/3.1.0-beta.7/specialisms/governance-aware-seller/index.yaml +0 -143
  468. package/compliance/cache/3.1.0-beta.7/specialisms/governance-aware-seller/scenarios/governance_multi_agent_rejected.yaml +0 -117
  469. package/compliance/cache/3.1.0-beta.7/specialisms/governance-delivery-monitor/index.yaml +0 -441
  470. package/compliance/cache/3.1.0-beta.7/specialisms/governance-spend-authority/denied.yaml +0 -221
  471. package/compliance/cache/3.1.0-beta.7/specialisms/governance-spend-authority/index.yaml +0 -330
  472. package/compliance/cache/3.1.0-beta.7/specialisms/property-lists/index.yaml +0 -482
  473. package/compliance/cache/3.1.0-beta.7/specialisms/sales-broadcast-tv/index.yaml +0 -738
  474. package/compliance/cache/3.1.0-beta.7/specialisms/sales-catalog-driven/index.yaml +0 -840
  475. package/compliance/cache/3.1.0-beta.7/specialisms/sales-guaranteed/index.yaml +0 -601
  476. package/compliance/cache/3.1.0-beta.7/specialisms/sales-non-guaranteed/index.yaml +0 -546
  477. package/compliance/cache/3.1.0-beta.7/specialisms/sales-proposal-mode/index.yaml +0 -586
  478. package/compliance/cache/3.1.0-beta.7/specialisms/sales-social/index.yaml +0 -919
  479. package/compliance/cache/3.1.0-beta.7/specialisms/signal-marketplace/index.yaml +0 -424
  480. package/compliance/cache/3.1.0-beta.7/specialisms/signal-marketplace/scenarios/governance_denied.yaml +0 -211
  481. package/compliance/cache/3.1.0-beta.7/specialisms/signal-owned/index.yaml +0 -317
  482. package/compliance/cache/3.1.0-beta.7/specialisms/sponsored-intelligence/index.yaml +0 -59
  483. package/compliance/cache/3.1.0-beta.7/test-kits/acme-outdoor-live.yaml +0 -78
  484. package/compliance/cache/3.1.0-beta.7/test-kits/acme-outdoor.yaml +0 -223
  485. package/compliance/cache/3.1.0-beta.7/test-kits/billing-gate-runner.yaml +0 -115
  486. package/compliance/cache/3.1.0-beta.7/test-kits/bistro-oranje.yaml +0 -126
  487. package/compliance/cache/3.1.0-beta.7/test-kits/distributed-brand-runner.yaml +0 -281
  488. package/compliance/cache/3.1.0-beta.7/test-kits/nova-motors.yaml +0 -262
  489. package/compliance/cache/3.1.0-beta.7/test-kits/osei-natural.yaml +0 -126
  490. package/compliance/cache/3.1.0-beta.7/test-kits/parallel-dispatch-runner.yaml +0 -196
  491. package/compliance/cache/3.1.0-beta.7/test-kits/rate-limit-trip-runner.yaml +0 -172
  492. package/compliance/cache/3.1.0-beta.7/test-kits/signed-requests-runner.yaml +0 -155
  493. package/compliance/cache/3.1.0-beta.7/test-kits/single-side-trust-runner.yaml +0 -294
  494. package/compliance/cache/3.1.0-beta.7/test-kits/substitution-observer-runner.yaml +0 -688
  495. package/compliance/cache/3.1.0-beta.7/test-kits/summit-foods.yaml +0 -125
  496. package/compliance/cache/3.1.0-beta.7/test-kits/webhook-receiver-runner.yaml +0 -265
  497. package/compliance/cache/3.1.0-beta.7/test-vectors/plan-hash/001-minimal-plan.json +0 -43
  498. package/compliance/cache/3.1.0-beta.7/test-vectors/plan-hash/002-full-plan.json +0 -217
  499. package/compliance/cache/3.1.0-beta.7/test-vectors/plan-hash/003-bookkeeping-stripped.json +0 -60
  500. package/compliance/cache/3.1.0-beta.7/test-vectors/plan-hash/004a-human-review-omitted.json +0 -43
  501. package/compliance/cache/3.1.0-beta.7/test-vectors/plan-hash/004b-human-review-explicit-null.json +0 -49
  502. package/compliance/cache/3.1.0-beta.7/test-vectors/plan-hash/005a-policy-categories-order-1.json +0 -53
  503. package/compliance/cache/3.1.0-beta.7/test-vectors/plan-hash/005b-policy-categories-order-2.json +0 -57
  504. package/compliance/cache/3.1.0-beta.7/test-vectors/plan-hash/006a-ext-trace-v1.json +0 -49
  505. package/compliance/cache/3.1.0-beta.7/test-vectors/plan-hash/006b-ext-trace-v2.json +0 -53
  506. package/compliance/cache/3.1.0-beta.7/test-vectors/plan-hash/007-unicode-objectives.json +0 -43
  507. package/compliance/cache/3.1.0-beta.7/test-vectors/plan-hash/008-numeric-canonicalization.json +0 -65
  508. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/README.md +0 -220
  509. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/canonicalization.json +0 -241
  510. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/keys.json +0 -60
  511. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/001-no-signature-header.json +0 -24
  512. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/002-wrong-tag.json +0 -26
  513. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/003-expired-signature.json +0 -26
  514. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/004-window-too-long.json +0 -26
  515. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/005-alg-not-allowed.json +0 -26
  516. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/006-missing-covered-component.json +0 -26
  517. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/007-missing-content-digest.json +0 -26
  518. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/008-unknown-keyid.json +0 -26
  519. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/009-key-ops-missing-verify.json +0 -27
  520. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/010-content-digest-mismatch.json +0 -33
  521. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/011-malformed-header.json +0 -27
  522. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/012-missing-expires-param.json +0 -26
  523. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/013-expires-le-created.json +0 -27
  524. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/014-missing-nonce-param.json +0 -27
  525. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/015-signature-invalid.json +0 -28
  526. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/016-replayed-nonce.json +0 -35
  527. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/017-key-revoked.json +0 -38
  528. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/018-digest-covered-when-forbidden.json +0 -28
  529. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/019-signature-without-signature-input.json +0 -26
  530. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/020-rate-abuse.json +0 -34
  531. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/021-duplicate-signature-input-label.json +0 -31
  532. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/022-multi-valued-content-type.json +0 -31
  533. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/023-multi-valued-content-digest.json +0 -32
  534. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/024-unquoted-string-param.json +0 -31
  535. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/025-jwk-alg-crv-mismatch.json +0 -43
  536. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/026-non-ascii-host.json +0 -31
  537. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/027-webhook-registration-authentication-unsigned.json +0 -25
  538. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/028-unsigned-protocol-method-required.json +0 -26
  539. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/positive/001-basic-post.json +0 -30
  540. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/positive/002-post-with-content-digest.json +0 -31
  541. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/positive/003-es256-post.json +0 -30
  542. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/positive/004-multiple-signature-labels.json +0 -26
  543. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/positive/005-default-port-stripped.json +0 -30
  544. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/positive/006-dot-segment-path.json +0 -30
  545. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/positive/007-query-byte-preserved.json +0 -30
  546. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/positive/008-percent-encoded-path.json +0 -30
  547. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/positive/009-percent-encoded-unreserved-decoded.json +0 -30
  548. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/positive/010-percent-encoded-slash-preserved.json +0 -30
  549. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/positive/011-ipv6-authority.json +0 -30
  550. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/positive/012-ipv6-authority-default-port-stripped.json +0 -30
  551. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/README.md +0 -211
  552. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/keys.json +0 -61
  553. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/negative/001-wrong-tag.json +0 -26
  554. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/negative/002-expired-signature.json +0 -26
  555. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/negative/003-window-too-long.json +0 -26
  556. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/negative/004-alg-not-allowed.json +0 -26
  557. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/negative/005-missing-authority-component.json +0 -26
  558. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/negative/006-missing-content-digest.json +0 -25
  559. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/negative/007-unknown-keyid.json +0 -26
  560. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/negative/008-wrong-adcp-use.json +0 -26
  561. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/negative/009-content-digest-mismatch.json +0 -26
  562. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/negative/010-malformed-signature-input.json +0 -26
  563. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/negative/011-signature-without-input.json +0 -25
  564. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/negative/012-missing-expires-param.json +0 -26
  565. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/negative/013-expires-le-created.json +0 -26
  566. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/negative/014-missing-nonce-param.json +0 -26
  567. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/negative/015-signature-invalid.json +0 -26
  568. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/negative/016-replayed-nonce.json +0 -37
  569. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/negative/017-key-revoked.json +0 -32
  570. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/negative/018-rate-abuse.json +0 -33
  571. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/negative/019-revocation-stale.json +0 -32
  572. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/negative/020-key-ops-missing-verify.json +0 -41
  573. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/negative/021-base64-alphabet-mixing.json +0 -26
  574. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/positive/001-basic-post.json +0 -24
  575. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/positive/002-es256-post.json +0 -24
  576. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/positive/003-multiple-signature-labels.json +0 -24
  577. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/positive/004-default-port-stripped.json +0 -24
  578. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/positive/005-percent-encoded-path.json +0 -24
  579. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/positive/006-query-byte-preserved.json +0 -24
  580. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/positive/007-body-without-idempotency-key.json +0 -25
  581. package/compliance/cache/3.1.0-beta.7/universal/billing-gate-dispatch.yaml +0 -450
  582. package/compliance/cache/3.1.0-beta.7/universal/canonical-format-validate-input.yaml +0 -640
  583. package/compliance/cache/3.1.0-beta.7/universal/capability-discovery.yaml +0 -125
  584. package/compliance/cache/3.1.0-beta.7/universal/collection-lists-pagination-integrity.yaml +0 -306
  585. package/compliance/cache/3.1.0-beta.7/universal/comply-controller-mode-gate.yaml +0 -141
  586. package/compliance/cache/3.1.0-beta.7/universal/content-standards-pagination-integrity.yaml +0 -326
  587. package/compliance/cache/3.1.0-beta.7/universal/deterministic-testing.yaml +0 -1430
  588. package/compliance/cache/3.1.0-beta.7/universal/error-compliance-signals.yaml +0 -377
  589. package/compliance/cache/3.1.0-beta.7/universal/error-compliance.yaml +0 -528
  590. package/compliance/cache/3.1.0-beta.7/universal/fictional-entities.yaml +0 -307
  591. package/compliance/cache/3.1.0-beta.7/universal/get-media-buys-pagination-integrity.yaml +0 -160
  592. package/compliance/cache/3.1.0-beta.7/universal/get-signals-pagination-integrity.yaml +0 -211
  593. package/compliance/cache/3.1.0-beta.7/universal/idempotency.yaml +0 -861
  594. package/compliance/cache/3.1.0-beta.7/universal/notification-config-event-scope.yaml +0 -119
  595. package/compliance/cache/3.1.0-beta.7/universal/notification-config-lifecycle.yaml +0 -337
  596. package/compliance/cache/3.1.0-beta.7/universal/notification-config-rejections.yaml +0 -107
  597. package/compliance/cache/3.1.0-beta.7/universal/pagination-integrity-creative-formats.yaml +0 -265
  598. package/compliance/cache/3.1.0-beta.7/universal/pagination-integrity-list-accounts.yaml +0 -245
  599. package/compliance/cache/3.1.0-beta.7/universal/pagination-integrity.yaml +0 -263
  600. package/compliance/cache/3.1.0-beta.7/universal/property-lists-pagination-integrity.yaml +0 -307
  601. package/compliance/cache/3.1.0-beta.7/universal/read-tool-idempotency.yaml +0 -405
  602. package/compliance/cache/3.1.0-beta.7/universal/runner-output-contract.yaml +0 -1266
  603. package/compliance/cache/3.1.0-beta.7/universal/schema-validation-signals.yaml +0 -181
  604. package/compliance/cache/3.1.0-beta.7/universal/schema-validation.yaml +0 -548
  605. package/compliance/cache/3.1.0-beta.7/universal/security.yaml +0 -539
  606. package/compliance/cache/3.1.0-beta.7/universal/signed-requests.yaml +0 -217
  607. package/compliance/cache/3.1.0-beta.7/universal/stale-response-advisory.yaml +0 -295
  608. package/compliance/cache/3.1.0-beta.7/universal/storyboard-schema.yaml +0 -2136
  609. package/compliance/cache/3.1.0-beta.7/universal/v3-envelope-integrity.yaml +0 -117
  610. package/compliance/cache/3.1.0-beta.7/universal/version-negotiation.yaml +0 -130
  611. package/compliance/cache/3.1.0-beta.7/universal/webhook-emission.yaml +0 -411
  612. package/compliance/cache/3.1.0-beta.7/universal/wholesale-feed-bulk-webhooks.yaml +0 -82
  613. package/compliance/cache/3.1.0-beta.7/universal/wholesale-feed-product-webhooks.yaml +0 -83
  614. package/compliance/cache/3.1.0-beta.7/universal/wholesale-feed-products.yaml +0 -151
  615. package/compliance/cache/3.1.0-beta.7/universal/wholesale-feed-signal-webhooks.yaml +0 -83
  616. package/compliance/cache/3.1.0-beta.7/universal/wholesale-feed-signals.yaml +0 -149
  617. package/dist/lib/types/v3-1-beta/index.d.mts +0 -1
  618. package/dist/lib/types/v3-1-beta/index.d.ts +0 -1
  619. package/dist/lib/types/v3-1-beta/index.mjs +0 -1
  620. package/dist/lib/types/v3-1-beta/tools.generated.d.mts +0 -26788
  621. package/dist/lib/types/v3-1-beta/tools.generated.d.ts +0 -26788
  622. /package/dist/lib/{types/v3-1-beta/tools.generated.mjs → media-buy/action-types.mjs} +0 -0
@@ -0,0 +1,128 @@
1
+ "use strict";
2
+ var __defProp = Object.defineProperty;
3
+ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
4
+ var __getOwnPropNames = Object.getOwnPropertyNames;
5
+ var __hasOwnProp = Object.prototype.hasOwnProperty;
6
+ var __export = (target, all) => {
7
+ for (var name in all)
8
+ __defProp(target, name, { get: all[name], enumerable: true });
9
+ };
10
+ var __copyProps = (to, from, except, desc) => {
11
+ if (from && typeof from === "object" || typeof from === "function") {
12
+ for (let key of __getOwnPropNames(from))
13
+ if (!__hasOwnProp.call(to, key) && key !== except)
14
+ __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
15
+ }
16
+ return to;
17
+ };
18
+ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
19
+ var action_metadata_generated_exports = {};
20
+ __export(action_metadata_generated_exports, {
21
+ CANONICAL_ACTION_TASKS: () => CANONICAL_ACTION_TASKS,
22
+ CHANGE_CONSTRAINT_ACTIONS: () => CHANGE_CONSTRAINT_ACTIONS,
23
+ CHANGE_TERM_ACTIONS: () => CHANGE_TERM_ACTIONS,
24
+ LEGACY_AVAILABLE_ACTIONS: () => LEGACY_AVAILABLE_ACTIONS
25
+ });
26
+ module.exports = __toCommonJS(action_metadata_generated_exports);
27
+ const CANONICAL_ACTION_TASKS = {
28
+ pause: ["control_media_buy"],
29
+ resume: ["control_media_buy"],
30
+ cancel: ["control_media_buy", "refine_proposals"],
31
+ update_name: ["control_media_buy"],
32
+ increase_budget: ["control_media_buy", "refine_proposals"],
33
+ decrease_budget: ["control_media_buy", "refine_proposals"],
34
+ reallocate_budget: ["control_media_buy", "refine_proposals"],
35
+ update_budget_allocation: ["control_media_buy", "refine_proposals"],
36
+ update_targeting: ["control_media_buy", "refine_proposals"],
37
+ update_pacing: ["control_media_buy", "refine_proposals"],
38
+ update_bidding: ["control_media_buy", "refine_proposals"],
39
+ update_frequency_caps: ["control_media_buy", "refine_proposals"],
40
+ update_media_buy_frequency_cap: ["control_media_buy", "refine_proposals"],
41
+ update_catalog_assignments: ["control_media_buy"],
42
+ update_keywords: ["control_media_buy"],
43
+ update_optimization_goals: ["control_media_buy"],
44
+ update_impression_goal: ["control_media_buy"],
45
+ update_spend_target: ["control_media_buy"],
46
+ update_reporting_webhook: ["control_media_buy"],
47
+ remove_packages: ["control_media_buy", "refine_proposals"],
48
+ extend_flight: ["refine_proposals"],
49
+ shorten_flight: ["refine_proposals"],
50
+ update_flight_dates: ["refine_proposals"],
51
+ add_packages: ["refine_proposals"],
52
+ replace_creative: ["sync_creatives"],
53
+ update_creative_assignments: ["sync_creatives"],
54
+ remove_creative: ["sync_creatives"]
55
+ };
56
+ const CHANGE_CONSTRAINT_ACTIONS = {
57
+ budget: [
58
+ "increase_budget",
59
+ "decrease_budget",
60
+ "reallocate_budget",
61
+ "update_budget_allocation",
62
+ "update_spend_target"
63
+ ],
64
+ flight: ["extend_flight", "shorten_flight", "update_flight_dates"],
65
+ package_count: ["add_packages", "remove_packages"],
66
+ effective_timing: ["pause", "resume", "cancel"]
67
+ };
68
+ const LEGACY_AVAILABLE_ACTIONS = [
69
+ "pause",
70
+ "resume",
71
+ "cancel",
72
+ "update_name",
73
+ "extend_flight",
74
+ "shorten_flight",
75
+ "update_flight_dates",
76
+ "increase_budget",
77
+ "decrease_budget",
78
+ "reallocate_budget",
79
+ "update_budget_allocation",
80
+ "update_targeting",
81
+ "update_pacing",
82
+ "update_bidding",
83
+ "update_frequency_caps",
84
+ "replace_creative",
85
+ "update_creative_assignments",
86
+ "remove_creative",
87
+ "add_packages",
88
+ "remove_packages",
89
+ "update_budget",
90
+ "update_dates",
91
+ "update_packages",
92
+ "sync_creatives"
93
+ ];
94
+ const CHANGE_TERM_ACTIONS = [
95
+ "pause",
96
+ "resume",
97
+ "cancel",
98
+ "extend_flight",
99
+ "shorten_flight",
100
+ "update_flight_dates",
101
+ "increase_budget",
102
+ "decrease_budget",
103
+ "reallocate_budget",
104
+ "update_budget_allocation",
105
+ "update_targeting",
106
+ "update_pacing",
107
+ "update_bidding",
108
+ "update_frequency_caps",
109
+ "update_media_buy_frequency_cap",
110
+ "update_catalog_assignments",
111
+ "update_keywords",
112
+ "update_optimization_goals",
113
+ "update_impression_goal",
114
+ "update_spend_target",
115
+ "update_reporting_webhook",
116
+ "replace_creative",
117
+ "update_creative_assignments",
118
+ "remove_creative",
119
+ "add_packages",
120
+ "remove_packages"
121
+ ];
122
+ // Annotate the CommonJS export names for ESM import in node:
123
+ 0 && (module.exports = {
124
+ CANONICAL_ACTION_TASKS,
125
+ CHANGE_CONSTRAINT_ACTIONS,
126
+ CHANGE_TERM_ACTIONS,
127
+ LEGACY_AVAILABLE_ACTIONS
128
+ });
@@ -0,0 +1,101 @@
1
+ const CANONICAL_ACTION_TASKS = {
2
+ pause: ["control_media_buy"],
3
+ resume: ["control_media_buy"],
4
+ cancel: ["control_media_buy", "refine_proposals"],
5
+ update_name: ["control_media_buy"],
6
+ increase_budget: ["control_media_buy", "refine_proposals"],
7
+ decrease_budget: ["control_media_buy", "refine_proposals"],
8
+ reallocate_budget: ["control_media_buy", "refine_proposals"],
9
+ update_budget_allocation: ["control_media_buy", "refine_proposals"],
10
+ update_targeting: ["control_media_buy", "refine_proposals"],
11
+ update_pacing: ["control_media_buy", "refine_proposals"],
12
+ update_bidding: ["control_media_buy", "refine_proposals"],
13
+ update_frequency_caps: ["control_media_buy", "refine_proposals"],
14
+ update_media_buy_frequency_cap: ["control_media_buy", "refine_proposals"],
15
+ update_catalog_assignments: ["control_media_buy"],
16
+ update_keywords: ["control_media_buy"],
17
+ update_optimization_goals: ["control_media_buy"],
18
+ update_impression_goal: ["control_media_buy"],
19
+ update_spend_target: ["control_media_buy"],
20
+ update_reporting_webhook: ["control_media_buy"],
21
+ remove_packages: ["control_media_buy", "refine_proposals"],
22
+ extend_flight: ["refine_proposals"],
23
+ shorten_flight: ["refine_proposals"],
24
+ update_flight_dates: ["refine_proposals"],
25
+ add_packages: ["refine_proposals"],
26
+ replace_creative: ["sync_creatives"],
27
+ update_creative_assignments: ["sync_creatives"],
28
+ remove_creative: ["sync_creatives"]
29
+ };
30
+ const CHANGE_CONSTRAINT_ACTIONS = {
31
+ budget: [
32
+ "increase_budget",
33
+ "decrease_budget",
34
+ "reallocate_budget",
35
+ "update_budget_allocation",
36
+ "update_spend_target"
37
+ ],
38
+ flight: ["extend_flight", "shorten_flight", "update_flight_dates"],
39
+ package_count: ["add_packages", "remove_packages"],
40
+ effective_timing: ["pause", "resume", "cancel"]
41
+ };
42
+ const LEGACY_AVAILABLE_ACTIONS = [
43
+ "pause",
44
+ "resume",
45
+ "cancel",
46
+ "update_name",
47
+ "extend_flight",
48
+ "shorten_flight",
49
+ "update_flight_dates",
50
+ "increase_budget",
51
+ "decrease_budget",
52
+ "reallocate_budget",
53
+ "update_budget_allocation",
54
+ "update_targeting",
55
+ "update_pacing",
56
+ "update_bidding",
57
+ "update_frequency_caps",
58
+ "replace_creative",
59
+ "update_creative_assignments",
60
+ "remove_creative",
61
+ "add_packages",
62
+ "remove_packages",
63
+ "update_budget",
64
+ "update_dates",
65
+ "update_packages",
66
+ "sync_creatives"
67
+ ];
68
+ const CHANGE_TERM_ACTIONS = [
69
+ "pause",
70
+ "resume",
71
+ "cancel",
72
+ "extend_flight",
73
+ "shorten_flight",
74
+ "update_flight_dates",
75
+ "increase_budget",
76
+ "decrease_budget",
77
+ "reallocate_budget",
78
+ "update_budget_allocation",
79
+ "update_targeting",
80
+ "update_pacing",
81
+ "update_bidding",
82
+ "update_frequency_caps",
83
+ "update_media_buy_frequency_cap",
84
+ "update_catalog_assignments",
85
+ "update_keywords",
86
+ "update_optimization_goals",
87
+ "update_impression_goal",
88
+ "update_spend_target",
89
+ "update_reporting_webhook",
90
+ "replace_creative",
91
+ "update_creative_assignments",
92
+ "remove_creative",
93
+ "add_packages",
94
+ "remove_packages"
95
+ ];
96
+ export {
97
+ CANONICAL_ACTION_TASKS,
98
+ CHANGE_CONSTRAINT_ACTIONS,
99
+ CHANGE_TERM_ACTIONS,
100
+ LEGACY_AVAILABLE_ACTIONS
101
+ };
@@ -0,0 +1,106 @@
1
+ import type { CanonicalProductAction, MediaBuyChangeTerm, MediaBuyStatus } from '../types/core.generated.mjs';
2
+ import type { MediaBuyActionContext, MediaBuyActionId, MediaBuyActionMode, SLAWindow } from './types.mjs';
3
+ /** Explicit task vocabulary; update_media_buy is the established 3.1 default. */
4
+ export type MediaBuyTask = 'update_media_buy' | 'control_media_buy' | 'refine_proposals' | 'sync_creatives';
5
+ /** Alias of the shared, schema-derived action vocabulary. */
6
+ export type MediaBuyAction = MediaBuyActionId;
7
+ export type ProductActionTemplate = Pick<CanonicalProductAction, 'modes' | 'allowed_statuses' | 'sla' | 'constraints' | 'terms_ref'> & {
8
+ action: MediaBuyAction;
9
+ };
10
+ export type ProposalChangeTerm = Pick<MediaBuyChangeTerm, 'term_id' | 'service_mode' | 'allowed_statuses' | 'processing_sla' | 'conditions' | 'constraints' | 'terms_ref' | 'description' | 'ext'> & {
11
+ action: MediaBuyAction;
12
+ };
13
+ /** Portable ergonomic view of the schema's anyOf constraint variants. */
14
+ export type ChangeTermConstraints = {
15
+ kind: 'budget';
16
+ max_delta_amount?: ChangeMoney;
17
+ max_delta_percent?: number;
18
+ min_result_amount?: ChangeMoney;
19
+ max_result_amount?: ChangeMoney;
20
+ } | {
21
+ kind: 'flight';
22
+ max_change?: ChangeDuration;
23
+ earliest_result?: string;
24
+ latest_result?: string;
25
+ minimum_notice?: ChangeDuration;
26
+ } | {
27
+ kind: 'package_count';
28
+ max_additions?: number;
29
+ max_removals?: number;
30
+ max_result_count?: number;
31
+ } | {
32
+ kind: 'effective_timing';
33
+ minimum_notice?: ChangeDuration;
34
+ earliest_effective_at?: string;
35
+ latest_effective_at?: string;
36
+ };
37
+ export interface ChangeMoney {
38
+ amount: number;
39
+ currency: string;
40
+ }
41
+ export interface ChangeDuration {
42
+ interval: number;
43
+ unit: 'seconds' | 'minutes' | 'hours' | 'days' | 'campaign';
44
+ }
45
+ export type { MediaBuyStatus };
46
+ /** A readable wire entry, including the established 3.1 shape without task. */
47
+ export interface LiveMediaBuyAction {
48
+ /** Readable wire IDs may be unknown to this SDK; runtime assessment validates them. */
49
+ action: string;
50
+ mode: MediaBuyActionMode;
51
+ task?: MediaBuyTask;
52
+ sla?: SLAWindow;
53
+ /** rc.3 exact package scope. Omission means all relevant packages. */
54
+ applicable_package_ids?: readonly string[];
55
+ change_term_id?: string;
56
+ /** Opaque in 3.1. Equality is checked only with an explicitly declared 3.2 alias projection. */
57
+ terms_ref?: string;
58
+ }
59
+ export interface ActionProduct {
60
+ product_id?: string;
61
+ allowed_actions?: readonly ProductActionTemplate[];
62
+ }
63
+ export interface ActionProposal {
64
+ proposal_id?: string;
65
+ proposal_status?: string;
66
+ media_buy_id?: string;
67
+ commercial_terms?: {
68
+ change_terms?: readonly ProposalChangeTerm[];
69
+ };
70
+ }
71
+ /** Same current snapshot accepted by the existing preflight helpers. */
72
+ export type ActionBuy = MediaBuyActionContext;
73
+ export type ConstraintAssessment = {
74
+ status: 'satisfied';
75
+ } | {
76
+ status: 'unknown';
77
+ constraint: string;
78
+ path: string;
79
+ message: string;
80
+ } | {
81
+ status: 'exceeded';
82
+ constraint: string;
83
+ path: string;
84
+ message: string;
85
+ };
86
+ export type ProductActionAssessment = {
87
+ status: 'possible';
88
+ template: ProductActionTemplate;
89
+ binding: false;
90
+ } | {
91
+ status: 'unsupported';
92
+ binding: false;
93
+ } | {
94
+ status: 'unknown';
95
+ binding: false;
96
+ message: string;
97
+ };
98
+ export type ProposalActionAssessment = {
99
+ status: 'promised';
100
+ term: ProposalChangeTerm;
101
+ } | {
102
+ status: 'not_negotiated';
103
+ } | {
104
+ status: 'unknown';
105
+ message: string;
106
+ };
@@ -0,0 +1,106 @@
1
+ import type { CanonicalProductAction, MediaBuyChangeTerm, MediaBuyStatus } from '../types/core.generated';
2
+ import type { MediaBuyActionContext, MediaBuyActionId, MediaBuyActionMode, SLAWindow } from './types';
3
+ /** Explicit task vocabulary; update_media_buy is the established 3.1 default. */
4
+ export type MediaBuyTask = 'update_media_buy' | 'control_media_buy' | 'refine_proposals' | 'sync_creatives';
5
+ /** Alias of the shared, schema-derived action vocabulary. */
6
+ export type MediaBuyAction = MediaBuyActionId;
7
+ export type ProductActionTemplate = Pick<CanonicalProductAction, 'modes' | 'allowed_statuses' | 'sla' | 'constraints' | 'terms_ref'> & {
8
+ action: MediaBuyAction;
9
+ };
10
+ export type ProposalChangeTerm = Pick<MediaBuyChangeTerm, 'term_id' | 'service_mode' | 'allowed_statuses' | 'processing_sla' | 'conditions' | 'constraints' | 'terms_ref' | 'description' | 'ext'> & {
11
+ action: MediaBuyAction;
12
+ };
13
+ /** Portable ergonomic view of the schema's anyOf constraint variants. */
14
+ export type ChangeTermConstraints = {
15
+ kind: 'budget';
16
+ max_delta_amount?: ChangeMoney;
17
+ max_delta_percent?: number;
18
+ min_result_amount?: ChangeMoney;
19
+ max_result_amount?: ChangeMoney;
20
+ } | {
21
+ kind: 'flight';
22
+ max_change?: ChangeDuration;
23
+ earliest_result?: string;
24
+ latest_result?: string;
25
+ minimum_notice?: ChangeDuration;
26
+ } | {
27
+ kind: 'package_count';
28
+ max_additions?: number;
29
+ max_removals?: number;
30
+ max_result_count?: number;
31
+ } | {
32
+ kind: 'effective_timing';
33
+ minimum_notice?: ChangeDuration;
34
+ earliest_effective_at?: string;
35
+ latest_effective_at?: string;
36
+ };
37
+ export interface ChangeMoney {
38
+ amount: number;
39
+ currency: string;
40
+ }
41
+ export interface ChangeDuration {
42
+ interval: number;
43
+ unit: 'seconds' | 'minutes' | 'hours' | 'days' | 'campaign';
44
+ }
45
+ export type { MediaBuyStatus };
46
+ /** A readable wire entry, including the established 3.1 shape without task. */
47
+ export interface LiveMediaBuyAction {
48
+ /** Readable wire IDs may be unknown to this SDK; runtime assessment validates them. */
49
+ action: string;
50
+ mode: MediaBuyActionMode;
51
+ task?: MediaBuyTask;
52
+ sla?: SLAWindow;
53
+ /** rc.3 exact package scope. Omission means all relevant packages. */
54
+ applicable_package_ids?: readonly string[];
55
+ change_term_id?: string;
56
+ /** Opaque in 3.1. Equality is checked only with an explicitly declared 3.2 alias projection. */
57
+ terms_ref?: string;
58
+ }
59
+ export interface ActionProduct {
60
+ product_id?: string;
61
+ allowed_actions?: readonly ProductActionTemplate[];
62
+ }
63
+ export interface ActionProposal {
64
+ proposal_id?: string;
65
+ proposal_status?: string;
66
+ media_buy_id?: string;
67
+ commercial_terms?: {
68
+ change_terms?: readonly ProposalChangeTerm[];
69
+ };
70
+ }
71
+ /** Same current snapshot accepted by the existing preflight helpers. */
72
+ export type ActionBuy = MediaBuyActionContext;
73
+ export type ConstraintAssessment = {
74
+ status: 'satisfied';
75
+ } | {
76
+ status: 'unknown';
77
+ constraint: string;
78
+ path: string;
79
+ message: string;
80
+ } | {
81
+ status: 'exceeded';
82
+ constraint: string;
83
+ path: string;
84
+ message: string;
85
+ };
86
+ export type ProductActionAssessment = {
87
+ status: 'possible';
88
+ template: ProductActionTemplate;
89
+ binding: false;
90
+ } | {
91
+ status: 'unsupported';
92
+ binding: false;
93
+ } | {
94
+ status: 'unknown';
95
+ binding: false;
96
+ message: string;
97
+ };
98
+ export type ProposalActionAssessment = {
99
+ status: 'promised';
100
+ term: ProposalChangeTerm;
101
+ } | {
102
+ status: 'not_negotiated';
103
+ } | {
104
+ status: 'unknown';
105
+ message: string;
106
+ };
@@ -12,5 +12,5 @@ var __copyProps = (to, from, except, desc) => {
12
12
  return to;
13
13
  };
14
14
  var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
15
- var tools_generated_exports = {};
16
- module.exports = __toCommonJS(tools_generated_exports);
15
+ var action_types_exports = {};
16
+ module.exports = __toCommonJS(action_types_exports);
@@ -0,0 +1,6 @@
1
+ /** Pure buyer action assessment entry point; safe for browser tree shaking. */
2
+ export * from './action-types.mjs';
3
+ export * from './action-assessment.mjs';
4
+ export { evaluateChangeTermConstraints } from './action-constraints.mjs';
5
+ export type { ConstraintEvaluationOptions } from './action-constraints.mjs';
6
+ export { mediaBuyActionTasks, defaultMediaBuyActionTask } from './action-contracts.mjs';
@@ -0,0 +1,6 @@
1
+ /** Pure buyer action assessment entry point; safe for browser tree shaking. */
2
+ export * from './action-types';
3
+ export * from './action-assessment';
4
+ export { evaluateChangeTermConstraints } from './action-constraints';
5
+ export type { ConstraintEvaluationOptions } from './action-constraints';
6
+ export { mediaBuyActionTasks, defaultMediaBuyActionTask } from './action-contracts';
@@ -0,0 +1,38 @@
1
+ "use strict";
2
+ var __defProp = Object.defineProperty;
3
+ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
4
+ var __getOwnPropNames = Object.getOwnPropertyNames;
5
+ var __hasOwnProp = Object.prototype.hasOwnProperty;
6
+ var __export = (target, all) => {
7
+ for (var name in all)
8
+ __defProp(target, name, { get: all[name], enumerable: true });
9
+ };
10
+ var __copyProps = (to, from, except, desc) => {
11
+ if (from && typeof from === "object" || typeof from === "function") {
12
+ for (let key of __getOwnPropNames(from))
13
+ if (!__hasOwnProp.call(to, key) && key !== except)
14
+ __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
15
+ }
16
+ return to;
17
+ };
18
+ var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
19
+ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
20
+ var actions_exports = {};
21
+ __export(actions_exports, {
22
+ defaultMediaBuyActionTask: () => import_action_contracts.defaultMediaBuyActionTask,
23
+ evaluateChangeTermConstraints: () => import_action_constraints.evaluateChangeTermConstraints,
24
+ mediaBuyActionTasks: () => import_action_contracts.mediaBuyActionTasks
25
+ });
26
+ module.exports = __toCommonJS(actions_exports);
27
+ __reExport(actions_exports, require('./action-types.js'), module.exports);
28
+ __reExport(actions_exports, require('./action-assessment.js'), module.exports);
29
+ var import_action_constraints = require('./action-constraints.js');
30
+ var import_action_contracts = require('./action-contracts.js');
31
+ // Annotate the CommonJS export names for ESM import in node:
32
+ 0 && (module.exports = {
33
+ defaultMediaBuyActionTask,
34
+ evaluateChangeTermConstraints,
35
+ mediaBuyActionTasks,
36
+ ...require('./action-types.js'),
37
+ ...require('./action-assessment.js')
38
+ });
@@ -0,0 +1,9 @@
1
+ export * from "./action-types.mjs";
2
+ export * from "./action-assessment.mjs";
3
+ import { evaluateChangeTermConstraints } from "./action-constraints.mjs";
4
+ import { mediaBuyActionTasks, defaultMediaBuyActionTask } from "./action-contracts.mjs";
5
+ export {
6
+ defaultMediaBuyActionTask,
7
+ evaluateChangeTermConstraints,
8
+ mediaBuyActionTasks
9
+ };
@@ -1,4 +1,5 @@
1
- import type { MediaBuyActionContext, MediaBuyActionId, MediaBuyAvailableAction, MediaBuyValidAction } from './types.mjs';
1
+ import type { LiveMediaBuyAction as MediaBuyAvailableAction } from './action-types.mjs';
2
+ import type { MediaBuyActionContext, MediaBuyActionId, MediaBuyValidAction } from './types.mjs';
2
3
  /**
3
4
  * Source the normalized `available_actions[]` came from. Callers branch on
4
5
  * this to decide whether to enforce mode constraints (`available_actions`)
@@ -1,4 +1,5 @@
1
- import type { MediaBuyActionContext, MediaBuyActionId, MediaBuyAvailableAction, MediaBuyValidAction } from './types';
1
+ import type { LiveMediaBuyAction as MediaBuyAvailableAction } from './action-types';
2
+ import type { MediaBuyActionContext, MediaBuyActionId, MediaBuyValidAction } from './types';
2
3
  /**
3
4
  * Source the normalized `available_actions[]` came from. Callers branch on
4
5
  * this to decide whether to enforce mode constraints (`available_actions`)
@@ -35,7 +35,7 @@ function __resetValidActionsWarningForTests() {
35
35
  warnedOnce = false;
36
36
  }
37
37
  function getAvailableActions(buy, options = {}) {
38
- if (buy.available_actions && buy.available_actions.length > 0) {
38
+ if (buy.available_actions !== void 0) {
39
39
  return { actions: [...buy.available_actions], source: "available_actions" };
40
40
  }
41
41
  if (buy.valid_actions && buy.valid_actions.length > 0) {
@@ -54,11 +54,12 @@ function getAvailableActions(buy, options = {}) {
54
54
  function findAvailableAction(buy, action, options = {}) {
55
55
  const result = getAvailableActions(buy, options);
56
56
  const direct = result.actions.find((a) => a.action === action);
57
- if (direct) return { entry: direct, result };
57
+ const knownMode = (entry) => ["self_serve", "conditional_self_serve", "seller_managed", "requires_approval"].includes(entry.mode);
58
+ if (direct) return knownMode(direct) ? { entry: direct, result } : void 0;
58
59
  const rollupParent = ROLLUP_PARENT_OF[action];
59
60
  if (rollupParent) {
60
61
  const parent = result.actions.find((a) => a.action === rollupParent);
61
- if (parent) return { entry: parent, result };
62
+ if (parent && knownMode(parent)) return { entry: parent, result };
62
63
  }
63
64
  return void 0;
64
65
  }
@@ -9,7 +9,7 @@ function __resetValidActionsWarningForTests() {
9
9
  warnedOnce = false;
10
10
  }
11
11
  function getAvailableActions(buy, options = {}) {
12
- if (buy.available_actions && buy.available_actions.length > 0) {
12
+ if (buy.available_actions !== void 0) {
13
13
  return { actions: [...buy.available_actions], source: "available_actions" };
14
14
  }
15
15
  if (buy.valid_actions && buy.valid_actions.length > 0) {
@@ -28,11 +28,12 @@ function getAvailableActions(buy, options = {}) {
28
28
  function findAvailableAction(buy, action, options = {}) {
29
29
  const result = getAvailableActions(buy, options);
30
30
  const direct = result.actions.find((a) => a.action === action);
31
- if (direct) return { entry: direct, result };
31
+ const knownMode = (entry) => ["self_serve", "conditional_self_serve", "seller_managed", "requires_approval"].includes(entry.mode);
32
+ if (direct) return knownMode(direct) ? { entry: direct, result } : void 0;
32
33
  const rollupParent = ROLLUP_PARENT_OF[action];
33
34
  if (rollupParent) {
34
35
  const parent = result.actions.find((a) => a.action === rollupParent);
35
- if (parent) return { entry: parent, result };
36
+ if (parent && knownMode(parent)) return { entry: parent, result };
36
37
  }
37
38
  return void 0;
38
39
  }
@@ -434,6 +434,9 @@ function snapshotCompatibilityTaskOptions(options) {
434
434
  ...options.metadata !== void 0 && { metadata: structuredClone(options.metadata) },
435
435
  ...options.delegatedOperatorAuthorization !== void 0 && {
436
436
  delegatedOperatorAuthorization: { ...options.delegatedOperatorAuthorization }
437
+ },
438
+ ...options.durableContinuationRecovery !== void 0 && {
439
+ durableContinuationRecovery: { ...options.durableContinuationRecovery }
437
440
  }
438
441
  };
439
442
  }
@@ -427,6 +427,9 @@ function snapshotCompatibilityTaskOptions(options) {
427
427
  ...options.metadata !== void 0 && { metadata: structuredClone(options.metadata) },
428
428
  ...options.delegatedOperatorAuthorization !== void 0 && {
429
429
  delegatedOperatorAuthorization: { ...options.delegatedOperatorAuthorization }
430
+ },
431
+ ...options.durableContinuationRecovery !== void 0 && {
432
+ durableContinuationRecovery: { ...options.durableContinuationRecovery }
430
433
  }
431
434
  };
432
435
  }
@@ -1,5 +1,7 @@
1
1
  export type { ActionNotAllowedDetails, ActionNotAllowedReason, LegacyCoarseAction, MediaBuyActionContext, MediaBuyActionId, MediaBuyActionMode, MediaBuyAvailableAction, MediaBuyValidAction, SLAWindow, SlaWindow, UpdateMediaBuyRequestLike, } from './types.mjs';
2
2
  export { LEGACY_COARSE_ACTIONS } from './types.mjs';
3
+ /** Readable result of getAvailableActions; MediaBuyAvailableAction remains the narrower legacy wire type. */
4
+ export type { LiveMediaBuyAction } from './action-types.mjs';
3
5
  export type { AvailableActionsResult, AvailableActionsSource } from './available-actions.mjs';
4
6
  export { findAvailableAction, getAvailableActions, getRollupParent, __resetValidActionsWarningForTests, } from './available-actions.mjs';
5
7
  export type { BuyerPropertyPolicy, NormalizedPolicyDomain, ProductPolicyProductLike, ProductPropertyPolicyDiagnostic, ProductPropertyPolicyDiagnosticCode, ProductPropertyPolicyDiagnosticSeverity, ProductPropertyPolicyMode, ProductPropertyPolicySelectorBehavior, ProductPropertyPolicyValidationResult, ValidateProductsAgainstPropertyPolicyOptions, } from './property-policy.mjs';
@@ -7,9 +9,11 @@ export { ProductPropertyPolicyError, normalizeDomainForPropertyPolicy, validateP
7
9
  export type { DecomposedUpdateMediaBuy, DecomposedUpdateMediaBuyMutation, MediaBuyMutationDirection, MediaBuyMutationScope, ModeMismatchRecovery, PreflightAllowed, PreflightDenial, PreflightDenied, PreflightResult, ResolvedAction, } from './preflight.mjs';
8
10
  export { canAddPackages, canCancel, canDecreaseBudget, canExtendFlight, canIncreaseBudget, canPause, canReallocateBudget, canRemoveCreative, canRemovePackages, canReplaceCreative, canResume, canShortenFlight, canUpdateCreativeAssignments, canUpdateFlightDates, canUpdateFrequencyCaps, canUpdatePacing, canUpdateTargeting, decomposeUpdateMediaBuy, getActionForMutation, preflightUpdateMediaBuy, recoveryForModeMismatch, } from './preflight.mjs';
9
11
  export type { MediaBuyUpdateFieldAction, StructuredOnlyMediaBuyAction, UpdateFieldEntry, } from './update-fields.generated.mjs';
12
+ /** Legacy coarse update-field metadata. Use decomposeUpdateMediaBuy for current accepted-term action mapping. */
10
13
  export { ACTIONS_BY_FIELD, STRUCTURED_ONLY_MEDIA_BUY_ACTIONS, UPDATE_FIELDS_BY_ACTION, } from './update-fields.generated.mjs';
11
14
  export { applyTargetingInput, hasTargetingClears, resolveTargetingInput } from './targeting-input.mjs';
12
15
  export type { ResolvedTargetingInput, TargetingInputFor } from './targeting-input.mjs';
13
16
  export * from './compatibility.mjs';
14
17
  export * from './established-proposal-store.mjs';
15
18
  export * from './legacy-purchase-continuation.mjs';
19
+ export * from './actions.mjs';
@@ -1,5 +1,7 @@
1
1
  export type { ActionNotAllowedDetails, ActionNotAllowedReason, LegacyCoarseAction, MediaBuyActionContext, MediaBuyActionId, MediaBuyActionMode, MediaBuyAvailableAction, MediaBuyValidAction, SLAWindow, SlaWindow, UpdateMediaBuyRequestLike, } from './types';
2
2
  export { LEGACY_COARSE_ACTIONS } from './types';
3
+ /** Readable result of getAvailableActions; MediaBuyAvailableAction remains the narrower legacy wire type. */
4
+ export type { LiveMediaBuyAction } from './action-types';
3
5
  export type { AvailableActionsResult, AvailableActionsSource } from './available-actions';
4
6
  export { findAvailableAction, getAvailableActions, getRollupParent, __resetValidActionsWarningForTests, } from './available-actions';
5
7
  export type { BuyerPropertyPolicy, NormalizedPolicyDomain, ProductPolicyProductLike, ProductPropertyPolicyDiagnostic, ProductPropertyPolicyDiagnosticCode, ProductPropertyPolicyDiagnosticSeverity, ProductPropertyPolicyMode, ProductPropertyPolicySelectorBehavior, ProductPropertyPolicyValidationResult, ValidateProductsAgainstPropertyPolicyOptions, } from './property-policy';
@@ -7,9 +9,11 @@ export { ProductPropertyPolicyError, normalizeDomainForPropertyPolicy, validateP
7
9
  export type { DecomposedUpdateMediaBuy, DecomposedUpdateMediaBuyMutation, MediaBuyMutationDirection, MediaBuyMutationScope, ModeMismatchRecovery, PreflightAllowed, PreflightDenial, PreflightDenied, PreflightResult, ResolvedAction, } from './preflight';
8
10
  export { canAddPackages, canCancel, canDecreaseBudget, canExtendFlight, canIncreaseBudget, canPause, canReallocateBudget, canRemoveCreative, canRemovePackages, canReplaceCreative, canResume, canShortenFlight, canUpdateCreativeAssignments, canUpdateFlightDates, canUpdateFrequencyCaps, canUpdatePacing, canUpdateTargeting, decomposeUpdateMediaBuy, getActionForMutation, preflightUpdateMediaBuy, recoveryForModeMismatch, } from './preflight';
9
11
  export type { MediaBuyUpdateFieldAction, StructuredOnlyMediaBuyAction, UpdateFieldEntry, } from './update-fields.generated';
12
+ /** Legacy coarse update-field metadata. Use decomposeUpdateMediaBuy for current accepted-term action mapping. */
10
13
  export { ACTIONS_BY_FIELD, STRUCTURED_ONLY_MEDIA_BUY_ACTIONS, UPDATE_FIELDS_BY_ACTION, } from './update-fields.generated';
11
14
  export { applyTargetingInput, hasTargetingClears, resolveTargetingInput } from './targeting-input';
12
15
  export type { ResolvedTargetingInput, TargetingInputFor } from './targeting-input';
13
16
  export * from './compatibility';
14
17
  export * from './established-proposal-store';
15
18
  export * from './legacy-purchase-continuation';
19
+ export * from './actions';
@@ -65,6 +65,7 @@ var import_targeting_input = require('./targeting-input.js');
65
65
  __reExport(media_buy_exports, require('./compatibility.js'), module.exports);
66
66
  __reExport(media_buy_exports, require('./established-proposal-store.js'), module.exports);
67
67
  __reExport(media_buy_exports, require('./legacy-purchase-continuation.js'), module.exports);
68
+ __reExport(media_buy_exports, require('./actions.js'), module.exports);
68
69
  // Annotate the CommonJS export names for ESM import in node:
69
70
  0 && (module.exports = {
70
71
  ACTIONS_BY_FIELD,
@@ -104,5 +105,6 @@ __reExport(media_buy_exports, require('./legacy-purchase-continuation.js'), modu
104
105
  validateProductsAgainstPropertyPolicy,
105
106
  ...require('./compatibility.js'),
106
107
  ...require('./established-proposal-store.js'),
107
- ...require('./legacy-purchase-continuation.js')
108
+ ...require('./legacy-purchase-continuation.js'),
109
+ ...require('./actions.js')
108
110
  });