@adcp/sdk 6.10.0 → 6.12.0

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

@@ -0,0 +1,203 @@
+/**
+ * Proposal-dispatch — the v1.5 framework intercept seams.
+ *
+ * Pure functions that the runtime calls from the wire-handler shims
+ * (`getProducts`, `createMediaBuy`, `updateMediaBuy`,
+ * `getMediaBuyDelivery`). Each helper short-circuits when no manager /
+ * store is wired for the request, so the v1 path is preserved
+ * byte-for-byte.
+ *
+ * Five integration points (parity with `adcp-client-python.src/adcp/decisioning/proposal_dispatch.py`):
+ *
+ *   - {@link maybeInterceptFinalize} — `getProducts` shim. Detects
+ *     `refine[i].action: 'finalize'`, calls the manager's
+ *     `finalizeProposal`, commits the proposal, returns the wire
+ *     response. Returns `null` when no finalize entry / no
+ *     finalize-capable manager.
+ *   - {@link maybePersistDraftAfterGetProducts} — `getProducts` shim
+ *     (post-call). Walks the response's `proposals[]`, validates
+ *     `overlap ⊆ wire`, persists each as a draft.
+ *   - {@link maybeReserveProposalForCreateMediaBuy} — `createMediaBuy`
+ *     shim. When `proposal_id` is set, validates expiry + capability
+ *     overlap, reserves the proposal (`COMMITTED → CONSUMING`), returns
+ *     the recipes map for `ctx.recipes` hydration.
+ *   - {@link finalizeProposalConsumption} — `createMediaBuy` shim
+ *     (post-success). Promotes `CONSUMING → CONSUMED` and records the
+ *     `mediaBuyId` back-reference.
+ *   - {@link releaseProposalReservation} — `createMediaBuy` shim
+ *     (failure rollback). Restores `CONSUMING → COMMITTED`.
+ *   - {@link maybeHydrateRecipesForMediaBuyId} —
+ *     `updateMediaBuy` / `getMediaBuyDelivery` shims. Reverse-index
+ *     hydration via `getByMediaBuyId`. Re-runs capability-overlap
+ *     validation per Resolutions §5.
+ *
+ * @public
+ * @packageDocumentation
+ */
+import { type TaskHandoff } from '../async-outcome';
+import type { GetProductsRequest, GetProductsResponse } from '../../../types/tools.generated';
+import type { ProposalRecord, ProposalStore } from './store';
+import type { FinalizeProposalSuccess, ProposalManager, Recipe } from './types';
+/**
+ * Result of {@link maybeInterceptFinalize}.
+ *
+ *   - `kind: 'intercepted'` — adopter's `finalizeProposal` was called.
+ *     Caller threads `result` and `project` through the framework's
+ *     standard `routeIfHandoff` so the projection callback fires
+ *     synchronously for sync `FinalizeProposalSuccess` returns AND
+ *     inside the background task for `TaskHandoff<FinalizeProposalSuccess>`
+ *     returns. The projection commits the proposal store, emits the
+ *     `proposal.finalized` log, and shapes the wire response.
+ *   - `kind: 'pass'` — no finalize entry / no finalize-capable manager;
+ *     caller continues with the standard `getProducts` dispatch.
+ *
+ * No special-case handling: finalize HITL inherits the framework's
+ * task-lifecycle posture (cancellation, restart-via-durable-store,
+ * deadline, webhook delivery) from `routeIfHandoff`, the same machinery
+ * that drives `createMediaBuy` HITL and `syncCreatives` HITL.
+ *
+ * @public
+ */
+export type FinalizeInterceptResult<TRecipe extends Recipe = Recipe> = {
+    kind: 'intercepted';
+    result: FinalizeProposalSuccess<TRecipe> | TaskHandoff<FinalizeProposalSuccess<TRecipe>>;
+    project: (success: FinalizeProposalSuccess<TRecipe>) => Promise<GetProductsResponse>;
+} | {
+    kind: 'pass';
+};
+/**
+ * Intercept `buying_mode: 'refine'` requests carrying a
+ * `refine[i].action: 'finalize'` entry. Hydrates the draft, calls the
+ * manager's `finalizeProposal`, and returns the raw adopter result + a
+ * projection callback. The runtime threads them through the framework's
+ * standard `routeIfHandoff` so:
+ *
+ *   - Sync `FinalizeProposalSuccess` returns: projection runs inline,
+ *     buyer sees the committed proposal in the response.
+ *   - HITL `TaskHandoff<FinalizeProposalSuccess>` returns: framework
+ *     returns the Submitted envelope to the buyer, runs the adopter's
+ *     handoff fn in background; projection runs when the handoff
+ *     resolves, commits the proposal, projects the terminal task
+ *     artifact.
+ *
+ * Same machinery as `createMediaBuy` HITL — finalize inherits whatever
+ * cancellation, restart-via-durable-store, deadline, and webhook
+ * delivery semantics the framework's task lifecycle provides for every
+ * other unified-hybrid tool. No special-case wrapper.
+ *
+ * @public
+ */
+export declare function maybeInterceptFinalize<TRecipe extends Recipe, TCtxMeta>(args: {
+    request: GetProductsRequest;
+    manager: ProposalManager<TRecipe, TCtxMeta> | undefined;
+    store: ProposalStore<TRecipe> | undefined;
+    ctx: {
+        account: {
+            id: string;
+        };
+    } & Record<string, unknown>;
+}): Promise<FinalizeInterceptResult<TRecipe>>;
+/**
+ * Persist proposals returned by `getProducts` / `refineProducts` as
+ * drafts in the wired {@link ProposalStore}. Validates `overlap ⊆ wire`
+ * for any returned recipes before persisting.
+ *
+ * Quietly returns when no store is wired, no `proposals[]` in the
+ * response, or no typed recipes attached to products.
+ *
+ * @public
+ */
+export declare function maybePersistDraftAfterGetProducts<TRecipe extends Recipe>(args: {
+    response: GetProductsResponse;
+    store: ProposalStore<TRecipe> | undefined;
+    ctx: {
+        account: {
+            id: string;
+        };
+    };
+}): Promise<void>;
+/**
+ * Result of {@link maybeReserveProposalForCreateMediaBuy}.
+ *
+ *   - `record` — the reserved {@link ProposalRecord}. Caller threads
+ *     `recipes` onto `ctx.recipes` and calls
+ *     {@link finalizeProposalConsumption} on adapter success or
+ *     {@link releaseProposalReservation} on failure.
+ *   - `null` — request has no `proposal_id`, no store wired, or the
+ *     framework didn't intercept (v1 path).
+ *
+ * @public
+ */
+export type ReservedProposal<TRecipe extends Recipe> = ProposalRecord<TRecipe>;
+/**
+ * Reserve the proposal for consumption and hydrate `ctx.recipes`.
+ *
+ * Atomic CAS via {@link ProposalStore.tryReserveConsumption} — the
+ * proposal transitions `COMMITTED → CONSUMING` before the adapter runs.
+ * Two parallel `createMediaBuy(proposal_id=X)` calls cannot both
+ * reserve; the loser raises `PROPOSAL_NOT_COMMITTED`.
+ *
+ * Validates per § D7 (expiry) BEFORE reserving — an expired proposal
+ * surfaces `PROPOSAL_EXPIRED` without flipping the state.
+ *
+ * @public
+ */
+export declare function maybeReserveProposalForCreateMediaBuy<TRecipe extends Recipe, TCtxMeta>(args: {
+    request: {
+        proposal_id?: string;
+        packages?: ReadonlyArray<unknown>;
+    } & Record<string, unknown>;
+    manager: ProposalManager<TRecipe, TCtxMeta> | undefined;
+    store: ProposalStore<TRecipe> | undefined;
+    ctx: {
+        account: {
+            id: string;
+        };
+    };
+    now?: Date;
+}): Promise<ReservedProposal<TRecipe> | null>;
+/**
+ * Promote `CONSUMING → CONSUMED` after the adapter's `createMediaBuy`
+ * succeeded.
+ *
+ * @public
+ */
+export declare function finalizeProposalConsumption<TRecipe extends Recipe>(args: {
+    store: ProposalStore<TRecipe> | undefined;
+    record: ReservedProposal<TRecipe>;
+    mediaBuyId: string;
+}): Promise<void>;
+/**
+ * Roll back the reservation: `CONSUMING → COMMITTED`. Best-effort.
+ *
+ * @public
+ */
+export declare function releaseProposalReservation<TRecipe extends Recipe>(args: {
+    store: ProposalStore<TRecipe> | undefined;
+    record: ReservedProposal<TRecipe>;
+    logger?: {
+        warn(message: string): void;
+    };
+}): Promise<void>;
+/**
+ * Hydrate `ctx.recipes` for post-acceptance buy operations via the
+ * `getByMediaBuyId` reverse-index. Returns the record (so the caller
+ * can re-validate overlap if a packages-shaped patch is provided);
+ * returns `null` when no proposal backs this buy.
+ *
+ * Per Resolutions §5: re-validates capability overlap on every call
+ * with packages.
+ *
+ * @public
+ */
+export declare function maybeHydrateRecipesForMediaBuyId<TRecipe extends Recipe>(args: {
+    mediaBuyId: string | undefined;
+    store: ProposalStore<TRecipe> | undefined;
+    ctx: {
+        account: {
+            id: string;
+        };
+    };
+    packages?: ReadonlyArray<unknown>;
+}): Promise<ProposalRecord<TRecipe> | null>;
+//# sourceMappingURL=dispatch.d.ts.map

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

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

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

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

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

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

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

@@ -0,0 +1,21 @@
+/**
+ * ProposalManager — primitives for the two-platform composition.
+ *
+ * Splits proposal assembly (`get_products`, refine, finalize) from media-buy
+ * execution (`create_media_buy`, lifecycle), mirroring `adcp-client-python`'s
+ * v1.5 ProposalManager. Either side can be mock-backed independently.
+ *
+ * @public
+ * @packageDocumentation
+ */
+export type { ProposalManager, ProposalCapabilities, ProposalSalesSpecialism, Recipe, CapabilityOverlap, FinalizeProposalRequest, FinalizeProposalSuccess, } from './types';
+export { validateProposalCapabilities } from './types';
+export type { ProposalState, ProposalRecord, ProposalStore, InMemoryProposalStoreOptions } from './store';
+export { InMemoryProposalStore } from './store';
+export { MockProposalManager } from './mock-manager';
+export type { MockProposalManagerOptions } from './mock-manager';
+export { enforceProposalExpiry, validateCapabilityOverlap, validateOverlapSubsetOfWire, detectFinalizeAction, setProposalLifecycleLogger, logDraftPersisted, logFinalizeSucceeded, logExpired, logConsumed, } from './lifecycle';
+export type { FinalizeActionRef, ProposalLifecycleLogger } from './lifecycle';
+export { maybeInterceptFinalize, maybePersistDraftAfterGetProducts, maybeReserveProposalForCreateMediaBuy, finalizeProposalConsumption, releaseProposalReservation, maybeHydrateRecipesForMediaBuyId, } from './dispatch';
+export type { FinalizeInterceptResult, ReservedProposal } from './dispatch';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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"}