@adcp/sdk 6.7.0 → 6.8.0

package/dist/lib/mock-server/sales-non-guaranteed/seed-data.js

@@ -0,0 +1,193 @@
+"use strict";
+/**
+ * Seed data for the `sales-non-guaranteed` mock-server.
+ *
+ * Closes #1457 (sub-issue of #1381). Programmatic-auction shape:
+ * floor pricing per product (`min_cpm`), sync confirmation on
+ * `POST /v1/orders` (no HITL approval), single-bucket delivery
+ * scaling with budget × pacing curve. No guaranteed-availability
+ * surface — forecast is `spend`-only with saturating returns at
+ * high budgets (auction-clearing premium ~1.3x floor at modest
+ * budgets, asymptoting at ~2x).
+ *
+ * Compare to `sales-guaranteed/seed-data.ts`:
+ *   - `MockProduct.pricing.cpm` (fixed) → `MockProduct.pricing.min_cpm` (floor) + optional `target_cpm`.
+ *   - `MockProduct.availability.available_impressions` → out of scope (programmatic).
+ *   - `MockProduct.delivery_type: 'guaranteed'` → always `'non_guaranteed'`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_API_KEY = exports.PRODUCTS = exports.AD_UNITS = exports.NETWORKS = void 0;
+exports.NETWORKS = [
+    {
+        network_code: 'net_remnant_us',
+        display_name: 'Programmatic Remnant Network — US',
+        adcp_publisher: 'remnant-network.example',
+    },
+    {
+        network_code: 'net_remnant_eu',
+        display_name: 'Programmatic Remnant Network — EU',
+        adcp_publisher: 'remnant-network.eu',
+    },
+    // Storyboard-fixture-aligned entries — the `sales_non_guaranteed`
+    // storyboard sends payloads with these publisher domains. Mirrors the
+    // pattern from `sales-guaranteed/seed-data.ts`. Without seeded fixture
+    // domains, every `_lookup/network` returns 404 and a blind agent has
+    // to invent a fallback that contradicts the skill's "fail closed on
+    // 404" advice. Track upstream-fixture rationale at adcontextprotocol/adcp#3822.
+    {
+        network_code: 'net_acmeoutdoor',
+        display_name: 'Acme Outdoor Media',
+        adcp_publisher: 'acmeoutdoor.example',
+    },
+    {
+        network_code: 'net_pinnacle',
+        display_name: 'Pinnacle Agency',
+        adcp_publisher: 'pinnacle-agency.example',
+    },
+];
+exports.AD_UNITS = [
+    {
+        ad_unit_id: 'au_us_display_medrec',
+        name: 'US Display Medrec — Run of Network',
+        path: '/remnant/us/display/medrec',
+        network_code: 'net_remnant_us',
+        sizes: [{ width: 300, height: 250 }],
+        environment: 'web',
+        targetable: true,
+    },
+    {
+        ad_unit_id: 'au_us_display_leaderboard',
+        name: 'US Display Leaderboard — Run of Network',
+        path: '/remnant/us/display/leaderboard',
+        network_code: 'net_remnant_us',
+        sizes: [{ width: 728, height: 90 }],
+        environment: 'web',
+        targetable: true,
+    },
+    {
+        ad_unit_id: 'au_us_video_outstream',
+        name: 'US Video Outstream — Run of Network',
+        path: '/remnant/us/video/outstream',
+        network_code: 'net_remnant_us',
+        sizes: [{ width: 640, height: 360 }],
+        environment: 'web',
+        targetable: true,
+    },
+    {
+        ad_unit_id: 'au_us_ctv_15s',
+        name: 'US CTV 15s — Programmatic Remnant',
+        path: '/remnant/us/ctv/15s',
+        network_code: 'net_remnant_us',
+        sizes: [{ width: 1920, height: 1080 }],
+        environment: 'ctv',
+        targetable: true,
+    },
+    {
+        ad_unit_id: 'au_eu_display_medrec',
+        name: 'EU Display Medrec — Run of Network',
+        path: '/remnant/eu/display/medrec',
+        network_code: 'net_remnant_eu',
+        sizes: [{ width: 300, height: 250 }],
+        environment: 'web',
+        targetable: true,
+    },
+    // Storyboard-fixture-aligned ad units.
+    {
+        ad_unit_id: 'au_acmeoutdoor_dooh',
+        name: 'Acme Outdoor — DOOH Programmatic',
+        path: '/acme/outdoor/dooh',
+        network_code: 'net_acmeoutdoor',
+        sizes: [{ width: 1920, height: 1080 }],
+        environment: 'web',
+        targetable: true,
+    },
+    {
+        ad_unit_id: 'au_pinnacle_remnant',
+        name: 'Pinnacle Display Remnant',
+        path: '/pinnacle/display/remnant',
+        network_code: 'net_pinnacle',
+        sizes: [{ width: 300, height: 250 }],
+        environment: 'web',
+        targetable: true,
+    },
+];
+exports.PRODUCTS = [
+    {
+        product_id: 'display_medrec_remnant',
+        name: 'Display Medrec — Remnant',
+        network_code: 'net_remnant_us',
+        delivery_type: 'non_guaranteed',
+        channel: 'display',
+        format_ids: ['display_300x250'],
+        ad_unit_ids: ['au_us_display_medrec'],
+        pricing: { min_cpm: 1.5, target_cpm: 2.25, currency: 'USD' },
+    },
+    {
+        product_id: 'display_leaderboard_remnant',
+        name: 'Display Leaderboard — Remnant',
+        network_code: 'net_remnant_us',
+        delivery_type: 'non_guaranteed',
+        channel: 'display',
+        format_ids: ['display_728x90'],
+        ad_unit_ids: ['au_us_display_leaderboard'],
+        pricing: { min_cpm: 1.0, target_cpm: 1.5, currency: 'USD' },
+    },
+    {
+        product_id: 'video_outstream_remnant',
+        name: 'Video Outstream — Remnant',
+        network_code: 'net_remnant_us',
+        delivery_type: 'non_guaranteed',
+        channel: 'video',
+        format_ids: ['video_30s', 'video_15s'],
+        ad_unit_ids: ['au_us_video_outstream'],
+        pricing: { min_cpm: 8.0, target_cpm: 12.0, currency: 'USD', min_spend: 1_000 },
+    },
+    {
+        product_id: 'ctv_15s_remnant',
+        name: 'CTV 15s — Programmatic Remnant',
+        network_code: 'net_remnant_us',
+        delivery_type: 'non_guaranteed',
+        channel: 'ctv',
+        format_ids: ['video_15s'],
+        ad_unit_ids: ['au_us_ctv_15s'],
+        pricing: { min_cpm: 15.0, target_cpm: 22.0, currency: 'USD', min_spend: 5_000 },
+    },
+    {
+        product_id: 'display_medrec_remnant_eu',
+        name: 'Display Medrec — Remnant (EU)',
+        network_code: 'net_remnant_eu',
+        delivery_type: 'non_guaranteed',
+        channel: 'display',
+        format_ids: ['display_300x250'],
+        ad_unit_ids: ['au_eu_display_medrec'],
+        pricing: { min_cpm: 1.2, target_cpm: 1.8, currency: 'EUR' },
+    },
+    // Storyboard-fixture-aligned products.
+    {
+        product_id: 'acme_dooh_remnant_q2',
+        name: 'Acme Outdoor — DOOH Programmatic Q2',
+        network_code: 'net_acmeoutdoor',
+        delivery_type: 'non_guaranteed',
+        channel: 'video',
+        format_ids: ['video_15s'],
+        ad_unit_ids: ['au_acmeoutdoor_dooh'],
+        pricing: { min_cpm: 6.0, target_cpm: 9.0, currency: 'USD', min_spend: 500 },
+    },
+    {
+        product_id: 'pinnacle_display_remnant_q2',
+        name: 'Pinnacle Display Remnant Q2',
+        network_code: 'net_pinnacle',
+        delivery_type: 'non_guaranteed',
+        channel: 'display',
+        format_ids: ['display_300x250'],
+        ad_unit_ids: ['au_pinnacle_remnant'],
+        pricing: { min_cpm: 0.85, target_cpm: 1.3, currency: 'USD' },
+    },
+];
+/** Default static API key (Bearer). Real DSPs / SSPs typically use OAuth
+ * or signed-request auth; static Bearer keeps the test surface varied
+ * (sales-social already exercises OAuth, sales-guaranteed uses static
+ * Bearer too — this mock matches the latter to focus on the auction
+ * shape rather than re-exercising OAuth). */
+exports.DEFAULT_API_KEY = 'mock_sales_non_guaranteed_key_do_not_use_in_prod';
+//# sourceMappingURL=seed-data.js.map

package/dist/lib/mock-server/sales-non-guaranteed/seed-data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seed-data.js","sourceRoot":"","sources":["../../../../src/lib/mock-server/sales-non-guaranteed/seed-data.ts"],"names":[],"mappings":"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"}

package/dist/lib/mock-server/sales-non-guaranteed/server.d.ts

@@ -0,0 +1,33 @@
+/**
+ * `sales-non-guaranteed` upstream-shape mock-server. Programmatic-auction
+ * remnant inventory; sync confirmation on `POST /v1/orders`; floor pricing
+ * per product; spend-only forecast (no availability check).
+ *
+ * Closes #1457 (sub-issue of #1381). Pattern modeled on
+ * `sales-guaranteed/server.ts` with these deltas:
+ *
+ *   - Order confirmation is **sync**: `POST /v1/orders` returns
+ *     `status: 'confirmed'` immediately. No HITL approval task.
+ *   - Pricing is **floor-based** (`min_cpm`). Effective CPM at the
+ *     requested budget = `target_cpm` if set, else `1.3 × min_cpm`,
+ *     saturating toward `2 × min_cpm` at high budgets.
+ *   - Forecast is **`spend`-only**. No `availability` unit; auction
+ *     mocks don't pre-commit inventory.
+ *   - Delivery scales with `(budget × elapsed_pct × pacing_curve)`.
+ *     Pacing modes: `even`, `asap`, `front_loaded`.
+ *   - No CAPI / conversions surface (out of scope per #1457).
+ */
+import { type MockAdUnit, type MockNetwork, type MockProduct } from './seed-data';
+export interface BootOptions {
+    port: number;
+    apiKey?: string;
+    networks?: MockNetwork[];
+    adUnits?: MockAdUnit[];
+    products?: MockProduct[];
+}
+export interface BootResult {
+    url: string;
+    close: () => Promise<void>;
+}
+export declare function bootSalesNonGuaranteed(options: BootOptions): Promise<BootResult>;
+//# sourceMappingURL=server.d.ts.map

package/dist/lib/mock-server/sales-non-guaranteed/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../../src/lib/mock-server/sales-non-guaranteed/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,OAAO,EAKL,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,WAAW,EACjB,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;IACzB,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC;IACvB,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAsED,wBAAsB,sBAAsB,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CA6pBtF"}