@adcp/sdk 6.11.0 → 6.12.0

package/dist/lib/adapters/proposal-manager.d.ts

@@ -1,142 +0,0 @@
-/**
- * Proposal Manager
- *
- * Server-side adapter for managing media plan proposals in get_products.
- * Publishers use this to generate, store, and refine proposals based on
- * campaign briefs.
- *
- * This is a stub implementation that doesn't generate proposals.
- * Publishers should extend or replace this with their recommendation logic.
- */
-import type { Proposal, Product, ProductAllocation, BrandReference } from '../types/tools.generated';
-/**
- * Context for generating proposals
- */
-export interface ProposalContext {
-    /** Original brief text */
-    brief?: string;
-    /** Available products to allocate */
-    products: Product[];
-    /** Brand reference if provided */
-    brand?: BrandReference;
-    /** Property list ID if filtering was applied */
-    propertyListId?: string;
-    /** Previous proposal being refined */
-    previousProposal?: Proposal;
-}
-/**
- * Abstract interface for proposal managers.
- * Publishers implement this to provide their proposal generation logic.
- */
-export interface IProposalManager {
-    /**
-     * Check if proposal generation is supported by this server
-     */
-    isSupported(): boolean;
-    /**
-     * Generate proposals for a get_products request
-     */
-    generateProposals(context: ProposalContext): Promise<Proposal[]>;
-    /**
-     * Refine an existing proposal based on new instructions
-     */
-    refineProposal(proposalId: string, refinementBrief: string, context: ProposalContext): Promise<Proposal | null>;
-    /**
-     * Get a stored proposal by ID
-     */
-    getProposal(proposalId: string): Promise<Proposal | null>;
-    /**
-     * Store a proposal for later retrieval
-     */
-    storeProposal(proposal: Proposal): Promise<void>;
-    /**
-     * Clean up expired proposals
-     */
-    cleanupExpiredProposals(): Promise<number>;
-}
-/**
- * Error codes for proposal operations
- */
-export declare const ProposalErrorCodes: {
-    readonly NOT_SUPPORTED: "UNSUPPORTED_FEATURE";
-    readonly PROPOSAL_NOT_FOUND: "REFERENCE_NOT_FOUND";
-    readonly PROPOSAL_EXPIRED: "PROPOSAL_EXPIRED";
-    readonly INVALID_ALLOCATION: "INVALID_REQUEST";
-    readonly GENERATION_FAILED: "SERVICE_UNAVAILABLE";
-};
-/**
- * Stub implementation of ProposalManager.
- * Uses in-memory storage and doesn't generate proposals.
- *
- * Publishers should extend this class or provide their own implementation
- * that integrates with their media planning systems or AI.
- */
-export declare class ProposalManager implements IProposalManager {
-    private proposals;
-    private nextId;
-    /**
-     * Check if proposal generation is supported.
-     * Override this to return true when implementing real logic.
-     */
-    isSupported(): boolean;
-    /**
-     * Generate proposals for a get_products request.
-     * Stub implementation returns empty array.
-     *
-     * Publishers should override this to implement:
-     * - AI-powered media planning based on brief
-     * - Rule-based allocation logic
-     * - Historical performance-based recommendations
-     */
-    generateProposals(context: ProposalContext): Promise<Proposal[]>;
-    /**
-     * Refine an existing proposal based on new instructions.
-     * Stub implementation returns null.
-     *
-     * Publishers should override this to implement:
-     * - Parse refinement instructions (e.g., "more mobile", "increase German reach")
-     * - Adjust allocations based on instructions
-     * - Re-validate and return updated proposal
-     */
-    refineProposal(proposalId: string, refinementBrief: string, context: ProposalContext): Promise<Proposal | null>;
-    /**
-     * Get a stored proposal by ID.
-     */
-    getProposal(proposalId: string): Promise<Proposal | null>;
-    /**
-     * Store a proposal for later retrieval.
-     */
-    storeProposal(proposal: Proposal): Promise<void>;
-    /**
-     * Clean up expired proposals.
-     * Returns the number of proposals removed.
-     */
-    cleanupExpiredProposals(): Promise<number>;
-    /**
-     * Generate a unique proposal ID.
-     */
-    protected generateProposalId(): string;
-    /**
-     * Helper to validate that allocations sum to 100%.
-     */
-    protected validateAllocations(allocations: ProductAllocation[]): boolean;
-    /**
-     * Helper to create a proposal with default expiration.
-     */
-    protected createProposal(name: string, description: string, allocations: [ProductAllocation, ...ProductAllocation[]], expirationHours?: number): Proposal;
-}
-/**
- * Example of an AI-powered proposal manager (stub).
- * Shows how publishers might extend the base class.
- */
-export declare class AIProposalManager extends ProposalManager {
-    private aiEndpoint?;
-    constructor(aiEndpoint?: string);
-    isSupported(): boolean;
-    generateProposals(context: ProposalContext): Promise<Proposal[]>;
-}
-/**
- * Default singleton instance for servers that don't need proposals
- */
-export declare const defaultProposalManager: ProposalManager;
-//# sourceMappingURL=proposal-manager.d.ts.map

package/dist/lib/adapters/proposal-manager.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"proposal-manager.d.ts","sourceRoot":"","sources":["../../../src/lib/adapters/proposal-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAEV,QAAQ,EACR,OAAO,EACP,iBAAiB,EACjB,cAAc,EACf,MAAM,0BAA0B,CAAC;AAElC;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,0BAA0B;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,kCAAkC;IAClC,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,gDAAgD;IAChD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sCAAsC;IACtC,gBAAgB,CAAC,EAAE,QAAQ,CAAC;CAC7B;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,WAAW,IAAI,OAAO,CAAC;IAEvB;;OAEG;IACH,iBAAiB,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAEjE;;OAEG;IACH,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;IAEhH;;OAEG;IACH,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;IAE1D;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjD;;OAEG;IACH,uBAAuB,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CAC5C;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;CAMrB,CAAC;AAEX;;;;;;GAMG;AACH,qBAAa,eAAgB,YAAW,gBAAgB;IACtD,OAAO,CAAC,SAAS,CAAoC;IACrD,OAAO,CAAC,MAAM,CAAK;IAEnB;;;OAGG;IACH,WAAW,IAAI,OAAO;IAItB;;;;;;;;OAQG;IACG,iBAAiB,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IActE;;;;;;;;OAQG;IACG,cAAc,CAClB,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,MAAM,EACvB,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAmB3B;;OAEG;IACG,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAe/D;;OAEG;IACG,aAAa,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAItD;;;OAGG;IACG,uBAAuB,IAAI,OAAO,CAAC,MAAM,CAAC;IAchD;;OAEG;IACH,SAAS,CAAC,kBAAkB,IAAI,MAAM;IAItC;;OAEG;IACH,SAAS,CAAC,mBAAmB,CAAC,WAAW,EAAE,iBAAiB,EAAE,GAAG,OAAO;IAKxE;;OAEG;IACH,SAAS,CAAC,cAAc,CACtB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,CAAC,iBAAiB,EAAE,GAAG,iBAAiB,EAAE,CAAC,EACxD,eAAe,GAAE,MAAW,GAC3B,QAAQ;CAYZ;AAED;;;GAGG;AACH,qBAAa,iBAAkB,SAAQ,eAAe;IACpD,OAAO,CAAC,UAAU,CAAC,CAAS;gBAEhB,UAAU,CAAC,EAAE,MAAM;IAK/B,WAAW,IAAI,OAAO;IAIhB,iBAAiB,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;CAgBvE;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB,iBAAwB,CAAC"}

package/dist/lib/adapters/proposal-manager.js

@@ -1,184 +0,0 @@
-"use strict";
-/**
- * Proposal Manager
- *
- * Server-side adapter for managing media plan proposals in get_products.
- * Publishers use this to generate, store, and refine proposals based on
- * campaign briefs.
- *
- * This is a stub implementation that doesn't generate proposals.
- * Publishers should extend or replace this with their recommendation logic.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.defaultProposalManager = exports.AIProposalManager = exports.ProposalManager = exports.ProposalErrorCodes = void 0;
-/**
- * Error codes for proposal operations
- */
-exports.ProposalErrorCodes = {
-    NOT_SUPPORTED: 'UNSUPPORTED_FEATURE',
-    PROPOSAL_NOT_FOUND: 'REFERENCE_NOT_FOUND',
-    PROPOSAL_EXPIRED: 'PROPOSAL_EXPIRED',
-    INVALID_ALLOCATION: 'INVALID_REQUEST',
-    GENERATION_FAILED: 'SERVICE_UNAVAILABLE',
-};
-/**
- * Stub implementation of ProposalManager.
- * Uses in-memory storage and doesn't generate proposals.
- *
- * Publishers should extend this class or provide their own implementation
- * that integrates with their media planning systems or AI.
- */
-class ProposalManager {
-    proposals = new Map();
-    nextId = 1;
-    /**
-     * Check if proposal generation is supported.
-     * Override this to return true when implementing real logic.
-     */
-    isSupported() {
-        return false;
-    }
-    /**
-     * Generate proposals for a get_products request.
-     * Stub implementation returns empty array.
-     *
-     * Publishers should override this to implement:
-     * - AI-powered media planning based on brief
-     * - Rule-based allocation logic
-     * - Historical performance-based recommendations
-     */
-    async generateProposals(context) {
-        if (!this.isSupported()) {
-            return [];
-        }
-        // Override in subclass to implement actual proposal generation
-        // Example implementation would:
-        // 1. Parse the brief to understand campaign objectives
-        // 2. Score products against the brief requirements
-        // 3. Generate optimal budget allocations
-        // 4. Create one or more proposal variants
-        return [];
-    }
-    /**
-     * Refine an existing proposal based on new instructions.
-     * Stub implementation returns null.
-     *
-     * Publishers should override this to implement:
-     * - Parse refinement instructions (e.g., "more mobile", "increase German reach")
-     * - Adjust allocations based on instructions
-     * - Re-validate and return updated proposal
-     */
-    async refineProposal(proposalId, refinementBrief, context) {
-        if (!this.isSupported()) {
-            return null;
-        }
-        const existing = await this.getProposal(proposalId);
-        if (!existing) {
-            return null;
-        }
-        // Check expiration
-        if (existing.expires_at && new Date(existing.expires_at) < new Date()) {
-            return null;
-        }
-        // Override in subclass to implement actual refinement logic
-        return null;
-    }
-    /**
-     * Get a stored proposal by ID.
-     */
-    async getProposal(proposalId) {
-        const proposal = this.proposals.get(proposalId);
-        if (!proposal) {
-            return null;
-        }
-        // Check expiration
-        if (proposal.expires_at && new Date(proposal.expires_at) < new Date()) {
-            this.proposals.delete(proposalId);
-            return null;
-        }
-        return proposal;
-    }
-    /**
-     * Store a proposal for later retrieval.
-     */
-    async storeProposal(proposal) {
-        this.proposals.set(proposal.proposal_id, proposal);
-    }
-    /**
-     * Clean up expired proposals.
-     * Returns the number of proposals removed.
-     */
-    async cleanupExpiredProposals() {
-        const now = new Date();
-        let removed = 0;
-        for (const [id, proposal] of this.proposals) {
-            if (proposal.expires_at && new Date(proposal.expires_at) < now) {
-                this.proposals.delete(id);
-                removed++;
-            }
-        }
-        return removed;
-    }
-    /**
-     * Generate a unique proposal ID.
-     */
-    generateProposalId() {
-        return `prop_${this.nextId++}_${Date.now()}`;
-    }
-    /**
-     * Helper to validate that allocations sum to 100%.
-     */
-    validateAllocations(allocations) {
-        const sum = allocations.reduce((acc, a) => acc + a.allocation_percentage, 0);
-        return Math.abs(sum - 100) < 0.01; // Allow small floating point errors
-    }
-    /**
-     * Helper to create a proposal with default expiration.
-     */
-    createProposal(name, description, allocations, expirationHours = 24) {
-        const expiresAt = new Date();
-        expiresAt.setHours(expiresAt.getHours() + expirationHours);
-        return {
-            proposal_id: this.generateProposalId(),
-            name,
-            description,
-            allocations,
-            expires_at: expiresAt.toISOString(),
-        };
-    }
-}
-exports.ProposalManager = ProposalManager;
-/**
- * Example of an AI-powered proposal manager (stub).
- * Shows how publishers might extend the base class.
- */
-class AIProposalManager extends ProposalManager {
-    aiEndpoint;
-    constructor(aiEndpoint) {
-        super();
-        this.aiEndpoint = aiEndpoint;
-    }
-    isSupported() {
-        return !!this.aiEndpoint;
-    }
-    async generateProposals(context) {
-        if (!this.isSupported() || !context.brief) {
-            return [];
-        }
-        // In a real implementation, this would call an AI service
-        // to generate recommendations based on the brief and products
-        //
-        // Example flow:
-        // 1. Send brief + product catalog to AI
-        // 2. AI returns recommended allocations with rationale
-        // 3. Validate allocations sum to 100%
-        // 4. Store and return proposals
-        return [];
-    }
-}
-exports.AIProposalManager = AIProposalManager;
-/**
- * Default singleton instance for servers that don't need proposals
- */
-exports.defaultProposalManager = new ProposalManager();
-//# sourceMappingURL=proposal-manager.js.map

package/dist/lib/adapters/proposal-manager.js.map

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