@adcp/sdk 5.23.0

package/dist/lib/utils/index.js

@@ -0,0 +1,196 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getFloorPrice = exports.getPrice = exports.isCPAPricing = exports.isFixedPricing = exports.usesV3PricingFields = exports.usesV2PricingFields = exports.normalizeGetProductsResponse = exports.normalizeProductPricing = exports.normalizePricingOption = exports.adaptPricingOptionForV2 = exports.normalizeProductChannels = exports.adaptGetProductsRequestForV2 = exports.hasAssets = exports.getAssetCount = exports.usesDeprecatedAssetsField = exports.getRepeatableGroups = exports.getIndividualAssets = exports.getOptionalAssets = exports.getRequiredAssets = exports.getFormatAssets = exports.stripTransportSuffix = exports.stripAgentCardPath = exports.buildCardUrls = exports.isWellKnownAgentCardUrl = exports.isAgentCardPath = exports.TRANSPORT_SUFFIX_REGEX = exports.A2A_CARD_PATHS = exports.detectProtocolWithTimeout = exports.detectProtocol = exports.getExpectedAction = exports.resolveRecovery = exports.extractCorrelationId = exports.extractAdcpErrorInfo = exports.extractAdcpErrorFromTransport = exports.extractAdcpErrorFromMcp = exports.getRetryDelay = exports.isRetryable = exports.extractResult = exports.isAdcpSuccess = exports.isAdcpError = exports.unwrapProtocolResponse = exports.CircuitBreaker = exports.STANDARD_FORMATS = exports.MAX_CONCURRENT = exports.REQUEST_TIMEOUT = exports.clearPreviewCache = exports.batchPreviewFormats = exports.batchPreviewProducts = exports.createLogger = exports.logger = void 0;
+exports.paginatePages = exports.paginate = exports.adaptSyncCreativesRequestForV2 = void 0;
+exports.getCircuitBreaker = getCircuitBreaker;
+exports.getStandardFormats = getStandardFormats;
+// Re-export logger utilities
+var logger_1 = require("./logger");
+Object.defineProperty(exports, "logger", { enumerable: true, get: function () { return logger_1.logger; } });
+Object.defineProperty(exports, "createLogger", { enumerable: true, get: function () { return logger_1.createLogger; } });
+const logger_2 = require("./logger");
+// Re-export preview utilities
+var preview_utils_1 = require("./preview-utils");
+Object.defineProperty(exports, "batchPreviewProducts", { enumerable: true, get: function () { return preview_utils_1.batchPreviewProducts; } });
+Object.defineProperty(exports, "batchPreviewFormats", { enumerable: true, get: function () { return preview_utils_1.batchPreviewFormats; } });
+Object.defineProperty(exports, "clearPreviewCache", { enumerable: true, get: function () { return preview_utils_1.clearPreviewCache; } });
+// Configuration constants
+exports.REQUEST_TIMEOUT = parseInt(process.env.REQUEST_TIMEOUT || '30000'); // 30 seconds
+exports.MAX_CONCURRENT = parseInt(process.env.MAX_CONCURRENT || '5');
+// Standard creative formats (hardcoded for now)
+exports.STANDARD_FORMATS = [
+    {
+        format_id: {
+            agent_url: 'https://creatives.adcontextprotocol.org',
+            id: 'banner_728x90',
+        },
+        name: 'Leaderboard',
+        dimensions: { width: 728, height: 90 },
+        aspect_ratio: '8:1',
+        file_types: ['jpg', 'jpeg', 'png', 'gif'],
+        max_file_size: 150000,
+    },
+    {
+        format_id: {
+            agent_url: 'https://creatives.adcontextprotocol.org',
+            id: 'banner_300x250',
+        },
+        name: 'Medium Rectangle',
+        dimensions: { width: 300, height: 250 },
+        aspect_ratio: '6:5',
+        file_types: ['jpg', 'jpeg', 'png', 'gif'],
+        max_file_size: 150000,
+    },
+    {
+        format_id: {
+            agent_url: 'https://creatives.adcontextprotocol.org',
+            id: 'banner_320x50',
+        },
+        name: 'Mobile Banner',
+        dimensions: { width: 320, height: 50 },
+        aspect_ratio: '32:5',
+        file_types: ['jpg', 'jpeg', 'png', 'gif'],
+        max_file_size: 40000,
+    },
+    {
+        format_id: {
+            agent_url: 'https://creatives.adcontextprotocol.org',
+            id: 'video_1920x1080',
+        },
+        name: 'Full HD Video',
+        dimensions: { width: 1920, height: 1080 },
+        aspect_ratio: '16:9',
+        file_types: ['mp4', 'webm'],
+        max_file_size: 10000000,
+        duration_range: { min: 6, max: 30 },
+    },
+];
+/**
+ * Circuit Breaker for handling agent failures
+ */
+class CircuitBreaker {
+    agentId;
+    failures = 0;
+    lastFailTime = 0;
+    state = 'closed';
+    failureThreshold = 5;
+    resetTimeout = 60000; // 1 minute
+    constructor(agentId) {
+        this.agentId = agentId;
+    }
+    async call(fn) {
+        if (this.state === 'open') {
+            if (Date.now() - this.lastFailTime > this.resetTimeout) {
+                this.state = 'half-open';
+                logger_2.logger.info(`🔄 Circuit breaker for ${this.agentId} attempting to close...`);
+            }
+            else {
+                throw new Error(`Circuit breaker is open for agent ${this.agentId}`);
+            }
+        }
+        try {
+            const result = await fn();
+            this.onSuccess();
+            return result;
+        }
+        catch (error) {
+            this.onFailure();
+            throw error;
+        }
+    }
+    onSuccess() {
+        this.failures = 0;
+        if (this.state === 'half-open') {
+            this.state = 'closed';
+            logger_2.logger.info(`✅ Circuit breaker for ${this.agentId} closed successfully`);
+        }
+    }
+    onFailure() {
+        this.failures++;
+        this.lastFailTime = Date.now();
+        if (this.failures >= this.failureThreshold) {
+            this.state = 'open';
+            logger_2.logger.warn(`🚨 Circuit breaker opened for agent ${this.agentId} after ${this.failures} failures`);
+        }
+    }
+}
+exports.CircuitBreaker = CircuitBreaker;
+// Circuit breaker instances for each agent
+const circuitBreakers = new Map();
+function getCircuitBreaker(agentId) {
+    if (!circuitBreakers.has(agentId)) {
+        circuitBreakers.set(agentId, new CircuitBreaker(agentId));
+    }
+    return circuitBreakers.get(agentId);
+}
+/**
+ * Get standard creative formats
+ */
+function getStandardFormats() {
+    return exports.STANDARD_FORMATS;
+}
+// Re-export response unwrapping utilities
+var response_unwrapper_1 = require("./response-unwrapper");
+Object.defineProperty(exports, "unwrapProtocolResponse", { enumerable: true, get: function () { return response_unwrapper_1.unwrapProtocolResponse; } });
+Object.defineProperty(exports, "isAdcpError", { enumerable: true, get: function () { return response_unwrapper_1.isAdcpError; } });
+Object.defineProperty(exports, "isAdcpSuccess", { enumerable: true, get: function () { return response_unwrapper_1.isAdcpSuccess; } });
+// Lightweight MCP CallToolResult extractor (prefers structuredContent, falls back to JSON text).
+var extract_result_1 = require("./extract-result");
+Object.defineProperty(exports, "extractResult", { enumerable: true, get: function () { return extract_result_1.extractResult; } });
+// Re-export retry utilities
+var retry_1 = require("./retry");
+Object.defineProperty(exports, "isRetryable", { enumerable: true, get: function () { return retry_1.isRetryable; } });
+Object.defineProperty(exports, "getRetryDelay", { enumerable: true, get: function () { return retry_1.getRetryDelay; } });
+// Re-export error extraction utilities
+var error_extraction_1 = require("./error-extraction");
+Object.defineProperty(exports, "extractAdcpErrorFromMcp", { enumerable: true, get: function () { return error_extraction_1.extractAdcpErrorFromMcp; } });
+Object.defineProperty(exports, "extractAdcpErrorFromTransport", { enumerable: true, get: function () { return error_extraction_1.extractAdcpErrorFromTransport; } });
+Object.defineProperty(exports, "extractAdcpErrorInfo", { enumerable: true, get: function () { return error_extraction_1.extractAdcpErrorInfo; } });
+Object.defineProperty(exports, "extractCorrelationId", { enumerable: true, get: function () { return error_extraction_1.extractCorrelationId; } });
+Object.defineProperty(exports, "resolveRecovery", { enumerable: true, get: function () { return error_extraction_1.resolveRecovery; } });
+Object.defineProperty(exports, "getExpectedAction", { enumerable: true, get: function () { return error_extraction_1.getExpectedAction; } });
+// Re-export protocol detection utilities
+var protocol_detection_1 = require("./protocol-detection");
+Object.defineProperty(exports, "detectProtocol", { enumerable: true, get: function () { return protocol_detection_1.detectProtocol; } });
+Object.defineProperty(exports, "detectProtocolWithTimeout", { enumerable: true, get: function () { return protocol_detection_1.detectProtocolWithTimeout; } });
+// Re-export A2A discovery utilities
+var a2a_discovery_1 = require("./a2a-discovery");
+Object.defineProperty(exports, "A2A_CARD_PATHS", { enumerable: true, get: function () { return a2a_discovery_1.A2A_CARD_PATHS; } });
+Object.defineProperty(exports, "TRANSPORT_SUFFIX_REGEX", { enumerable: true, get: function () { return a2a_discovery_1.TRANSPORT_SUFFIX_REGEX; } });
+Object.defineProperty(exports, "isAgentCardPath", { enumerable: true, get: function () { return a2a_discovery_1.isAgentCardPath; } });
+Object.defineProperty(exports, "isWellKnownAgentCardUrl", { enumerable: true, get: function () { return a2a_discovery_1.isWellKnownAgentCardUrl; } });
+Object.defineProperty(exports, "buildCardUrls", { enumerable: true, get: function () { return a2a_discovery_1.buildCardUrls; } });
+Object.defineProperty(exports, "stripAgentCardPath", { enumerable: true, get: function () { return a2a_discovery_1.stripAgentCardPath; } });
+Object.defineProperty(exports, "stripTransportSuffix", { enumerable: true, get: function () { return a2a_discovery_1.stripTransportSuffix; } });
+// Re-export format asset utilities
+var format_assets_1 = require("./format-assets");
+Object.defineProperty(exports, "getFormatAssets", { enumerable: true, get: function () { return format_assets_1.getFormatAssets; } });
+Object.defineProperty(exports, "getRequiredAssets", { enumerable: true, get: function () { return format_assets_1.getRequiredAssets; } });
+Object.defineProperty(exports, "getOptionalAssets", { enumerable: true, get: function () { return format_assets_1.getOptionalAssets; } });
+Object.defineProperty(exports, "getIndividualAssets", { enumerable: true, get: function () { return format_assets_1.getIndividualAssets; } });
+Object.defineProperty(exports, "getRepeatableGroups", { enumerable: true, get: function () { return format_assets_1.getRepeatableGroups; } });
+Object.defineProperty(exports, "usesDeprecatedAssetsField", { enumerable: true, get: function () { return format_assets_1.usesDeprecatedAssetsField; } });
+Object.defineProperty(exports, "getAssetCount", { enumerable: true, get: function () { return format_assets_1.getAssetCount; } });
+Object.defineProperty(exports, "hasAssets", { enumerable: true, get: function () { return format_assets_1.hasAssets; } });
+// Re-export pricing adapter utilities (v3 pricing field compatibility)
+var pricing_adapter_1 = require("./pricing-adapter");
+Object.defineProperty(exports, "adaptGetProductsRequestForV2", { enumerable: true, get: function () { return pricing_adapter_1.adaptGetProductsRequestForV2; } });
+Object.defineProperty(exports, "normalizeProductChannels", { enumerable: true, get: function () { return pricing_adapter_1.normalizeProductChannels; } });
+Object.defineProperty(exports, "adaptPricingOptionForV2", { enumerable: true, get: function () { return pricing_adapter_1.adaptPricingOptionForV2; } });
+Object.defineProperty(exports, "normalizePricingOption", { enumerable: true, get: function () { return pricing_adapter_1.normalizePricingOption; } });
+Object.defineProperty(exports, "normalizeProductPricing", { enumerable: true, get: function () { return pricing_adapter_1.normalizeProductPricing; } });
+Object.defineProperty(exports, "normalizeGetProductsResponse", { enumerable: true, get: function () { return pricing_adapter_1.normalizeGetProductsResponse; } });
+Object.defineProperty(exports, "usesV2PricingFields", { enumerable: true, get: function () { return pricing_adapter_1.usesV2PricingFields; } });
+Object.defineProperty(exports, "usesV3PricingFields", { enumerable: true, get: function () { return pricing_adapter_1.usesV3PricingFields; } });
+Object.defineProperty(exports, "isFixedPricing", { enumerable: true, get: function () { return pricing_adapter_1.isFixedPricing; } });
+Object.defineProperty(exports, "isCPAPricing", { enumerable: true, get: function () { return pricing_adapter_1.isCPAPricing; } });
+Object.defineProperty(exports, "getPrice", { enumerable: true, get: function () { return pricing_adapter_1.getPrice; } });
+Object.defineProperty(exports, "getFloorPrice", { enumerable: true, get: function () { return pricing_adapter_1.getFloorPrice; } });
+// Re-export sync creatives adapter (v2/v3 compatibility)
+var sync_creatives_adapter_1 = require("./sync-creatives-adapter");
+Object.defineProperty(exports, "adaptSyncCreativesRequestForV2", { enumerable: true, get: function () { return sync_creatives_adapter_1.adaptSyncCreativesRequestForV2; } });
+// Re-export pagination utilities
+var pagination_1 = require("./pagination");
+Object.defineProperty(exports, "paginate", { enumerable: true, get: function () { return pagination_1.paginate; } });
+Object.defineProperty(exports, "paginatePages", { enumerable: true, get: function () { return pagination_1.paginatePages; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/utils/index.ts"],"names":[],"mappings":";;;;AA0HA,8CAKC;AAKD,gDAEC;AApID,6BAA6B;AAC7B,mCAAkF;AAAzE,gGAAA,MAAM,OAAA;AAAE,sGAAA,YAAY,OAAA;AAC7B,qCAAkC;AAElC,8BAA8B;AAC9B,iDAMyB;AALvB,qHAAA,oBAAoB,OAAA;AACpB,oHAAA,mBAAmB,OAAA;AACnB,kHAAA,iBAAiB,OAAA;AAKnB,0BAA0B;AACb,QAAA,eAAe,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,OAAO,CAAC,CAAC,CAAC,aAAa;AACjF,QAAA,cAAc,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,GAAG,CAAC,CAAC;AAE1E,gDAAgD;AACnC,QAAA,gBAAgB,GAAqB;IAChD;QACE,SAAS,EAAE;YACT,SAAS,EAAE,yCAAyC;YACpD,EAAE,EAAE,eAAe;SACpB;QACD,IAAI,EAAE,aAAa;QACnB,UAAU,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE;QACtC,YAAY,EAAE,KAAK;QACnB,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC;QACzC,aAAa,EAAE,MAAM;KACtB;IACD;QACE,SAAS,EAAE;YACT,SAAS,EAAE,yCAAyC;YACpD,EAAE,EAAE,gBAAgB;SACrB;QACD,IAAI,EAAE,kBAAkB;QACxB,UAAU,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE;QACvC,YAAY,EAAE,KAAK;QACnB,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC;QACzC,aAAa,EAAE,MAAM;KACtB;IACD;QACE,SAAS,EAAE;YACT,SAAS,EAAE,yCAAyC;YACpD,EAAE,EAAE,eAAe;SACpB;QACD,IAAI,EAAE,eAAe;QACrB,UAAU,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE;QACtC,YAAY,EAAE,MAAM;QACpB,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC;QACzC,aAAa,EAAE,KAAK;KACrB;IACD;QACE,SAAS,EAAE;YACT,SAAS,EAAE,yCAAyC;YACpD,EAAE,EAAE,iBAAiB;SACtB;QACD,IAAI,EAAE,eAAe;QACrB,UAAU,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;QACzC,YAAY,EAAE,MAAM;QACpB,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC;QAC3B,aAAa,EAAE,QAAQ;QACvB,cAAc,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE;KACpC;CACF,CAAC;AAEF;;GAEG;AACH,MAAa,cAAc;IAOL;IANZ,QAAQ,GAAG,CAAC,CAAC;IACb,YAAY,GAAG,CAAC,CAAC;IACjB,KAAK,GAAoC,QAAQ,CAAC;IACzC,gBAAgB,GAAG,CAAC,CAAC;IACrB,YAAY,GAAG,KAAK,CAAC,CAAC,WAAW;IAElD,YAAoB,OAAe;QAAf,YAAO,GAAP,OAAO,CAAQ;IAAG,CAAC;IAEvC,KAAK,CAAC,IAAI,CAAI,EAAoB;QAChC,IAAI,IAAI,CAAC,KAAK,KAAK,MAAM,EAAE,CAAC;YAC1B,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;gBACvD,IAAI,CAAC,KAAK,GAAG,WAAW,CAAC;gBACzB,eAAM,CAAC,IAAI,CAAC,0BAA0B,IAAI,CAAC,OAAO,yBAAyB,CAAC,CAAC;YAC/E,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,KAAK,CAAC,qCAAqC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;YACvE,CAAC;QACH,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,EAAE,EAAE,CAAC;YAC1B,IAAI,CAAC,SAAS,EAAE,CAAC;YACjB,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,SAAS,EAAE,CAAC;YACjB,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAEO,SAAS;QACf,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC;QAClB,IAAI,IAAI,CAAC,KAAK,KAAK,WAAW,EAAE,CAAC;YAC/B,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC;YACtB,eAAM,CAAC,IAAI,CAAC,yBAAyB,IAAI,CAAC,OAAO,sBAAsB,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC;IAEO,SAAS;QACf,IAAI,CAAC,QAAQ,EAAE,CAAC;QAChB,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE/B,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC3C,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC;YACpB,eAAM,CAAC,IAAI,CAAC,uCAAuC,IAAI,CAAC,OAAO,UAAU,IAAI,CAAC,QAAQ,WAAW,CAAC,CAAC;QACrG,CAAC;IACH,CAAC;CACF;AA9CD,wCA8CC;AAED,2CAA2C;AAC3C,MAAM,eAAe,GAAG,IAAI,GAAG,EAA0B,CAAC;AAE1D,SAAgB,iBAAiB,CAAC,OAAe;IAC/C,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;QAClC,eAAe,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;IAC5D,CAAC;IACD,OAAO,eAAe,CAAC,GAAG,CAAC,OAAO,CAAE,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,SAAgB,kBAAkB;IAChC,OAAO,wBAAgB,CAAC;AAC1B,CAAC;AAED,0CAA0C;AAC1C,2DAA0F;AAAjF,4HAAA,sBAAsB,OAAA;AAAE,iHAAA,WAAW,OAAA;AAAE,mHAAA,aAAa,OAAA;AAG3D,iGAAiG;AACjG,mDAA0E;AAAjE,+GAAA,aAAa,OAAA;AAEtB,4BAA4B;AAC5B,iCAAqD;AAA5C,oGAAA,WAAW,OAAA;AAAE,sGAAA,aAAa,OAAA;AAEnC,uCAAuC;AACvC,uDAO4B;AAN1B,2HAAA,uBAAuB,OAAA;AACvB,iIAAA,6BAA6B,OAAA;AAC7B,wHAAA,oBAAoB,OAAA;AACpB,wHAAA,oBAAoB,OAAA;AACpB,mHAAA,eAAe,OAAA;AACf,qHAAA,iBAAiB,OAAA;AAInB,yCAAyC;AACzC,2DAAiF;AAAxE,oHAAA,cAAc,OAAA;AAAE,+HAAA,yBAAyB,OAAA;AAElD,oCAAoC;AACpC,iDAQyB;AAPvB,+GAAA,cAAc,OAAA;AACd,uHAAA,sBAAsB,OAAA;AACtB,gHAAA,eAAe,OAAA;AACf,wHAAA,uBAAuB,OAAA;AACvB,8GAAA,aAAa,OAAA;AACb,mHAAA,kBAAkB,OAAA;AAClB,qHAAA,oBAAoB,OAAA;AAGtB,mCAAmC;AACnC,iDASyB;AARvB,gHAAA,eAAe,OAAA;AACf,kHAAA,iBAAiB,OAAA;AACjB,kHAAA,iBAAiB,OAAA;AACjB,oHAAA,mBAAmB,OAAA;AACnB,oHAAA,mBAAmB,OAAA;AACnB,0HAAA,yBAAyB,OAAA;AACzB,8GAAA,aAAa,OAAA;AACb,0GAAA,SAAS,OAAA;AAGX,uEAAuE;AACvE,qDAiB2B;AAhBzB,+HAAA,4BAA4B,OAAA;AAC5B,2HAAA,wBAAwB,OAAA;AACxB,0HAAA,uBAAuB,OAAA;AACvB,yHAAA,sBAAsB,OAAA;AACtB,0HAAA,uBAAuB,OAAA;AACvB,+HAAA,4BAA4B,OAAA;AAC5B,sHAAA,mBAAmB,OAAA;AACnB,sHAAA,mBAAmB,OAAA;AACnB,iHAAA,cAAc,OAAA;AACd,+GAAA,YAAY,OAAA;AACZ,2GAAA,QAAQ,OAAA;AACR,gHAAA,aAAa,OAAA;AAOf,yDAAyD;AACzD,mEAA0E;AAAjE,wIAAA,8BAA8B,OAAA;AAEvC,iCAAiC;AACjC,2CAA6E;AAApE,sGAAA,QAAQ,OAAA;AAAE,2GAAA,aAAa,OAAA"}

package/dist/lib/utils/jcs.d.ts

@@ -0,0 +1,30 @@
+/**
+ * RFC 8785 JSON Canonicalization Scheme (JCS).
+ *
+ * Produces a byte-for-byte stable serialization of JSON values so two
+ * semantically equivalent payloads hash to the same value across serializers,
+ * languages, and whitespace choices. Used by the idempotency layer to compare
+ * request payloads for equivalence without being fooled by key ordering,
+ * whitespace, or number formatting.
+ *
+ * Spec: https://www.rfc-editor.org/rfc/rfc8785
+ */
+/**
+ * Canonicalize a JSON-serializable value per RFC 8785.
+ *
+ * - Object keys sorted by UTF-16 code units
+ * - Numbers serialized per ECMAScript 7.1.12.1 (Number::toString)
+ * - Strings escaped per RFC 8785 §3.2.2.2
+ * - No insignificant whitespace
+ *
+ * Throws if the value contains unsupported types (functions, undefined, symbols).
+ */
+export declare function canonicalize(value: unknown): string;
+/**
+ * SHA-256 hash of the JCS-canonicalized form, as lowercase hex.
+ *
+ * This is the canonical "did these two requests mean the same thing" comparison
+ * for idempotency.
+ */
+export declare function canonicalJsonSha256(value: unknown): string;
+//# sourceMappingURL=jcs.d.ts.map

package/dist/lib/utils/jcs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jcs.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/jcs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEnD;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAE1D"}

package/dist/lib/utils/jcs.js

@@ -0,0 +1,167 @@
+"use strict";
+/**
+ * RFC 8785 JSON Canonicalization Scheme (JCS).
+ *
+ * Produces a byte-for-byte stable serialization of JSON values so two
+ * semantically equivalent payloads hash to the same value across serializers,
+ * languages, and whitespace choices. Used by the idempotency layer to compare
+ * request payloads for equivalence without being fooled by key ordering,
+ * whitespace, or number formatting.
+ *
+ * Spec: https://www.rfc-editor.org/rfc/rfc8785
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.canonicalize = canonicalize;
+exports.canonicalJsonSha256 = canonicalJsonSha256;
+const crypto_1 = require("crypto");
+/**
+ * Canonicalize a JSON-serializable value per RFC 8785.
+ *
+ * - Object keys sorted by UTF-16 code units
+ * - Numbers serialized per ECMAScript 7.1.12.1 (Number::toString)
+ * - Strings escaped per RFC 8785 §3.2.2.2
+ * - No insignificant whitespace
+ *
+ * Throws if the value contains unsupported types (functions, undefined, symbols).
+ */
+function canonicalize(value) {
+    return serialize(value);
+}
+/**
+ * SHA-256 hash of the JCS-canonicalized form, as lowercase hex.
+ *
+ * This is the canonical "did these two requests mean the same thing" comparison
+ * for idempotency.
+ */
+function canonicalJsonSha256(value) {
+    return (0, crypto_1.createHash)('sha256').update(canonicalize(value)).digest('hex');
+}
+function serialize(value) {
+    if (value === null)
+        return 'null';
+    if (value === true)
+        return 'true';
+    if (value === false)
+        return 'false';
+    const t = typeof value;
+    if (t === 'number')
+        return serializeNumber(value);
+    if (t === 'string')
+        return serializeString(value);
+    if (t === 'bigint') {
+        throw new TypeError('JCS does not support BigInt values');
+    }
+    if (t === 'undefined') {
+        throw new TypeError('JCS does not support undefined values');
+    }
+    if (t === 'function' || t === 'symbol') {
+        throw new TypeError(`JCS does not support ${t} values`);
+    }
+    if (Array.isArray(value))
+        return serializeArray(value);
+    if (t === 'object') {
+        // JSON canonicalization is defined over plain objects. Exotic
+        // objects (Map, Set, Date, Buffer, class instances) silently
+        // serialize as `{}` via Object.keys, which is a nasty data-loss
+        // footgun — throw loudly instead.
+        const proto = Object.getPrototypeOf(value);
+        if (proto !== null && proto !== Object.prototype) {
+            const ctorName = value?.constructor?.name ?? 'object';
+            throw new TypeError(`JCS: only plain objects are supported; got ${ctorName}. Convert to a plain object (e.g., Object.fromEntries for Map, toISOString for Date) before hashing.`);
+        }
+        return serializeObject(value);
+    }
+    throw new TypeError(`JCS: unsupported value type ${t}`);
+}
+function serializeArray(arr) {
+    const parts = [];
+    for (const item of arr) {
+        parts.push(serialize(item === undefined ? null : item));
+    }
+    return '[' + parts.join(',') + ']';
+}
+function serializeObject(obj) {
+    const keys = Object.keys(obj).filter(k => obj[k] !== undefined);
+    keys.sort(compareUtf16);
+    const parts = [];
+    for (const key of keys) {
+        parts.push(serializeString(key) + ':' + serialize(obj[key]));
+    }
+    return '{' + parts.join(',') + '}';
+}
+/**
+ * Compare two strings by UTF-16 code unit (per RFC 8785 §3.2.3).
+ * V8's default Array.sort() already compares by code unit, but making this
+ * explicit guards against future locale-sensitive comparators.
+ */
+function compareUtf16(a, b) {
+    const len = Math.min(a.length, b.length);
+    for (let i = 0; i < len; i++) {
+        const ca = a.charCodeAt(i);
+        const cb = b.charCodeAt(i);
+        if (ca !== cb)
+            return ca - cb;
+    }
+    return a.length - b.length;
+}
+/**
+ * Serialize a number per ECMAScript Number::toString (RFC 8785 §3.2.2.3).
+ *
+ * JavaScript's native String(num) matches Number::toString exactly for all
+ * finite numbers, which is what RFC 8785 requires. Non-finite numbers are
+ * not valid JSON and throw.
+ */
+function serializeNumber(n) {
+    if (!Number.isFinite(n)) {
+        throw new TypeError(`JCS: non-finite number ${n} is not valid JSON`);
+    }
+    // JSON.stringify matches Number::toString for finite numbers but also handles
+    // the -0 case (renders as "0", which JCS requires).
+    return JSON.stringify(n);
+}
+/**
+ * Serialize a string per RFC 8785 §3.2.2.2.
+ *
+ * Rules:
+ * - Wrapped in double quotes
+ * - Escape " \ and control chars U+0000..U+001F
+ * - Use shortest escape form: \b \t \n \f \r for the common ones, \u00XX for others
+ * - Do NOT escape forward slash, non-ASCII chars pass through verbatim
+ * - Lone surrogates are preserved (JSON allows them)
+ */
+function serializeString(s) {
+    let out = '"';
+    for (let i = 0; i < s.length; i++) {
+        const code = s.charCodeAt(i);
+        if (code === 0x22) {
+            out += '\\"';
+        }
+        else if (code === 0x5c) {
+            out += '\\\\';
+        }
+        else if (code === 0x08) {
+            out += '\\b';
+        }
+        else if (code === 0x09) {
+            out += '\\t';
+        }
+        else if (code === 0x0a) {
+            out += '\\n';
+        }
+        else if (code === 0x0c) {
+            out += '\\f';
+        }
+        else if (code === 0x0d) {
+            out += '\\r';
+        }
+        else if (code < 0x20) {
+            out += '\\u' + code.toString(16).padStart(4, '0');
+        }
+        else {
+            out += s[i];
+        }
+    }
+    out += '"';
+    return out;
+}
+//# sourceMappingURL=jcs.js.map

package/dist/lib/utils/jcs.js.map

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

package/dist/lib/utils/logger.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Logger utility for AdCP Client
+ *
+ * Provides structured logging with levels and contextual metadata.
+ */
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+export interface LoggerConfig {
+    /** Minimum log level to output (default: 'info') */
+    level?: LogLevel;
+    /** Enable/disable logging globally (default: true) */
+    enabled?: boolean;
+    /** Custom log handler (default: console) */
+    handler?: {
+        debug: (message: string, meta?: unknown) => void;
+        info: (message: string, meta?: unknown) => void;
+        warn: (message: string, meta?: unknown) => void;
+        error: (message: string, meta?: unknown) => void;
+    };
+}
+declare class Logger {
+    private config;
+    constructor(config?: LoggerConfig);
+    private shouldLog;
+    /**
+     * Log debug message (development/troubleshooting)
+     */
+    debug(message: string, meta?: unknown): void;
+    /**
+     * Log info message (general information)
+     */
+    info(message: string, meta?: unknown): void;
+    /**
+     * Log warning message (non-critical issues)
+     */
+    warn(message: string, meta?: unknown): void;
+    /**
+     * Log error message (critical issues)
+     */
+    error(message: string, meta?: unknown): void;
+    /**
+     * Create a child logger with contextual prefix
+     */
+    child(context: string): Logger;
+    /**
+     * Update logger configuration
+     */
+    configure(config: Partial<LoggerConfig>): void;
+}
+export declare const logger: Logger;
+/**
+ * Create a new logger instance with custom configuration
+ */
+export declare function createLogger(config?: LoggerConfig): Logger;
+export {};
+//# sourceMappingURL=logger.d.ts.map

package/dist/lib/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D,MAAM,WAAW,YAAY;IAC3B,oDAAoD;IACpD,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,sDAAsD;IACtD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,4CAA4C;IAC5C,OAAO,CAAC,EAAE;QACR,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;QACjD,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;QAChD,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;QAChD,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;KAClD,CAAC;CACH;AASD,cAAM,MAAM;IACV,OAAO,CAAC,MAAM,CAAyB;gBAE3B,MAAM,GAAE,YAAiB;IAarC,OAAO,CAAC,SAAS;IAKjB;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAM5C;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAM3C;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAM3C;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAM5C;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAa9B;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI;CAG/C;AAGD,eAAO,MAAM,MAAM,QAGjB,CAAC;AAEH;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,MAAM,CAE1D"}

package/dist/lib/utils/logger.js

@@ -0,0 +1,100 @@
+"use strict";
+/**
+ * Logger utility for AdCP Client
+ *
+ * Provides structured logging with levels and contextual metadata.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logger = void 0;
+exports.createLogger = createLogger;
+const LOG_LEVELS = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+};
+class Logger {
+    config;
+    constructor(config = {}) {
+        this.config = {
+            level: config.level || 'info',
+            enabled: config.enabled !== false,
+            handler: config.handler || {
+                debug: (msg, meta) => console.log(msg, meta ? meta : ''),
+                info: (msg, meta) => console.log(msg, meta ? meta : ''),
+                warn: (msg, meta) => console.warn(msg, meta ? meta : ''),
+                error: (msg, meta) => console.error(msg, meta ? meta : ''),
+            },
+        };
+    }
+    shouldLog(level) {
+        if (!this.config.enabled)
+            return false;
+        return LOG_LEVELS[level] >= LOG_LEVELS[this.config.level];
+    }
+    /**
+     * Log debug message (development/troubleshooting)
+     */
+    debug(message, meta) {
+        if (this.shouldLog('debug')) {
+            this.config.handler.debug(message, meta);
+        }
+    }
+    /**
+     * Log info message (general information)
+     */
+    info(message, meta) {
+        if (this.shouldLog('info')) {
+            this.config.handler.info(message, meta);
+        }
+    }
+    /**
+     * Log warning message (non-critical issues)
+     */
+    warn(message, meta) {
+        if (this.shouldLog('warn')) {
+            this.config.handler.warn(message, meta);
+        }
+    }
+    /**
+     * Log error message (critical issues)
+     */
+    error(message, meta) {
+        if (this.shouldLog('error')) {
+            this.config.handler.error(message, meta);
+        }
+    }
+    /**
+     * Create a child logger with contextual prefix
+     */
+    child(context) {
+        const parentHandler = this.config.handler;
+        return new Logger({
+            ...this.config,
+            handler: {
+                debug: (msg, meta) => parentHandler.debug(`[${context}] ${msg}`, meta),
+                info: (msg, meta) => parentHandler.info(`[${context}] ${msg}`, meta),
+                warn: (msg, meta) => parentHandler.warn(`[${context}] ${msg}`, meta),
+                error: (msg, meta) => parentHandler.error(`[${context}] ${msg}`, meta),
+            },
+        });
+    }
+    /**
+     * Update logger configuration
+     */
+    configure(config) {
+        Object.assign(this.config, config);
+    }
+}
+// Default global logger instance
+exports.logger = new Logger({
+    level: process.env.LOG_LEVEL || 'info',
+    enabled: process.env.LOG_ENABLED !== 'false',
+});
+/**
+ * Create a new logger instance with custom configuration
+ */
+function createLogger(config) {
+    return new Logger(config);
+}
+//# sourceMappingURL=logger.js.map

package/dist/lib/utils/logger.js.map

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

package/dist/lib/utils/pagination.d.ts

@@ -0,0 +1,31 @@
+import type { PaginationRequest, PaginationResponse } from '../types/tools.generated';
+export interface PaginateOptions {
+    /** Maximum total items to fetch across all pages */
+    maxItems?: number;
+    /** Maximum number of pages to fetch (default: 100) */
+    maxPages?: number;
+    /** Page size hint passed as max_results per request */
+    pageSize?: number;
+}
+type PaginatedResponse = {
+    pagination?: PaginationResponse;
+    [key: string]: unknown;
+};
+/**
+ * Collect all items across paginated AdCP responses.
+ *
+ * @param fetchPage - Calls the paginated endpoint with optional pagination params
+ * @param getItems - Extracts the item array from a single page response
+ * @param options - Controls for page size, max items, and max pages
+ */
+export declare function paginate<TResponse extends PaginatedResponse, TItem>(fetchPage: (pagination?: PaginationRequest) => Promise<TResponse>, getItems: (response: TResponse) => TItem[], options?: PaginateOptions): Promise<TItem[]>;
+/**
+ * Async generator that yields one page at a time from a paginated AdCP endpoint.
+ * Useful for progressive/streaming UI rendering.
+ *
+ * @param fetchPage - Calls the paginated endpoint with optional pagination params
+ * @param options - Controls for page size and max pages
+ */
+export declare function paginatePages<TResponse extends PaginatedResponse>(fetchPage: (pagination?: PaginationRequest) => Promise<TResponse>, options?: PaginateOptions): AsyncGenerator<TResponse>;
+export {};
+//# sourceMappingURL=pagination.d.ts.map

package/dist/lib/utils/pagination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/pagination.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAEtF,MAAM,WAAW,eAAe;IAC9B,oDAAoD;IACpD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,KAAK,iBAAiB,GAAG;IACvB,UAAU,CAAC,EAAE,kBAAkB,CAAC;IAChC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC;AAEF;;;;;;GAMG;AACH,wBAAsB,QAAQ,CAAC,SAAS,SAAS,iBAAiB,EAAE,KAAK,EACvE,SAAS,EAAE,CAAC,UAAU,CAAC,EAAE,iBAAiB,KAAK,OAAO,CAAC,SAAS,CAAC,EACjE,QAAQ,EAAE,CAAC,QAAQ,EAAE,SAAS,KAAK,KAAK,EAAE,EAC1C,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,KAAK,EAAE,CAAC,CAyBlB;AAED;;;;;;GAMG;AACH,wBAAuB,aAAa,CAAC,SAAS,SAAS,iBAAiB,EACtE,SAAS,EAAE,CAAC,UAAU,CAAC,EAAE,iBAAiB,KAAK,OAAO,CAAC,SAAS,CAAC,EACjE,OAAO,CAAC,EAAE,eAAe,GACxB,cAAc,CAAC,SAAS,CAAC,CAiB3B"}