@arthurzakharov/convert-service 1.0.0

package/dist/utils/logger.js

@@ -0,0 +1,136 @@
+"use strict";
+// ── ANSI escape helpers ───────────────────────────────────────────────────────
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Logger = void 0;
+exports.createLogger = createLogger;
+const R = '\x1b[0m'; // reset
+const BOLD = '\x1b[1m';
+const DIM = '\x1b[2m';
+const fg = {
+    gray: '\x1b[90m',
+    red: '\x1b[91m',
+    green: '\x1b[92m',
+    yellow: '\x1b[93m',
+    blue: '\x1b[94m',
+    magenta: '\x1b[95m',
+    cyan: '\x1b[96m',
+    white: '\x1b[97m',
+};
+const bg = {
+    blue: '\x1b[44m',
+    yellow: '\x1b[43m',
+    red: '\x1b[41m',
+    gray: '\x1b[100m',
+    green: '\x1b[42m',
+};
+// Always use color unless the NO_COLOR convention is set.
+// Railway (and most modern log viewers) renders ANSI fine even though
+// process.stdout.isTTY is false in piped/containerised environments.
+const USE_COLOR = !process.env['NO_COLOR'];
+const paint = (code, text) => USE_COLOR ? `${code}${text}${R}` : text;
+const bold = (s) => paint(BOLD, s);
+const dim = (s) => paint(DIM, s);
+const gray = (s) => paint(fg.gray, s);
+const green = (s) => paint(fg.green, s);
+const yellow = (s) => paint(fg.yellow, s);
+const cyan = (s) => paint(fg.cyan, s);
+const blue = (s) => paint(fg.blue, s);
+const magenta = (s) => paint(fg.magenta, s);
+const white = (s) => paint(fg.white, s);
+// ── Value formatting ──────────────────────────────────────────────────────────
+const MAX_DEPTH = 4;
+const TREE_INDENT = '   ';
+function isPrimitive(val) {
+    return (val === null ||
+        val === undefined ||
+        (typeof val !== 'object' && typeof val !== 'function'));
+}
+function formatPrimitive(val) {
+    if (val === null)
+        return dim('null');
+    if (val === undefined)
+        return dim('undefined');
+    if (typeof val === 'string')
+        return green(`'${val}'`);
+    if (typeof val === 'number')
+        return yellow(String(val));
+    if (typeof val === 'boolean')
+        return cyan(String(val));
+    return String(val);
+}
+function formatValue(val, depth = 0, baseIndent = '') {
+    if (isPrimitive(val))
+        return formatPrimitive(val);
+    if (Array.isArray(val)) {
+        if (val.length === 0)
+            return dim('[]');
+        // Flat array of primitives → compact inline
+        if (val.every(isPrimitive)) {
+            const items = val.map(formatPrimitive).join(dim(', '));
+            return `${dim('[')} ${items} ${dim(']')}`;
+        }
+        // Mixed / nested → tree
+        return formatEntries(val.map((v, i) => [String(i), v]), depth, baseIndent);
+    }
+    if (typeof val === 'object' && val !== null) {
+        if (depth >= MAX_DEPTH)
+            return gray('{…}');
+        const entries = Object.entries(val);
+        if (entries.length === 0)
+            return dim('{}');
+        return formatEntries(entries, depth, baseIndent);
+    }
+    return String(val);
+}
+function formatEntries(entries, depth, baseIndent) {
+    const childIndent = baseIndent + TREE_INDENT;
+    const lines = entries.map(([key, val], i) => {
+        const isLast = i === entries.length - 1;
+        const branch = dim(isLast ? '└─ ' : '├─ ');
+        const keyPart = blue(key) + dim(':');
+        const valStr = formatValue(val, depth + 1, childIndent + TREE_INDENT);
+        // If the formatted value itself starts with '\n' it already carries its own tree
+        const sep = valStr.startsWith('\n') ? '' : ' ';
+        return `${childIndent}${branch}${keyPart}${sep}${valStr}`;
+    });
+    return '\n' + lines.join('\n');
+}
+const BADGE = {
+    info: paint(`${BOLD}${bg.blue}`, white(' INFO ')),
+    warn: paint(`${BOLD}${bg.yellow}`, white(' WARN ')),
+    error: paint(`${BOLD}${bg.red}`, white(' ERR  ')),
+    debug: paint(`${BOLD}${bg.gray}`, white(' DBG  ')),
+};
+// ── Logger ────────────────────────────────────────────────────────────────────
+function timestamp() {
+    return dim(new Date().toTimeString().slice(0, 8));
+}
+class Logger {
+    constructor(ns) {
+        this.ns = ns;
+    }
+    emit(level, message, data) {
+        const ns = magenta(this.ns);
+        const header = `${timestamp()}  ${BADGE[level]}  ${ns}  ${bold(message)}`;
+        if (data === undefined) {
+            process.stdout.write(header + '\n');
+            return;
+        }
+        if (isPrimitive(data)) {
+            process.stdout.write(`${header}  ${formatPrimitive(data)}\n`);
+            return;
+        }
+        const tree = formatValue(data, 0, '');
+        process.stdout.write(header + tree + '\n');
+    }
+    info(msg, data) { this.emit('info', msg, data); }
+    warn(msg, data) { this.emit('warn', msg, data); }
+    error(msg, data) { this.emit('error', msg, data); }
+    debug(msg, data) { this.emit('debug', msg, data); }
+}
+exports.Logger = Logger;
+// ── Factory ───────────────────────────────────────────────────────────────────
+function createLogger(namespace) {
+    return new Logger(namespace);
+}
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":";AAAA,iFAAiF;;;AA+JjF,oCAEC;AA/JD,MAAM,CAAC,GAAM,SAAS,CAAC,CAAG,QAAQ;AAClC,MAAM,IAAI,GAAG,SAAS,CAAC;AACvB,MAAM,GAAG,GAAI,SAAS,CAAC;AAEvB,MAAM,EAAE,GAAG;IACT,IAAI,EAAK,UAAU;IACnB,GAAG,EAAM,UAAU;IACnB,KAAK,EAAI,UAAU;IACnB,MAAM,EAAG,UAAU;IACnB,IAAI,EAAK,UAAU;IACnB,OAAO,EAAE,UAAU;IACnB,IAAI,EAAK,UAAU;IACnB,KAAK,EAAI,UAAU;CACX,CAAC;AAEX,MAAM,EAAE,GAAG;IACT,IAAI,EAAI,UAAU;IAClB,MAAM,EAAE,UAAU;IAClB,GAAG,EAAK,UAAU;IAClB,IAAI,EAAI,WAAW;IACnB,KAAK,EAAG,UAAU;CACV,CAAC;AAEX,0DAA0D;AAC1D,sEAAsE;AACtE,qEAAqE;AACrE,MAAM,SAAS,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;AAE3C,MAAM,KAAK,GAAG,CAAC,IAAY,EAAE,IAAY,EAAE,EAAE,CAC3C,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,IAAI,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAE1C,MAAM,IAAI,GAAM,CAAC,CAAS,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAS,CAAC,CAAC,CAAC;AACrD,MAAM,GAAG,GAAO,CAAC,CAAS,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,EAAU,CAAC,CAAC,CAAC;AACrD,MAAM,IAAI,GAAM,CAAC,CAAS,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAM,CAAC,CAAC,CAAC;AACrD,MAAM,KAAK,GAAK,CAAC,CAAS,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAK,CAAC,CAAC,CAAC;AACrD,MAAM,MAAM,GAAI,CAAC,CAAS,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAI,CAAC,CAAC,CAAC;AACrD,MAAM,IAAI,GAAM,CAAC,CAAS,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAM,CAAC,CAAC,CAAC;AACrD,MAAM,IAAI,GAAM,CAAC,CAAS,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAM,CAAC,CAAC,CAAC;AACrD,MAAM,OAAO,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAG,CAAC,CAAC,CAAC;AACrD,MAAM,KAAK,GAAK,CAAC,CAAS,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAK,CAAC,CAAC,CAAC;AAErD,iFAAiF;AAEjF,MAAM,SAAS,GAAG,CAAC,CAAC;AACpB,MAAM,WAAW,GAAG,KAAK,CAAC;AAI1B,SAAS,WAAW,CAAC,GAAY;IAC/B,OAAO,CACL,GAAG,KAAK,IAAI;QACZ,GAAG,KAAK,SAAS;QACjB,CAAC,OAAO,GAAG,KAAK,QAAQ,IAAI,OAAO,GAAG,KAAK,UAAU,CAAC,CACvD,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,GAAc;IACrC,IAAI,GAAG,KAAK,IAAI;QAAY,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC;IAC/C,IAAI,GAAG,KAAK,SAAS;QAAO,OAAO,GAAG,CAAC,WAAW,CAAC,CAAC;IACpD,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAG,OAAO,KAAK,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC;IACvD,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAG,OAAO,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IACzD,IAAI,OAAO,GAAG,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IACvD,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;AACrB,CAAC;AAED,SAAS,WAAW,CAAC,GAAY,EAAE,KAAK,GAAG,CAAC,EAAE,UAAU,GAAG,EAAE;IAC3D,IAAI,WAAW,CAAC,GAAG,CAAC;QAAE,OAAO,eAAe,CAAC,GAAG,CAAC,CAAC;IAElD,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,GAAG,CAAC,IAAI,CAAC,CAAC;QACvC,4CAA4C;QAC5C,IAAI,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC;YAC3B,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;YACvD,OAAO,GAAG,GAAG,CAAC,GAAG,CAAC,IAAI,KAAK,IAAI,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QAC5C,CAAC;QACD,wBAAwB;QACxB,OAAO,aAAa,CAClB,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAsB,CAAC,EACtD,KAAK,EACL,UAAU,CACX,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QAC5C,IAAI,KAAK,IAAI,SAAS;YAAE,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC;QAC3C,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,GAA8B,CAAC,CAAC;QAC/D,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,GAAG,CAAC,IAAI,CAAC,CAAC;QAC3C,OAAO,aAAa,CAAC,OAAO,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;IACnD,CAAC;IAED,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;AACrB,CAAC;AAED,SAAS,aAAa,CACpB,OAA4B,EAC5B,KAAa,EACb,UAAkB;IAElB,MAAM,WAAW,GAAG,UAAU,GAAG,WAAW,CAAC;IAC7C,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE;QAC1C,MAAM,MAAM,GAAI,CAAC,KAAK,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;QACzC,MAAM,MAAM,GAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;QACrC,MAAM,MAAM,GAAI,WAAW,CAAC,GAAG,EAAE,KAAK,GAAG,CAAC,EAAE,WAAW,GAAG,WAAW,CAAC,CAAC;QACvE,iFAAiF;QACjF,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;QAC/C,OAAO,GAAG,WAAW,GAAG,MAAM,GAAG,OAAO,GAAG,GAAG,GAAG,MAAM,EAAE,CAAC;IAC5D,CAAC,CAAC,CAAC;IACH,OAAO,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACjC,CAAC;AAMD,MAAM,KAAK,GAA0B;IACnC,IAAI,EAAG,KAAK,CAAC,GAAG,IAAI,GAAG,EAAE,CAAC,IAAI,EAAE,EAAI,KAAK,CAAC,QAAQ,CAAC,CAAE;IACrD,IAAI,EAAG,KAAK,CAAC,GAAG,IAAI,GAAG,EAAE,CAAC,MAAM,EAAE,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAE;IACrD,KAAK,EAAE,KAAK,CAAC,GAAG,IAAI,GAAG,EAAE,CAAC,GAAG,EAAE,EAAK,KAAK,CAAC,QAAQ,CAAC,CAAE;IACrD,KAAK,EAAE,KAAK,CAAC,GAAG,IAAI,GAAG,EAAE,CAAC,IAAI,EAAE,EAAI,KAAK,CAAC,QAAQ,CAAC,CAAE;CACtD,CAAC;AAEF,iFAAiF;AAEjF,SAAS,SAAS;IAChB,OAAO,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,YAAY,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AACpD,CAAC;AAED,MAAa,MAAM;IACjB,YAA6B,EAAU;QAAV,OAAE,GAAF,EAAE,CAAQ;IAAG,CAAC;IAEnC,IAAI,CAAC,KAAY,EAAE,OAAe,EAAE,IAAc;QACxD,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC5B,MAAM,MAAM,GAAG,GAAG,SAAS,EAAE,KAAK,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAE1E,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;YACpC,OAAO;QACT,CAAC;QAED,IAAI,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;YACtB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,KAAK,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC9D,OAAO;QACT,CAAC;QAED,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QACtC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC;IAC7C,CAAC;IAED,IAAI,CAAE,GAAW,EAAE,IAAc,IAAU,IAAI,CAAC,IAAI,CAAC,MAAM,EAAG,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IAC3E,IAAI,CAAE,GAAW,EAAE,IAAc,IAAU,IAAI,CAAC,IAAI,CAAC,MAAM,EAAG,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IAC3E,KAAK,CAAC,GAAW,EAAE,IAAc,IAAU,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IAC3E,KAAK,CAAC,GAAW,EAAE,IAAc,IAAU,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;CAC5E;AAzBD,wBAyBC;AAED,iFAAiF;AAEjF,SAAgB,YAAY,CAAC,SAAiB;IAC5C,OAAO,IAAI,MAAM,CAAC,SAAS,CAAC,CAAC;AAC/B,CAAC"}

package/dist/utils/segments.d.ts

@@ -0,0 +1,25 @@
+import type { Request } from 'express';
+type ConvertBrowser = 'IE' | 'CH' | 'FF' | 'OP' | 'SF' | 'OTH';
+type ConvertDevice = 'ALLPH' | 'IPH' | 'OTHPH' | 'ALLTAB' | 'IPAD' | 'OTHTAB' | 'DESK' | 'OTHDEV';
+type ConvertSource = 'campaign' | 'search' | 'referral' | 'direct' | 'ai_tool';
+type ConvertVisitorType = 'new' | 'returning';
+export interface VisitorSegments {
+    browser?: ConvertBrowser;
+    devices?: ConvertDevice[];
+    country?: string;
+    source?: ConvertSource;
+    campaign?: string;
+    visitorType?: ConvertVisitorType;
+}
+/**
+ * Build Convert default segments from the incoming HTTP request.
+ *
+ * Auto-detected from headers:  browser, devices, country (geoip from IP)
+ * Passed by frontend:          pageUrl (not used directly), campaign (UTM param)
+ *
+ * Note: Convert's `source` field is a traffic category ('direct' | 'campaign' | ...),
+ * not a URL. If a UTM campaign is present we report 'campaign'; otherwise 'direct'.
+ */
+export declare function buildSegments(req: Request, _pageUrl?: string, campaign?: string): VisitorSegments;
+export {};
+//# sourceMappingURL=segments.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"segments.d.ts","sourceRoot":"","sources":["../../src/utils/segments.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAMvC,KAAK,cAAc,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,CAAC;AAC/D,KAAK,aAAa,GAAG,OAAO,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC;AAClG,KAAK,aAAa,GAAG,UAAU,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAC;AAC/E,KAAK,kBAAkB,GAAG,KAAK,GAAG,WAAW,CAAC;AAE9C,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,OAAO,CAAC,EAAE,aAAa,EAAE,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,kBAAkB,CAAC;CAClC;AAqDD;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,OAAO,EACZ,QAAQ,CAAC,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,MAAM,GAChB,eAAe,CA6BjB"}

package/dist/utils/segments.js

@@ -0,0 +1,103 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildSegments = buildSegments;
+const ua_parser_js_1 = require("ua-parser-js");
+const geoip_lite_1 = __importDefault(require("geoip-lite"));
+const logger_1 = require("./logger");
+const log = (0, logger_1.createLogger)('segments');
+/**
+ * Normalise UAParser browser name to Convert's internal browser codes.
+ * Convert API accepts: 'CH' (Chrome) | 'FF' (Firefox) | 'SF' (Safari) |
+ *                      'IE' (IE) | 'OP' (Opera) | 'OTH' (Other)
+ * Note: Edge is not in the enum — maps to 'OTH'.
+ * Order matters: check 'edge' before 'chrome' (Edge UA contains "Chrome")
+ */
+function normaliseBrowser(name) {
+    if (!name)
+        return 'OTH';
+    const n = name.toLowerCase();
+    if (n.includes('edge'))
+        return 'OTH';
+    if (n.includes('chrome') || n.includes('chromium'))
+        return 'CH';
+    if (n.includes('firefox'))
+        return 'FF';
+    if (n.includes('safari'))
+        return 'SF';
+    if (n.includes('ie') || n.includes('internet explorer'))
+        return 'IE';
+    if (n.includes('opera'))
+        return 'OP';
+    return 'OTH';
+}
+/**
+ * Normalise UAParser device type to Convert's internal device codes (array).
+ * Convert API accepts: ['DESK'] | ['ALLPH'] | ['ALLTAB']
+ * UAParser returns undefined for desktops — treat that as 'DESK'.
+ */
+function normaliseDevice(type) {
+    if (type === 'mobile')
+        return ['ALLPH'];
+    if (type === 'tablet')
+        return ['ALLTAB'];
+    return ['DESK'];
+}
+/**
+ * Derive traffic source category from available context.
+ * Convert API accepts: 'campaign' | 'search' | 'referral' | 'direct' | 'ai_tool'
+ */
+function deriveSource(campaign) {
+    if (campaign)
+        return 'campaign';
+    return 'direct';
+}
+/**
+ * Extract the real client IP, accounting for Railway / reverse proxy headers.
+ */
+function getClientIp(req) {
+    const forwarded = req.headers['x-forwarded-for'];
+    if (forwarded) {
+        const first = Array.isArray(forwarded) ? forwarded[0] : forwarded.split(',')[0];
+        return first.trim();
+    }
+    return req.socket?.remoteAddress;
+}
+/**
+ * Build Convert default segments from the incoming HTTP request.
+ *
+ * Auto-detected from headers:  browser, devices, country (geoip from IP)
+ * Passed by frontend:          pageUrl (not used directly), campaign (UTM param)
+ *
+ * Note: Convert's `source` field is a traffic category ('direct' | 'campaign' | ...),
+ * not a URL. If a UTM campaign is present we report 'campaign'; otherwise 'direct'.
+ */
+function buildSegments(req, _pageUrl, campaign) {
+    const ua = req.headers['user-agent'];
+    const parser = new ua_parser_js_1.UAParser(ua);
+    const result = parser.getResult();
+    // Country: try Cloudflare header first, fall back to offline geoip lookup
+    let country;
+    const cfCountry = req.headers['cf-ipcountry'];
+    if (cfCountry && cfCountry !== 'XX') {
+        country = cfCountry;
+    }
+    else {
+        const ip = getClientIp(req);
+        if (ip) {
+            const geo = geoip_lite_1.default.lookup(ip);
+            country = geo?.country ?? undefined;
+        }
+    }
+    const browser = normaliseBrowser(result.browser.name);
+    const devices = normaliseDevice(result.device.type);
+    const source = deriveSource(campaign);
+    const segments = { browser, devices, country, source };
+    if (campaign)
+        segments.campaign = campaign;
+    log.debug('built', { browser, devices, country, source, campaign });
+    return segments;
+}
+//# sourceMappingURL=segments.js.map

package/dist/utils/segments.js.map

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

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@arthurzakharov/convert-service",
+  "version": "1.0.0",
+  "description": "Server-side Convert.com SDK proxy service",
+  "repository": {
+    "url": "https://github.com/arthurzakharov/convert-service"
+  },
+  "author": {
+    "name": "Artur Zakharov",
+    "email": "zakharov.arthur@icloud.com"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./client": {
+      "types": "./dist/client.d.ts",
+      "default": "./dist/client.js"
+    },
+    "./contracts": {
+      "types": "./dist/contracts.d.ts",
+      "default": "./dist/contracts.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc && tsc-alias && node scripts/build-report.js",
+    "start": "node dist/index.js",
+    "dev": "ts-node-dev -r tsconfig-paths/register --respawn --transpile-only src/index.ts",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@convertcom/js-sdk": "^4.4.3",
+    "cors": "^2.8.5",
+    "dotenv": "^16.4.5",
+    "express": "^4.19.2",
+    "geoip-lite": "^1.4.10",
+    "ua-parser-js": "^2.0.10"
+  },
+  "devDependencies": {
+    "@types/cors": "^2.8.17",
+    "@types/express": "^4.17.21",
+    "@types/geoip-lite": "^1.4.4",
+    "@types/node": "^20.14.0",
+    "@types/ua-parser-js": "^0.7.39",
+    "ts-node-dev": "^2.0.0",
+    "tsc-alias": "^1.8.17",
+    "tsconfig-paths": "^4.2.0",
+    "typescript": "^5.4.5"
+  }
+}