@adcp/sdk 5.23.0

package/dist/lib/adapters/content-standards-adapter.js

@@ -0,0 +1,201 @@
+"use strict";
+/**
+ * Content Standards Adapter
+ *
+ * Server-side adapter for implementing content standards evaluation logic.
+ * Publishers use this to plug in their brand safety/suitability evaluation systems.
+ *
+ * This is a stub implementation that returns not-supported responses.
+ * Publishers should extend or replace this with their actual evaluation logic.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultContentStandardsAdapter = exports.ContentStandardsAdapter = exports.ContentStandardsErrorCodes = void 0;
+exports.isContentStandardsError = isContentStandardsError;
+/**
+ * Error codes for content standards operations
+ */
+exports.ContentStandardsErrorCodes = {
+    NOT_SUPPORTED: 'UNSUPPORTED_FEATURE',
+    STANDARDS_NOT_FOUND: 'REFERENCE_NOT_FOUND',
+    INVALID_STANDARDS: 'INVALID_REQUEST',
+    EVALUATION_FAILED: 'SERVICE_UNAVAILABLE',
+    QUOTA_EXCEEDED: 'QUOTA_EXCEEDED',
+};
+/**
+ * Stub implementation of ContentStandardsAdapter.
+ * Returns not-supported errors for all operations.
+ *
+ * Publishers should extend this class or provide their own implementation
+ * that integrates with their brand safety systems.
+ */
+class ContentStandardsAdapter {
+    /**
+     * Check if content standards are supported.
+     * Override this to return true when implementing real logic.
+     */
+    isSupported() {
+        return false;
+    }
+    async listStandards(request) {
+        if (!this.isSupported()) {
+            return {
+                errors: [
+                    {
+                        code: exports.ContentStandardsErrorCodes.NOT_SUPPORTED,
+                        message: 'Content standards are not supported by this server',
+                    },
+                ],
+            };
+        }
+        // Override in subclass to return actual standards
+        return {
+            standards: [],
+            context: request.context,
+        };
+    }
+    async getStandards(request) {
+        if (!this.isSupported()) {
+            return {
+                errors: [
+                    {
+                        code: exports.ContentStandardsErrorCodes.NOT_SUPPORTED,
+                        message: 'Content standards are not supported by this server',
+                    },
+                ],
+            };
+        }
+        // Override in subclass to return actual standards
+        return {
+            errors: [
+                {
+                    code: exports.ContentStandardsErrorCodes.STANDARDS_NOT_FOUND,
+                    message: `Standards not found: ${request.standards_id}`,
+                },
+            ],
+        };
+    }
+    async createStandards(request) {
+        if (!this.isSupported()) {
+            return {
+                errors: [
+                    {
+                        code: exports.ContentStandardsErrorCodes.NOT_SUPPORTED,
+                        message: 'Content standards are not supported by this server',
+                    },
+                ],
+            };
+        }
+        // Override in subclass to implement creation logic
+        return {
+            errors: [
+                {
+                    code: exports.ContentStandardsErrorCodes.NOT_SUPPORTED,
+                    message: 'Creating content standards is not implemented',
+                },
+            ],
+        };
+    }
+    async updateStandards(request) {
+        if (!this.isSupported()) {
+            return {
+                success: false,
+                errors: [
+                    {
+                        code: exports.ContentStandardsErrorCodes.NOT_SUPPORTED,
+                        message: 'Content standards are not supported by this server',
+                    },
+                ],
+            };
+        }
+        // Override in subclass to implement update logic
+        return {
+            success: false,
+            errors: [
+                {
+                    code: exports.ContentStandardsErrorCodes.NOT_SUPPORTED,
+                    message: 'Updating content standards is not implemented',
+                },
+            ],
+        };
+    }
+    async calibrateContent(request) {
+        if (!this.isSupported()) {
+            return {
+                errors: [
+                    {
+                        code: exports.ContentStandardsErrorCodes.NOT_SUPPORTED,
+                        message: 'Content standards calibration is not supported by this server',
+                    },
+                ],
+            };
+        }
+        // Override in subclass to implement calibration logic
+        return {
+            errors: [
+                {
+                    code: exports.ContentStandardsErrorCodes.EVALUATION_FAILED,
+                    message: 'Content calibration is not implemented',
+                },
+            ],
+        };
+    }
+    async validateContentDelivery(request) {
+        if (!this.isSupported()) {
+            return {
+                errors: [
+                    {
+                        code: exports.ContentStandardsErrorCodes.NOT_SUPPORTED,
+                        message: 'Content delivery validation is not supported by this server',
+                    },
+                ],
+                context: request.context,
+            };
+        }
+        // Override in subclass to implement validation logic
+        // Stub returns all records as passed (no filtering)
+        return {
+            summary: {
+                total_records: request.records.length,
+                passed_records: request.records.length,
+                failed_records: 0,
+            },
+            results: request.records.map(record => ({
+                record_id: record.record_id,
+                verdict: 'pass',
+            })),
+            context: request.context,
+        };
+    }
+    /**
+     * Evaluate a single artifact against content standards.
+     * Used by get_products and create_media_buy to filter content.
+     */
+    async evaluateArtifact(standardsId, artifact) {
+        if (!this.isSupported()) {
+            // When not supported, all content passes (no filtering)
+            return {
+                verdict: 'pass',
+                confidence: 1.0,
+                explanation: 'Content standards evaluation not enabled',
+            };
+        }
+        // Override in subclass to implement actual evaluation
+        return {
+            verdict: 'pass',
+            confidence: 1.0,
+            explanation: 'Default pass-through (no evaluation implemented)',
+        };
+    }
+}
+exports.ContentStandardsAdapter = ContentStandardsAdapter;
+/**
+ * Helper to check if a response is an error response
+ */
+function isContentStandardsError(response) {
+    return 'errors' in response && Array.isArray(response.errors) && response.errors.length > 0;
+}
+/**
+ * Default singleton instance for servers that don't need content standards
+ */
+exports.defaultContentStandardsAdapter = new ContentStandardsAdapter();
+//# sourceMappingURL=content-standards-adapter.js.map

package/dist/lib/adapters/content-standards-adapter.js.map

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

package/dist/lib/adapters/governance-adapter.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Governance Adapter
+ *
+ * Server-side adapter for implementing committed governance checks.
+ * Sellers use this to check governance before executing media buys.
+ *
+ * The committed check verifies that the seller's planned delivery
+ * parameters comply with the buyer's campaign governance plan.
+ */
+import type { CheckGovernanceRequest, CheckGovernanceResponse, PlannedDelivery, GovernancePhase } from '../types/tools.generated';
+import type { AgentConfig } from '../types';
+/**
+ * Configuration for the seller-side governance adapter.
+ */
+export interface GovernanceAdapterConfig {
+    /** The governance agent to call for committed checks */
+    agent: AgentConfig;
+    /** The seller's caller URL for governance checks */
+    callerUrl: string;
+}
+/**
+ * Committed governance check request from the seller's perspective.
+ */
+export interface CommittedCheckRequest {
+    /** Campaign governance plan ID */
+    planId: string;
+    /** @deprecated No longer sent to governance agent — use governanceContext instead */
+    mediaBuyId?: string;
+    /** Opaque governance context from the buyer's protocol envelope. Pass through verbatim. */
+    governanceContext?: string;
+    /** What the seller will actually deliver */
+    plannedDelivery: PlannedDelivery;
+    /** Lifecycle phase of the check */
+    phase?: GovernancePhase;
+    /** Delivery metrics for delivery-phase checks */
+    deliveryMetrics?: CheckGovernanceRequest['delivery_metrics'];
+    /** Summary of changes for modification-phase checks */
+    modificationSummary?: string;
+}
+/**
+ * Interface for seller-side governance adapters.
+ * Sellers implement this to integrate governance checks into their execution path.
+ */
+export interface IGovernanceAdapter {
+    /** Whether governance is supported by this server */
+    isSupported(): boolean;
+    /** Run a committed governance check before executing a media buy */
+    checkCommitted(request: CommittedCheckRequest): Promise<CheckGovernanceResponse>;
+}
+/**
+ * Error codes for governance adapter responses.
+ */
+export declare const GovernanceAdapterErrorCodes: {
+    readonly NOT_SUPPORTED: "governance_not_supported";
+    readonly CHECK_FAILED: "governance_check_failed";
+    readonly AGENT_UNREACHABLE: "governance_agent_unreachable";
+};
+export type GovernanceAdapterErrorCode = (typeof GovernanceAdapterErrorCodes)[keyof typeof GovernanceAdapterErrorCodes];
+/**
+ * Type guard: check if a response is a governance adapter error.
+ */
+export declare function isGovernanceAdapterError(response: unknown): response is {
+    error: {
+        code: GovernanceAdapterErrorCode;
+        message?: string;
+    };
+};
+/**
+ * Governance adapter that calls a governance agent via AdCP protocol.
+ *
+ * Sellers configure this with their governance agent and caller URL,
+ * then call checkCommitted() before executing media buys.
+ *
+ * For custom governance logic, extend this class and override checkCommitted().
+ */
+export declare class GovernanceAdapter implements IGovernanceAdapter {
+    private agentConfig?;
+    constructor(config?: GovernanceAdapterConfig);
+    isSupported(): boolean;
+    checkCommitted(request: CommittedCheckRequest): Promise<CheckGovernanceResponse>;
+}
+/**
+ * Pre-configured governance adapter with no agent.
+ * isSupported() returns false and checkCommitted() returns a denial.
+ * Replace with a configured instance when connecting to a governance agent.
+ */
+export declare const defaultGovernanceAdapter: GovernanceAdapter;
+//# sourceMappingURL=governance-adapter.d.ts.map

package/dist/lib/adapters/governance-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"governance-adapter.d.ts","sourceRoot":"","sources":["../../../src/lib/adapters/governance-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,sBAAsB,EACtB,uBAAuB,EACvB,eAAe,EACf,eAAe,EAChB,MAAM,0BAA0B,CAAC;AAElC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAG5C;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,wDAAwD;IACxD,KAAK,EAAE,WAAW,CAAC;IACnB,oDAAoD;IACpD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,qFAAqF;IACrF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2FAA2F;IAC3F,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,4CAA4C;IAC5C,eAAe,EAAE,eAAe,CAAC;IACjC,mCAAmC;IACnC,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,iDAAiD;IACjD,eAAe,CAAC,EAAE,sBAAsB,CAAC,kBAAkB,CAAC,CAAC;IAC7D,uDAAuD;IACvD,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,qDAAqD;IACrD,WAAW,IAAI,OAAO,CAAC;IACvB,oEAAoE;IACpE,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAC;CAClF;AAED;;GAEG;AACH,eAAO,MAAM,2BAA2B;;;;CAI9B,CAAC;AAEX,MAAM,MAAM,0BAA0B,GAAG,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,OAAO,2BAA2B,CAAC,CAAC;AAExH;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,OAAO,GAChB,QAAQ,IAAI;IAAE,KAAK,EAAE;QAAE,IAAI,EAAE,0BAA0B,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAI/E;AAED;;;;;;;GAOG;AACH,qBAAa,iBAAkB,YAAW,kBAAkB;IAC1D,OAAO,CAAC,WAAW,CAAC,CAA0B;gBAElC,MAAM,CAAC,EAAE,uBAAuB;IAI5C,WAAW,IAAI,OAAO;IAIhB,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,uBAAuB,CAAC;CA0CvF;AAED;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,mBAA0B,CAAC"}

package/dist/lib/adapters/governance-adapter.js

@@ -0,0 +1,93 @@
+"use strict";
+/**
+ * Governance Adapter
+ *
+ * Server-side adapter for implementing committed governance checks.
+ * Sellers use this to check governance before executing media buys.
+ *
+ * The committed check verifies that the seller's planned delivery
+ * parameters comply with the buyer's campaign governance plan.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultGovernanceAdapter = exports.GovernanceAdapter = exports.GovernanceAdapterErrorCodes = void 0;
+exports.isGovernanceAdapterError = isGovernanceAdapterError;
+const protocols_1 = require("../protocols");
+const response_unwrapper_1 = require("../utils/response-unwrapper");
+/**
+ * Error codes for governance adapter responses.
+ */
+exports.GovernanceAdapterErrorCodes = {
+    NOT_SUPPORTED: 'governance_not_supported',
+    CHECK_FAILED: 'governance_check_failed',
+    AGENT_UNREACHABLE: 'governance_agent_unreachable',
+};
+/**
+ * Type guard: check if a response is a governance adapter error.
+ */
+function isGovernanceAdapterError(response) {
+    if (!response || typeof response !== 'object')
+        return false;
+    const r = response;
+    return r.error?.code && Object.values(exports.GovernanceAdapterErrorCodes).includes(r.error.code);
+}
+/**
+ * Governance adapter that calls a governance agent via AdCP protocol.
+ *
+ * Sellers configure this with their governance agent and caller URL,
+ * then call checkCommitted() before executing media buys.
+ *
+ * For custom governance logic, extend this class and override checkCommitted().
+ */
+class GovernanceAdapter {
+    agentConfig;
+    constructor(config) {
+        this.agentConfig = config;
+    }
+    isSupported() {
+        return !!this.agentConfig;
+    }
+    async checkCommitted(request) {
+        if (!this.agentConfig) {
+            return {
+                check_id: '',
+                status: 'denied',
+                binding: 'committed',
+                plan_id: request.planId,
+                explanation: 'Governance not configured on this server',
+                error_code: exports.GovernanceAdapterErrorCodes.NOT_SUPPORTED,
+            };
+        }
+        const checkRequest = {
+            plan_id: request.planId,
+            caller: this.agentConfig.callerUrl,
+            governance_context: request.governanceContext,
+            planned_delivery: request.plannedDelivery,
+            phase: request.phase,
+            delivery_metrics: request.deliveryMetrics,
+            ...(request.mediaBuyId && { payload: { media_buy_id: request.mediaBuyId } }),
+            ...(request.modificationSummary && { payload: { modification_summary: request.modificationSummary } }),
+        };
+        try {
+            const response = await protocols_1.ProtocolClient.callTool(this.agentConfig.agent, 'check_governance', checkRequest);
+            return (0, response_unwrapper_1.unwrapProtocolResponse)(response);
+        }
+        catch (err) {
+            return {
+                check_id: '',
+                status: 'denied',
+                binding: 'committed',
+                plan_id: request.planId,
+                explanation: `Governance agent unreachable: ${err.message}`,
+                error_code: exports.GovernanceAdapterErrorCodes.AGENT_UNREACHABLE,
+            };
+        }
+    }
+}
+exports.GovernanceAdapter = GovernanceAdapter;
+/**
+ * Pre-configured governance adapter with no agent.
+ * isSupported() returns false and checkCommitted() returns a denial.
+ * Replace with a configured instance when connecting to a governance agent.
+ */
+exports.defaultGovernanceAdapter = new GovernanceAdapter();
+//# sourceMappingURL=governance-adapter.js.map

package/dist/lib/adapters/governance-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"governance-adapter.js","sourceRoot":"","sources":["../../../src/lib/adapters/governance-adapter.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAmEH,4DAMC;AAjED,4CAA8C;AAE9C,oEAAqE;AA2CrE;;GAEG;AACU,QAAA,2BAA2B,GAAG;IACzC,aAAa,EAAE,0BAA0B;IACzC,YAAY,EAAE,yBAAyB;IACvC,iBAAiB,EAAE,8BAA8B;CACzC,CAAC;AAIX;;GAEG;AACH,SAAgB,wBAAwB,CACtC,QAAiB;IAEjB,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5D,MAAM,CAAC,GAAG,QAA+B,CAAC;IAC1C,OAAO,CAAC,CAAC,KAAK,EAAE,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,mCAA2B,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAC5F,CAAC;AAED;;;;;;;GAOG;AACH,MAAa,iBAAiB;IACpB,WAAW,CAA2B;IAE9C,YAAY,MAAgC;QAC1C,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC;IAC5B,CAAC;IAED,WAAW;QACT,OAAO,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,OAA8B;QACjD,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,OAAO;gBACL,QAAQ,EAAE,EAAE;gBACZ,MAAM,EAAE,QAAQ;gBAChB,OAAO,EAAE,WAAW;gBACpB,OAAO,EAAE,OAAO,CAAC,MAAM;gBACvB,WAAW,EAAE,0CAA0C;gBACvD,UAAU,EAAE,mCAA2B,CAAC,aAAa;aAC3B,CAAC;QAC/B,CAAC;QAED,MAAM,YAAY,GAA2B;YAC3C,OAAO,EAAE,OAAO,CAAC,MAAM;YACvB,MAAM,EAAE,IAAI,CAAC,WAAW,CAAC,SAAS;YAClC,kBAAkB,EAAE,OAAO,CAAC,iBAAiB;YAC7C,gBAAgB,EAAE,OAAO,CAAC,eAAe;YACzC,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,gBAAgB,EAAE,OAAO,CAAC,eAAe;YACzC,GAAG,CAAC,OAAO,CAAC,UAAU,IAAI,EAAE,OAAO,EAAE,EAAE,YAAY,EAAE,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;YAC5E,GAAG,CAAC,OAAO,CAAC,mBAAmB,IAAI,EAAE,OAAO,EAAE,EAAE,oBAAoB,EAAE,OAAO,CAAC,mBAAmB,EAAE,EAAE,CAAC;SACvG,CAAC;QAEF,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,0BAAc,CAAC,QAAQ,CAC5C,IAAI,CAAC,WAAW,CAAC,KAAK,EACtB,kBAAkB,EAClB,YAAmC,CACpC,CAAC;YAEF,OAAO,IAAA,2CAAsB,EAAC,QAAQ,CAAuC,CAAC;QAChF,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO;gBACL,QAAQ,EAAE,EAAE;gBACZ,MAAM,EAAE,QAAQ;gBAChB,OAAO,EAAE,WAAW;gBACpB,OAAO,EAAE,OAAO,CAAC,MAAM;gBACvB,WAAW,EAAE,iCAAkC,GAAa,CAAC,OAAO,EAAE;gBACtE,UAAU,EAAE,mCAA2B,CAAC,iBAAiB;aAC/B,CAAC;QAC/B,CAAC;IACH,CAAC;CACF;AArDD,8CAqDC;AAED;;;;GAIG;AACU,QAAA,wBAAwB,GAAG,IAAI,iBAAiB,EAAE,CAAC"}

package/dist/lib/adapters/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Server-Side Adapters
+ *
+ * These adapters allow publishers/brands to plug in their business logic
+ * when implementing AdCP servers. Each adapter provides a stub implementation
+ * that can be extended or replaced.
+ *
+ * Usage:
+ * - ContentStandardsAdapter: Implement brand safety/suitability evaluation
+ * - PropertyListAdapter: Manage buyer-defined property lists
+ * - ProposalManager: Generate and refine media plan proposals
+ * - SISessionManager: Handle Sponsored Intelligence conversational sessions
+ */
+export { ContentStandardsAdapter, type IContentStandardsAdapter, type ContentEvaluationResult, ContentStandardsErrorCodes, isContentStandardsError, defaultContentStandardsAdapter, } from './content-standards-adapter';
+export { PropertyListAdapter, type IPropertyListAdapter, type ResolvedProperty, PropertyListErrorCodes, isPropertyListError, defaultPropertyListAdapter, } from './property-list-adapter';
+export { ProposalManager, AIProposalManager, type IProposalManager, type ProposalContext, ProposalErrorCodes, defaultProposalManager, } from './proposal-manager';
+export { GovernanceAdapter, defaultGovernanceAdapter, type IGovernanceAdapter, type GovernanceAdapterConfig, type GovernanceAdapterErrorCode, type CommittedCheckRequest, GovernanceAdapterErrorCodes, isGovernanceAdapterError, } from './governance-adapter';
+export { SISessionManager, AISISessionManager, type ISISessionManager, type SISession, SIErrorCodes, defaultSISessionManager, } from './si-session-manager';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/adapters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EACL,uBAAuB,EACvB,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,EAC5B,0BAA0B,EAC1B,uBAAuB,EACvB,8BAA8B,GAC/B,MAAM,6BAA6B,CAAC;AAGrC,OAAO,EACL,mBAAmB,EACnB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,sBAAsB,EACtB,mBAAmB,EACnB,0BAA0B,GAC3B,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,iBAAiB,EACjB,wBAAwB,EACxB,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,0BAA0B,EAC/B,KAAK,qBAAqB,EAC1B,2BAA2B,EAC3B,wBAAwB,GACzB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,KAAK,iBAAiB,EACtB,KAAK,SAAS,EACd,YAAY,EACZ,uBAAuB,GACxB,MAAM,sBAAsB,CAAC"}

package/dist/lib/adapters/index.js

@@ -0,0 +1,47 @@
+"use strict";
+/**
+ * Server-Side Adapters
+ *
+ * These adapters allow publishers/brands to plug in their business logic
+ * when implementing AdCP servers. Each adapter provides a stub implementation
+ * that can be extended or replaced.
+ *
+ * Usage:
+ * - ContentStandardsAdapter: Implement brand safety/suitability evaluation
+ * - PropertyListAdapter: Manage buyer-defined property lists
+ * - ProposalManager: Generate and refine media plan proposals
+ * - SISessionManager: Handle Sponsored Intelligence conversational sessions
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultSISessionManager = exports.SIErrorCodes = exports.AISISessionManager = exports.SISessionManager = exports.isGovernanceAdapterError = exports.GovernanceAdapterErrorCodes = exports.defaultGovernanceAdapter = exports.GovernanceAdapter = exports.defaultProposalManager = exports.ProposalErrorCodes = exports.AIProposalManager = exports.ProposalManager = exports.defaultPropertyListAdapter = exports.isPropertyListError = exports.PropertyListErrorCodes = exports.PropertyListAdapter = exports.defaultContentStandardsAdapter = exports.isContentStandardsError = exports.ContentStandardsErrorCodes = exports.ContentStandardsAdapter = void 0;
+// Content Standards
+var content_standards_adapter_1 = require("./content-standards-adapter");
+Object.defineProperty(exports, "ContentStandardsAdapter", { enumerable: true, get: function () { return content_standards_adapter_1.ContentStandardsAdapter; } });
+Object.defineProperty(exports, "ContentStandardsErrorCodes", { enumerable: true, get: function () { return content_standards_adapter_1.ContentStandardsErrorCodes; } });
+Object.defineProperty(exports, "isContentStandardsError", { enumerable: true, get: function () { return content_standards_adapter_1.isContentStandardsError; } });
+Object.defineProperty(exports, "defaultContentStandardsAdapter", { enumerable: true, get: function () { return content_standards_adapter_1.defaultContentStandardsAdapter; } });
+// Property Lists
+var property_list_adapter_1 = require("./property-list-adapter");
+Object.defineProperty(exports, "PropertyListAdapter", { enumerable: true, get: function () { return property_list_adapter_1.PropertyListAdapter; } });
+Object.defineProperty(exports, "PropertyListErrorCodes", { enumerable: true, get: function () { return property_list_adapter_1.PropertyListErrorCodes; } });
+Object.defineProperty(exports, "isPropertyListError", { enumerable: true, get: function () { return property_list_adapter_1.isPropertyListError; } });
+Object.defineProperty(exports, "defaultPropertyListAdapter", { enumerable: true, get: function () { return property_list_adapter_1.defaultPropertyListAdapter; } });
+// Proposal Management
+var proposal_manager_1 = require("./proposal-manager");
+Object.defineProperty(exports, "ProposalManager", { enumerable: true, get: function () { return proposal_manager_1.ProposalManager; } });
+Object.defineProperty(exports, "AIProposalManager", { enumerable: true, get: function () { return proposal_manager_1.AIProposalManager; } });
+Object.defineProperty(exports, "ProposalErrorCodes", { enumerable: true, get: function () { return proposal_manager_1.ProposalErrorCodes; } });
+Object.defineProperty(exports, "defaultProposalManager", { enumerable: true, get: function () { return proposal_manager_1.defaultProposalManager; } });
+// Governance (seller-side committed checks)
+var governance_adapter_1 = require("./governance-adapter");
+Object.defineProperty(exports, "GovernanceAdapter", { enumerable: true, get: function () { return governance_adapter_1.GovernanceAdapter; } });
+Object.defineProperty(exports, "defaultGovernanceAdapter", { enumerable: true, get: function () { return governance_adapter_1.defaultGovernanceAdapter; } });
+Object.defineProperty(exports, "GovernanceAdapterErrorCodes", { enumerable: true, get: function () { return governance_adapter_1.GovernanceAdapterErrorCodes; } });
+Object.defineProperty(exports, "isGovernanceAdapterError", { enumerable: true, get: function () { return governance_adapter_1.isGovernanceAdapterError; } });
+// Sponsored Intelligence Sessions
+var si_session_manager_1 = require("./si-session-manager");
+Object.defineProperty(exports, "SISessionManager", { enumerable: true, get: function () { return si_session_manager_1.SISessionManager; } });
+Object.defineProperty(exports, "AISISessionManager", { enumerable: true, get: function () { return si_session_manager_1.AISISessionManager; } });
+Object.defineProperty(exports, "SIErrorCodes", { enumerable: true, get: function () { return si_session_manager_1.SIErrorCodes; } });
+Object.defineProperty(exports, "defaultSISessionManager", { enumerable: true, get: function () { return si_session_manager_1.defaultSISessionManager; } });
+//# sourceMappingURL=index.js.map

package/dist/lib/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/adapters/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;;AAEH,oBAAoB;AACpB,yEAOqC;AANnC,oIAAA,uBAAuB,OAAA;AAGvB,uIAAA,0BAA0B,OAAA;AAC1B,oIAAA,uBAAuB,OAAA;AACvB,2IAAA,8BAA8B,OAAA;AAGhC,iBAAiB;AACjB,iEAOiC;AAN/B,4HAAA,mBAAmB,OAAA;AAGnB,+HAAA,sBAAsB,OAAA;AACtB,4HAAA,mBAAmB,OAAA;AACnB,mIAAA,0BAA0B,OAAA;AAG5B,sBAAsB;AACtB,uDAO4B;AAN1B,mHAAA,eAAe,OAAA;AACf,qHAAA,iBAAiB,OAAA;AAGjB,sHAAA,kBAAkB,OAAA;AAClB,0HAAA,sBAAsB,OAAA;AAGxB,4CAA4C;AAC5C,2DAS8B;AAR5B,uHAAA,iBAAiB,OAAA;AACjB,8HAAA,wBAAwB,OAAA;AAKxB,iIAAA,2BAA2B,OAAA;AAC3B,8HAAA,wBAAwB,OAAA;AAG1B,kCAAkC;AAClC,2DAO8B;AAN5B,sHAAA,gBAAgB,OAAA;AAChB,wHAAA,kBAAkB,OAAA;AAGlB,kHAAA,YAAY,OAAA;AACZ,6HAAA,uBAAuB,OAAA"}

package/dist/lib/adapters/property-list-adapter.d.ts

@@ -0,0 +1,123 @@
+/**
+ * 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.
+ */
+import type { CreatePropertyListRequest, CreatePropertyListResponse, UpdatePropertyListRequest, UpdatePropertyListResponse, GetPropertyListRequest, GetPropertyListResponse, ListPropertyListsRequest, ListPropertyListsResponse, DeletePropertyListRequest, DeletePropertyListResponse } from '../types/tools.generated';
+/**
+ * Resolved property identifier
+ */
+export interface ResolvedProperty {
+    identifier_type: string;
+    identifier_value: string;
+    publisher_domain?: string;
+    display_name?: string;
+    status?: 'active' | 'inactive' | 'pending';
+}
+/**
+ * Error thrown when property list operations fail
+ */
+export declare class PropertyListError extends Error {
+    code: string;
+    constructor(code: string, message: string);
+}
+/**
+ * Abstract interface for property list adapters.
+ * Publishers implement this to provide their storage and resolution logic.
+ */
+export interface IPropertyListAdapter {
+    /**
+     * Check if property list management is supported by this server
+     */
+    isSupported(): boolean;
+    /**
+     * Create a new property list
+     */
+    createList(request: CreatePropertyListRequest): Promise<CreatePropertyListResponse>;
+    /**
+     * Update an existing property list
+     */
+    updateList(request: UpdatePropertyListRequest): Promise<UpdatePropertyListResponse>;
+    /**
+     * Get a property list with optional resolution
+     */
+    getList(request: GetPropertyListRequest): Promise<GetPropertyListResponse>;
+    /**
+     * List all property lists for an account
+     */
+    listLists(request: ListPropertyListsRequest): Promise<ListPropertyListsResponse>;
+    /**
+     * Delete a property list
+     */
+    deleteList(request: DeletePropertyListRequest): Promise<DeletePropertyListResponse>;
+    /**
+     * Check if a property identifier is in a property list.
+     * Used by get_products and create_media_buy for filtering.
+     */
+    isPropertyInList(listId: string, identifierType: string, identifierValue: string): Promise<boolean>;
+    /**
+     * Resolve a property list to its constituent identifiers.
+     * Applies filters and returns matching properties.
+     */
+    resolveList(listId: string, maxResults?: number, cursor?: string): Promise<ResolvedProperty[]>;
+}
+/**
+ * Error codes for property list operations
+ */
+export declare const PropertyListErrorCodes: {
+    readonly NOT_SUPPORTED: "UNSUPPORTED_FEATURE";
+    readonly LIST_NOT_FOUND: "REFERENCE_NOT_FOUND";
+    readonly INVALID_LIST: "INVALID_REQUEST";
+    readonly PERMISSION_DENIED: "PERMISSION_DENIED";
+    readonly 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.
+ */
+export declare class PropertyListAdapter implements IPropertyListAdapter {
+    private lists;
+    private authTokens;
+    private nextId;
+    /**
+     * Check if property list management is supported.
+     * Override this to return true when implementing real logic.
+     */
+    isSupported(): boolean;
+    createList(request: CreatePropertyListRequest): Promise<CreatePropertyListResponse>;
+    updateList(request: UpdatePropertyListRequest): Promise<UpdatePropertyListResponse>;
+    getList(request: GetPropertyListRequest): Promise<GetPropertyListResponse>;
+    listLists(request: ListPropertyListsRequest): Promise<ListPropertyListsResponse>;
+    deleteList(request: DeletePropertyListRequest): Promise<DeletePropertyListResponse>;
+    /**
+     * Check if a property is in a list.
+     * Stub implementation returns false (property not found).
+     */
+    isPropertyInList(listId: string, identifierType: string, identifierValue: string): Promise<boolean>;
+    /**
+     * Resolve a property list to identifiers.
+     * Stub implementation returns empty array.
+     */
+    resolveList(listId: string, maxResults?: number, cursor?: string): Promise<ResolvedProperty[]>;
+    /**
+     * Generate a random token for auth
+     */
+    protected generateToken(): string;
+}
+/**
+ * Helper to check if an error is a PropertyListError
+ */
+export declare function isPropertyListError(error: unknown): error is PropertyListError;
+/**
+ * Default singleton instance for servers that don't need property list management
+ */
+export declare const defaultPropertyListAdapter: PropertyListAdapter;
+//# sourceMappingURL=property-list-adapter.d.ts.map

package/dist/lib/adapters/property-list-adapter.d.ts.map

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