@adcp/client 3.7.0 → 3.8.0

package/dist/lib/adapters/property-list-adapter.js

@@ -0,0 +1,212 @@
+"use strict";
+/**
+ * Property List Adapter
+ *
+ * Server-side adapter for implementing property list management logic.
+ * Publishers use this to manage buyer-defined property lists for filtering
+ * available inventory.
+ *
+ * This is a stub implementation that stores lists in memory.
+ * Publishers should extend or replace this with persistent storage.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultPropertyListAdapter = exports.PropertyListAdapter = exports.PropertyListErrorCodes = exports.PropertyListError = void 0;
+exports.isPropertyListError = isPropertyListError;
+/**
+ * Error thrown when property list operations fail
+ */
+class PropertyListError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = 'PropertyListError';
+    }
+}
+exports.PropertyListError = PropertyListError;
+/**
+ * Error codes for property list operations
+ */
+exports.PropertyListErrorCodes = {
+    NOT_SUPPORTED: 'property_lists_not_supported',
+    LIST_NOT_FOUND: 'list_not_found',
+    INVALID_LIST: 'invalid_list',
+    PERMISSION_DENIED: 'permission_denied',
+    QUOTA_EXCEEDED: 'quota_exceeded',
+};
+/**
+ * Stub implementation of PropertyListAdapter.
+ * Uses in-memory storage for development and testing.
+ *
+ * Publishers should extend this class or provide their own implementation
+ * that integrates with their property management systems.
+ */
+class PropertyListAdapter {
+    lists = new Map();
+    authTokens = new Map();
+    nextId = 1;
+    /**
+     * Check if property list management is supported.
+     * Override this to return true when implementing real logic.
+     */
+    isSupported() {
+        return false;
+    }
+    async createList(request) {
+        if (!this.isSupported()) {
+            throw new PropertyListError(exports.PropertyListErrorCodes.NOT_SUPPORTED, 'Property list management is not supported by this server');
+        }
+        // Generate ID and auth token
+        const listId = `pl_${this.nextId++}_${Date.now()}`;
+        const authToken = `plat_${this.generateToken()}`;
+        const now = new Date().toISOString();
+        const list = {
+            list_id: listId,
+            name: request.name,
+            description: request.description,
+            base_properties: request.base_properties,
+            filters: request.filters,
+            brand_manifest: request.brand_manifest,
+            created_at: now,
+            updated_at: now,
+            property_count: 0,
+        };
+        this.lists.set(listId, list);
+        this.authTokens.set(listId, authToken);
+        return {
+            list,
+            auth_token: authToken,
+        };
+    }
+    async updateList(request) {
+        if (!this.isSupported()) {
+            throw new PropertyListError(exports.PropertyListErrorCodes.NOT_SUPPORTED, 'Property list management is not supported by this server');
+        }
+        const existing = this.lists.get(request.list_id);
+        if (!existing) {
+            throw new PropertyListError(exports.PropertyListErrorCodes.LIST_NOT_FOUND, `Property list not found: ${request.list_id}`);
+        }
+        // Update fields
+        const updated = {
+            ...existing,
+            name: request.name ?? existing.name,
+            description: request.description ?? existing.description,
+            base_properties: request.base_properties ?? existing.base_properties,
+            filters: request.filters ?? existing.filters,
+            brand_manifest: request.brand_manifest ?? existing.brand_manifest,
+            updated_at: new Date().toISOString(),
+        };
+        this.lists.set(request.list_id, updated);
+        return { list: updated };
+    }
+    async getList(request) {
+        if (!this.isSupported()) {
+            throw new PropertyListError(exports.PropertyListErrorCodes.NOT_SUPPORTED, 'Property list management is not supported by this server');
+        }
+        const list = this.lists.get(request.list_id);
+        if (!list) {
+            throw new PropertyListError(exports.PropertyListErrorCodes.LIST_NOT_FOUND, `Property list not found: ${request.list_id}`);
+        }
+        // Resolve property identifiers if requested
+        let identifiers;
+        if (request.resolve !== false) {
+            const resolved = await this.resolveList(request.list_id, request.max_results, request.cursor);
+            identifiers = resolved.map(p => ({
+                identifier_type: p.identifier_type,
+                identifier_value: p.identifier_value,
+            }));
+        }
+        return {
+            list: {
+                ...list,
+                property_count: identifiers?.length ?? list.property_count,
+            },
+            identifiers,
+            total_count: identifiers?.length,
+            resolved_at: new Date().toISOString(),
+        };
+    }
+    async listLists(request) {
+        if (!this.isSupported()) {
+            throw new PropertyListError(exports.PropertyListErrorCodes.NOT_SUPPORTED, 'Property list management is not supported by this server');
+        }
+        // Filter by principal if provided
+        let lists = Array.from(this.lists.values());
+        if (request.principal) {
+            lists = lists.filter(l => l.principal === request.principal);
+        }
+        // Filter by name if provided
+        if (request.name_contains) {
+            const searchTerm = request.name_contains.toLowerCase();
+            lists = lists.filter(l => l.name.toLowerCase().includes(searchTerm));
+        }
+        // Apply pagination
+        const maxResults = request.max_results ?? 100;
+        const paginatedLists = lists.slice(0, maxResults);
+        return {
+            lists: paginatedLists,
+            total_count: lists.length,
+            returned_count: paginatedLists.length,
+        };
+    }
+    async deleteList(request) {
+        if (!this.isSupported()) {
+            throw new PropertyListError(exports.PropertyListErrorCodes.NOT_SUPPORTED, 'Property list management is not supported by this server');
+        }
+        if (!this.lists.has(request.list_id)) {
+            throw new PropertyListError(exports.PropertyListErrorCodes.LIST_NOT_FOUND, `Property list not found: ${request.list_id}`);
+        }
+        this.lists.delete(request.list_id);
+        this.authTokens.delete(request.list_id);
+        return {
+            deleted: true,
+            list_id: request.list_id,
+        };
+    }
+    /**
+     * Check if a property is in a list.
+     * Stub implementation returns false (property not found).
+     */
+    async isPropertyInList(listId, identifierType, identifierValue) {
+        if (!this.isSupported()) {
+            // When not supported, all properties are considered in-list (no filtering)
+            return true;
+        }
+        // Override in subclass to implement actual lookup
+        return false;
+    }
+    /**
+     * Resolve a property list to identifiers.
+     * Stub implementation returns empty array.
+     */
+    async resolveList(listId, maxResults, cursor) {
+        if (!this.isSupported()) {
+            return [];
+        }
+        // Override in subclass to implement actual resolution
+        return [];
+    }
+    /**
+     * Generate a random token for auth
+     */
+    generateToken() {
+        const chars = 'abcdefghijklmnopqrstuvwxyz0123456789';
+        let result = '';
+        for (let i = 0; i < 32; i++) {
+            result += chars[Math.floor(Math.random() * chars.length)];
+        }
+        return result;
+    }
+}
+exports.PropertyListAdapter = PropertyListAdapter;
+/**
+ * Helper to check if an error is a PropertyListError
+ */
+function isPropertyListError(error) {
+    return error instanceof PropertyListError;
+}
+/**
+ * Default singleton instance for servers that don't need property list management
+ */
+exports.defaultPropertyListAdapter = new PropertyListAdapter();
+//# sourceMappingURL=property-list-adapter.js.map

package/dist/lib/adapters/property-list-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"property-list-adapter.js","sourceRoot":"","sources":["../../../src/lib/adapters/property-list-adapter.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AAuTH,kDAEC;AA9RD;;GAEG;AACH,MAAa,iBAAkB,SAAQ,KAAK;IAEjC;IADT,YACS,IAAY,EACnB,OAAe;QAEf,KAAK,CAAC,OAAO,CAAC,CAAC;QAHR,SAAI,GAAJ,IAAI,CAAQ;QAInB,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF;AARD,8CAQC;AAkDD;;GAEG;AACU,QAAA,sBAAsB,GAAG;IACpC,aAAa,EAAE,8BAA8B;IAC7C,cAAc,EAAE,gBAAgB;IAChC,YAAY,EAAE,cAAc;IAC5B,iBAAiB,EAAE,mBAAmB;IACtC,cAAc,EAAE,gBAAgB;CACxB,CAAC;AAEX;;;;;;GAMG;AACH,MAAa,mBAAmB;IACtB,KAAK,GAA8B,IAAI,GAAG,EAAE,CAAC;IAC7C,UAAU,GAAwB,IAAI,GAAG,EAAE,CAAC;IAC5C,MAAM,GAAG,CAAC,CAAC;IAEnB;;;OAGG;IACH,WAAW;QACT,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,OAAkC;QACjD,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,MAAM,IAAI,iBAAiB,CACzB,8BAAsB,CAAC,aAAa,EACpC,0DAA0D,CAC3D,CAAC;QACJ,CAAC;QAED,6BAA6B;QAC7B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;QACnD,MAAM,SAAS,GAAG,QAAQ,IAAI,CAAC,aAAa,EAAE,EAAE,CAAC;QACjD,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAErC,MAAM,IAAI,GAAiB;YACzB,OAAO,EAAE,MAAM;YACf,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,eAAe,EAAE,OAAO,CAAC,eAAe;YACxC,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,cAAc,EAAE,OAAO,CAAC,cAAc;YACtC,UAAU,EAAE,GAAG;YACf,UAAU,EAAE,GAAG;YACf,cAAc,EAAE,CAAC;SAClB,CAAC;QAEF,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC7B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QAEvC,OAAO;YACL,IAAI;YACJ,UAAU,EAAE,SAAS;SACtB,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,OAAkC;QACjD,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,MAAM,IAAI,iBAAiB,CACzB,8BAAsB,CAAC,aAAa,EACpC,0DAA0D,CAC3D,CAAC;QACJ,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACjD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,iBAAiB,CAAC,8BAAsB,CAAC,cAAc,EAAE,4BAA4B,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;QACpH,CAAC;QAED,gBAAgB;QAChB,MAAM,OAAO,GAAiB;YAC5B,GAAG,QAAQ;YACX,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,QAAQ,CAAC,IAAI;YACnC,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,QAAQ,CAAC,WAAW;YACxD,eAAe,EAAE,OAAO,CAAC,eAAe,IAAI,QAAQ,CAAC,eAAe;YACpE,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,QAAQ,CAAC,OAAO;YAC5C,cAAc,EAAE,OAAO,CAAC,cAAc,IAAI,QAAQ,CAAC,cAAc;YACjE,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACrC,CAAC;QAEF,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAEzC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,OAA+B;QAC3C,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,MAAM,IAAI,iBAAiB,CACzB,8BAAsB,CAAC,aAAa,EACpC,0DAA0D,CAC3D,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC7C,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,iBAAiB,CAAC,8BAAsB,CAAC,cAAc,EAAE,4BAA4B,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;QACpH,CAAC;QAED,4CAA4C;QAC5C,IAAI,WAA8B,CAAC;QACnC,IAAI,OAAO,CAAC,OAAO,KAAK,KAAK,EAAE,CAAC;YAC9B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;YAC9F,WAAW,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBAC/B,eAAe,EAAE,CAAC,CAAC,eAAe;gBAClC,gBAAgB,EAAE,CAAC,CAAC,gBAAgB;aACrC,CAAC,CAAC,CAAC;QACN,CAAC;QAED,OAAO;YACL,IAAI,EAAE;gBACJ,GAAG,IAAI;gBACP,cAAc,EAAE,WAAW,EAAE,MAAM,IAAI,IAAI,CAAC,cAAc;aAC3D;YACD,WAAW;YACX,WAAW,EAAE,WAAW,EAAE,MAAM;YAChC,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACtC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,OAAiC;QAC/C,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,MAAM,IAAI,iBAAiB,CACzB,8BAAsB,CAAC,aAAa,EACpC,0DAA0D,CAC3D,CAAC;QACJ,CAAC;QAED,kCAAkC;QAClC,IAAI,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QAC5C,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;YACtB,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;QAC/D,CAAC;QAED,6BAA6B;QAC7B,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;YAC1B,MAAM,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC,WAAW,EAAE,CAAC;YACvD,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC;QACvE,CAAC;QAED,mBAAmB;QACnB,MAAM,UAAU,GAAG,OAAO,CAAC,WAAW,IAAI,GAAG,CAAC;QAC9C,MAAM,cAAc,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;QAElD,OAAO;YACL,KAAK,EAAE,cAAc;YACrB,WAAW,EAAE,KAAK,CAAC,MAAM;YACzB,cAAc,EAAE,cAAc,CAAC,MAAM;SACtC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,OAAkC;QACjD,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,MAAM,IAAI,iBAAiB,CACzB,8BAAsB,CAAC,aAAa,EACpC,0DAA0D,CAC3D,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YACrC,MAAM,IAAI,iBAAiB,CAAC,8BAAsB,CAAC,cAAc,EAAE,4BAA4B,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;QACpH,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACnC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAExC,OAAO;YACL,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,OAAO,CAAC,OAAO;SACzB,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,gBAAgB,CAAC,MAAc,EAAE,cAAsB,EAAE,eAAuB;QACpF,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,2EAA2E;YAC3E,OAAO,IAAI,CAAC;QACd,CAAC;QAED,kDAAkD;QAClD,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,WAAW,CAAC,MAAc,EAAE,UAAmB,EAAE,MAAe;QACpE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,sDAAsD;QACtD,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;OAEG;IACO,aAAa;QACrB,MAAM,KAAK,GAAG,sCAAsC,CAAC;QACrD,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;QAC5D,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAxMD,kDAwMC;AAED;;GAEG;AACH,SAAgB,mBAAmB,CAAC,KAAc;IAChD,OAAO,KAAK,YAAY,iBAAiB,CAAC;AAC5C,CAAC;AAED;;GAEG;AACU,QAAA,0BAA0B,GAAG,IAAI,mBAAmB,EAAE,CAAC"}

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

@@ -0,0 +1,142 @@
+/**
+ * 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, BrandManifest } from '../types/tools.generated';
+/**
+ * Context for generating proposals
+ */
+export interface ProposalContext {
+    /** Original brief text */
+    brief?: string;
+    /** Available products to allocate */
+    products: Product[];
+    /** Brand information if provided */
+    brandManifest?: BrandManifest;
+    /** 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: "proposals_not_supported";
+    readonly PROPOSAL_NOT_FOUND: "proposal_not_found";
+    readonly PROPOSAL_EXPIRED: "proposal_expired";
+    readonly INVALID_ALLOCATION: "invalid_allocation";
+    readonly GENERATION_FAILED: "generation_failed";
+};
+/**
+ * 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

@@ -0,0 +1 @@
+{"version":3,"file":"proposal-manager.d.ts","sourceRoot":"","sources":["../../../src/lib/adapters/proposal-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAsB,QAAQ,EAAE,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAExH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,0BAA0B;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,oCAAoC;IACpC,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,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

@@ -0,0 +1,184 @@
+"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: 'proposals_not_supported',
+    PROPOSAL_NOT_FOUND: 'proposal_not_found',
+    PROPOSAL_EXPIRED: 'proposal_expired',
+    INVALID_ALLOCATION: 'invalid_allocation',
+    GENERATION_FAILED: 'generation_failed',
+};
+/**
+ * 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

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