@adcp/sdk 12.1.0 → 13.0.0-rc.0

package/dist/lib/server/decisioning/proposal/dispatch.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../src/lib/server/decisioning/proposal/dispatch.ts"],"sourcesContent":["/**\n * Proposal-dispatch — the v1.5 framework intercept seams.\n *\n * Pure functions that the runtime calls from the wire-handler shims\n * (`getProducts`, `createMediaBuy`, `updateMediaBuy`,\n * `getMediaBuyDelivery`). Each helper short-circuits when no manager /\n * store is wired for the request, so the v1 path is preserved\n * byte-for-byte.\n *\n * Five integration points (parity with `adcp-client-python.src/adcp/decisioning/proposal_dispatch.py`):\n *\n *   - {@link maybeInterceptFinalize} — `getProducts` shim. Detects\n *     `refine[i].action: 'finalize'`, calls the manager's\n *     `finalizeProposal`, commits the proposal, returns the wire\n *     response. Returns `null` when no finalize entry / no\n *     finalize-capable manager.\n *   - {@link maybePersistDraftAfterGetProducts} — `getProducts` shim\n *     (post-call). Walks the response's `proposals[]`, validates\n *     `overlap ⊆ wire`, persists each as a draft.\n *   - {@link maybeReserveProposalForCreateMediaBuy} — `createMediaBuy`\n *     shim. When `proposal_id` is set, validates expiry + capability\n *     overlap, reserves the proposal (`COMMITTED → CONSUMING`), returns\n *     the recipes map for `ctx.recipes` hydration.\n *   - {@link finalizeProposalConsumption} — `createMediaBuy` shim\n *     (post-success). Promotes `CONSUMING → CONSUMED` and records the\n *     `mediaBuyId` back-reference.\n *   - {@link releaseProposalReservation} — `createMediaBuy` shim\n *     (failure rollback). Restores `CONSUMING → COMMITTED`.\n *   - {@link maybeHydrateRecipesForMediaBuyId} —\n *     `updateMediaBuy` / `getMediaBuyDelivery` shims. Reverse-index\n *     hydration via `getByMediaBuyId`. Re-runs capability-overlap\n *     validation per Resolutions §5.\n *\n * @public\n * @packageDocumentation\n */\n\nimport { AdcpError, isTaskHandoff, type TaskHandoff } from '../async-outcome';\nimport type { GetProductsRequest, Product, Proposal } from '../../../types/tools.generated';\nimport {\n  detectFinalizeAction,\n  enforceProposalExpiry,\n  logConsumed,\n  logDraftPersisted,\n  logFinalizeSucceeded,\n  validateCapabilityOverlap,\n  validateOverlapSubsetOfWire,\n} from './lifecycle';\nimport type { ProposalRecord, ProposalStore } from './store';\nimport type {\n  FinalizeProposalRequest,\n  FinalizeProposalSuccess,\n  ProposalGetProductsPayload,\n  ProposalManager,\n  Recipe,\n} from './types';\n\n// ---------------------------------------------------------------------------\n// Capability detection\n// ---------------------------------------------------------------------------\n\n/**\n * Per Resolutions §7: framework detects finalize via method-presence +\n * `capabilities.finalize` flag. Adopters opt in by both implementing\n * AND declaring; flipping only one half is an adopter bug.\n */\nfunction hasFinalizeCapability<TRecipe extends Recipe, TCtxMeta>(\n  manager: ProposalManager<TRecipe, TCtxMeta> | undefined\n): boolean {\n  if (!manager) return false;\n  if (!manager.capabilities.finalize) return false;\n  return typeof manager.finalizeProposal === 'function';\n}\n\n// ---------------------------------------------------------------------------\n// getProducts — finalize interception\n// ---------------------------------------------------------------------------\n\n/**\n * Result of {@link maybeInterceptFinalize}.\n *\n *   - `kind: 'intercepted'` — adopter's `finalizeProposal` was called.\n *     Caller threads `result` and `project` through the framework's\n *     standard `routeIfHandoff` so the projection callback fires\n *     synchronously for sync `FinalizeProposalSuccess` returns AND\n *     inside the background task for `TaskHandoff<FinalizeProposalSuccess>`\n *     returns. The projection commits the proposal store, emits the\n *     `proposal.finalized` log, and shapes the wire response.\n *   - `kind: 'pass'` — no finalize entry / no finalize-capable manager;\n *     caller continues with the standard `getProducts` dispatch.\n *\n * No special-case handling: finalize HITL inherits the framework's\n * task-lifecycle posture (cancellation, restart-via-durable-store,\n * deadline, webhook delivery) from `routeIfHandoff`, the same machinery\n * that drives `createMediaBuy` HITL and `syncCreatives` HITL.\n *\n * @public\n */\nexport type FinalizeInterceptResult<TRecipe extends Recipe = Recipe> =\n  | {\n      kind: 'intercepted';\n      result: FinalizeProposalSuccess<TRecipe> | TaskHandoff<FinalizeProposalSuccess<TRecipe>>;\n      project: (success: FinalizeProposalSuccess<TRecipe>) => Promise<ProposalGetProductsPayload>;\n    }\n  | { kind: 'pass' };\n\n/**\n * Intercept `buying_mode: 'refine'` requests carrying a\n * `refine[i].action: 'finalize'` entry. Hydrates the draft, calls the\n * manager's `finalizeProposal`, and returns the raw adopter result + a\n * projection callback. The runtime threads them through the framework's\n * standard `routeIfHandoff` so:\n *\n *   - Sync `FinalizeProposalSuccess` returns: projection runs inline,\n *     buyer sees the committed proposal in the response.\n *   - HITL `TaskHandoff<FinalizeProposalSuccess>` returns: framework\n *     returns the Submitted envelope to the buyer, runs the adopter's\n *     handoff fn in background; projection runs when the handoff\n *     resolves, commits the proposal, projects the terminal task\n *     artifact.\n *\n * Same machinery as `createMediaBuy` HITL — finalize inherits whatever\n * cancellation, restart-via-durable-store, deadline, and webhook\n * delivery semantics the framework's task lifecycle provides for every\n * other unified-hybrid tool. No special-case wrapper.\n *\n * @public\n */\nexport async function maybeInterceptFinalize<TRecipe extends Recipe, TCtxMeta>(args: {\n  request: GetProductsRequest;\n  manager: ProposalManager<TRecipe, TCtxMeta> | undefined;\n  store: ProposalStore<TRecipe> | undefined;\n  ctx: { account: { id: string } } & Record<string, unknown>;\n}): Promise<FinalizeInterceptResult<TRecipe>> {\n  const { request, manager, store, ctx } = args;\n  const finalizeEntry = detectFinalizeAction(request);\n  if (!finalizeEntry) return { kind: 'pass' };\n  if (!hasFinalizeCapability(manager) || !store) return { kind: 'pass' };\n\n  const fieldPath = `refine[${finalizeEntry.index}].proposal_id`;\n  const accountId = ctx.account.id;\n  const record = await store.get(finalizeEntry.proposalId, { expectedAccountId: accountId });\n  if (!record) {\n    throw new AdcpError('PROPOSAL_NOT_FOUND', {\n      recovery: 'correctable',\n      message:\n        `Proposal ${JSON.stringify(finalizeEntry.proposalId)} not found. The buyer must call ` +\n        `get_products with buying_mode='brief' or 'refine' to obtain a draft proposal_id ` +\n        `before finalizing it.`,\n      field: fieldPath,\n    });\n  }\n  if (record.state !== 'draft') {\n    throw new AdcpError('PROPOSAL_NOT_COMMITTED', {\n      recovery: 'correctable',\n      message:\n        `Proposal ${JSON.stringify(finalizeEntry.proposalId)} is in state ` +\n        `${JSON.stringify(record.state)}; only draft proposals can be finalized. ` +\n        `Already-committed proposals should be accepted via create_media_buy(proposal_id=...) ` +\n        `directly.`,\n      field: fieldPath,\n    });\n  }\n\n  const finalizeReq: FinalizeProposalRequest<TRecipe> = {\n    proposalId: finalizeEntry.proposalId,\n    recipes: record.recipes,\n    proposalPayload: record.proposalPayload,\n    parentRequest: request,\n    ...(finalizeEntry.ask !== undefined && { ask: finalizeEntry.ask }),\n  };\n\n  // manager + finalizeProposal are non-undefined per hasFinalizeCapability.\n  const result = await manager!.finalizeProposal!(finalizeReq, ctx as never);\n  // Pre-determine the path label by checking whether the adopter\n  // returned a TaskHandoff up-front. `routeIfHandoff` runs `project`\n  // synchronously for the sync arm and inside the background task for\n  // the handoff arm; either way, we want the log to reflect which arm\n  // the adopter chose.\n  const path: 'inline' | 'handoff' = isTaskHandoff(result) ? 'handoff' : 'inline';\n  const finalizeProposalId = finalizeEntry.proposalId;\n\n  const project = async (success: FinalizeProposalSuccess<TRecipe>): Promise<ProposalGetProductsPayload> => {\n    if (!isFinalizeSuccess<TRecipe>(success)) {\n      throw new AdcpError('INTERNAL_ERROR', {\n        recovery: 'terminal',\n        message:\n          `finalizeProposal resolved to an unexpected shape; expected FinalizeProposalSuccess ` +\n          `with 'proposal' and 'expiresAt' fields.`,\n      });\n    }\n    await store.commit(finalizeProposalId, {\n      expiresAt: success.expiresAt,\n      proposalPayload: success.proposal,\n    });\n    logFinalizeSucceeded({\n      proposalId: finalizeProposalId,\n      accountId,\n      expiresAt: success.expiresAt,\n      path,\n    });\n    return projectFinalizeResponse({\n      request,\n      committedProposal: success.proposal,\n      finalizeProposalId,\n    });\n  };\n\n  return { kind: 'intercepted', result, project };\n}\n\nfunction isFinalizeSuccess<TRecipe extends Recipe>(v: unknown): v is FinalizeProposalSuccess<TRecipe> {\n  if (!v || typeof v !== 'object') return false;\n  const r = v as Record<string, unknown>;\n  return r.proposal != null && r.expiresAt instanceof Date;\n}\n\nfunction projectFinalizeResponse(args: {\n  request: GetProductsRequest;\n  committedProposal: Record<string, unknown>;\n  finalizeProposalId: string;\n}): ProposalGetProductsPayload {\n  const refineEntries = (args.request as { refine?: ReadonlyArray<Record<string, unknown>> }).refine;\n  const refinementApplied: Array<Record<string, unknown>> = [];\n  if (refineEntries) {\n    for (const entry of refineEntries) {\n      const scope = entry.scope;\n      if (scope === 'proposal') {\n        refinementApplied.push({\n          scope: 'proposal',\n          proposal_id: typeof entry.proposal_id === 'string' ? entry.proposal_id : args.finalizeProposalId,\n          status: 'applied',\n        });\n      } else if (scope === 'product') {\n        refinementApplied.push({\n          scope: 'product',\n          product_id: typeof entry.product_id === 'string' ? entry.product_id : '',\n          status: 'applied',\n        });\n      } else {\n        refinementApplied.push({ scope: 'request', status: 'applied' });\n      }\n    }\n  }\n  // **Decision: `products: []` on the finalize response by design.** The\n  // committed proposal carries `allocations[]` keyed by `product_id`;\n  // the buyer either has the products from the prior `brief_with_proposals`\n  // step (the natural flow) or fetches by id. Echoing the products here\n  // would require the framework to either re-emit from the persisted\n  // draft (extra wire bytes the buyer already has) or call back into the\n  // adopter (extra round-trip to upstream). Buyers who explicitly want\n  // products on the finalize response can fetch them via a follow-up\n  // `get_products({ product_ids: [...] })` keyed off\n  // `proposals[0].allocations[].product_id`.\n  return {\n    cache_scope: 'account',\n    products: [],\n    proposals: [args.committedProposal as unknown as Proposal],\n    refinement_applied: refinementApplied,\n  } as unknown as ProposalGetProductsPayload;\n}\n\n// ---------------------------------------------------------------------------\n// getProducts / refineProducts — post-call draft persistence\n// ---------------------------------------------------------------------------\n\n/**\n * Persist proposals returned by `getProducts` / `refineProducts` as\n * drafts in the wired {@link ProposalStore}. Validates `overlap ⊆ wire`\n * for any returned recipes before persisting.\n *\n * Quietly returns when no store is wired, no `proposals[]` in the\n * response, or no typed recipes attached to products.\n *\n * @public\n */\nexport async function maybePersistDraftAfterGetProducts<TRecipe extends Recipe>(args: {\n  response: ProposalGetProductsPayload;\n  store: ProposalStore<TRecipe> | undefined;\n  ctx: { account: { id: string } };\n}): Promise<void> {\n  const { response, store, ctx } = args;\n  if (!store) return;\n  const proposals = (response as { proposals?: ReadonlyArray<Proposal> }).proposals;\n  if (!proposals || proposals.length === 0) return;\n  const products = (response as { products?: ReadonlyArray<Product> }).products ?? [];\n\n  for (const proposal of proposals) {\n    const proposalId = (proposal as { proposal_id?: string }).proposal_id;\n    if (!proposalId) continue;\n    const proposalPayload = toPlainObject(proposal);\n    const recipes = collectRecipesFromProducts<TRecipe>(products, proposalPayload);\n    if (recipes.size > 0) {\n      validateOverlapSubsetOfWire({ recipes, products });\n    }\n    await store.putDraft({\n      proposalId,\n      accountId: ctx.account.id,\n      recipes,\n      proposalPayload,\n    });\n    logDraftPersisted({\n      proposalId,\n      accountId: ctx.account.id,\n      recipesCount: recipes.size,\n    });\n  }\n}\n\nfunction collectRecipesFromProducts<TRecipe extends Recipe>(\n  products: readonly Product[],\n  proposalPayload: Record<string, unknown>\n): Map<string, TRecipe> {\n  // Filter to products referenced by the proposal's allocations[] (per\n  // spec) or legacy products[] string array when present.\n  let referenced: Set<string> | null = null;\n  const allocations = proposalPayload.allocations;\n  if (Array.isArray(allocations)) {\n    referenced = new Set(\n      allocations\n        .map((a: unknown) => (a as { product_id?: string }).product_id)\n        .filter((id): id is string => typeof id === 'string')\n    );\n  } else if (Array.isArray(proposalPayload.products)) {\n    referenced = new Set((proposalPayload.products as unknown[]).filter((p): p is string => typeof p === 'string'));\n  }\n\n  const recipes = new Map<string, TRecipe>();\n  for (const product of products) {\n    const productId = product.product_id;\n    if (!productId) continue;\n    if (referenced && !referenced.has(productId)) continue;\n    const implConfig = (product as { implementation_config?: unknown }).implementation_config;\n    if (isRecipe(implConfig)) {\n      recipes.set(productId, implConfig as TRecipe);\n    }\n  }\n  return recipes;\n}\n\nfunction isRecipe(v: unknown): boolean {\n  return v != null && typeof v === 'object' && typeof (v as { recipe_kind?: unknown }).recipe_kind === 'string';\n}\n\nfunction toPlainObject(v: unknown): Record<string, unknown> {\n  if (v == null || typeof v !== 'object') return {};\n  // Deep clone via JSON to drop class-instance prototypes — the stored\n  // payload must round-trip through a durable backing.\n  return JSON.parse(JSON.stringify(v)) as Record<string, unknown>;\n}\n\n// ---------------------------------------------------------------------------\n// createMediaBuy — recipe hydration on proposal_id\n// ---------------------------------------------------------------------------\n\n/**\n * Result of {@link maybeReserveProposalForCreateMediaBuy}.\n *\n *   - `record` — the reserved {@link ProposalRecord}. Caller threads\n *     `recipes` onto `ctx.recipes` and calls\n *     {@link finalizeProposalConsumption} on adapter success or\n *     {@link releaseProposalReservation} on failure.\n *   - `null` — request has no `proposal_id`, no store wired, or the\n *     framework didn't intercept (v1 path).\n *\n * @public\n */\nexport type ReservedProposal<TRecipe extends Recipe> = ProposalRecord<TRecipe>;\n\n/**\n * Reserve the proposal for consumption and hydrate `ctx.recipes`.\n *\n * Atomic CAS via {@link ProposalStore.tryReserveConsumption} — the\n * proposal transitions `COMMITTED → CONSUMING` before the adapter runs.\n * Two parallel `createMediaBuy(proposal_id=X)` calls cannot both\n * reserve; the loser raises `PROPOSAL_NOT_COMMITTED`.\n *\n * Validates per § D7 (expiry) BEFORE reserving — an expired proposal\n * surfaces `PROPOSAL_EXPIRED` without flipping the state.\n *\n * @public\n */\nexport async function maybeReserveProposalForCreateMediaBuy<TRecipe extends Recipe, TCtxMeta>(args: {\n  request: { proposal_id?: string; packages?: ReadonlyArray<unknown> } & Record<string, unknown>;\n  manager: ProposalManager<TRecipe, TCtxMeta> | undefined;\n  store: ProposalStore<TRecipe> | undefined;\n  ctx: { account: { id: string } };\n  now?: Date;\n}): Promise<ReservedProposal<TRecipe> | null> {\n  const { request, manager, store, ctx, now } = args;\n  const proposalId = request.proposal_id;\n  if (!proposalId || !store) return null;\n  const graceSeconds = manager?.capabilities.expiresAtGraceSeconds ?? 0;\n\n  // Expiry check BEFORE reserving — keep the buyer's slot uncommitted\n  // when telling them they're expired.\n  await enforceProposalExpiry(proposalId, {\n    proposalStore: store,\n    expectedAccountId: ctx.account.id,\n    graceSeconds,\n    ...(now && { now }),\n  });\n\n  const reserved = await store.tryReserveConsumption(proposalId, {\n    expectedAccountId: ctx.account.id,\n  });\n\n  // Capability-overlap gate per D4. Buyer's packages may be empty when\n  // proposal_id is set (the spec allows the seller to derive packages\n  // from allocations); skip the gate in that case.\n  const packages = request.packages;\n  if (packages && Array.isArray(packages) && packages.length > 0) {\n    validateCapabilityOverlap({\n      packages: packages as never,\n      recipes: reserved.recipes,\n    });\n  }\n\n  return reserved;\n}\n\n/**\n * Promote `CONSUMING → CONSUMED` after the adapter's `createMediaBuy`\n * succeeded.\n *\n * @public\n */\nexport async function finalizeProposalConsumption<TRecipe extends Recipe>(args: {\n  store: ProposalStore<TRecipe> | undefined;\n  record: ReservedProposal<TRecipe>;\n  mediaBuyId: string;\n}): Promise<void> {\n  const { store, record, mediaBuyId } = args;\n  if (!store) return;\n  await store.finalizeConsumption(record.proposalId, {\n    mediaBuyId,\n    expectedAccountId: record.accountId,\n  });\n  logConsumed({\n    proposalId: record.proposalId,\n    accountId: record.accountId,\n    mediaBuyId,\n  });\n}\n\n/**\n * Roll back the reservation: `CONSUMING → COMMITTED`. Best-effort.\n *\n * @public\n */\nexport async function releaseProposalReservation<TRecipe extends Recipe>(args: {\n  store: ProposalStore<TRecipe> | undefined;\n  record: ReservedProposal<TRecipe>;\n  logger?: { warn(message: string): void };\n}): Promise<void> {\n  const { store, record, logger } = args;\n  if (!store) return;\n  try {\n    await store.releaseConsumption(record.proposalId, {\n      expectedAccountId: record.accountId,\n    });\n  } catch (err) {\n    const message = err instanceof Error ? err.message : String(err);\n    logger?.warn(\n      `[adcp/decisioning] failed to release consumption reservation for proposal ` +\n        `${record.proposalId}: ${message}. The record may stay in CONSUMING until eviction.`\n    );\n  }\n}\n\n// ---------------------------------------------------------------------------\n// updateMediaBuy / getMediaBuyDelivery — reverse-index recipe hydration\n// ---------------------------------------------------------------------------\n\n/**\n * Hydrate `ctx.recipes` for post-acceptance buy operations via the\n * `getByMediaBuyId` reverse-index. Returns the record (so the caller\n * can re-validate overlap if a packages-shaped patch is provided);\n * returns `null` when no proposal backs this buy.\n *\n * Per Resolutions §5: re-validates capability overlap on every call\n * with packages.\n *\n * @public\n */\nexport async function maybeHydrateRecipesForMediaBuyId<TRecipe extends Recipe>(args: {\n  mediaBuyId: string | undefined;\n  store: ProposalStore<TRecipe> | undefined;\n  ctx: { account: { id: string } };\n  packages?: ReadonlyArray<unknown>;\n}): Promise<ProposalRecord<TRecipe> | null> {\n  const { mediaBuyId, store, ctx, packages } = args;\n  if (!mediaBuyId || !store) return null;\n  const record = await store.getByMediaBuyId(mediaBuyId, {\n    expectedAccountId: ctx.account.id,\n  });\n  if (!record) return null;\n  if (packages && Array.isArray(packages) && packages.length > 0) {\n    validateCapabilityOverlap({\n      packages: packages as never,\n      recipes: record.recipes,\n    });\n  }\n  return record;\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../../../../src/lib/server/decisioning/proposal/dispatch.ts"],"sourcesContent":["/**\n * Proposal-dispatch — the v1.5 framework intercept seams.\n *\n * Pure functions that the runtime calls from the wire-handler shims\n * (`getProducts`, `createMediaBuy`, `updateMediaBuy`,\n * `getMediaBuyDelivery`). Each helper short-circuits when no manager /\n * store is wired for the request, so the v1 path is preserved\n * byte-for-byte.\n *\n * Five integration points (parity with `adcp-client-python.src/adcp/decisioning/proposal_dispatch.py`):\n *\n *   - {@link maybeInterceptFinalize} — `getProducts` shim. Detects\n *     `refine[i].action: 'finalize'`, calls the manager's\n *     `finalizeProposal`, commits the proposal, returns the wire\n *     response. Returns `null` when no finalize entry / no\n *     finalize-capable manager.\n *   - {@link maybePersistDraftAfterGetProducts} — `getProducts` shim\n *     (post-call). Walks the response's `proposals[]`, validates\n *     `overlap ⊆ wire`, persists each as a draft.\n *   - {@link maybeReserveProposalForCreateMediaBuy} — `createMediaBuy`\n *     shim. When `proposal_id` is set, validates expiry + capability\n *     overlap, reserves the proposal (`COMMITTED → CONSUMING`), returns\n *     the recipes map for `ctx.recipes` hydration.\n *   - {@link finalizeProposalConsumption} — `createMediaBuy` shim\n *     (post-success). Promotes `CONSUMING → CONSUMED` and records the\n *     `mediaBuyId` back-reference.\n *   - {@link releaseProposalReservation} — `createMediaBuy` shim\n *     (failure rollback). Restores `CONSUMING → COMMITTED`.\n *   - {@link maybeHydrateRecipesForMediaBuyId} —\n *     `updateMediaBuy` / `getMediaBuyDelivery` shims. Reverse-index\n *     hydration via `getByMediaBuyId`. Re-runs capability-overlap\n *     validation per Resolutions §5.\n *\n * @public\n * @packageDocumentation\n */\n\nimport { AdcpError, isTaskHandoff, type TaskHandoff } from '../async-outcome';\nimport type { Product, Proposal } from '../../../types/tools.generated';\nimport type { CanonicalGetProductsRequest } from '../../../v2/projection/creative-delivery';\nimport {\n  detectFinalizeAction,\n  enforceProposalExpiry,\n  logConsumed,\n  logDraftPersisted,\n  logFinalizeSucceeded,\n  validateCapabilityOverlap,\n  validateOverlapSubsetOfWire,\n} from './lifecycle';\nimport type { ProposalRecord, ProposalStore } from './store';\nimport type {\n  FinalizeProposalRequest,\n  FinalizeProposalSuccess,\n  ProposalGetProductsPayload,\n  ProposalManager,\n  Recipe,\n} from './types';\n\n// ---------------------------------------------------------------------------\n// Capability detection\n// ---------------------------------------------------------------------------\n\n/**\n * Per Resolutions §7: framework detects finalize via method-presence +\n * `capabilities.finalize` flag. Adopters opt in by both implementing\n * AND declaring; flipping only one half is an adopter bug.\n */\nfunction hasFinalizeCapability<TRecipe extends Recipe, TCtxMeta>(\n  manager: ProposalManager<TRecipe, TCtxMeta> | undefined\n): boolean {\n  if (!manager) return false;\n  if (!manager.capabilities.finalize) return false;\n  return typeof manager.finalizeProposal === 'function';\n}\n\n// ---------------------------------------------------------------------------\n// getProducts — finalize interception\n// ---------------------------------------------------------------------------\n\n/**\n * Result of {@link maybeInterceptFinalize}.\n *\n *   - `kind: 'intercepted'` — adopter's `finalizeProposal` was called.\n *     Caller threads `result` and `project` through the framework's\n *     standard `routeIfHandoff` so the projection callback fires\n *     synchronously for sync `FinalizeProposalSuccess` returns AND\n *     inside the background task for `TaskHandoff<FinalizeProposalSuccess>`\n *     returns. The projection commits the proposal store, emits the\n *     `proposal.finalized` log, and shapes the wire response.\n *   - `kind: 'pass'` — no finalize entry / no finalize-capable manager;\n *     caller continues with the standard `getProducts` dispatch.\n *\n * No special-case handling: finalize HITL inherits the framework's\n * task-lifecycle posture (cancellation, restart-via-durable-store,\n * deadline, webhook delivery) from `routeIfHandoff`, the same machinery\n * that drives `createMediaBuy` HITL and `syncCreatives` HITL.\n *\n * @public\n */\nexport type FinalizeInterceptResult<TRecipe extends Recipe = Recipe> =\n  | {\n      kind: 'intercepted';\n      result: FinalizeProposalSuccess<TRecipe> | TaskHandoff<FinalizeProposalSuccess<TRecipe>>;\n      project: (success: FinalizeProposalSuccess<TRecipe>) => Promise<ProposalGetProductsPayload>;\n    }\n  | { kind: 'pass' };\n\n/**\n * Intercept `buying_mode: 'refine'` requests carrying a\n * `refine[i].action: 'finalize'` entry. Hydrates the draft, calls the\n * manager's `finalizeProposal`, and returns the raw adopter result + a\n * projection callback. The runtime threads them through the framework's\n * standard `routeIfHandoff` so:\n *\n *   - Sync `FinalizeProposalSuccess` returns: projection runs inline,\n *     buyer sees the committed proposal in the response.\n *   - HITL `TaskHandoff<FinalizeProposalSuccess>` returns: framework\n *     returns the Submitted envelope to the buyer, runs the adopter's\n *     handoff fn in background; projection runs when the handoff\n *     resolves, commits the proposal, projects the terminal task\n *     artifact.\n *\n * Same machinery as `createMediaBuy` HITL — finalize inherits whatever\n * cancellation, restart-via-durable-store, deadline, and webhook\n * delivery semantics the framework's task lifecycle provides for every\n * other unified-hybrid tool. No special-case wrapper.\n *\n * @public\n */\nexport async function maybeInterceptFinalize<TRecipe extends Recipe, TCtxMeta>(args: {\n  request: CanonicalGetProductsRequest;\n  manager: ProposalManager<TRecipe, TCtxMeta> | undefined;\n  store: ProposalStore<TRecipe> | undefined;\n  ctx: { account: { id: string } } & Record<string, unknown>;\n}): Promise<FinalizeInterceptResult<TRecipe>> {\n  const { request, manager, store, ctx } = args;\n  const finalizeEntry = detectFinalizeAction(request);\n  if (!finalizeEntry) return { kind: 'pass' };\n  if (!hasFinalizeCapability(manager) || !store) return { kind: 'pass' };\n\n  const fieldPath = `refine[${finalizeEntry.index}].proposal_id`;\n  const accountId = ctx.account.id;\n  const record = await store.get(finalizeEntry.proposalId, { expectedAccountId: accountId });\n  if (!record) {\n    throw new AdcpError('PROPOSAL_NOT_FOUND', {\n      recovery: 'correctable',\n      message:\n        `Proposal ${JSON.stringify(finalizeEntry.proposalId)} not found. The buyer must call ` +\n        `get_products with buying_mode='brief' or 'refine' to obtain a draft proposal_id ` +\n        `before finalizing it.`,\n      field: fieldPath,\n    });\n  }\n  if (record.state !== 'draft') {\n    throw new AdcpError('PROPOSAL_NOT_COMMITTED', {\n      recovery: 'correctable',\n      message:\n        `Proposal ${JSON.stringify(finalizeEntry.proposalId)} is in state ` +\n        `${JSON.stringify(record.state)}; only draft proposals can be finalized. ` +\n        `Already-committed proposals should be accepted via create_media_buy(proposal_id=...) ` +\n        `directly.`,\n      field: fieldPath,\n    });\n  }\n\n  const finalizeReq: FinalizeProposalRequest<TRecipe> = {\n    proposalId: finalizeEntry.proposalId,\n    recipes: record.recipes,\n    proposalPayload: record.proposalPayload,\n    parentRequest: request,\n    ...(finalizeEntry.ask !== undefined && { ask: finalizeEntry.ask }),\n  };\n\n  // manager + finalizeProposal are non-undefined per hasFinalizeCapability.\n  const result = await manager!.finalizeProposal!(finalizeReq, ctx as never);\n  // Pre-determine the path label by checking whether the adopter\n  // returned a TaskHandoff up-front. `routeIfHandoff` runs `project`\n  // synchronously for the sync arm and inside the background task for\n  // the handoff arm; either way, we want the log to reflect which arm\n  // the adopter chose.\n  const path: 'inline' | 'handoff' = isTaskHandoff(result) ? 'handoff' : 'inline';\n  const finalizeProposalId = finalizeEntry.proposalId;\n\n  const project = async (success: FinalizeProposalSuccess<TRecipe>): Promise<ProposalGetProductsPayload> => {\n    if (!isFinalizeSuccess<TRecipe>(success)) {\n      throw new AdcpError('INTERNAL_ERROR', {\n        recovery: 'terminal',\n        message:\n          `finalizeProposal resolved to an unexpected shape; expected FinalizeProposalSuccess ` +\n          `with 'proposal' and 'expiresAt' fields.`,\n      });\n    }\n    await store.commit(finalizeProposalId, {\n      expiresAt: success.expiresAt,\n      proposalPayload: success.proposal,\n    });\n    logFinalizeSucceeded({\n      proposalId: finalizeProposalId,\n      accountId,\n      expiresAt: success.expiresAt,\n      path,\n    });\n    return projectFinalizeResponse({\n      request,\n      committedProposal: success.proposal,\n      finalizeProposalId,\n    });\n  };\n\n  return { kind: 'intercepted', result, project };\n}\n\nfunction isFinalizeSuccess<TRecipe extends Recipe>(v: unknown): v is FinalizeProposalSuccess<TRecipe> {\n  if (!v || typeof v !== 'object') return false;\n  const r = v as Record<string, unknown>;\n  return r.proposal != null && r.expiresAt instanceof Date;\n}\n\nfunction projectFinalizeResponse(args: {\n  request: CanonicalGetProductsRequest;\n  committedProposal: Record<string, unknown>;\n  finalizeProposalId: string;\n}): ProposalGetProductsPayload {\n  const refineEntries = (args.request as { refine?: ReadonlyArray<Record<string, unknown>> }).refine;\n  const refinementApplied: Array<Record<string, unknown>> = [];\n  if (refineEntries) {\n    for (const entry of refineEntries) {\n      const scope = entry.scope;\n      if (scope === 'proposal') {\n        refinementApplied.push({\n          scope: 'proposal',\n          proposal_id: typeof entry.proposal_id === 'string' ? entry.proposal_id : args.finalizeProposalId,\n          status: 'applied',\n        });\n      } else if (scope === 'product') {\n        refinementApplied.push({\n          scope: 'product',\n          product_id: typeof entry.product_id === 'string' ? entry.product_id : '',\n          status: 'applied',\n        });\n      } else {\n        refinementApplied.push({ scope: 'request', status: 'applied' });\n      }\n    }\n  }\n  // **Decision: `products: []` on the finalize response by design.** The\n  // committed proposal carries `allocations[]` keyed by `product_id`;\n  // the buyer either has the products from the prior `brief_with_proposals`\n  // step (the natural flow) or fetches by id. Echoing the products here\n  // would require the framework to either re-emit from the persisted\n  // draft (extra wire bytes the buyer already has) or call back into the\n  // adopter (extra round-trip to upstream). Buyers who explicitly want\n  // products on the finalize response can fetch them via a follow-up\n  // `get_products({ product_ids: [...] })` keyed off\n  // `proposals[0].allocations[].product_id`.\n  return {\n    cache_scope: 'account',\n    products: [],\n    proposals: [args.committedProposal as unknown as Proposal],\n    refinement_applied: refinementApplied,\n  } as unknown as ProposalGetProductsPayload;\n}\n\n// ---------------------------------------------------------------------------\n// getProducts / refineProducts — post-call draft persistence\n// ---------------------------------------------------------------------------\n\n/**\n * Persist proposals returned by `getProducts` / `refineProducts` as\n * drafts in the wired {@link ProposalStore}. Validates `overlap ⊆ wire`\n * for any returned recipes before persisting.\n *\n * Quietly returns when no store is wired, no `proposals[]` in the\n * response, or no typed recipes attached to products.\n *\n * @public\n */\nexport async function maybePersistDraftAfterGetProducts<TRecipe extends Recipe>(args: {\n  response: ProposalGetProductsPayload;\n  store: ProposalStore<TRecipe> | undefined;\n  ctx: { account: { id: string } };\n}): Promise<void> {\n  const { response, store, ctx } = args;\n  if (!store) return;\n  const proposals = (response as { proposals?: ReadonlyArray<Proposal> }).proposals;\n  if (!proposals || proposals.length === 0) return;\n  const products = (response as { products?: ReadonlyArray<Product> }).products ?? [];\n\n  for (const proposal of proposals) {\n    const proposalId = (proposal as { proposal_id?: string }).proposal_id;\n    if (!proposalId) continue;\n    const proposalPayload = toPlainObject(proposal);\n    const recipes = collectRecipesFromProducts<TRecipe>(products, proposalPayload);\n    if (recipes.size > 0) {\n      validateOverlapSubsetOfWire({ recipes, products });\n    }\n    await store.putDraft({\n      proposalId,\n      accountId: ctx.account.id,\n      recipes,\n      proposalPayload,\n    });\n    logDraftPersisted({\n      proposalId,\n      accountId: ctx.account.id,\n      recipesCount: recipes.size,\n    });\n  }\n}\n\nfunction collectRecipesFromProducts<TRecipe extends Recipe>(\n  products: readonly Product[],\n  proposalPayload: Record<string, unknown>\n): Map<string, TRecipe> {\n  // Filter to products referenced by the proposal's allocations[] (per\n  // spec) or legacy products[] string array when present.\n  let referenced: Set<string> | null = null;\n  const allocations = proposalPayload.allocations;\n  if (Array.isArray(allocations)) {\n    referenced = new Set(\n      allocations\n        .map((a: unknown) => (a as { product_id?: string }).product_id)\n        .filter((id): id is string => typeof id === 'string')\n    );\n  } else if (Array.isArray(proposalPayload.products)) {\n    referenced = new Set((proposalPayload.products as unknown[]).filter((p): p is string => typeof p === 'string'));\n  }\n\n  const recipes = new Map<string, TRecipe>();\n  for (const product of products) {\n    const productId = product.product_id;\n    if (!productId) continue;\n    if (referenced && !referenced.has(productId)) continue;\n    const implConfig = (product as { implementation_config?: unknown }).implementation_config;\n    if (isRecipe(implConfig)) {\n      recipes.set(productId, implConfig as TRecipe);\n    }\n  }\n  return recipes;\n}\n\nfunction isRecipe(v: unknown): boolean {\n  return v != null && typeof v === 'object' && typeof (v as { recipe_kind?: unknown }).recipe_kind === 'string';\n}\n\nfunction toPlainObject(v: unknown): Record<string, unknown> {\n  if (v == null || typeof v !== 'object') return {};\n  // Deep clone via JSON to drop class-instance prototypes — the stored\n  // payload must round-trip through a durable backing.\n  return JSON.parse(JSON.stringify(v)) as Record<string, unknown>;\n}\n\n// ---------------------------------------------------------------------------\n// createMediaBuy — recipe hydration on proposal_id\n// ---------------------------------------------------------------------------\n\n/**\n * Result of {@link maybeReserveProposalForCreateMediaBuy}.\n *\n *   - `record` — the reserved {@link ProposalRecord}. Caller threads\n *     `recipes` onto `ctx.recipes` and calls\n *     {@link finalizeProposalConsumption} on adapter success or\n *     {@link releaseProposalReservation} on failure.\n *   - `null` — request has no `proposal_id`, no store wired, or the\n *     framework didn't intercept (v1 path).\n *\n * @public\n */\nexport type ReservedProposal<TRecipe extends Recipe> = ProposalRecord<TRecipe>;\n\n/**\n * Reserve the proposal for consumption and hydrate `ctx.recipes`.\n *\n * Atomic CAS via {@link ProposalStore.tryReserveConsumption} — the\n * proposal transitions `COMMITTED → CONSUMING` before the adapter runs.\n * Two parallel `createMediaBuy(proposal_id=X)` calls cannot both\n * reserve; the loser raises `PROPOSAL_NOT_COMMITTED`.\n *\n * Validates per § D7 (expiry) BEFORE reserving — an expired proposal\n * surfaces `PROPOSAL_EXPIRED` without flipping the state.\n *\n * @public\n */\nexport async function maybeReserveProposalForCreateMediaBuy<TRecipe extends Recipe, TCtxMeta>(args: {\n  request: { proposal_id?: string; packages?: ReadonlyArray<unknown> } & Record<string, unknown>;\n  manager: ProposalManager<TRecipe, TCtxMeta> | undefined;\n  store: ProposalStore<TRecipe> | undefined;\n  ctx: { account: { id: string } };\n  now?: Date;\n}): Promise<ReservedProposal<TRecipe> | null> {\n  const { request, manager, store, ctx, now } = args;\n  const proposalId = request.proposal_id;\n  if (!proposalId || !store) return null;\n  const graceSeconds = manager?.capabilities.expiresAtGraceSeconds ?? 0;\n\n  // Expiry check BEFORE reserving — keep the buyer's slot uncommitted\n  // when telling them they're expired.\n  await enforceProposalExpiry(proposalId, {\n    proposalStore: store,\n    expectedAccountId: ctx.account.id,\n    graceSeconds,\n    ...(now && { now }),\n  });\n\n  const reserved = await store.tryReserveConsumption(proposalId, {\n    expectedAccountId: ctx.account.id,\n  });\n\n  // Capability-overlap gate per D4. Buyer's packages may be empty when\n  // proposal_id is set (the spec allows the seller to derive packages\n  // from allocations); skip the gate in that case.\n  const packages = request.packages;\n  if (packages && Array.isArray(packages) && packages.length > 0) {\n    validateCapabilityOverlap({\n      packages: packages as never,\n      recipes: reserved.recipes,\n    });\n  }\n\n  return reserved;\n}\n\n/**\n * Promote `CONSUMING → CONSUMED` after the adapter's `createMediaBuy`\n * succeeded.\n *\n * @public\n */\nexport async function finalizeProposalConsumption<TRecipe extends Recipe>(args: {\n  store: ProposalStore<TRecipe> | undefined;\n  record: ReservedProposal<TRecipe>;\n  mediaBuyId: string;\n}): Promise<void> {\n  const { store, record, mediaBuyId } = args;\n  if (!store) return;\n  await store.finalizeConsumption(record.proposalId, {\n    mediaBuyId,\n    expectedAccountId: record.accountId,\n  });\n  logConsumed({\n    proposalId: record.proposalId,\n    accountId: record.accountId,\n    mediaBuyId,\n  });\n}\n\n/**\n * Roll back the reservation: `CONSUMING → COMMITTED`. Best-effort.\n *\n * @public\n */\nexport async function releaseProposalReservation<TRecipe extends Recipe>(args: {\n  store: ProposalStore<TRecipe> | undefined;\n  record: ReservedProposal<TRecipe>;\n  logger?: { warn(message: string): void };\n}): Promise<void> {\n  const { store, record, logger } = args;\n  if (!store) return;\n  try {\n    await store.releaseConsumption(record.proposalId, {\n      expectedAccountId: record.accountId,\n    });\n  } catch (err) {\n    const message = err instanceof Error ? err.message : String(err);\n    logger?.warn(\n      `[adcp/decisioning] failed to release consumption reservation for proposal ` +\n        `${record.proposalId}: ${message}. The record may stay in CONSUMING until eviction.`\n    );\n  }\n}\n\n// ---------------------------------------------------------------------------\n// updateMediaBuy / getMediaBuyDelivery — reverse-index recipe hydration\n// ---------------------------------------------------------------------------\n\n/**\n * Hydrate `ctx.recipes` for post-acceptance buy operations via the\n * `getByMediaBuyId` reverse-index. Returns the record (so the caller\n * can re-validate overlap if a packages-shaped patch is provided);\n * returns `null` when no proposal backs this buy.\n *\n * Per Resolutions §5: re-validates capability overlap on every call\n * with packages.\n *\n * @public\n */\nexport async function maybeHydrateRecipesForMediaBuyId<TRecipe extends Recipe>(args: {\n  mediaBuyId: string | undefined;\n  store: ProposalStore<TRecipe> | undefined;\n  ctx: { account: { id: string } };\n  packages?: ReadonlyArray<unknown>;\n}): Promise<ProposalRecord<TRecipe> | null> {\n  const { mediaBuyId, store, ctx, packages } = args;\n  if (!mediaBuyId || !store) return null;\n  const record = await store.getByMediaBuyId(mediaBuyId, {\n    expectedAccountId: ctx.account.id,\n  });\n  if (!record) return null;\n  if (packages && Array.isArray(packages) && packages.length > 0) {\n    validateCapabilityOverlap({\n      packages: packages as never,\n      recipes: record.recipes,\n    });\n  }\n  return record;\n}\n"],"mappings":"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","names":[]}

package/dist/lib/server/decisioning/proposal/dispatch.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../src/lib/server/decisioning/proposal/dispatch.ts"],"sourcesContent":["/**\n * Proposal-dispatch — the v1.5 framework intercept seams.\n *\n * Pure functions that the runtime calls from the wire-handler shims\n * (`getProducts`, `createMediaBuy`, `updateMediaBuy`,\n * `getMediaBuyDelivery`). Each helper short-circuits when no manager /\n * store is wired for the request, so the v1 path is preserved\n * byte-for-byte.\n *\n * Five integration points (parity with `adcp-client-python.src/adcp/decisioning/proposal_dispatch.py`):\n *\n *   - {@link maybeInterceptFinalize} — `getProducts` shim. Detects\n *     `refine[i].action: 'finalize'`, calls the manager's\n *     `finalizeProposal`, commits the proposal, returns the wire\n *     response. Returns `null` when no finalize entry / no\n *     finalize-capable manager.\n *   - {@link maybePersistDraftAfterGetProducts} — `getProducts` shim\n *     (post-call). Walks the response's `proposals[]`, validates\n *     `overlap ⊆ wire`, persists each as a draft.\n *   - {@link maybeReserveProposalForCreateMediaBuy} — `createMediaBuy`\n *     shim. When `proposal_id` is set, validates expiry + capability\n *     overlap, reserves the proposal (`COMMITTED → CONSUMING`), returns\n *     the recipes map for `ctx.recipes` hydration.\n *   - {@link finalizeProposalConsumption} — `createMediaBuy` shim\n *     (post-success). Promotes `CONSUMING → CONSUMED` and records the\n *     `mediaBuyId` back-reference.\n *   - {@link releaseProposalReservation} — `createMediaBuy` shim\n *     (failure rollback). Restores `CONSUMING → COMMITTED`.\n *   - {@link maybeHydrateRecipesForMediaBuyId} —\n *     `updateMediaBuy` / `getMediaBuyDelivery` shims. Reverse-index\n *     hydration via `getByMediaBuyId`. Re-runs capability-overlap\n *     validation per Resolutions §5.\n *\n * @public\n * @packageDocumentation\n */\n\nimport { AdcpError, isTaskHandoff, type TaskHandoff } from '../async-outcome';\nimport type { GetProductsRequest, Product, Proposal } from '../../../types/tools.generated';\nimport {\n  detectFinalizeAction,\n  enforceProposalExpiry,\n  logConsumed,\n  logDraftPersisted,\n  logFinalizeSucceeded,\n  validateCapabilityOverlap,\n  validateOverlapSubsetOfWire,\n} from './lifecycle';\nimport type { ProposalRecord, ProposalStore } from './store';\nimport type {\n  FinalizeProposalRequest,\n  FinalizeProposalSuccess,\n  ProposalGetProductsPayload,\n  ProposalManager,\n  Recipe,\n} from './types';\n\n// ---------------------------------------------------------------------------\n// Capability detection\n// ---------------------------------------------------------------------------\n\n/**\n * Per Resolutions §7: framework detects finalize via method-presence +\n * `capabilities.finalize` flag. Adopters opt in by both implementing\n * AND declaring; flipping only one half is an adopter bug.\n */\nfunction hasFinalizeCapability<TRecipe extends Recipe, TCtxMeta>(\n  manager: ProposalManager<TRecipe, TCtxMeta> | undefined\n): boolean {\n  if (!manager) return false;\n  if (!manager.capabilities.finalize) return false;\n  return typeof manager.finalizeProposal === 'function';\n}\n\n// ---------------------------------------------------------------------------\n// getProducts — finalize interception\n// ---------------------------------------------------------------------------\n\n/**\n * Result of {@link maybeInterceptFinalize}.\n *\n *   - `kind: 'intercepted'` — adopter's `finalizeProposal` was called.\n *     Caller threads `result` and `project` through the framework's\n *     standard `routeIfHandoff` so the projection callback fires\n *     synchronously for sync `FinalizeProposalSuccess` returns AND\n *     inside the background task for `TaskHandoff<FinalizeProposalSuccess>`\n *     returns. The projection commits the proposal store, emits the\n *     `proposal.finalized` log, and shapes the wire response.\n *   - `kind: 'pass'` — no finalize entry / no finalize-capable manager;\n *     caller continues with the standard `getProducts` dispatch.\n *\n * No special-case handling: finalize HITL inherits the framework's\n * task-lifecycle posture (cancellation, restart-via-durable-store,\n * deadline, webhook delivery) from `routeIfHandoff`, the same machinery\n * that drives `createMediaBuy` HITL and `syncCreatives` HITL.\n *\n * @public\n */\nexport type FinalizeInterceptResult<TRecipe extends Recipe = Recipe> =\n  | {\n      kind: 'intercepted';\n      result: FinalizeProposalSuccess<TRecipe> | TaskHandoff<FinalizeProposalSuccess<TRecipe>>;\n      project: (success: FinalizeProposalSuccess<TRecipe>) => Promise<ProposalGetProductsPayload>;\n    }\n  | { kind: 'pass' };\n\n/**\n * Intercept `buying_mode: 'refine'` requests carrying a\n * `refine[i].action: 'finalize'` entry. Hydrates the draft, calls the\n * manager's `finalizeProposal`, and returns the raw adopter result + a\n * projection callback. The runtime threads them through the framework's\n * standard `routeIfHandoff` so:\n *\n *   - Sync `FinalizeProposalSuccess` returns: projection runs inline,\n *     buyer sees the committed proposal in the response.\n *   - HITL `TaskHandoff<FinalizeProposalSuccess>` returns: framework\n *     returns the Submitted envelope to the buyer, runs the adopter's\n *     handoff fn in background; projection runs when the handoff\n *     resolves, commits the proposal, projects the terminal task\n *     artifact.\n *\n * Same machinery as `createMediaBuy` HITL — finalize inherits whatever\n * cancellation, restart-via-durable-store, deadline, and webhook\n * delivery semantics the framework's task lifecycle provides for every\n * other unified-hybrid tool. No special-case wrapper.\n *\n * @public\n */\nexport async function maybeInterceptFinalize<TRecipe extends Recipe, TCtxMeta>(args: {\n  request: GetProductsRequest;\n  manager: ProposalManager<TRecipe, TCtxMeta> | undefined;\n  store: ProposalStore<TRecipe> | undefined;\n  ctx: { account: { id: string } } & Record<string, unknown>;\n}): Promise<FinalizeInterceptResult<TRecipe>> {\n  const { request, manager, store, ctx } = args;\n  const finalizeEntry = detectFinalizeAction(request);\n  if (!finalizeEntry) return { kind: 'pass' };\n  if (!hasFinalizeCapability(manager) || !store) return { kind: 'pass' };\n\n  const fieldPath = `refine[${finalizeEntry.index}].proposal_id`;\n  const accountId = ctx.account.id;\n  const record = await store.get(finalizeEntry.proposalId, { expectedAccountId: accountId });\n  if (!record) {\n    throw new AdcpError('PROPOSAL_NOT_FOUND', {\n      recovery: 'correctable',\n      message:\n        `Proposal ${JSON.stringify(finalizeEntry.proposalId)} not found. The buyer must call ` +\n        `get_products with buying_mode='brief' or 'refine' to obtain a draft proposal_id ` +\n        `before finalizing it.`,\n      field: fieldPath,\n    });\n  }\n  if (record.state !== 'draft') {\n    throw new AdcpError('PROPOSAL_NOT_COMMITTED', {\n      recovery: 'correctable',\n      message:\n        `Proposal ${JSON.stringify(finalizeEntry.proposalId)} is in state ` +\n        `${JSON.stringify(record.state)}; only draft proposals can be finalized. ` +\n        `Already-committed proposals should be accepted via create_media_buy(proposal_id=...) ` +\n        `directly.`,\n      field: fieldPath,\n    });\n  }\n\n  const finalizeReq: FinalizeProposalRequest<TRecipe> = {\n    proposalId: finalizeEntry.proposalId,\n    recipes: record.recipes,\n    proposalPayload: record.proposalPayload,\n    parentRequest: request,\n    ...(finalizeEntry.ask !== undefined && { ask: finalizeEntry.ask }),\n  };\n\n  // manager + finalizeProposal are non-undefined per hasFinalizeCapability.\n  const result = await manager!.finalizeProposal!(finalizeReq, ctx as never);\n  // Pre-determine the path label by checking whether the adopter\n  // returned a TaskHandoff up-front. `routeIfHandoff` runs `project`\n  // synchronously for the sync arm and inside the background task for\n  // the handoff arm; either way, we want the log to reflect which arm\n  // the adopter chose.\n  const path: 'inline' | 'handoff' = isTaskHandoff(result) ? 'handoff' : 'inline';\n  const finalizeProposalId = finalizeEntry.proposalId;\n\n  const project = async (success: FinalizeProposalSuccess<TRecipe>): Promise<ProposalGetProductsPayload> => {\n    if (!isFinalizeSuccess<TRecipe>(success)) {\n      throw new AdcpError('INTERNAL_ERROR', {\n        recovery: 'terminal',\n        message:\n          `finalizeProposal resolved to an unexpected shape; expected FinalizeProposalSuccess ` +\n          `with 'proposal' and 'expiresAt' fields.`,\n      });\n    }\n    await store.commit(finalizeProposalId, {\n      expiresAt: success.expiresAt,\n      proposalPayload: success.proposal,\n    });\n    logFinalizeSucceeded({\n      proposalId: finalizeProposalId,\n      accountId,\n      expiresAt: success.expiresAt,\n      path,\n    });\n    return projectFinalizeResponse({\n      request,\n      committedProposal: success.proposal,\n      finalizeProposalId,\n    });\n  };\n\n  return { kind: 'intercepted', result, project };\n}\n\nfunction isFinalizeSuccess<TRecipe extends Recipe>(v: unknown): v is FinalizeProposalSuccess<TRecipe> {\n  if (!v || typeof v !== 'object') return false;\n  const r = v as Record<string, unknown>;\n  return r.proposal != null && r.expiresAt instanceof Date;\n}\n\nfunction projectFinalizeResponse(args: {\n  request: GetProductsRequest;\n  committedProposal: Record<string, unknown>;\n  finalizeProposalId: string;\n}): ProposalGetProductsPayload {\n  const refineEntries = (args.request as { refine?: ReadonlyArray<Record<string, unknown>> }).refine;\n  const refinementApplied: Array<Record<string, unknown>> = [];\n  if (refineEntries) {\n    for (const entry of refineEntries) {\n      const scope = entry.scope;\n      if (scope === 'proposal') {\n        refinementApplied.push({\n          scope: 'proposal',\n          proposal_id: typeof entry.proposal_id === 'string' ? entry.proposal_id : args.finalizeProposalId,\n          status: 'applied',\n        });\n      } else if (scope === 'product') {\n        refinementApplied.push({\n          scope: 'product',\n          product_id: typeof entry.product_id === 'string' ? entry.product_id : '',\n          status: 'applied',\n        });\n      } else {\n        refinementApplied.push({ scope: 'request', status: 'applied' });\n      }\n    }\n  }\n  // **Decision: `products: []` on the finalize response by design.** The\n  // committed proposal carries `allocations[]` keyed by `product_id`;\n  // the buyer either has the products from the prior `brief_with_proposals`\n  // step (the natural flow) or fetches by id. Echoing the products here\n  // would require the framework to either re-emit from the persisted\n  // draft (extra wire bytes the buyer already has) or call back into the\n  // adopter (extra round-trip to upstream). Buyers who explicitly want\n  // products on the finalize response can fetch them via a follow-up\n  // `get_products({ product_ids: [...] })` keyed off\n  // `proposals[0].allocations[].product_id`.\n  return {\n    cache_scope: 'account',\n    products: [],\n    proposals: [args.committedProposal as unknown as Proposal],\n    refinement_applied: refinementApplied,\n  } as unknown as ProposalGetProductsPayload;\n}\n\n// ---------------------------------------------------------------------------\n// getProducts / refineProducts — post-call draft persistence\n// ---------------------------------------------------------------------------\n\n/**\n * Persist proposals returned by `getProducts` / `refineProducts` as\n * drafts in the wired {@link ProposalStore}. Validates `overlap ⊆ wire`\n * for any returned recipes before persisting.\n *\n * Quietly returns when no store is wired, no `proposals[]` in the\n * response, or no typed recipes attached to products.\n *\n * @public\n */\nexport async function maybePersistDraftAfterGetProducts<TRecipe extends Recipe>(args: {\n  response: ProposalGetProductsPayload;\n  store: ProposalStore<TRecipe> | undefined;\n  ctx: { account: { id: string } };\n}): Promise<void> {\n  const { response, store, ctx } = args;\n  if (!store) return;\n  const proposals = (response as { proposals?: ReadonlyArray<Proposal> }).proposals;\n  if (!proposals || proposals.length === 0) return;\n  const products = (response as { products?: ReadonlyArray<Product> }).products ?? [];\n\n  for (const proposal of proposals) {\n    const proposalId = (proposal as { proposal_id?: string }).proposal_id;\n    if (!proposalId) continue;\n    const proposalPayload = toPlainObject(proposal);\n    const recipes = collectRecipesFromProducts<TRecipe>(products, proposalPayload);\n    if (recipes.size > 0) {\n      validateOverlapSubsetOfWire({ recipes, products });\n    }\n    await store.putDraft({\n      proposalId,\n      accountId: ctx.account.id,\n      recipes,\n      proposalPayload,\n    });\n    logDraftPersisted({\n      proposalId,\n      accountId: ctx.account.id,\n      recipesCount: recipes.size,\n    });\n  }\n}\n\nfunction collectRecipesFromProducts<TRecipe extends Recipe>(\n  products: readonly Product[],\n  proposalPayload: Record<string, unknown>\n): Map<string, TRecipe> {\n  // Filter to products referenced by the proposal's allocations[] (per\n  // spec) or legacy products[] string array when present.\n  let referenced: Set<string> | null = null;\n  const allocations = proposalPayload.allocations;\n  if (Array.isArray(allocations)) {\n    referenced = new Set(\n      allocations\n        .map((a: unknown) => (a as { product_id?: string }).product_id)\n        .filter((id): id is string => typeof id === 'string')\n    );\n  } else if (Array.isArray(proposalPayload.products)) {\n    referenced = new Set((proposalPayload.products as unknown[]).filter((p): p is string => typeof p === 'string'));\n  }\n\n  const recipes = new Map<string, TRecipe>();\n  for (const product of products) {\n    const productId = product.product_id;\n    if (!productId) continue;\n    if (referenced && !referenced.has(productId)) continue;\n    const implConfig = (product as { implementation_config?: unknown }).implementation_config;\n    if (isRecipe(implConfig)) {\n      recipes.set(productId, implConfig as TRecipe);\n    }\n  }\n  return recipes;\n}\n\nfunction isRecipe(v: unknown): boolean {\n  return v != null && typeof v === 'object' && typeof (v as { recipe_kind?: unknown }).recipe_kind === 'string';\n}\n\nfunction toPlainObject(v: unknown): Record<string, unknown> {\n  if (v == null || typeof v !== 'object') return {};\n  // Deep clone via JSON to drop class-instance prototypes — the stored\n  // payload must round-trip through a durable backing.\n  return JSON.parse(JSON.stringify(v)) as Record<string, unknown>;\n}\n\n// ---------------------------------------------------------------------------\n// createMediaBuy — recipe hydration on proposal_id\n// ---------------------------------------------------------------------------\n\n/**\n * Result of {@link maybeReserveProposalForCreateMediaBuy}.\n *\n *   - `record` — the reserved {@link ProposalRecord}. Caller threads\n *     `recipes` onto `ctx.recipes` and calls\n *     {@link finalizeProposalConsumption} on adapter success or\n *     {@link releaseProposalReservation} on failure.\n *   - `null` — request has no `proposal_id`, no store wired, or the\n *     framework didn't intercept (v1 path).\n *\n * @public\n */\nexport type ReservedProposal<TRecipe extends Recipe> = ProposalRecord<TRecipe>;\n\n/**\n * Reserve the proposal for consumption and hydrate `ctx.recipes`.\n *\n * Atomic CAS via {@link ProposalStore.tryReserveConsumption} — the\n * proposal transitions `COMMITTED → CONSUMING` before the adapter runs.\n * Two parallel `createMediaBuy(proposal_id=X)` calls cannot both\n * reserve; the loser raises `PROPOSAL_NOT_COMMITTED`.\n *\n * Validates per § D7 (expiry) BEFORE reserving — an expired proposal\n * surfaces `PROPOSAL_EXPIRED` without flipping the state.\n *\n * @public\n */\nexport async function maybeReserveProposalForCreateMediaBuy<TRecipe extends Recipe, TCtxMeta>(args: {\n  request: { proposal_id?: string; packages?: ReadonlyArray<unknown> } & Record<string, unknown>;\n  manager: ProposalManager<TRecipe, TCtxMeta> | undefined;\n  store: ProposalStore<TRecipe> | undefined;\n  ctx: { account: { id: string } };\n  now?: Date;\n}): Promise<ReservedProposal<TRecipe> | null> {\n  const { request, manager, store, ctx, now } = args;\n  const proposalId = request.proposal_id;\n  if (!proposalId || !store) return null;\n  const graceSeconds = manager?.capabilities.expiresAtGraceSeconds ?? 0;\n\n  // Expiry check BEFORE reserving — keep the buyer's slot uncommitted\n  // when telling them they're expired.\n  await enforceProposalExpiry(proposalId, {\n    proposalStore: store,\n    expectedAccountId: ctx.account.id,\n    graceSeconds,\n    ...(now && { now }),\n  });\n\n  const reserved = await store.tryReserveConsumption(proposalId, {\n    expectedAccountId: ctx.account.id,\n  });\n\n  // Capability-overlap gate per D4. Buyer's packages may be empty when\n  // proposal_id is set (the spec allows the seller to derive packages\n  // from allocations); skip the gate in that case.\n  const packages = request.packages;\n  if (packages && Array.isArray(packages) && packages.length > 0) {\n    validateCapabilityOverlap({\n      packages: packages as never,\n      recipes: reserved.recipes,\n    });\n  }\n\n  return reserved;\n}\n\n/**\n * Promote `CONSUMING → CONSUMED` after the adapter's `createMediaBuy`\n * succeeded.\n *\n * @public\n */\nexport async function finalizeProposalConsumption<TRecipe extends Recipe>(args: {\n  store: ProposalStore<TRecipe> | undefined;\n  record: ReservedProposal<TRecipe>;\n  mediaBuyId: string;\n}): Promise<void> {\n  const { store, record, mediaBuyId } = args;\n  if (!store) return;\n  await store.finalizeConsumption(record.proposalId, {\n    mediaBuyId,\n    expectedAccountId: record.accountId,\n  });\n  logConsumed({\n    proposalId: record.proposalId,\n    accountId: record.accountId,\n    mediaBuyId,\n  });\n}\n\n/**\n * Roll back the reservation: `CONSUMING → COMMITTED`. Best-effort.\n *\n * @public\n */\nexport async function releaseProposalReservation<TRecipe extends Recipe>(args: {\n  store: ProposalStore<TRecipe> | undefined;\n  record: ReservedProposal<TRecipe>;\n  logger?: { warn(message: string): void };\n}): Promise<void> {\n  const { store, record, logger } = args;\n  if (!store) return;\n  try {\n    await store.releaseConsumption(record.proposalId, {\n      expectedAccountId: record.accountId,\n    });\n  } catch (err) {\n    const message = err instanceof Error ? err.message : String(err);\n    logger?.warn(\n      `[adcp/decisioning] failed to release consumption reservation for proposal ` +\n        `${record.proposalId}: ${message}. The record may stay in CONSUMING until eviction.`\n    );\n  }\n}\n\n// ---------------------------------------------------------------------------\n// updateMediaBuy / getMediaBuyDelivery — reverse-index recipe hydration\n// ---------------------------------------------------------------------------\n\n/**\n * Hydrate `ctx.recipes` for post-acceptance buy operations via the\n * `getByMediaBuyId` reverse-index. Returns the record (so the caller\n * can re-validate overlap if a packages-shaped patch is provided);\n * returns `null` when no proposal backs this buy.\n *\n * Per Resolutions §5: re-validates capability overlap on every call\n * with packages.\n *\n * @public\n */\nexport async function maybeHydrateRecipesForMediaBuyId<TRecipe extends Recipe>(args: {\n  mediaBuyId: string | undefined;\n  store: ProposalStore<TRecipe> | undefined;\n  ctx: { account: { id: string } };\n  packages?: ReadonlyArray<unknown>;\n}): Promise<ProposalRecord<TRecipe> | null> {\n  const { mediaBuyId, store, ctx, packages } = args;\n  if (!mediaBuyId || !store) return null;\n  const record = await store.getByMediaBuyId(mediaBuyId, {\n    expectedAccountId: ctx.account.id,\n  });\n  if (!record) return null;\n  if (packages && Array.isArray(packages) && packages.length > 0) {\n    validateCapabilityOverlap({\n      packages: packages as never,\n      recipes: record.recipes,\n    });\n  }\n  return record;\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../../../../src/lib/server/decisioning/proposal/dispatch.ts"],"sourcesContent":["/**\n * Proposal-dispatch — the v1.5 framework intercept seams.\n *\n * Pure functions that the runtime calls from the wire-handler shims\n * (`getProducts`, `createMediaBuy`, `updateMediaBuy`,\n * `getMediaBuyDelivery`). Each helper short-circuits when no manager /\n * store is wired for the request, so the v1 path is preserved\n * byte-for-byte.\n *\n * Five integration points (parity with `adcp-client-python.src/adcp/decisioning/proposal_dispatch.py`):\n *\n *   - {@link maybeInterceptFinalize} — `getProducts` shim. Detects\n *     `refine[i].action: 'finalize'`, calls the manager's\n *     `finalizeProposal`, commits the proposal, returns the wire\n *     response. Returns `null` when no finalize entry / no\n *     finalize-capable manager.\n *   - {@link maybePersistDraftAfterGetProducts} — `getProducts` shim\n *     (post-call). Walks the response's `proposals[]`, validates\n *     `overlap ⊆ wire`, persists each as a draft.\n *   - {@link maybeReserveProposalForCreateMediaBuy} — `createMediaBuy`\n *     shim. When `proposal_id` is set, validates expiry + capability\n *     overlap, reserves the proposal (`COMMITTED → CONSUMING`), returns\n *     the recipes map for `ctx.recipes` hydration.\n *   - {@link finalizeProposalConsumption} — `createMediaBuy` shim\n *     (post-success). Promotes `CONSUMING → CONSUMED` and records the\n *     `mediaBuyId` back-reference.\n *   - {@link releaseProposalReservation} — `createMediaBuy` shim\n *     (failure rollback). Restores `CONSUMING → COMMITTED`.\n *   - {@link maybeHydrateRecipesForMediaBuyId} —\n *     `updateMediaBuy` / `getMediaBuyDelivery` shims. Reverse-index\n *     hydration via `getByMediaBuyId`. Re-runs capability-overlap\n *     validation per Resolutions §5.\n *\n * @public\n * @packageDocumentation\n */\n\nimport { AdcpError, isTaskHandoff, type TaskHandoff } from '../async-outcome';\nimport type { Product, Proposal } from '../../../types/tools.generated';\nimport type { CanonicalGetProductsRequest } from '../../../v2/projection/creative-delivery';\nimport {\n  detectFinalizeAction,\n  enforceProposalExpiry,\n  logConsumed,\n  logDraftPersisted,\n  logFinalizeSucceeded,\n  validateCapabilityOverlap,\n  validateOverlapSubsetOfWire,\n} from './lifecycle';\nimport type { ProposalRecord, ProposalStore } from './store';\nimport type {\n  FinalizeProposalRequest,\n  FinalizeProposalSuccess,\n  ProposalGetProductsPayload,\n  ProposalManager,\n  Recipe,\n} from './types';\n\n// ---------------------------------------------------------------------------\n// Capability detection\n// ---------------------------------------------------------------------------\n\n/**\n * Per Resolutions §7: framework detects finalize via method-presence +\n * `capabilities.finalize` flag. Adopters opt in by both implementing\n * AND declaring; flipping only one half is an adopter bug.\n */\nfunction hasFinalizeCapability<TRecipe extends Recipe, TCtxMeta>(\n  manager: ProposalManager<TRecipe, TCtxMeta> | undefined\n): boolean {\n  if (!manager) return false;\n  if (!manager.capabilities.finalize) return false;\n  return typeof manager.finalizeProposal === 'function';\n}\n\n// ---------------------------------------------------------------------------\n// getProducts — finalize interception\n// ---------------------------------------------------------------------------\n\n/**\n * Result of {@link maybeInterceptFinalize}.\n *\n *   - `kind: 'intercepted'` — adopter's `finalizeProposal` was called.\n *     Caller threads `result` and `project` through the framework's\n *     standard `routeIfHandoff` so the projection callback fires\n *     synchronously for sync `FinalizeProposalSuccess` returns AND\n *     inside the background task for `TaskHandoff<FinalizeProposalSuccess>`\n *     returns. The projection commits the proposal store, emits the\n *     `proposal.finalized` log, and shapes the wire response.\n *   - `kind: 'pass'` — no finalize entry / no finalize-capable manager;\n *     caller continues with the standard `getProducts` dispatch.\n *\n * No special-case handling: finalize HITL inherits the framework's\n * task-lifecycle posture (cancellation, restart-via-durable-store,\n * deadline, webhook delivery) from `routeIfHandoff`, the same machinery\n * that drives `createMediaBuy` HITL and `syncCreatives` HITL.\n *\n * @public\n */\nexport type FinalizeInterceptResult<TRecipe extends Recipe = Recipe> =\n  | {\n      kind: 'intercepted';\n      result: FinalizeProposalSuccess<TRecipe> | TaskHandoff<FinalizeProposalSuccess<TRecipe>>;\n      project: (success: FinalizeProposalSuccess<TRecipe>) => Promise<ProposalGetProductsPayload>;\n    }\n  | { kind: 'pass' };\n\n/**\n * Intercept `buying_mode: 'refine'` requests carrying a\n * `refine[i].action: 'finalize'` entry. Hydrates the draft, calls the\n * manager's `finalizeProposal`, and returns the raw adopter result + a\n * projection callback. The runtime threads them through the framework's\n * standard `routeIfHandoff` so:\n *\n *   - Sync `FinalizeProposalSuccess` returns: projection runs inline,\n *     buyer sees the committed proposal in the response.\n *   - HITL `TaskHandoff<FinalizeProposalSuccess>` returns: framework\n *     returns the Submitted envelope to the buyer, runs the adopter's\n *     handoff fn in background; projection runs when the handoff\n *     resolves, commits the proposal, projects the terminal task\n *     artifact.\n *\n * Same machinery as `createMediaBuy` HITL — finalize inherits whatever\n * cancellation, restart-via-durable-store, deadline, and webhook\n * delivery semantics the framework's task lifecycle provides for every\n * other unified-hybrid tool. No special-case wrapper.\n *\n * @public\n */\nexport async function maybeInterceptFinalize<TRecipe extends Recipe, TCtxMeta>(args: {\n  request: CanonicalGetProductsRequest;\n  manager: ProposalManager<TRecipe, TCtxMeta> | undefined;\n  store: ProposalStore<TRecipe> | undefined;\n  ctx: { account: { id: string } } & Record<string, unknown>;\n}): Promise<FinalizeInterceptResult<TRecipe>> {\n  const { request, manager, store, ctx } = args;\n  const finalizeEntry = detectFinalizeAction(request);\n  if (!finalizeEntry) return { kind: 'pass' };\n  if (!hasFinalizeCapability(manager) || !store) return { kind: 'pass' };\n\n  const fieldPath = `refine[${finalizeEntry.index}].proposal_id`;\n  const accountId = ctx.account.id;\n  const record = await store.get(finalizeEntry.proposalId, { expectedAccountId: accountId });\n  if (!record) {\n    throw new AdcpError('PROPOSAL_NOT_FOUND', {\n      recovery: 'correctable',\n      message:\n        `Proposal ${JSON.stringify(finalizeEntry.proposalId)} not found. The buyer must call ` +\n        `get_products with buying_mode='brief' or 'refine' to obtain a draft proposal_id ` +\n        `before finalizing it.`,\n      field: fieldPath,\n    });\n  }\n  if (record.state !== 'draft') {\n    throw new AdcpError('PROPOSAL_NOT_COMMITTED', {\n      recovery: 'correctable',\n      message:\n        `Proposal ${JSON.stringify(finalizeEntry.proposalId)} is in state ` +\n        `${JSON.stringify(record.state)}; only draft proposals can be finalized. ` +\n        `Already-committed proposals should be accepted via create_media_buy(proposal_id=...) ` +\n        `directly.`,\n      field: fieldPath,\n    });\n  }\n\n  const finalizeReq: FinalizeProposalRequest<TRecipe> = {\n    proposalId: finalizeEntry.proposalId,\n    recipes: record.recipes,\n    proposalPayload: record.proposalPayload,\n    parentRequest: request,\n    ...(finalizeEntry.ask !== undefined && { ask: finalizeEntry.ask }),\n  };\n\n  // manager + finalizeProposal are non-undefined per hasFinalizeCapability.\n  const result = await manager!.finalizeProposal!(finalizeReq, ctx as never);\n  // Pre-determine the path label by checking whether the adopter\n  // returned a TaskHandoff up-front. `routeIfHandoff` runs `project`\n  // synchronously for the sync arm and inside the background task for\n  // the handoff arm; either way, we want the log to reflect which arm\n  // the adopter chose.\n  const path: 'inline' | 'handoff' = isTaskHandoff(result) ? 'handoff' : 'inline';\n  const finalizeProposalId = finalizeEntry.proposalId;\n\n  const project = async (success: FinalizeProposalSuccess<TRecipe>): Promise<ProposalGetProductsPayload> => {\n    if (!isFinalizeSuccess<TRecipe>(success)) {\n      throw new AdcpError('INTERNAL_ERROR', {\n        recovery: 'terminal',\n        message:\n          `finalizeProposal resolved to an unexpected shape; expected FinalizeProposalSuccess ` +\n          `with 'proposal' and 'expiresAt' fields.`,\n      });\n    }\n    await store.commit(finalizeProposalId, {\n      expiresAt: success.expiresAt,\n      proposalPayload: success.proposal,\n    });\n    logFinalizeSucceeded({\n      proposalId: finalizeProposalId,\n      accountId,\n      expiresAt: success.expiresAt,\n      path,\n    });\n    return projectFinalizeResponse({\n      request,\n      committedProposal: success.proposal,\n      finalizeProposalId,\n    });\n  };\n\n  return { kind: 'intercepted', result, project };\n}\n\nfunction isFinalizeSuccess<TRecipe extends Recipe>(v: unknown): v is FinalizeProposalSuccess<TRecipe> {\n  if (!v || typeof v !== 'object') return false;\n  const r = v as Record<string, unknown>;\n  return r.proposal != null && r.expiresAt instanceof Date;\n}\n\nfunction projectFinalizeResponse(args: {\n  request: CanonicalGetProductsRequest;\n  committedProposal: Record<string, unknown>;\n  finalizeProposalId: string;\n}): ProposalGetProductsPayload {\n  const refineEntries = (args.request as { refine?: ReadonlyArray<Record<string, unknown>> }).refine;\n  const refinementApplied: Array<Record<string, unknown>> = [];\n  if (refineEntries) {\n    for (const entry of refineEntries) {\n      const scope = entry.scope;\n      if (scope === 'proposal') {\n        refinementApplied.push({\n          scope: 'proposal',\n          proposal_id: typeof entry.proposal_id === 'string' ? entry.proposal_id : args.finalizeProposalId,\n          status: 'applied',\n        });\n      } else if (scope === 'product') {\n        refinementApplied.push({\n          scope: 'product',\n          product_id: typeof entry.product_id === 'string' ? entry.product_id : '',\n          status: 'applied',\n        });\n      } else {\n        refinementApplied.push({ scope: 'request', status: 'applied' });\n      }\n    }\n  }\n  // **Decision: `products: []` on the finalize response by design.** The\n  // committed proposal carries `allocations[]` keyed by `product_id`;\n  // the buyer either has the products from the prior `brief_with_proposals`\n  // step (the natural flow) or fetches by id. Echoing the products here\n  // would require the framework to either re-emit from the persisted\n  // draft (extra wire bytes the buyer already has) or call back into the\n  // adopter (extra round-trip to upstream). Buyers who explicitly want\n  // products on the finalize response can fetch them via a follow-up\n  // `get_products({ product_ids: [...] })` keyed off\n  // `proposals[0].allocations[].product_id`.\n  return {\n    cache_scope: 'account',\n    products: [],\n    proposals: [args.committedProposal as unknown as Proposal],\n    refinement_applied: refinementApplied,\n  } as unknown as ProposalGetProductsPayload;\n}\n\n// ---------------------------------------------------------------------------\n// getProducts / refineProducts — post-call draft persistence\n// ---------------------------------------------------------------------------\n\n/**\n * Persist proposals returned by `getProducts` / `refineProducts` as\n * drafts in the wired {@link ProposalStore}. Validates `overlap ⊆ wire`\n * for any returned recipes before persisting.\n *\n * Quietly returns when no store is wired, no `proposals[]` in the\n * response, or no typed recipes attached to products.\n *\n * @public\n */\nexport async function maybePersistDraftAfterGetProducts<TRecipe extends Recipe>(args: {\n  response: ProposalGetProductsPayload;\n  store: ProposalStore<TRecipe> | undefined;\n  ctx: { account: { id: string } };\n}): Promise<void> {\n  const { response, store, ctx } = args;\n  if (!store) return;\n  const proposals = (response as { proposals?: ReadonlyArray<Proposal> }).proposals;\n  if (!proposals || proposals.length === 0) return;\n  const products = (response as { products?: ReadonlyArray<Product> }).products ?? [];\n\n  for (const proposal of proposals) {\n    const proposalId = (proposal as { proposal_id?: string }).proposal_id;\n    if (!proposalId) continue;\n    const proposalPayload = toPlainObject(proposal);\n    const recipes = collectRecipesFromProducts<TRecipe>(products, proposalPayload);\n    if (recipes.size > 0) {\n      validateOverlapSubsetOfWire({ recipes, products });\n    }\n    await store.putDraft({\n      proposalId,\n      accountId: ctx.account.id,\n      recipes,\n      proposalPayload,\n    });\n    logDraftPersisted({\n      proposalId,\n      accountId: ctx.account.id,\n      recipesCount: recipes.size,\n    });\n  }\n}\n\nfunction collectRecipesFromProducts<TRecipe extends Recipe>(\n  products: readonly Product[],\n  proposalPayload: Record<string, unknown>\n): Map<string, TRecipe> {\n  // Filter to products referenced by the proposal's allocations[] (per\n  // spec) or legacy products[] string array when present.\n  let referenced: Set<string> | null = null;\n  const allocations = proposalPayload.allocations;\n  if (Array.isArray(allocations)) {\n    referenced = new Set(\n      allocations\n        .map((a: unknown) => (a as { product_id?: string }).product_id)\n        .filter((id): id is string => typeof id === 'string')\n    );\n  } else if (Array.isArray(proposalPayload.products)) {\n    referenced = new Set((proposalPayload.products as unknown[]).filter((p): p is string => typeof p === 'string'));\n  }\n\n  const recipes = new Map<string, TRecipe>();\n  for (const product of products) {\n    const productId = product.product_id;\n    if (!productId) continue;\n    if (referenced && !referenced.has(productId)) continue;\n    const implConfig = (product as { implementation_config?: unknown }).implementation_config;\n    if (isRecipe(implConfig)) {\n      recipes.set(productId, implConfig as TRecipe);\n    }\n  }\n  return recipes;\n}\n\nfunction isRecipe(v: unknown): boolean {\n  return v != null && typeof v === 'object' && typeof (v as { recipe_kind?: unknown }).recipe_kind === 'string';\n}\n\nfunction toPlainObject(v: unknown): Record<string, unknown> {\n  if (v == null || typeof v !== 'object') return {};\n  // Deep clone via JSON to drop class-instance prototypes — the stored\n  // payload must round-trip through a durable backing.\n  return JSON.parse(JSON.stringify(v)) as Record<string, unknown>;\n}\n\n// ---------------------------------------------------------------------------\n// createMediaBuy — recipe hydration on proposal_id\n// ---------------------------------------------------------------------------\n\n/**\n * Result of {@link maybeReserveProposalForCreateMediaBuy}.\n *\n *   - `record` — the reserved {@link ProposalRecord}. Caller threads\n *     `recipes` onto `ctx.recipes` and calls\n *     {@link finalizeProposalConsumption} on adapter success or\n *     {@link releaseProposalReservation} on failure.\n *   - `null` — request has no `proposal_id`, no store wired, or the\n *     framework didn't intercept (v1 path).\n *\n * @public\n */\nexport type ReservedProposal<TRecipe extends Recipe> = ProposalRecord<TRecipe>;\n\n/**\n * Reserve the proposal for consumption and hydrate `ctx.recipes`.\n *\n * Atomic CAS via {@link ProposalStore.tryReserveConsumption} — the\n * proposal transitions `COMMITTED → CONSUMING` before the adapter runs.\n * Two parallel `createMediaBuy(proposal_id=X)` calls cannot both\n * reserve; the loser raises `PROPOSAL_NOT_COMMITTED`.\n *\n * Validates per § D7 (expiry) BEFORE reserving — an expired proposal\n * surfaces `PROPOSAL_EXPIRED` without flipping the state.\n *\n * @public\n */\nexport async function maybeReserveProposalForCreateMediaBuy<TRecipe extends Recipe, TCtxMeta>(args: {\n  request: { proposal_id?: string; packages?: ReadonlyArray<unknown> } & Record<string, unknown>;\n  manager: ProposalManager<TRecipe, TCtxMeta> | undefined;\n  store: ProposalStore<TRecipe> | undefined;\n  ctx: { account: { id: string } };\n  now?: Date;\n}): Promise<ReservedProposal<TRecipe> | null> {\n  const { request, manager, store, ctx, now } = args;\n  const proposalId = request.proposal_id;\n  if (!proposalId || !store) return null;\n  const graceSeconds = manager?.capabilities.expiresAtGraceSeconds ?? 0;\n\n  // Expiry check BEFORE reserving — keep the buyer's slot uncommitted\n  // when telling them they're expired.\n  await enforceProposalExpiry(proposalId, {\n    proposalStore: store,\n    expectedAccountId: ctx.account.id,\n    graceSeconds,\n    ...(now && { now }),\n  });\n\n  const reserved = await store.tryReserveConsumption(proposalId, {\n    expectedAccountId: ctx.account.id,\n  });\n\n  // Capability-overlap gate per D4. Buyer's packages may be empty when\n  // proposal_id is set (the spec allows the seller to derive packages\n  // from allocations); skip the gate in that case.\n  const packages = request.packages;\n  if (packages && Array.isArray(packages) && packages.length > 0) {\n    validateCapabilityOverlap({\n      packages: packages as never,\n      recipes: reserved.recipes,\n    });\n  }\n\n  return reserved;\n}\n\n/**\n * Promote `CONSUMING → CONSUMED` after the adapter's `createMediaBuy`\n * succeeded.\n *\n * @public\n */\nexport async function finalizeProposalConsumption<TRecipe extends Recipe>(args: {\n  store: ProposalStore<TRecipe> | undefined;\n  record: ReservedProposal<TRecipe>;\n  mediaBuyId: string;\n}): Promise<void> {\n  const { store, record, mediaBuyId } = args;\n  if (!store) return;\n  await store.finalizeConsumption(record.proposalId, {\n    mediaBuyId,\n    expectedAccountId: record.accountId,\n  });\n  logConsumed({\n    proposalId: record.proposalId,\n    accountId: record.accountId,\n    mediaBuyId,\n  });\n}\n\n/**\n * Roll back the reservation: `CONSUMING → COMMITTED`. Best-effort.\n *\n * @public\n */\nexport async function releaseProposalReservation<TRecipe extends Recipe>(args: {\n  store: ProposalStore<TRecipe> | undefined;\n  record: ReservedProposal<TRecipe>;\n  logger?: { warn(message: string): void };\n}): Promise<void> {\n  const { store, record, logger } = args;\n  if (!store) return;\n  try {\n    await store.releaseConsumption(record.proposalId, {\n      expectedAccountId: record.accountId,\n    });\n  } catch (err) {\n    const message = err instanceof Error ? err.message : String(err);\n    logger?.warn(\n      `[adcp/decisioning] failed to release consumption reservation for proposal ` +\n        `${record.proposalId}: ${message}. The record may stay in CONSUMING until eviction.`\n    );\n  }\n}\n\n// ---------------------------------------------------------------------------\n// updateMediaBuy / getMediaBuyDelivery — reverse-index recipe hydration\n// ---------------------------------------------------------------------------\n\n/**\n * Hydrate `ctx.recipes` for post-acceptance buy operations via the\n * `getByMediaBuyId` reverse-index. Returns the record (so the caller\n * can re-validate overlap if a packages-shaped patch is provided);\n * returns `null` when no proposal backs this buy.\n *\n * Per Resolutions §5: re-validates capability overlap on every call\n * with packages.\n *\n * @public\n */\nexport async function maybeHydrateRecipesForMediaBuyId<TRecipe extends Recipe>(args: {\n  mediaBuyId: string | undefined;\n  store: ProposalStore<TRecipe> | undefined;\n  ctx: { account: { id: string } };\n  packages?: ReadonlyArray<unknown>;\n}): Promise<ProposalRecord<TRecipe> | null> {\n  const { mediaBuyId, store, ctx, packages } = args;\n  if (!mediaBuyId || !store) return null;\n  const record = await store.getByMediaBuyId(mediaBuyId, {\n    expectedAccountId: ctx.account.id,\n  });\n  if (!record) return null;\n  if (packages && Array.isArray(packages) && packages.length > 0) {\n    validateCapabilityOverlap({\n      packages: packages as never,\n      recipes: record.recipes,\n    });\n  }\n  return record;\n}\n"],"mappings":"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","names":[]}

package/dist/lib/server/decisioning/proposal/index.d.mts

@@ -8,7 +8,7 @@
  * @public
  * @packageDocumentation
  */
-export type { ProposalManager, ProposalCapabilities, ProposalSalesSpecialism, Recipe, CapabilityOverlap, FinalizeProposalRequest, FinalizeProposalSuccess, } from './types.mjs';
+export type { ProposalManager, ProposalCapabilities, ProposalSalesSpecialism, Recipe, CapabilityOverlap, FinalizeProposalRequest, FinalizeProposalSuccess, ProposalGetProductsPayload, LegacyProposalGetProductsPayload, } from './types.mjs';
 export { validateProposalCapabilities } from './types.mjs';
 export type { ProposalState, ProposalRecord, ProposalStore, InMemoryProposalStoreOptions } from './store.mjs';
 export { InMemoryProposalStore } from './store.mjs';

package/dist/lib/server/decisioning/proposal/index.d.ts

@@ -8,7 +8,7 @@
  * @public
  * @packageDocumentation
  */
-export type { ProposalManager, ProposalCapabilities, ProposalSalesSpecialism, Recipe, CapabilityOverlap, FinalizeProposalRequest, FinalizeProposalSuccess, } from './types';
+export type { ProposalManager, ProposalCapabilities, ProposalSalesSpecialism, Recipe, CapabilityOverlap, FinalizeProposalRequest, FinalizeProposalSuccess, ProposalGetProductsPayload, LegacyProposalGetProductsPayload, } from './types';
 export { validateProposalCapabilities } from './types';
 export type { ProposalState, ProposalRecord, ProposalStore, InMemoryProposalStoreOptions } from './store';
 export { InMemoryProposalStore } from './store';

package/dist/lib/server/decisioning/proposal/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/lib/server/decisioning/proposal/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,YAAY,EACV,eAAe,EACf,oBAAoB,EACpB,uBAAuB,EACvB,MAAM,EACN,iBAAiB,EACjB,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,4BAA4B,EAAE,MAAM,SAAS,CAAC;AAEvD,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,aAAa,EAAE,4BAA4B,EAAE,MAAM,SAAS,CAAC;AAE1G,OAAO,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAEhD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,YAAY,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AAEjE,OAAO,EACL,qBAAqB,EACrB,yBAAyB,EACzB,2BAA2B,EAC3B,oBAAoB,EACpB,0BAA0B,EAC1B,iBAAiB,EACjB,oBAAoB,EACpB,UAAU,EACV,WAAW,GACZ,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAE9E,OAAO,EACL,sBAAsB,EACtB,iCAAiC,EACjC,qCAAqC,EACrC,2BAA2B,EAC3B,0BAA0B,EAC1B,gCAAgC,GACjC,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/lib/server/decisioning/proposal/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,YAAY,EACV,eAAe,EACf,oBAAoB,EACpB,uBAAuB,EACvB,MAAM,EACN,iBAAiB,EACjB,uBAAuB,EACvB,uBAAuB,EACvB,0BAA0B,EAC1B,gCAAgC,GACjC,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,4BAA4B,EAAE,MAAM,SAAS,CAAC;AAEvD,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,aAAa,EAAE,4BAA4B,EAAE,MAAM,SAAS,CAAC;AAE1G,OAAO,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAEhD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,YAAY,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AAEjE,OAAO,EACL,qBAAqB,EACrB,yBAAyB,EACzB,2BAA2B,EAC3B,oBAAoB,EACpB,0BAA0B,EAC1B,iBAAiB,EACjB,oBAAoB,EACpB,UAAU,EACV,WAAW,GACZ,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAE9E,OAAO,EACL,sBAAsB,EACtB,iCAAiC,EACjC,qCAAqC,EACrC,2BAA2B,EAC3B,0BAA0B,EAC1B,gCAAgC,GACjC,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC"}

package/dist/lib/server/decisioning/proposal/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../src/lib/server/decisioning/proposal/index.ts"],"sourcesContent":["/**\n * ProposalManager — primitives for the two-platform composition.\n *\n * Splits proposal assembly (`get_products`, refine, finalize) from media-buy\n * execution (`create_media_buy`, lifecycle), mirroring `adcp-client-python`'s\n * v1.5 ProposalManager. Either side can be mock-backed independently.\n *\n * @public\n * @packageDocumentation\n */\n\nexport type {\n  ProposalManager,\n  ProposalCapabilities,\n  ProposalSalesSpecialism,\n  Recipe,\n  CapabilityOverlap,\n  FinalizeProposalRequest,\n  FinalizeProposalSuccess,\n} from './types';\n\nexport { validateProposalCapabilities } from './types';\n\nexport type { ProposalState, ProposalRecord, ProposalStore, InMemoryProposalStoreOptions } from './store';\n\nexport { InMemoryProposalStore } from './store';\n\nexport { MockProposalManager } from './mock-manager';\nexport type { MockProposalManagerOptions } from './mock-manager';\n\nexport {\n  enforceProposalExpiry,\n  validateCapabilityOverlap,\n  validateOverlapSubsetOfWire,\n  detectFinalizeAction,\n  setProposalLifecycleLogger,\n  logDraftPersisted,\n  logFinalizeSucceeded,\n  logExpired,\n  logConsumed,\n} from './lifecycle';\nexport type { FinalizeActionRef, ProposalLifecycleLogger } from './lifecycle';\n\nexport {\n  maybeInterceptFinalize,\n  maybePersistDraftAfterGetProducts,\n  maybeReserveProposalForCreateMediaBuy,\n  finalizeProposalConsumption,\n  releaseProposalReservation,\n  maybeHydrateRecipesForMediaBuyId,\n} from './dispatch';\nexport type { FinalizeInterceptResult, ReservedProposal } from './dispatch';\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAqBA,mBAA6C;AAI7C,mBAAsC;AAEtC,0BAAoC;AAGpC,uBAUO;AAGP,sBAOO;","names":[]}
+{"version":3,"sources":["../../../../../src/lib/server/decisioning/proposal/index.ts"],"sourcesContent":["/**\n * ProposalManager — primitives for the two-platform composition.\n *\n * Splits proposal assembly (`get_products`, refine, finalize) from media-buy\n * execution (`create_media_buy`, lifecycle), mirroring `adcp-client-python`'s\n * v1.5 ProposalManager. Either side can be mock-backed independently.\n *\n * @public\n * @packageDocumentation\n */\n\nexport type {\n  ProposalManager,\n  ProposalCapabilities,\n  ProposalSalesSpecialism,\n  Recipe,\n  CapabilityOverlap,\n  FinalizeProposalRequest,\n  FinalizeProposalSuccess,\n  ProposalGetProductsPayload,\n  LegacyProposalGetProductsPayload,\n} from './types';\n\nexport { validateProposalCapabilities } from './types';\n\nexport type { ProposalState, ProposalRecord, ProposalStore, InMemoryProposalStoreOptions } from './store';\n\nexport { InMemoryProposalStore } from './store';\n\nexport { MockProposalManager } from './mock-manager';\nexport type { MockProposalManagerOptions } from './mock-manager';\n\nexport {\n  enforceProposalExpiry,\n  validateCapabilityOverlap,\n  validateOverlapSubsetOfWire,\n  detectFinalizeAction,\n  setProposalLifecycleLogger,\n  logDraftPersisted,\n  logFinalizeSucceeded,\n  logExpired,\n  logConsumed,\n} from './lifecycle';\nexport type { FinalizeActionRef, ProposalLifecycleLogger } from './lifecycle';\n\nexport {\n  maybeInterceptFinalize,\n  maybePersistDraftAfterGetProducts,\n  maybeReserveProposalForCreateMediaBuy,\n  finalizeProposalConsumption,\n  releaseProposalReservation,\n  maybeHydrateRecipesForMediaBuyId,\n} from './dispatch';\nexport type { FinalizeInterceptResult, ReservedProposal } from './dispatch';\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAuBA,mBAA6C;AAI7C,mBAAsC;AAEtC,0BAAoC;AAGpC,uBAUO;AAGP,sBAOO;","names":[]}

package/dist/lib/server/decisioning/proposal/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../src/lib/server/decisioning/proposal/index.ts"],"sourcesContent":["/**\n * ProposalManager — primitives for the two-platform composition.\n *\n * Splits proposal assembly (`get_products`, refine, finalize) from media-buy\n * execution (`create_media_buy`, lifecycle), mirroring `adcp-client-python`'s\n * v1.5 ProposalManager. Either side can be mock-backed independently.\n *\n * @public\n * @packageDocumentation\n */\n\nexport type {\n  ProposalManager,\n  ProposalCapabilities,\n  ProposalSalesSpecialism,\n  Recipe,\n  CapabilityOverlap,\n  FinalizeProposalRequest,\n  FinalizeProposalSuccess,\n} from './types';\n\nexport { validateProposalCapabilities } from './types';\n\nexport type { ProposalState, ProposalRecord, ProposalStore, InMemoryProposalStoreOptions } from './store';\n\nexport { InMemoryProposalStore } from './store';\n\nexport { MockProposalManager } from './mock-manager';\nexport type { MockProposalManagerOptions } from './mock-manager';\n\nexport {\n  enforceProposalExpiry,\n  validateCapabilityOverlap,\n  validateOverlapSubsetOfWire,\n  detectFinalizeAction,\n  setProposalLifecycleLogger,\n  logDraftPersisted,\n  logFinalizeSucceeded,\n  logExpired,\n  logConsumed,\n} from './lifecycle';\nexport type { FinalizeActionRef, ProposalLifecycleLogger } from './lifecycle';\n\nexport {\n  maybeInterceptFinalize,\n  maybePersistDraftAfterGetProducts,\n  maybeReserveProposalForCreateMediaBuy,\n  finalizeProposalConsumption,\n  releaseProposalReservation,\n  maybeHydrateRecipesForMediaBuyId,\n} from './dispatch';\nexport type { FinalizeInterceptResult, ReservedProposal } from './dispatch';\n"],"mappings":"AAqBA,SAAS,oCAAoC;AAI7C,SAAS,6BAA6B;AAEtC,SAAS,2BAA2B;AAGpC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAGP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;","names":[]}
+{"version":3,"sources":["../../../../../src/lib/server/decisioning/proposal/index.ts"],"sourcesContent":["/**\n * ProposalManager — primitives for the two-platform composition.\n *\n * Splits proposal assembly (`get_products`, refine, finalize) from media-buy\n * execution (`create_media_buy`, lifecycle), mirroring `adcp-client-python`'s\n * v1.5 ProposalManager. Either side can be mock-backed independently.\n *\n * @public\n * @packageDocumentation\n */\n\nexport type {\n  ProposalManager,\n  ProposalCapabilities,\n  ProposalSalesSpecialism,\n  Recipe,\n  CapabilityOverlap,\n  FinalizeProposalRequest,\n  FinalizeProposalSuccess,\n  ProposalGetProductsPayload,\n  LegacyProposalGetProductsPayload,\n} from './types';\n\nexport { validateProposalCapabilities } from './types';\n\nexport type { ProposalState, ProposalRecord, ProposalStore, InMemoryProposalStoreOptions } from './store';\n\nexport { InMemoryProposalStore } from './store';\n\nexport { MockProposalManager } from './mock-manager';\nexport type { MockProposalManagerOptions } from './mock-manager';\n\nexport {\n  enforceProposalExpiry,\n  validateCapabilityOverlap,\n  validateOverlapSubsetOfWire,\n  detectFinalizeAction,\n  setProposalLifecycleLogger,\n  logDraftPersisted,\n  logFinalizeSucceeded,\n  logExpired,\n  logConsumed,\n} from './lifecycle';\nexport type { FinalizeActionRef, ProposalLifecycleLogger } from './lifecycle';\n\nexport {\n  maybeInterceptFinalize,\n  maybePersistDraftAfterGetProducts,\n  maybeReserveProposalForCreateMediaBuy,\n  finalizeProposalConsumption,\n  releaseProposalReservation,\n  maybeHydrateRecipesForMediaBuyId,\n} from './dispatch';\nexport type { FinalizeInterceptResult, ReservedProposal } from './dispatch';\n"],"mappings":"AAuBA,SAAS,oCAAoC;AAI7C,SAAS,6BAA6B;AAEtC,SAAS,2BAA2B;AAGpC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAGP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;","names":[]}

package/dist/lib/server/decisioning/proposal/lifecycle.d.mts

@@ -26,7 +26,8 @@
  * @public
  * @packageDocumentation
  */
-import type { GetProductsRequest, Product } from '../../../types/tools.generated.mjs';
+import type { Product } from '../../../types/tools.generated.mjs';
+import type { CanonicalGetProductsRequest } from '../../../v2/projection/creative-delivery.mjs';
 import type { ProposalRecord, ProposalStore } from './store.mjs';
 import type { Recipe } from './types.mjs';
 /**
@@ -140,7 +141,7 @@ export interface FinalizeActionRef {
  *
  * @public
  */
-export declare function detectFinalizeAction(req: GetProductsRequest): FinalizeActionRef | null;
+export declare function detectFinalizeAction(req: CanonicalGetProductsRequest): FinalizeActionRef | null;
 /**
  * Logger-shaped sink for structured proposal-lifecycle events. Defaults to
  * `console.info`-style emission; the dispatch path can pass a typed logger

package/dist/lib/server/decisioning/proposal/lifecycle.d.ts

@@ -26,7 +26,8 @@
  * @public
  * @packageDocumentation
  */
-import type { GetProductsRequest, Product } from '../../../types/tools.generated';
+import type { Product } from '../../../types/tools.generated';
+import type { CanonicalGetProductsRequest } from '../../../v2/projection/creative-delivery';
 import type { ProposalRecord, ProposalStore } from './store';
 import type { Recipe } from './types';
 /**
@@ -140,7 +141,7 @@ export interface FinalizeActionRef {
  *
  * @public
  */
-export declare function detectFinalizeAction(req: GetProductsRequest): FinalizeActionRef | null;
+export declare function detectFinalizeAction(req: CanonicalGetProductsRequest): FinalizeActionRef | null;
 /**
  * Logger-shaped sink for structured proposal-lifecycle events. Defaults to
  * `console.info`-style emission; the dispatch path can pass a typed logger

package/dist/lib/server/decisioning/proposal/lifecycle.d.ts.map

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

package/dist/lib/server/decisioning/proposal/lifecycle.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../src/lib/server/decisioning/proposal/lifecycle.ts"],"sourcesContent":["/**\n * Proposal-lifecycle framework helpers — the v1.5 intercept seam.\n *\n * Sits parallel to existing dispatch helpers in `runtime/from-platform.ts`.\n * Framework intercepts at a seam, does its work, dispatches.\n *\n * Public surface (the dispatch path imports these):\n *\n *   - {@link enforceProposalExpiry} — D7. Look up the committed proposal,\n *     validate `state === 'committed'` and `now <= expires_at + grace`,\n *     return the record.\n *   - {@link validateCapabilityOverlap} — D4. Walk a buyer's\n *     `create_media_buy` / `update_media_buy` request packages against\n *     each recipe's `capability_overlap` and reject mismatches with\n *     `INVALID_REQUEST`.\n *   - {@link validateOverlapSubsetOfWire} — D4 round-4. Validate at\n *     `putDraft` time that each recipe's `capability_overlap` axis is a\n *     subset of the corresponding wire-declared product capabilities.\n *     Mismatches throw `INTERNAL_ERROR` (adopter bug, not buyer bug).\n *   - {@link detectFinalizeAction} — pull out the first finalize-action\n *     refine entry from a `GetProductsRequest`.\n *   - structured-log helpers per § Observability.\n *\n * Ports `adcp-client-python.src/adcp/decisioning/proposal_lifecycle.py`.\n *\n * @public\n * @packageDocumentation\n */\n\nimport { AdcpError } from '../async-outcome';\nimport type { GetProductsRequest, Product } from '../../../types/tools.generated';\nimport type { ProposalRecord, ProposalStore } from './store';\nimport type { Recipe } from './types';\n\n// ---------------------------------------------------------------------------\n// D7 — expires_at enforcement\n// ---------------------------------------------------------------------------\n\n/**\n * Validate a proposal is committed and within its hold window.\n *\n * Three failure modes mapped to spec error codes:\n *\n *   - Record not found OR cross-tenant → `PROPOSAL_NOT_FOUND` (correctable).\n *     Cross-tenant probes return the same error as missing IDs (no\n *     principal-enumeration via id probing).\n *   - State !== `'committed'` → `PROPOSAL_NOT_COMMITTED` (correctable).\n *     The buyer needs to call `getProducts({ buying_mode: 'refine',\n *     refine: [{ action: 'finalize' }] })` first.\n *   - Committed but `now > expires_at + grace` → `PROPOSAL_EXPIRED`\n *     (correctable per AdCP 3.0.6 — the buyer re-discovers via\n *     `get_products` to obtain a fresh proposal).\n *\n * @public\n */\nexport async function enforceProposalExpiry<TRecipe extends Recipe>(\n  proposalId: string,\n  args: {\n    proposalStore: ProposalStore<TRecipe>;\n    expectedAccountId: string;\n    graceSeconds?: number;\n    now?: Date;\n  }\n): Promise<ProposalRecord<TRecipe>> {\n  const { proposalStore, expectedAccountId, graceSeconds = 0, now } = args;\n  const record = await proposalStore.get(proposalId, { expectedAccountId });\n  if (!record) {\n    throw new AdcpError('PROPOSAL_NOT_FOUND', {\n      recovery: 'correctable',\n      message:\n        `Proposal ${JSON.stringify(proposalId)} not found. The buyer must call get_products ` +\n        `with buying_mode='refine' and refine=[{action:'finalize',...}] to obtain a ` +\n        `committed proposal_id before referencing it on create_media_buy.`,\n      field: 'proposal_id',\n    });\n  }\n  if (record.state !== 'committed') {\n    throw new AdcpError('PROPOSAL_NOT_COMMITTED', {\n      recovery: 'correctable',\n      message:\n        `Proposal ${JSON.stringify(proposalId)} is in state ${JSON.stringify(record.state)}; ` +\n        `only committed proposals can be accepted via create_media_buy. Call get_products ` +\n        `with buying_mode='refine' and action='finalize' first.`,\n      field: 'proposal_id',\n    });\n  }\n  if (record.expiresAt) {\n    const current = now ?? new Date();\n    const deadline = record.expiresAt.getTime() + graceSeconds * 1000;\n    if (current.getTime() > deadline) {\n      logExpired({\n        proposalId,\n        accountId: record.accountId,\n        now: current,\n        expiresAt: record.expiresAt,\n        graceSeconds,\n      });\n      throw new AdcpError('PROPOSAL_EXPIRED', {\n        // Per AdCP 3.0.6 schemas/cache/3.0.6/enums/error-code.json,\n        // PROPOSAL_EXPIRED is `correctable` — the buyer re-discovers\n        // via `get_products` to obtain a fresh proposal (the hold\n        // window has lapsed but the buyer can re-request).\n        recovery: 'correctable',\n        message:\n          `Proposal ${JSON.stringify(proposalId)} expired at ${record.expiresAt.toISOString()}; ` +\n          `create_media_buy must be called within the inventory hold window. Call get_products ` +\n          `with buying_mode='refine' and action='finalize' to request a fresh hold.`,\n        field: 'proposal_id',\n      });\n    }\n  }\n  return record;\n}\n\n// ---------------------------------------------------------------------------\n// D4 — capability-overlap validation\n// ---------------------------------------------------------------------------\n\ninterface PackageLike {\n  product_id?: string;\n  pricing_option_id?: string;\n  pricing_model?: string;\n  delivery_type?: string;\n  signal_type?: string;\n  targeting_overlay?: Record<string, unknown>;\n  /**\n   * Adopter-resolved pricing model — the validation reads this when\n   * present. Set by the framework when it has resolved\n   * `pricing_option_id` against the product's pricing options.\n   */\n  _resolved_pricing_model?: string;\n  _resolved_delivery_type?: string;\n  [k: string]: unknown;\n}\n\n/**\n * Pre-adapter validation seam: walk buyer's packages against each recipe's\n * `capability_overlap` and reject mismatches.\n *\n * Called from the framework's `create_media_buy` and `update_media_buy`\n * dispatch paths after recipes are hydrated from the {@link ProposalStore}.\n * Per D4, the framework owns this gate so every adopter doesn't write the\n * same intersection logic.\n *\n * Validation axes (per {@link CapabilityOverlap}):\n *\n *   - `pricingModels` — checked against `package._resolved_pricing_model`\n *     or `package.pricing_model`.\n *   - `targetingDimensions` — checked against `package.targeting_overlay` keys.\n *   - `deliveryTypes` — checked against `package._resolved_delivery_type`\n *     or `package.delivery_type`.\n *   - `signalTypes` — checked against `package.signal_type`.\n *\n * Per the design's undefined-vs-empty-set semantics: `undefined` skips the\n * gate; an explicit `Set` (including the empty set) is enforced.\n *\n * @public\n */\nexport function validateCapabilityOverlap<TRecipe extends Recipe>(args: {\n  packages: readonly PackageLike[];\n  recipes: ReadonlyMap<string, TRecipe>;\n  fieldPathPrefix?: string;\n}): void {\n  const { packages, recipes, fieldPathPrefix = 'packages' } = args;\n  for (let i = 0; i < packages.length; i++) {\n    const pkg = packages[i]!;\n    const productId = pkg.product_id;\n    if (!productId) continue;\n    const recipe = recipes.get(productId);\n    if (!recipe || !recipe.capability_overlap) continue;\n    const overlap = recipe.capability_overlap;\n\n    if (overlap.pricingModels) {\n      const requested = pkg._resolved_pricing_model ?? pkg.pricing_model;\n      if (requested !== undefined && !overlap.pricingModels.has(String(requested))) {\n        throw new AdcpError('INVALID_REQUEST', {\n          recovery: 'terminal',\n          message:\n            `Buyer requested pricing_model=${JSON.stringify(requested)} on package ` +\n            `${JSON.stringify(productId)}, but this product's recipe declares ` +\n            `capability_overlap.pricingModels=${JSON.stringify([...overlap.pricingModels].sort())}. ` +\n            `The seller did not enable that pricing model for this product.`,\n          field: `${fieldPathPrefix}[${i}].pricing_option_id`,\n        });\n      }\n    }\n\n    if (overlap.targetingDimensions) {\n      const overlay = pkg.targeting_overlay;\n      const keys = overlay && typeof overlay === 'object' ? Object.keys(overlay) : [];\n      const disallowed = keys.filter(k => !overlap.targetingDimensions!.has(k));\n      if (disallowed.length > 0) {\n        throw new AdcpError('INVALID_REQUEST', {\n          recovery: 'terminal',\n          message:\n            `Buyer requested targeting dimensions ${JSON.stringify(disallowed.sort())} on ` +\n            `package ${JSON.stringify(productId)}, but this product's recipe declares ` +\n            `capability_overlap.targetingDimensions=` +\n            `${JSON.stringify([...overlap.targetingDimensions].sort())}. The seller did not ` +\n            `enable those targeting dimensions for this product.`,\n          field: `${fieldPathPrefix}[${i}].targeting_overlay`,\n        });\n      }\n    }\n\n    if (overlap.deliveryTypes) {\n      const delivery = pkg._resolved_delivery_type ?? pkg.delivery_type;\n      if (delivery !== undefined && !overlap.deliveryTypes.has(String(delivery))) {\n        throw new AdcpError('INVALID_REQUEST', {\n          recovery: 'terminal',\n          message:\n            `Buyer requested delivery_type=${JSON.stringify(delivery)} on package ` +\n            `${JSON.stringify(productId)}, but this product's recipe declares ` +\n            `capability_overlap.deliveryTypes=${JSON.stringify([...overlap.deliveryTypes].sort())}.`,\n          field: `${fieldPathPrefix}[${i}].delivery_type`,\n        });\n      }\n    }\n\n    if (overlap.signalTypes) {\n      const signalType = pkg.signal_type;\n      if (signalType !== undefined && !overlap.signalTypes.has(String(signalType))) {\n        throw new AdcpError('INVALID_REQUEST', {\n          recovery: 'terminal',\n          message:\n            `Buyer requested signal_type=${JSON.stringify(signalType)} on package ` +\n            `${JSON.stringify(productId)}, but this product's recipe declares ` +\n            `capability_overlap.signalTypes=${JSON.stringify([...overlap.signalTypes].sort())}.`,\n          field: `${fieldPathPrefix}[${i}].signal_type`,\n        });\n      }\n    }\n  }\n}\n\n/**\n * Validate `recipe.capability_overlap` is a subset of the matching product's\n * wire-declared capabilities.\n *\n * Called at `putDraft` time. Mismatches throw `INTERNAL_ERROR` — this is\n * an adopter bug (the manager declared an overlap claiming capabilities the\n * wire shape doesn't advertise), not a buyer bug.\n *\n * @public\n */\nexport function validateOverlapSubsetOfWire<TRecipe extends Recipe>(args: {\n  recipes: ReadonlyMap<string, TRecipe>;\n  products: readonly Product[];\n}): void {\n  const productsById = new Map<string, Product>();\n  for (const p of args.products) {\n    if (p.product_id) productsById.set(p.product_id, p);\n  }\n  for (const [productId, recipe] of args.recipes) {\n    if (!recipe.capability_overlap) continue;\n    const product = productsById.get(productId);\n    if (!product) continue; // missing-product is caught elsewhere\n    const overlap = recipe.capability_overlap;\n\n    if (overlap.pricingModels) {\n      const wirePricing = wirePricingModels(product);\n      const extras = [...overlap.pricingModels].filter(p => !wirePricing.has(p));\n      if (extras.length > 0) {\n        throw new AdcpError('INTERNAL_ERROR', {\n          recovery: 'terminal',\n          message:\n            `Recipe for product ${JSON.stringify(productId)} declares ` +\n            `capability_overlap.pricingModels=${JSON.stringify([...overlap.pricingModels].sort())} ` +\n            `including ${JSON.stringify(extras.sort())}, but the wire product only advertises ` +\n            `${JSON.stringify([...wirePricing].sort())}. The recipe's overlap must be a subset ` +\n            `of the wire-declared capabilities; adopter declaration is inconsistent with the ` +\n            `product shape.`,\n        });\n      }\n    }\n\n    if (overlap.deliveryTypes) {\n      const wireDelivery = wireDeliveryTypes(product);\n      const extras = [...overlap.deliveryTypes].filter(p => !wireDelivery.has(p));\n      // Only enforce when the wire declares something — products lacking a\n      // delivery_type field shouldn't trip the gate.\n      if (extras.length > 0 && wireDelivery.size > 0) {\n        throw new AdcpError('INTERNAL_ERROR', {\n          recovery: 'terminal',\n          message:\n            `Recipe for product ${JSON.stringify(productId)} declares ` +\n            `capability_overlap.deliveryTypes=${JSON.stringify([...overlap.deliveryTypes].sort())} ` +\n            `including ${JSON.stringify(extras.sort())}, but the wire product only advertises ` +\n            `${JSON.stringify([...wireDelivery].sort())}.`,\n        });\n      }\n    }\n  }\n}\n\nfunction wirePricingModels(product: Product): Set<string> {\n  const out = new Set<string>();\n  const pricing = (product as { pricing_options?: ReadonlyArray<{ pricing_model?: string }> }).pricing_options;\n  if (!pricing) return out;\n  for (const opt of pricing) {\n    if (opt.pricing_model) out.add(String(opt.pricing_model));\n  }\n  return out;\n}\n\nfunction wireDeliveryTypes(product: Product): Set<string> {\n  const dt = (product as { delivery_type?: string }).delivery_type;\n  return dt ? new Set([String(dt)]) : new Set();\n}\n\n// ---------------------------------------------------------------------------\n// Finalize action detection\n// ---------------------------------------------------------------------------\n\n/**\n * Result of {@link detectFinalizeAction}: the index, proposal_id, and\n * optional ask of the first finalize-action refine entry.\n *\n * @public\n */\nexport interface FinalizeActionRef {\n  index: number;\n  proposalId: string;\n  ask?: string;\n}\n\n/**\n * Return the first finalize-action refine entry from a\n * `GetProductsRequest`, or `null` if no finalize entry exists.\n *\n * The index points at the entry's position in `refine[]` so the framework\n * can produce indexed wire field paths (`refine[3].proposal_id`) on\n * rejection — buyers parsing the error get a precise pointer.\n *\n * Per the spec, `buying_mode: 'refine'` carries a `refine[]` array of\n * entries. Each entry has a `scope` (`request` / `product` / `proposal`)\n * and an optional `action` (`include` / `omit` / `finalize`). v1.5 only\n * intercepts `proposal`-scoped entries with `action: 'finalize'`.\n *\n * The framework processes ONE finalize entry per request; if the buyer\n * sends multiple finalize entries, only the first is processed (rest fall\n * through to the standard refine path).\n *\n * @public\n */\nexport function detectFinalizeAction(req: GetProductsRequest): FinalizeActionRef | null {\n  const refine = (req as { refine?: ReadonlyArray<Record<string, unknown>> }).refine;\n  if (!refine || refine.length === 0) return null;\n  for (let index = 0; index < refine.length; index++) {\n    const entry = refine[index]!;\n    if (entry.scope === 'proposal' && entry.action === 'finalize') {\n      const proposalId = entry.proposal_id;\n      if (typeof proposalId === 'string' && proposalId.length > 0) {\n        const ask = typeof entry.ask === 'string' ? entry.ask : undefined;\n        return ask !== undefined ? { index, proposalId, ask } : { index, proposalId };\n      }\n    }\n  }\n  return null;\n}\n\n// ---------------------------------------------------------------------------\n// Structured logging — § Observability\n// ---------------------------------------------------------------------------\n\n/**\n * Logger-shaped sink for structured proposal-lifecycle events. Defaults to\n * `console.info`-style emission; the dispatch path can pass a typed logger\n * to route through the rest of the framework's logging.\n *\n * @public\n */\nexport interface ProposalLifecycleLogger {\n  info(message: string, fields?: Record<string, unknown>): void;\n}\n\nlet logger: ProposalLifecycleLogger = {\n  info: (message, fields) => {\n    if (fields) {\n      console.log(JSON.stringify({ message, ...fields }));\n    } else {\n      console.log(message);\n    }\n  },\n};\n\n/**\n * Replace the module-level logger that proposal-lifecycle structured\n * events (`proposal.draft_persisted`, `proposal.finalized`, `proposal.expired`,\n * `proposal.consumed`) emit through. Adopters wire this to their existing\n * logger (pino, bunyan, etc.) so lifecycle events route through the same\n * pipeline as the rest of their server logs. Tests use it to capture\n * structured emissions for assertion.\n *\n * @public\n */\nexport function setProposalLifecycleLogger(next: ProposalLifecycleLogger): void {\n  logger = next;\n}\n\n/** `proposal.draft_persisted` event. */\nexport function logDraftPersisted(args: { proposalId: string; accountId: string; recipesCount: number }): void {\n  logger.info('proposal.draft_persisted', {\n    event: 'proposal.draft_persisted',\n    proposal_id: args.proposalId,\n    account_id: args.accountId,\n    recipes_count: args.recipesCount,\n  });\n}\n\n/**\n * `proposal.finalized` event. `path` is `'inline'` or `'handoff'`.\n */\nexport function logFinalizeSucceeded(args: {\n  proposalId: string;\n  accountId: string;\n  expiresAt: Date;\n  path: 'inline' | 'handoff';\n}): void {\n  logger.info('proposal.finalized', {\n    event: 'proposal.finalized',\n    proposal_id: args.proposalId,\n    account_id: args.accountId,\n    expires_at: args.expiresAt.toISOString(),\n    path: args.path,\n  });\n}\n\n/** `proposal.expired` event. */\nexport function logExpired(args: {\n  proposalId: string;\n  accountId: string;\n  now: Date;\n  expiresAt: Date;\n  graceSeconds: number;\n}): void {\n  logger.info('proposal.expired', {\n    event: 'proposal.expired',\n    proposal_id: args.proposalId,\n    account_id: args.accountId,\n    now: args.now.toISOString(),\n    expires_at: args.expiresAt.toISOString(),\n    grace_seconds: args.graceSeconds,\n  });\n}\n\n/** `proposal.consumed` event. */\nexport function logConsumed(args: { proposalId: string; accountId: string; mediaBuyId: string }): void {\n  logger.info('proposal.consumed', {\n    event: 'proposal.consumed',\n    proposal_id: args.proposalId,\n    account_id: args.accountId,\n    media_buy_id: args.mediaBuyId,\n  });\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../../../../src/lib/server/decisioning/proposal/lifecycle.ts"],"sourcesContent":["/**\n * Proposal-lifecycle framework helpers — the v1.5 intercept seam.\n *\n * Sits parallel to existing dispatch helpers in `runtime/from-platform.ts`.\n * Framework intercepts at a seam, does its work, dispatches.\n *\n * Public surface (the dispatch path imports these):\n *\n *   - {@link enforceProposalExpiry} — D7. Look up the committed proposal,\n *     validate `state === 'committed'` and `now <= expires_at + grace`,\n *     return the record.\n *   - {@link validateCapabilityOverlap} — D4. Walk a buyer's\n *     `create_media_buy` / `update_media_buy` request packages against\n *     each recipe's `capability_overlap` and reject mismatches with\n *     `INVALID_REQUEST`.\n *   - {@link validateOverlapSubsetOfWire} — D4 round-4. Validate at\n *     `putDraft` time that each recipe's `capability_overlap` axis is a\n *     subset of the corresponding wire-declared product capabilities.\n *     Mismatches throw `INTERNAL_ERROR` (adopter bug, not buyer bug).\n *   - {@link detectFinalizeAction} — pull out the first finalize-action\n *     refine entry from a `GetProductsRequest`.\n *   - structured-log helpers per § Observability.\n *\n * Ports `adcp-client-python.src/adcp/decisioning/proposal_lifecycle.py`.\n *\n * @public\n * @packageDocumentation\n */\n\nimport { AdcpError } from '../async-outcome';\nimport type { Product } from '../../../types/tools.generated';\nimport type { CanonicalGetProductsRequest } from '../../../v2/projection/creative-delivery';\nimport type { ProposalRecord, ProposalStore } from './store';\nimport type { Recipe } from './types';\n\n// ---------------------------------------------------------------------------\n// D7 — expires_at enforcement\n// ---------------------------------------------------------------------------\n\n/**\n * Validate a proposal is committed and within its hold window.\n *\n * Three failure modes mapped to spec error codes:\n *\n *   - Record not found OR cross-tenant → `PROPOSAL_NOT_FOUND` (correctable).\n *     Cross-tenant probes return the same error as missing IDs (no\n *     principal-enumeration via id probing).\n *   - State !== `'committed'` → `PROPOSAL_NOT_COMMITTED` (correctable).\n *     The buyer needs to call `getProducts({ buying_mode: 'refine',\n *     refine: [{ action: 'finalize' }] })` first.\n *   - Committed but `now > expires_at + grace` → `PROPOSAL_EXPIRED`\n *     (correctable per AdCP 3.0.6 — the buyer re-discovers via\n *     `get_products` to obtain a fresh proposal).\n *\n * @public\n */\nexport async function enforceProposalExpiry<TRecipe extends Recipe>(\n  proposalId: string,\n  args: {\n    proposalStore: ProposalStore<TRecipe>;\n    expectedAccountId: string;\n    graceSeconds?: number;\n    now?: Date;\n  }\n): Promise<ProposalRecord<TRecipe>> {\n  const { proposalStore, expectedAccountId, graceSeconds = 0, now } = args;\n  const record = await proposalStore.get(proposalId, { expectedAccountId });\n  if (!record) {\n    throw new AdcpError('PROPOSAL_NOT_FOUND', {\n      recovery: 'correctable',\n      message:\n        `Proposal ${JSON.stringify(proposalId)} not found. The buyer must call get_products ` +\n        `with buying_mode='refine' and refine=[{action:'finalize',...}] to obtain a ` +\n        `committed proposal_id before referencing it on create_media_buy.`,\n      field: 'proposal_id',\n    });\n  }\n  if (record.state !== 'committed') {\n    throw new AdcpError('PROPOSAL_NOT_COMMITTED', {\n      recovery: 'correctable',\n      message:\n        `Proposal ${JSON.stringify(proposalId)} is in state ${JSON.stringify(record.state)}; ` +\n        `only committed proposals can be accepted via create_media_buy. Call get_products ` +\n        `with buying_mode='refine' and action='finalize' first.`,\n      field: 'proposal_id',\n    });\n  }\n  if (record.expiresAt) {\n    const current = now ?? new Date();\n    const deadline = record.expiresAt.getTime() + graceSeconds * 1000;\n    if (current.getTime() > deadline) {\n      logExpired({\n        proposalId,\n        accountId: record.accountId,\n        now: current,\n        expiresAt: record.expiresAt,\n        graceSeconds,\n      });\n      throw new AdcpError('PROPOSAL_EXPIRED', {\n        // Per AdCP 3.0.6 schemas/cache/3.0.6/enums/error-code.json,\n        // PROPOSAL_EXPIRED is `correctable` — the buyer re-discovers\n        // via `get_products` to obtain a fresh proposal (the hold\n        // window has lapsed but the buyer can re-request).\n        recovery: 'correctable',\n        message:\n          `Proposal ${JSON.stringify(proposalId)} expired at ${record.expiresAt.toISOString()}; ` +\n          `create_media_buy must be called within the inventory hold window. Call get_products ` +\n          `with buying_mode='refine' and action='finalize' to request a fresh hold.`,\n        field: 'proposal_id',\n      });\n    }\n  }\n  return record;\n}\n\n// ---------------------------------------------------------------------------\n// D4 — capability-overlap validation\n// ---------------------------------------------------------------------------\n\ninterface PackageLike {\n  product_id?: string;\n  pricing_option_id?: string;\n  pricing_model?: string;\n  delivery_type?: string;\n  signal_type?: string;\n  targeting_overlay?: Record<string, unknown>;\n  /**\n   * Adopter-resolved pricing model — the validation reads this when\n   * present. Set by the framework when it has resolved\n   * `pricing_option_id` against the product's pricing options.\n   */\n  _resolved_pricing_model?: string;\n  _resolved_delivery_type?: string;\n  [k: string]: unknown;\n}\n\n/**\n * Pre-adapter validation seam: walk buyer's packages against each recipe's\n * `capability_overlap` and reject mismatches.\n *\n * Called from the framework's `create_media_buy` and `update_media_buy`\n * dispatch paths after recipes are hydrated from the {@link ProposalStore}.\n * Per D4, the framework owns this gate so every adopter doesn't write the\n * same intersection logic.\n *\n * Validation axes (per {@link CapabilityOverlap}):\n *\n *   - `pricingModels` — checked against `package._resolved_pricing_model`\n *     or `package.pricing_model`.\n *   - `targetingDimensions` — checked against `package.targeting_overlay` keys.\n *   - `deliveryTypes` — checked against `package._resolved_delivery_type`\n *     or `package.delivery_type`.\n *   - `signalTypes` — checked against `package.signal_type`.\n *\n * Per the design's undefined-vs-empty-set semantics: `undefined` skips the\n * gate; an explicit `Set` (including the empty set) is enforced.\n *\n * @public\n */\nexport function validateCapabilityOverlap<TRecipe extends Recipe>(args: {\n  packages: readonly PackageLike[];\n  recipes: ReadonlyMap<string, TRecipe>;\n  fieldPathPrefix?: string;\n}): void {\n  const { packages, recipes, fieldPathPrefix = 'packages' } = args;\n  for (let i = 0; i < packages.length; i++) {\n    const pkg = packages[i]!;\n    const productId = pkg.product_id;\n    if (!productId) continue;\n    const recipe = recipes.get(productId);\n    if (!recipe || !recipe.capability_overlap) continue;\n    const overlap = recipe.capability_overlap;\n\n    if (overlap.pricingModels) {\n      const requested = pkg._resolved_pricing_model ?? pkg.pricing_model;\n      if (requested !== undefined && !overlap.pricingModels.has(String(requested))) {\n        throw new AdcpError('INVALID_REQUEST', {\n          recovery: 'terminal',\n          message:\n            `Buyer requested pricing_model=${JSON.stringify(requested)} on package ` +\n            `${JSON.stringify(productId)}, but this product's recipe declares ` +\n            `capability_overlap.pricingModels=${JSON.stringify([...overlap.pricingModels].sort())}. ` +\n            `The seller did not enable that pricing model for this product.`,\n          field: `${fieldPathPrefix}[${i}].pricing_option_id`,\n        });\n      }\n    }\n\n    if (overlap.targetingDimensions) {\n      const overlay = pkg.targeting_overlay;\n      const keys = overlay && typeof overlay === 'object' ? Object.keys(overlay) : [];\n      const disallowed = keys.filter(k => !overlap.targetingDimensions!.has(k));\n      if (disallowed.length > 0) {\n        throw new AdcpError('INVALID_REQUEST', {\n          recovery: 'terminal',\n          message:\n            `Buyer requested targeting dimensions ${JSON.stringify(disallowed.sort())} on ` +\n            `package ${JSON.stringify(productId)}, but this product's recipe declares ` +\n            `capability_overlap.targetingDimensions=` +\n            `${JSON.stringify([...overlap.targetingDimensions].sort())}. The seller did not ` +\n            `enable those targeting dimensions for this product.`,\n          field: `${fieldPathPrefix}[${i}].targeting_overlay`,\n        });\n      }\n    }\n\n    if (overlap.deliveryTypes) {\n      const delivery = pkg._resolved_delivery_type ?? pkg.delivery_type;\n      if (delivery !== undefined && !overlap.deliveryTypes.has(String(delivery))) {\n        throw new AdcpError('INVALID_REQUEST', {\n          recovery: 'terminal',\n          message:\n            `Buyer requested delivery_type=${JSON.stringify(delivery)} on package ` +\n            `${JSON.stringify(productId)}, but this product's recipe declares ` +\n            `capability_overlap.deliveryTypes=${JSON.stringify([...overlap.deliveryTypes].sort())}.`,\n          field: `${fieldPathPrefix}[${i}].delivery_type`,\n        });\n      }\n    }\n\n    if (overlap.signalTypes) {\n      const signalType = pkg.signal_type;\n      if (signalType !== undefined && !overlap.signalTypes.has(String(signalType))) {\n        throw new AdcpError('INVALID_REQUEST', {\n          recovery: 'terminal',\n          message:\n            `Buyer requested signal_type=${JSON.stringify(signalType)} on package ` +\n            `${JSON.stringify(productId)}, but this product's recipe declares ` +\n            `capability_overlap.signalTypes=${JSON.stringify([...overlap.signalTypes].sort())}.`,\n          field: `${fieldPathPrefix}[${i}].signal_type`,\n        });\n      }\n    }\n  }\n}\n\n/**\n * Validate `recipe.capability_overlap` is a subset of the matching product's\n * wire-declared capabilities.\n *\n * Called at `putDraft` time. Mismatches throw `INTERNAL_ERROR` — this is\n * an adopter bug (the manager declared an overlap claiming capabilities the\n * wire shape doesn't advertise), not a buyer bug.\n *\n * @public\n */\nexport function validateOverlapSubsetOfWire<TRecipe extends Recipe>(args: {\n  recipes: ReadonlyMap<string, TRecipe>;\n  products: readonly Product[];\n}): void {\n  const productsById = new Map<string, Product>();\n  for (const p of args.products) {\n    if (p.product_id) productsById.set(p.product_id, p);\n  }\n  for (const [productId, recipe] of args.recipes) {\n    if (!recipe.capability_overlap) continue;\n    const product = productsById.get(productId);\n    if (!product) continue; // missing-product is caught elsewhere\n    const overlap = recipe.capability_overlap;\n\n    if (overlap.pricingModels) {\n      const wirePricing = wirePricingModels(product);\n      const extras = [...overlap.pricingModels].filter(p => !wirePricing.has(p));\n      if (extras.length > 0) {\n        throw new AdcpError('INTERNAL_ERROR', {\n          recovery: 'terminal',\n          message:\n            `Recipe for product ${JSON.stringify(productId)} declares ` +\n            `capability_overlap.pricingModels=${JSON.stringify([...overlap.pricingModels].sort())} ` +\n            `including ${JSON.stringify(extras.sort())}, but the wire product only advertises ` +\n            `${JSON.stringify([...wirePricing].sort())}. The recipe's overlap must be a subset ` +\n            `of the wire-declared capabilities; adopter declaration is inconsistent with the ` +\n            `product shape.`,\n        });\n      }\n    }\n\n    if (overlap.deliveryTypes) {\n      const wireDelivery = wireDeliveryTypes(product);\n      const extras = [...overlap.deliveryTypes].filter(p => !wireDelivery.has(p));\n      // Only enforce when the wire declares something — products lacking a\n      // delivery_type field shouldn't trip the gate.\n      if (extras.length > 0 && wireDelivery.size > 0) {\n        throw new AdcpError('INTERNAL_ERROR', {\n          recovery: 'terminal',\n          message:\n            `Recipe for product ${JSON.stringify(productId)} declares ` +\n            `capability_overlap.deliveryTypes=${JSON.stringify([...overlap.deliveryTypes].sort())} ` +\n            `including ${JSON.stringify(extras.sort())}, but the wire product only advertises ` +\n            `${JSON.stringify([...wireDelivery].sort())}.`,\n        });\n      }\n    }\n  }\n}\n\nfunction wirePricingModels(product: Product): Set<string> {\n  const out = new Set<string>();\n  const pricing = (product as { pricing_options?: ReadonlyArray<{ pricing_model?: string }> }).pricing_options;\n  if (!pricing) return out;\n  for (const opt of pricing) {\n    if (opt.pricing_model) out.add(String(opt.pricing_model));\n  }\n  return out;\n}\n\nfunction wireDeliveryTypes(product: Product): Set<string> {\n  const dt = (product as { delivery_type?: string }).delivery_type;\n  return dt ? new Set([String(dt)]) : new Set();\n}\n\n// ---------------------------------------------------------------------------\n// Finalize action detection\n// ---------------------------------------------------------------------------\n\n/**\n * Result of {@link detectFinalizeAction}: the index, proposal_id, and\n * optional ask of the first finalize-action refine entry.\n *\n * @public\n */\nexport interface FinalizeActionRef {\n  index: number;\n  proposalId: string;\n  ask?: string;\n}\n\n/**\n * Return the first finalize-action refine entry from a\n * `GetProductsRequest`, or `null` if no finalize entry exists.\n *\n * The index points at the entry's position in `refine[]` so the framework\n * can produce indexed wire field paths (`refine[3].proposal_id`) on\n * rejection — buyers parsing the error get a precise pointer.\n *\n * Per the spec, `buying_mode: 'refine'` carries a `refine[]` array of\n * entries. Each entry has a `scope` (`request` / `product` / `proposal`)\n * and an optional `action` (`include` / `omit` / `finalize`). v1.5 only\n * intercepts `proposal`-scoped entries with `action: 'finalize'`.\n *\n * The framework processes ONE finalize entry per request; if the buyer\n * sends multiple finalize entries, only the first is processed (rest fall\n * through to the standard refine path).\n *\n * @public\n */\nexport function detectFinalizeAction(req: CanonicalGetProductsRequest): FinalizeActionRef | null {\n  const refine = (req as { refine?: ReadonlyArray<Record<string, unknown>> }).refine;\n  if (!refine || refine.length === 0) return null;\n  for (let index = 0; index < refine.length; index++) {\n    const entry = refine[index]!;\n    if (entry.scope === 'proposal' && entry.action === 'finalize') {\n      const proposalId = entry.proposal_id;\n      if (typeof proposalId === 'string' && proposalId.length > 0) {\n        const ask = typeof entry.ask === 'string' ? entry.ask : undefined;\n        return ask !== undefined ? { index, proposalId, ask } : { index, proposalId };\n      }\n    }\n  }\n  return null;\n}\n\n// ---------------------------------------------------------------------------\n// Structured logging — § Observability\n// ---------------------------------------------------------------------------\n\n/**\n * Logger-shaped sink for structured proposal-lifecycle events. Defaults to\n * `console.info`-style emission; the dispatch path can pass a typed logger\n * to route through the rest of the framework's logging.\n *\n * @public\n */\nexport interface ProposalLifecycleLogger {\n  info(message: string, fields?: Record<string, unknown>): void;\n}\n\nlet logger: ProposalLifecycleLogger = {\n  info: (message, fields) => {\n    if (fields) {\n      console.log(JSON.stringify({ message, ...fields }));\n    } else {\n      console.log(message);\n    }\n  },\n};\n\n/**\n * Replace the module-level logger that proposal-lifecycle structured\n * events (`proposal.draft_persisted`, `proposal.finalized`, `proposal.expired`,\n * `proposal.consumed`) emit through. Adopters wire this to their existing\n * logger (pino, bunyan, etc.) so lifecycle events route through the same\n * pipeline as the rest of their server logs. Tests use it to capture\n * structured emissions for assertion.\n *\n * @public\n */\nexport function setProposalLifecycleLogger(next: ProposalLifecycleLogger): void {\n  logger = next;\n}\n\n/** `proposal.draft_persisted` event. */\nexport function logDraftPersisted(args: { proposalId: string; accountId: string; recipesCount: number }): void {\n  logger.info('proposal.draft_persisted', {\n    event: 'proposal.draft_persisted',\n    proposal_id: args.proposalId,\n    account_id: args.accountId,\n    recipes_count: args.recipesCount,\n  });\n}\n\n/**\n * `proposal.finalized` event. `path` is `'inline'` or `'handoff'`.\n */\nexport function logFinalizeSucceeded(args: {\n  proposalId: string;\n  accountId: string;\n  expiresAt: Date;\n  path: 'inline' | 'handoff';\n}): void {\n  logger.info('proposal.finalized', {\n    event: 'proposal.finalized',\n    proposal_id: args.proposalId,\n    account_id: args.accountId,\n    expires_at: args.expiresAt.toISOString(),\n    path: args.path,\n  });\n}\n\n/** `proposal.expired` event. */\nexport function logExpired(args: {\n  proposalId: string;\n  accountId: string;\n  now: Date;\n  expiresAt: Date;\n  graceSeconds: number;\n}): void {\n  logger.info('proposal.expired', {\n    event: 'proposal.expired',\n    proposal_id: args.proposalId,\n    account_id: args.accountId,\n    now: args.now.toISOString(),\n    expires_at: args.expiresAt.toISOString(),\n    grace_seconds: args.graceSeconds,\n  });\n}\n\n/** `proposal.consumed` event. */\nexport function logConsumed(args: { proposalId: string; accountId: string; mediaBuyId: string }): void {\n  logger.info('proposal.consumed', {\n    event: 'proposal.consumed',\n    proposal_id: args.proposalId,\n    account_id: args.accountId,\n    media_buy_id: args.mediaBuyId,\n  });\n}\n"],"mappings":"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","names":[]}