@cesteral/dbm-mcp 1.0.0

package/dist/utils/errors/bid-manager-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bid-manager-errors.js","sourceRoot":"","sources":["../../../src/utils/errors/bid-manager-errors.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAK9D,MAAM,OAAO,eAAgB,SAAQ,QAAQ;IAC3B,YAAY,CAAU;IACtB,UAAU,CAAU;IAEpC,YACE,OAAe,EACf,OAMC;QAED,KAAK,CAAC,OAAO,EAAE,IAAI,IAAI,gBAAgB,CAAC,aAAa,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE;YAC7E,KAAK,EAAE,OAAO,EAAE,KAAK;SACtB,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,IAAI,CAAC,YAAY,GAAG,OAAO,EAAE,YAAY,CAAC;QAC1C,IAAI,CAAC,UAAU,GAAG,OAAO,EAAE,UAAU,CAAC;IACxC,CAAC;CACF;AAKD,MAAM,OAAO,kBAAmB,SAAQ,eAAe;IACrD,YAAY,OAAe,EAAE,KAAe;QAC1C,KAAK,CAAC,uCAAuC,OAAO,EAAE,EAAE;YACtD,IAAI,EAAE,gBAAgB,CAAC,aAAa;YACpC,KAAK;SACN,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAKD,MAAM,OAAO,mBAAoB,SAAQ,eAAe;IACtC,OAAO,CAAS;IAEhC,YAAY,OAAe,EAAE,OAAe,EAAE,KAAe;QAC3D,KAAK,CAAC,2BAA2B,OAAO,KAAK,OAAO,EAAE,EAAE;YACtD,IAAI,EAAE,gBAAgB,CAAC,aAAa;YACpC,KAAK;YACL,IAAI,EAAE,EAAE,OAAO,EAAE;SAClB,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAKD,MAAM,OAAO,qBAAsB,SAAQ,eAAe;IACxC,OAAO,CAAS;IAChB,QAAQ,CAAS;IACjB,aAAa,CAAU;IAEvC,YAAY,OAAe,EAAE,QAAgB,EAAE,aAAsB,EAAE,KAAe;QACpF,KAAK,CAAC,UAAU,QAAQ,uBAAuB,aAAa,IAAI,gBAAgB,EAAE,EAAE;YAClF,IAAI,EAAE,gBAAgB,CAAC,aAAa;YACpC,KAAK;YACL,IAAI,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE;SAC3C,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;QACpC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;IACrC,CAAC;CACF;AAKD,MAAM,OAAO,gBAAiB,SAAQ,eAAe;IACnC,OAAO,CAAU;IAEjC,YAAY,OAAe,EAAE,OAAgB,EAAE,KAAe;QAC5D,KAAK,CAAC,gCAAgC,OAAO,EAAE,EAAE;YAC/C,IAAI,EAAE,gBAAgB,CAAC,aAAa;YACpC,KAAK;YACL,IAAI,EAAE,EAAE,OAAO,EAAE;SAClB,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAKD,MAAM,OAAO,gBAAiB,SAAQ,eAAe;IACnC,MAAM,CAAU;IAChB,SAAS,CAAU;IAEnC,YAAY,OAAe,EAAE,OAAkE;QAC7F,KAAK,CAAC,gCAAgC,OAAO,EAAE,EAAE;YAC/C,IAAI,EAAE,gBAAgB,CAAC,aAAa;YACpC,KAAK,EAAE,OAAO,EAAE,KAAK;YACrB,IAAI,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE;SACjE,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,IAAI,CAAC,MAAM,GAAG,OAAO,EAAE,MAAM,CAAC;QAC9B,IAAI,CAAC,SAAS,GAAG,OAAO,EAAE,SAAS,CAAC;IACtC,CAAC;CACF;AAKD,MAAM,OAAO,mBAAoB,SAAQ,eAAe;IACtD,YAAY,OAAe,EAAE,KAAe;QAC1C,KAAK,CAAC,sCAAsC,OAAO,EAAE,EAAE;YACrD,IAAI,EAAE,gBAAgB,CAAC,YAAY;YACnC,KAAK;SACN,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAKD,MAAM,OAAO,6BAA8B,SAAQ,eAAe;IAChE;QACE,KAAK,CACH,+FAA+F,EAC/F;YACE,IAAI,EAAE,gBAAgB,CAAC,YAAY;SACpC,CACF,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,+BAA+B,CAAC;IAC9C,CAAC;CACF;AAQD,MAAM,OAAO,mBAAoB,SAAQ,eAAe;IACtC,OAAO,CAAU;IACjB,QAAQ,CAAU;IAClB,YAAY,CAAS;IACrB,SAAS,CAAS;IAElC,YACE,YAAoB,EACpB,OAKC;QAED,MAAM,SAAS,GAAG,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,cAAc,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1E,MAAM,UAAU,GAAG,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,kBAAkB,OAAO,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAEtF,KAAK,CAAC,OAAO,YAAY,4BAA4B,SAAS,GAAG,UAAU,EAAE,EAAE;YAC7E,IAAI,EAAE,gBAAgB,CAAC,OAAO;YAC9B,KAAK,EAAE,OAAO,EAAE,SAAS;YACzB,IAAI,EAAE;gBACJ,YAAY;gBACZ,OAAO,EAAE,OAAO,EAAE,OAAO;gBACzB,QAAQ,EAAE,OAAO,EAAE,QAAQ;gBAC3B,UAAU,EAAE,OAAO,EAAE,UAAU;aAChC;SACF,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,IAAI,CAAC,OAAO,GAAG,OAAO,EAAE,OAAO,CAAC;QAChC,IAAI,CAAC,QAAQ,GAAG,OAAO,EAAE,QAAQ,CAAC;QAClC,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,SAAS,GAAG,OAAO,EAAE,SAAS,CAAC;IACtC,CAAC;CACF"}

package/dist/utils/errors/index.d.ts

@@ -0,0 +1,3 @@
+export { McpError, ErrorHandler, type ErrorContext, JsonRpcErrorCode, mapErrorCodeToHttpStatus, } from "@cesteral/shared";
+export { BidManagerError, QueryCreationError, QueryExecutionError, ReportGenerationError, ReportTimeoutError, ReportFetchError, ReportParseError, AuthenticationError, CredentialsNotConfiguredError, RetryExhaustedError, } from "./bid-manager-errors.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/errors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/errors/index.ts"],"names":[],"mappings":"AAWA,OAAO,EACL,QAAQ,EACR,YAAY,EACZ,KAAK,YAAY,EACjB,gBAAgB,EAChB,wBAAwB,GACzB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,6BAA6B,EAC7B,mBAAmB,GACpB,MAAM,yBAAyB,CAAC"}

package/dist/utils/errors/index.js

@@ -0,0 +1,3 @@
+export { McpError, ErrorHandler, JsonRpcErrorCode, mapErrorCodeToHttpStatus, } from "@cesteral/shared";
+export { BidManagerError, QueryCreationError, QueryExecutionError, ReportGenerationError, ReportTimeoutError, ReportFetchError, ReportParseError, AuthenticationError, CredentialsNotConfiguredError, RetryExhaustedError, } from "./bid-manager-errors.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/errors/index.ts"],"names":[],"mappings":"AAWA,OAAO,EACL,QAAQ,EACR,YAAY,EAEZ,gBAAgB,EAChB,wBAAwB,GACzB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,6BAA6B,EAC7B,mBAAmB,GACpB,MAAM,yBAAyB,CAAC"}

package/dist/utils/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./errors/index.js";
+export * from "./security/index.js";
+export * from "./telemetry/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AASA,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,4 @@
+export * from "./errors/index.js";
+export * from "./security/index.js";
+export * from "./telemetry/index.js";
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AASA,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC"}

package/dist/utils/math.d.ts

@@ -0,0 +1,9 @@
+export declare const DEFAULT_PRECISION = 4;
+export declare const round: (value: number, decimals?: number) => number;
+export declare const isValidNumber: (value: number | undefined | null) => value is number;
+export declare const safeNumber: (value: number | undefined | null, defaultValue?: number) => number;
+export declare const safeDivide: (numerator: number, denominator: number, defaultValue?: number) => number;
+export declare const safePercentage: (numerator: number, denominator: number, defaultValue?: number) => number;
+export declare const safePerMille: (numerator: number, denominator: number, defaultValue?: number) => number;
+export declare const clamp: (value: number, min: number, max: number) => number;
+//# sourceMappingURL=math.d.ts.map

package/dist/utils/math.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"math.d.ts","sourceRoot":"","sources":["../../src/utils/math.ts"],"names":[],"mappings":"AAaA,eAAO,MAAM,iBAAiB,IAAI,CAAC;AASnC,eAAO,MAAM,KAAK,GAAI,OAAO,MAAM,EAAE,WAAU,MAA0B,KAAG,MAG3E,CAAC;AAQF,eAAO,MAAM,aAAa,GAAI,OAAO,MAAM,GAAG,SAAS,GAAG,IAAI,KAAG,KAAK,IAAI,MAEzE,CAAC;AASF,eAAO,MAAM,UAAU,GAAI,OAAO,MAAM,GAAG,SAAS,GAAG,IAAI,EAAE,eAAc,MAAU,KAAG,MAEvF,CAAC;AAeF,eAAO,MAAM,UAAU,GACrB,WAAW,MAAM,EACjB,aAAa,MAAM,EACnB,eAAc,MAAU,KACvB,MAgBF,CAAC;AAUF,eAAO,MAAM,cAAc,GACzB,WAAW,MAAM,EACjB,aAAa,MAAM,EACnB,eAAc,MAAU,KACvB,MAGF,CAAC;AAWF,eAAO,MAAM,YAAY,GACvB,WAAW,MAAM,EACjB,aAAa,MAAM,EACnB,eAAc,MAAU,KACvB,MAGF,CAAC;AAUF,eAAO,MAAM,KAAK,GAAI,OAAO,MAAM,EAAE,KAAK,MAAM,EAAE,KAAK,MAAM,KAAG,MAG/D,CAAC"}

package/dist/utils/math.js

@@ -0,0 +1,38 @@
+export const DEFAULT_PRECISION = 4;
+export const round = (value, decimals = DEFAULT_PRECISION) => {
+    const multiplier = 10 ** decimals;
+    return Math.round(value * multiplier) / multiplier;
+};
+export const isValidNumber = (value) => {
+    return typeof value === "number" && Number.isFinite(value) && !Number.isNaN(value);
+};
+export const safeNumber = (value, defaultValue = 0) => {
+    return isValidNumber(value) ? value : defaultValue;
+};
+export const safeDivide = (numerator, denominator, defaultValue = 0) => {
+    if (!isValidNumber(numerator) || !isValidNumber(denominator)) {
+        return defaultValue;
+    }
+    if (denominator === 0) {
+        return defaultValue;
+    }
+    const result = numerator / denominator;
+    if (!isValidNumber(result)) {
+        return defaultValue;
+    }
+    return result;
+};
+export const safePercentage = (numerator, denominator, defaultValue = 0) => {
+    const result = safeDivide(numerator, denominator, defaultValue);
+    return result === defaultValue ? defaultValue : result * 100;
+};
+export const safePerMille = (numerator, denominator, defaultValue = 0) => {
+    const result = safeDivide(numerator, denominator, defaultValue);
+    return result === defaultValue ? defaultValue : result * 1000;
+};
+export const clamp = (value, min, max) => {
+    if (!isValidNumber(value))
+        return min;
+    return Math.max(min, Math.min(max, value));
+};
+//# sourceMappingURL=math.js.map

package/dist/utils/math.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"math.js","sourceRoot":"","sources":["../../src/utils/math.ts"],"names":[],"mappings":"AAaA,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC;AASnC,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,KAAa,EAAE,WAAmB,iBAAiB,EAAU,EAAE;IACnF,MAAM,UAAU,GAAG,EAAE,IAAI,QAAQ,CAAC;IAClC,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,UAAU,CAAC,GAAG,UAAU,CAAC;AACrD,CAAC,CAAC;AAQF,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAAgC,EAAmB,EAAE;IACjF,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AACrF,CAAC,CAAC;AASF,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,KAAgC,EAAE,eAAuB,CAAC,EAAU,EAAE;IAC/F,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC;AACrD,CAAC,CAAC;AAeF,MAAM,CAAC,MAAM,UAAU,GAAG,CACxB,SAAiB,EACjB,WAAmB,EACnB,eAAuB,CAAC,EAChB,EAAE;IACV,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,IAAI,CAAC,aAAa,CAAC,WAAW,CAAC,EAAE,CAAC;QAC7D,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,IAAI,WAAW,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,MAAM,MAAM,GAAG,SAAS,GAAG,WAAW,CAAC;IAEvC,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAUF,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,SAAiB,EACjB,WAAmB,EACnB,eAAuB,CAAC,EAChB,EAAE;IACV,MAAM,MAAM,GAAG,UAAU,CAAC,SAAS,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC;IAChE,OAAO,MAAM,KAAK,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,GAAG,GAAG,CAAC;AAC/D,CAAC,CAAC;AAWF,MAAM,CAAC,MAAM,YAAY,GAAG,CAC1B,SAAiB,EACjB,WAAmB,EACnB,eAAuB,CAAC,EAChB,EAAE;IACV,MAAM,MAAM,GAAG,UAAU,CAAC,SAAS,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC;IAChE,OAAO,MAAM,KAAK,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,GAAG,IAAI,CAAC;AAChE,CAAC,CAAC;AAUF,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,KAAa,EAAE,GAAW,EAAE,GAAW,EAAU,EAAE;IACvE,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC;IACtC,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;AAC7C,CAAC,CAAC"}

package/dist/utils/metrics.d.ts

@@ -0,0 +1,21 @@
+import type { DeliveryMetrics, PerformanceMetrics } from "../services/bid-manager/types.js";
+export interface MetricConfig {
+    numerator: keyof DeliveryMetrics;
+    denominator: keyof DeliveryMetrics;
+    multiplier?: number;
+    description: string;
+    unit?: string;
+}
+export type PerformanceMetricKey = "cpm" | "ctr" | "cpc" | "cpa" | "roas";
+export declare const PERFORMANCE_METRICS: Record<PerformanceMetricKey, MetricConfig>;
+export declare function calculateMetric(metrics: DeliveryMetrics, config: MetricConfig): number;
+export declare function calculateAllMetrics(delivery: DeliveryMetrics): PerformanceMetrics;
+export declare function calculateMetricByName(metrics: DeliveryMetrics, metricName: PerformanceMetricKey): number;
+export declare function calculateCPM(spend: number, impressions: number): number;
+export declare function calculateCTR(clicks: number, impressions: number): number;
+export declare function calculateCPC(spend: number, clicks: number): number;
+export declare function calculateCPA(spend: number, conversions: number): number;
+export declare function calculateROAS(revenue: number, spend: number): number;
+export declare function formatMetricValue(metricName: PerformanceMetricKey, value: number, decimals?: number): string;
+export declare function getMetricDescription(metricName: PerformanceMetricKey): string;
+//# sourceMappingURL=metrics.d.ts.map

package/dist/utils/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../src/utils/metrics.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAM5F,MAAM,WAAW,YAAY;IAE3B,SAAS,EAAE,MAAM,eAAe,CAAC;IAEjC,WAAW,EAAE,MAAM,eAAe,CAAC;IAEnC,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,WAAW,EAAE,MAAM,CAAC;IAEpB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAKD,MAAM,MAAM,oBAAoB,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;AAY1E,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,oBAAoB,EAAE,YAAY,CAoC1E,CAAC;AASF,wBAAgB,eAAe,CAAC,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM,CAOtF;AAYD,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,eAAe,GAAG,kBAAkB,CAYjF;AASD,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,eAAe,EACxB,UAAU,EAAE,oBAAoB,GAC/B,MAAM,CAGR;AASD,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAEvE;AASD,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAExE;AASD,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAElE;AASD,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAEvE;AASD,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAEpE;AAUD,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,oBAAoB,EAChC,KAAK,EAAE,MAAM,EACb,QAAQ,GAAE,MAAU,GACnB,MAAM,CAcR;AAQD,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,oBAAoB,GAAG,MAAM,CAE7E"}

package/dist/utils/metrics.js

@@ -0,0 +1,92 @@
+import { safeDivide, safePercentage, safePerMille, round } from "./math.js";
+export const PERFORMANCE_METRICS = {
+    cpm: {
+        numerator: "spend",
+        denominator: "impressions",
+        multiplier: 1000,
+        description: "Cost per thousand impressions",
+        unit: "$",
+    },
+    ctr: {
+        numerator: "clicks",
+        denominator: "impressions",
+        multiplier: 100,
+        description: "Click-through rate",
+        unit: "%",
+    },
+    cpc: {
+        numerator: "spend",
+        denominator: "clicks",
+        multiplier: 1,
+        description: "Cost per click",
+        unit: "$",
+    },
+    cpa: {
+        numerator: "spend",
+        denominator: "conversions",
+        multiplier: 1,
+        description: "Cost per acquisition/conversion",
+        unit: "$",
+    },
+    roas: {
+        numerator: "revenue",
+        denominator: "spend",
+        multiplier: 1,
+        description: "Return on ad spend",
+        unit: "x",
+    },
+};
+export function calculateMetric(metrics, config) {
+    const numeratorValue = metrics[config.numerator];
+    const denominatorValue = metrics[config.denominator];
+    const multiplier = config.multiplier ?? 1;
+    const result = safeDivide(numeratorValue, denominatorValue, 0) * multiplier;
+    return round(result);
+}
+export function calculateAllMetrics(delivery) {
+    return {
+        ...delivery,
+        cpm: calculateMetric(delivery, PERFORMANCE_METRICS.cpm),
+        ctr: calculateMetric(delivery, PERFORMANCE_METRICS.ctr),
+        cpc: calculateMetric(delivery, PERFORMANCE_METRICS.cpc),
+        cpa: calculateMetric(delivery, PERFORMANCE_METRICS.cpa),
+        roas: calculateMetric(delivery, PERFORMANCE_METRICS.roas),
+    };
+}
+export function calculateMetricByName(metrics, metricName) {
+    const config = PERFORMANCE_METRICS[metricName];
+    return calculateMetric(metrics, config);
+}
+export function calculateCPM(spend, impressions) {
+    return round(safePerMille(spend, impressions, 0));
+}
+export function calculateCTR(clicks, impressions) {
+    return round(safePercentage(clicks, impressions, 0));
+}
+export function calculateCPC(spend, clicks) {
+    return round(safeDivide(spend, clicks, 0));
+}
+export function calculateCPA(spend, conversions) {
+    return round(safeDivide(spend, conversions, 0));
+}
+export function calculateROAS(revenue, spend) {
+    return round(safeDivide(revenue, spend, 0));
+}
+export function formatMetricValue(metricName, value, decimals = 2) {
+    const config = PERFORMANCE_METRICS[metricName];
+    const formattedValue = round(value, decimals);
+    switch (config.unit) {
+        case "$":
+            return `$${formattedValue.toFixed(decimals)}`;
+        case "%":
+            return `${formattedValue.toFixed(decimals)}%`;
+        case "x":
+            return `${formattedValue.toFixed(decimals)}x`;
+        default:
+            return formattedValue.toFixed(decimals);
+    }
+}
+export function getMetricDescription(metricName) {
+    return PERFORMANCE_METRICS[metricName].description;
+}
+//# sourceMappingURL=metrics.js.map

package/dist/utils/metrics.js.map

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

package/dist/utils/platform.d.ts

@@ -0,0 +1,3 @@
+export declare const withBidManagerApiSpan: <T>(operation: string, entityType: string | undefined, fn: (span: import("@opentelemetry/api").Span) => Promise<T>) => Promise<T>;
+export declare const rateLimiter: import("@cesteral/shared").RateLimiter;
+//# sourceMappingURL=platform.d.ts.map

package/dist/utils/platform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../../src/utils/platform.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,qBAAqB,mIAAyC,CAAC;AAC5E,eAAO,MAAM,WAAW,wCAAwE,CAAC"}

package/dist/utils/platform.js

@@ -0,0 +1,5 @@
+import { createPlatformSpanHelper, createPlatformRateLimiter } from "@cesteral/shared";
+import { mcpConfig } from "../config/index.js";
+export const withBidManagerApiSpan = createPlatformSpanHelper("bidmanager");
+export const rateLimiter = createPlatformRateLimiter("bidmanager", mcpConfig.rateLimitPerMinute);
+//# sourceMappingURL=platform.js.map

package/dist/utils/platform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.js","sourceRoot":"","sources":["../../src/utils/platform.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AACvF,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C,MAAM,CAAC,MAAM,qBAAqB,GAAG,wBAAwB,CAAC,YAAY,CAAC,CAAC;AAC5E,MAAM,CAAC,MAAM,WAAW,GAAG,yBAAyB,CAAC,YAAY,EAAE,SAAS,CAAC,kBAAkB,CAAC,CAAC"}

package/dist/utils/security/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./rate-limiter.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/security/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/security/index.ts"],"names":[],"mappings":"AAOA,cAAc,mBAAmB,CAAC"}

package/dist/utils/security/index.js

@@ -0,0 +1,2 @@
+export * from "./rate-limiter.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/security/index.ts"],"names":[],"mappings":"AAOA,cAAc,mBAAmB,CAAC"}

package/dist/utils/security/rate-limiter.d.ts

@@ -0,0 +1,3 @@
+export { RateLimiter } from "@cesteral/shared";
+export declare const rateLimiter: import("@cesteral/shared").RateLimiter;
+//# sourceMappingURL=rate-limiter.d.ts.map

package/dist/utils/security/rate-limiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.d.ts","sourceRoot":"","sources":["../../../src/utils/security/rate-limiter.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAI/C,eAAO,MAAM,WAAW,wCAAwE,CAAC"}

package/dist/utils/security/rate-limiter.js

@@ -0,0 +1,5 @@
+export { RateLimiter } from "@cesteral/shared";
+import { createPlatformRateLimiter } from "@cesteral/shared";
+import { mcpConfig } from "../../config/index.js";
+export const rateLimiter = createPlatformRateLimiter("bidmanager", mcpConfig.rateLimitPerMinute);
+//# sourceMappingURL=rate-limiter.js.map

package/dist/utils/security/rate-limiter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.js","sourceRoot":"","sources":["../../../src/utils/security/rate-limiter.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD,MAAM,CAAC,MAAM,WAAW,GAAG,yBAAyB,CAAC,YAAY,EAAE,SAAS,CAAC,kBAAkB,CAAC,CAAC"}

package/dist/utils/telemetry/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./tracing.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/telemetry/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/telemetry/index.ts"],"names":[],"mappings":"AAGA,cAAc,cAAc,CAAC"}

package/dist/utils/telemetry/index.js

@@ -0,0 +1,2 @@
+export * from "./tracing.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/telemetry/index.ts"],"names":[],"mappings":"AAGA,cAAc,cAAc,CAAC"}

package/dist/utils/telemetry/tracing.d.ts

@@ -0,0 +1,3 @@
+export { initializeOpenTelemetry, shutdownOpenTelemetry, getOpenTelemetrySDK, isOpenTelemetryEnabled, otelLogMixin, getTracer, withSpan, withToolSpan, setSpanAttribute, recordSpanError, createPlatformSpanHelper, type Span, } from "@cesteral/shared";
+export declare const withBidManagerApiSpan: <T>(operation: string, entityType: string | undefined, fn: (span: import("@opentelemetry/api").Span) => Promise<T>) => Promise<T>;
+//# sourceMappingURL=tracing.d.ts.map

package/dist/utils/telemetry/tracing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracing.d.ts","sourceRoot":"","sources":["../../../src/utils/telemetry/tracing.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,mBAAmB,EACnB,sBAAsB,EACtB,YAAY,EACZ,SAAS,EACT,QAAQ,EACR,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,wBAAwB,EACxB,KAAK,IAAI,GACV,MAAM,kBAAkB,CAAC;AAI1B,eAAO,MAAM,qBAAqB,mIAAyC,CAAC"}

package/dist/utils/telemetry/tracing.js

@@ -0,0 +1,4 @@
+export { initializeOpenTelemetry, shutdownOpenTelemetry, getOpenTelemetrySDK, isOpenTelemetryEnabled, otelLogMixin, getTracer, withSpan, withToolSpan, setSpanAttribute, recordSpanError, createPlatformSpanHelper, } from "@cesteral/shared";
+import { createPlatformSpanHelper } from "@cesteral/shared";
+export const withBidManagerApiSpan = createPlatformSpanHelper("bidmanager");
+//# sourceMappingURL=tracing.js.map

package/dist/utils/telemetry/tracing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracing.js","sourceRoot":"","sources":["../../../src/utils/telemetry/tracing.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,mBAAmB,EACnB,sBAAsB,EACtB,YAAY,EACZ,SAAS,EACT,QAAQ,EACR,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,wBAAwB,GAEzB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAE5D,MAAM,CAAC,MAAM,qBAAqB,GAAG,wBAAwB,CAAC,YAAY,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@cesteral/dbm-mcp",
+  "mcpName": "io.github.cesteral/dbm-mcp",
+  "version": "1.0.0",
+  "description": "DBM MCP Server - Generic cross-platform reporting and metrics",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/cesteral/mcp-open-advertising.git",
+    "directory": "packages/dbm-mcp"
+  },
+  "homepage": "https://github.com/cesteral/mcp-open-advertising#readme",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "advertising",
+    "dv360",
+    "bid-manager",
+    "reporting"
+  ],
+  "files": [
+    "dist/",
+    "README.md",
+    "LICENSE.md"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "dbm-mcp": "./dist/index.js"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "1.27.1",
+    "googleapis": "^166.0.0",
+    "pino": "^10.1.0",
+    "zod": "3.25.76",
+    "@cesteral/shared": "1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.17.6",
+    "tsx": "^4.20.6",
+    "typescript": "^5.9.3",
+    "vitest": "^1.6.0"
+  },
+  "scripts": {
+    "generate": "node --import tsx ./scripts/generate-types.ts",
+    "prebuild": "pnpm run generate",
+    "build": "tsc --build",
+    "clean": "rm -rf dist *.tsbuildinfo src/generated",
+    "dev:http": "tsx watch src/index.ts",
+    "start": "node dist/index.js",
+    "typecheck": "pnpm run generate && tsc --noEmit",
+    "lint": "eslint src/",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage"
+  }
+}