@recombine-ai/platform 0.2.6-test.1 → 0.2.6-test.10

package/build/postgres-analytics-query.js

@@ -0,0 +1,392 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PostgresAnalyticsQueryService = exports.AnalyticsQueryError = void 0;
+exports.createPostgresAnalyticsQueryServices = createPostgresAnalyticsQueryServices;
+const pg_1 = require("pg");
+class AnalyticsQueryError extends Error {
+    name = 'AnalyticsQueryError';
+}
+exports.AnalyticsQueryError = AnalyticsQueryError;
+class PostgresAnalyticsQueryService {
+    database;
+    constructor(database) {
+        this.database = database;
+    }
+    async getConversation(conversationId) {
+        const result = await this.database.query(`SELECT c.conversation_id, c.agent_id, c.channel, c.region, c.started_at,
+                    c.ended_at, c.analytics,
+                    p.phone_number, p.recording_url, p.duration_seconds
+             FROM conversations c
+             LEFT JOIN phone_calls p ON p.conversation_id = c.conversation_id
+             WHERE c.conversation_id = $1`, [conversationId]);
+        const row = result.rows[0];
+        return row?.agent_id ? conversationRowToJson(row) : undefined;
+    }
+    async getConversations(query) {
+        const parsedLimit = Number.parseInt(optionalString(query.limit, 'limit') ?? '10', 10);
+        const requestedLimit = Number.isFinite(parsedLimit)
+            ? Math.min(100, Math.max(1, parsedLimit))
+            : 10;
+        const cursor = parseConversationCursor(optionalString(query.lastConversationId, 'lastConversationId'));
+        const { bind, conditions, values } = buildConversationConditions(query);
+        if (cursor) {
+            conditions.push(`(c.started_at, c.conversation_id) < (${bind(cursor.startedAt)}, ${bind(cursor.conversationId)})`);
+        }
+        const where = conditions.length ? `WHERE ${conditions.join(' AND ')}` : '';
+        const limitParameter = bind(requestedLimit + 1);
+        const result = await this.database.query(`SELECT c.conversation_id, c.agent_id, c.channel, c.region, c.started_at,
+                    c.ended_at, c.analytics,
+                    p.phone_number, p.recording_url, p.duration_seconds
+             FROM conversations c
+             LEFT JOIN phone_calls p ON p.conversation_id = c.conversation_id
+             ${where}
+             ORDER BY c.started_at DESC, c.conversation_id DESC
+             LIMIT ${limitParameter}`, values);
+        const hasNextPage = result.rows.length > requestedLimit;
+        const rows = result.rows.slice(0, requestedLimit);
+        return {
+            limit: requestedLimit,
+            items: rows.map(conversationRowToJson),
+            lastConversationId: hasNextPage && rows.length > 0 ? makeConversationCursor(rows.at(-1)) : undefined,
+        };
+    }
+    async getAnalyticsFields(query) {
+        const agentId = requiredString(query.agentId, 'agentId');
+        const values = [agentId];
+        const where = "WHERE jsonb_typeof(entry.value) IN ('boolean', 'number', 'string')" +
+            ' AND c.agent_id = $1';
+        const result = await this.database.query(`WITH value_counts AS (
+                 SELECT entry.key,
+                        jsonb_typeof(entry.value) AS type,
+                        entry.value AS value,
+                        COUNT(*)::bigint AS occurrence_count
+                 FROM conversations c
+                 CROSS JOIN LATERAL jsonb_each(c.analytics) AS entry(key, value)
+                 ${where}
+                 GROUP BY entry.key, type, entry.value
+             ),
+             ranked AS (
+                 SELECT key,
+                        type,
+                        value,
+                        occurrence_count,
+                        COUNT(*) OVER (PARTITION BY key, type)::integer AS variant_count,
+                        ROW_NUMBER() OVER (
+                            PARTITION BY key, type
+                            ORDER BY occurrence_count DESC, value::text ASC
+                        ) AS rank
+                 FROM value_counts
+             )
+             SELECT key, type, value, occurrence_count, variant_count
+             FROM ranked
+             WHERE rank <= 50
+             ORDER BY key ASC, type ASC, rank ASC`, values);
+        return analyticsFieldRowsToJson(result.rows);
+    }
+    async getTimeSeries(query) {
+        const metric = parseMetric(requiredString(query.metric, 'metric'));
+        const granularity = (optionalString(query.granularity, 'granularity') ??
+            'day');
+        if (!['hour', 'day', 'week', 'month'].includes(granularity)) {
+            throw new AnalyticsQueryError('granularity must be hour, day, week, or month');
+        }
+        const { bind, conditions, from, to, values } = buildConversationConditions(query);
+        if (!from || !to) {
+            throw new AnalyticsQueryError('from and to are required for a time series');
+        }
+        const bucketExpression = `date_trunc(${bind(granularity)}::text, c.started_at, 'UTC')`;
+        let valueExpression;
+        let numeratorExpression = 'NULL::bigint';
+        if (metric.operation === 'count') {
+            valueExpression = 'COUNT(*)::double precision';
+        }
+        else if (metric.operation === 'rate') {
+            const predicate = makeAnalyticsPredicate(metric.filter, bind);
+            numeratorExpression = `COUNT(*) FILTER (WHERE ${predicate})::bigint`;
+            valueExpression =
+                `COUNT(*) FILTER (WHERE ${predicate})::double precision / ` + 'NULLIF(COUNT(*), 0)';
+        }
+        else {
+            const key = bind(metric.key);
+            const numericValue = `CASE WHEN jsonb_typeof(c.analytics -> (${key}::text)) = 'number' ` +
+                `THEN (c.analytics ->> (${key}::text))::double precision END`;
+            valueExpression =
+                metric.operation === 'average' ? `AVG(${numericValue})` : `SUM(${numericValue})`;
+        }
+        const where = conditions.length ? `WHERE ${conditions.join(' AND ')}` : '';
+        const result = await this.database.query(`SELECT ${bucketExpression} AS bucket_start,
+                    ${valueExpression} AS metric_value,
+                    ${numeratorExpression} AS numerator,
+                    COUNT(*)::bigint AS denominator
+             FROM conversations c
+             LEFT JOIN phone_calls p ON p.conversation_id = c.conversation_id
+             ${where}
+             GROUP BY bucket_start
+             ORDER BY bucket_start ASC`, values);
+        return {
+            metric,
+            granularity,
+            from: from.toISOString(),
+            to: to.toISOString(),
+            items: result.rows.map((row) => ({
+                startAt: new Date(row.bucket_start).toISOString(),
+                value: row.metric_value === null ? null : Number(row.metric_value),
+                ...(metric.operation === 'rate'
+                    ? {
+                        numerator: Number(row.numerator),
+                        denominator: Number(row.denominator),
+                    }
+                    : {}),
+            })),
+        };
+    }
+}
+exports.PostgresAnalyticsQueryService = PostgresAnalyticsQueryService;
+function createPostgresAnalyticsQueryServices(config) {
+    const pool = new pg_1.Pool(config);
+    return {
+        queries: new PostgresAnalyticsQueryService(pool),
+        close: () => pool.end(),
+    };
+}
+function optionalString(value, name) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== 'string') {
+        throw new AnalyticsQueryError(`${name} must be a string`);
+    }
+    return value;
+}
+function requiredString(value, name) {
+    const result = optionalString(value, name);
+    if (!result) {
+        throw new AnalyticsQueryError(`${name} is required`);
+    }
+    return result;
+}
+function parseDateFilter(value, name) {
+    const stringValue = optionalString(value, name);
+    if (stringValue === undefined)
+        return undefined;
+    const date = /^\d+$/.test(stringValue) ? new Date(Number(stringValue)) : new Date(stringValue);
+    if (Number.isNaN(date.getTime())) {
+        throw new AnalyticsQueryError(`${name} must be a valid date`);
+    }
+    return date;
+}
+function parseDurationFilter(value, name) {
+    const stringValue = optionalString(value, name);
+    if (stringValue === undefined)
+        return undefined;
+    const duration = Number(stringValue);
+    if (!Number.isFinite(duration) || duration < 0) {
+        throw new AnalyticsQueryError(`${name} must be a non-negative number`);
+    }
+    return duration;
+}
+function parseAnalyticsFilters(value) {
+    const stringValue = optionalString(value, 'filters');
+    if (!stringValue)
+        return [];
+    let filters;
+    try {
+        filters = JSON.parse(stringValue);
+    }
+    catch {
+        throw new AnalyticsQueryError('filters must be valid JSON');
+    }
+    if (!Array.isArray(filters) || filters.length > 20) {
+        throw new AnalyticsQueryError('filters must be an array with at most 20 entries');
+    }
+    return filters.map(validateAnalyticsFilter);
+}
+function validateAnalyticsFilter(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw new AnalyticsQueryError('Each filter must be an object');
+    }
+    const filter = value;
+    if (typeof filter.key !== 'string' || !/^[A-Za-z0-9_.:-]{1,128}$/.test(filter.key)) {
+        throw new AnalyticsQueryError('Filter key is invalid');
+    }
+    if (!['boolean', 'number', 'string'].includes(String(filter.type))) {
+        throw new AnalyticsQueryError(`Filter '${filter.key}' has an invalid type`);
+    }
+    const type = filter.type;
+    const allowedOperators = type === 'number'
+        ? ['eq', 'in', 'gt', 'gte', 'lt', 'lte', 'exists']
+        : ['eq', 'in', 'exists'];
+    if (!allowedOperators.includes(String(filter.operator))) {
+        throw new AnalyticsQueryError(`Filter '${filter.key}' has an invalid operator`);
+    }
+    const operator = filter.operator;
+    if (operator === 'in') {
+        if (!Array.isArray(filter.values) ||
+            filter.values.length === 0 ||
+            filter.values.length > 50 ||
+            filter.values.some((item) => typeof item !== type || (type === 'number' && !Number.isFinite(item)))) {
+            throw new AnalyticsQueryError(`Filter '${filter.key}' has invalid values`);
+        }
+        return { key: filter.key, type, operator, values: filter.values };
+    }
+    if (operator !== 'exists' && typeof filter.value !== type) {
+        throw new AnalyticsQueryError(`Filter '${filter.key}' has an invalid value`);
+    }
+    if (type === 'number' && !Number.isFinite(filter.value)) {
+        throw new AnalyticsQueryError(`Filter '${filter.key}' has an invalid value`);
+    }
+    return {
+        key: filter.key,
+        type,
+        operator,
+        ...(operator === 'exists' ? {} : { value: filter.value }),
+    };
+}
+function parseMetric(value) {
+    let metric;
+    try {
+        metric = JSON.parse(value);
+    }
+    catch {
+        throw new AnalyticsQueryError('metric must be valid JSON');
+    }
+    if (!metric || typeof metric !== 'object' || Array.isArray(metric)) {
+        throw new AnalyticsQueryError('metric must be an object');
+    }
+    const record = metric;
+    if (!['count', 'rate', 'average', 'sum'].includes(String(record.operation))) {
+        throw new AnalyticsQueryError('metric operation is invalid');
+    }
+    if (record.operation === 'rate') {
+        return { operation: 'rate', filter: validateAnalyticsFilter(record.filter) };
+    }
+    if (record.operation === 'average' || record.operation === 'sum') {
+        if (typeof record.key !== 'string' || !/^[A-Za-z0-9_.:-]{1,128}$/.test(record.key)) {
+            throw new AnalyticsQueryError('Metric key is invalid');
+        }
+        return { operation: record.operation, key: record.key };
+    }
+    return { operation: 'count' };
+}
+function parseConversationCursor(value) {
+    if (!value)
+        return undefined;
+    try {
+        const cursor = JSON.parse(Buffer.from(value, 'base64url').toString('utf8'));
+        const startedAt = new Date(String(cursor.startedAt));
+        if (Number.isNaN(startedAt.getTime()) ||
+            typeof cursor.conversationId !== 'string' ||
+            cursor.conversationId === '') {
+            throw new Error('invalid cursor');
+        }
+        return { startedAt, conversationId: cursor.conversationId };
+    }
+    catch {
+        throw new AnalyticsQueryError('lastConversationId is invalid');
+    }
+}
+function makeConversationCursor(row) {
+    return Buffer.from(JSON.stringify({
+        startedAt: new Date(row.started_at).toISOString(),
+        conversationId: row.conversation_id,
+    })).toString('base64url');
+}
+function conversationRowToJson(row) {
+    return {
+        conversationId: row.conversation_id,
+        medium: row.channel,
+        agentId: row.agent_id,
+        region: row.region || undefined,
+        phoneNumber: row.phone_number || undefined,
+        duration: row.duration_seconds ?? undefined,
+        audioUrl: row.recording_url || undefined,
+        createdAt: new Date(row.started_at).getTime(),
+        endedAt: row.ended_at ? new Date(row.ended_at).getTime() : undefined,
+        analytics: analyticsScalars(row.analytics),
+    };
+}
+function analyticsScalars(values) {
+    return Object.fromEntries(Object.entries(values ?? {}).filter((entry) => {
+        const value = entry[1];
+        return (typeof value === 'boolean' ||
+            typeof value === 'string' ||
+            (typeof value === 'number' && Number.isFinite(value)));
+    }));
+}
+function analyticsFieldRowsToJson(rows) {
+    const fields = new Map();
+    for (const row of rows) {
+        const id = `${row.key}\u0000${row.type}`;
+        let field = fields.get(id);
+        if (!field) {
+            field = {
+                key: row.key,
+                type: row.type,
+                variantCount: Number(row.variant_count),
+                values: [],
+            };
+            fields.set(id, field);
+        }
+        if (field.variantCount <= 50) {
+            field.values.push({ value: row.value, count: Number(row.occurrence_count) });
+        }
+    }
+    return { items: [...fields.values()] };
+}
+function buildConversationConditions(query) {
+    const values = [];
+    const bind = (value) => {
+        values.push(value);
+        return `$${values.length}`;
+    };
+    const conditions = [];
+    const from = parseDateFilter(query.from, 'from');
+    const to = parseDateFilter(query.to, 'to');
+    if (from && to && from >= to) {
+        throw new AnalyticsQueryError('from must be earlier than to');
+    }
+    const agentId = requiredString(query.agentId, 'agentId');
+    const region = optionalString(query.region, 'region');
+    const channel = optionalString(query.channel, 'channel');
+    const phoneNumber = optionalString(query.phoneNumber, 'phoneNumber');
+    conditions.push(`c.agent_id = ${bind(agentId)}`);
+    if (region)
+        conditions.push(`c.region = ${bind(region)}`);
+    if (channel)
+        conditions.push(`c.channel = ${bind(channel)}`);
+    if (phoneNumber)
+        conditions.push(`p.phone_number = ${bind(phoneNumber)}`);
+    if (from)
+        conditions.push(`c.started_at >= ${bind(from)}`);
+    if (to)
+        conditions.push(`c.started_at < ${bind(to)}`);
+    const minDuration = parseDurationFilter(query.minDurationSeconds, 'minDurationSeconds');
+    const maxDuration = parseDurationFilter(query.maxDurationSeconds, 'maxDurationSeconds');
+    if (minDuration !== undefined)
+        conditions.push(`p.duration_seconds >= ${bind(minDuration)}`);
+    if (maxDuration !== undefined)
+        conditions.push(`p.duration_seconds <= ${bind(maxDuration)}`);
+    if (minDuration !== undefined && maxDuration !== undefined && minDuration > maxDuration) {
+        throw new AnalyticsQueryError('minDurationSeconds must not exceed maxDurationSeconds');
+    }
+    for (const filter of parseAnalyticsFilters(query.filters)) {
+        conditions.push(makeAnalyticsPredicate(filter, bind));
+    }
+    return { bind, conditions, from, to, values };
+}
+function makeAnalyticsPredicate(filter, bind) {
+    const key = bind(filter.key);
+    if (filter.operator === 'exists') {
+        return `c.analytics ? (${key}::text)`;
+    }
+    if (filter.operator === 'eq') {
+        return `c.analytics @> jsonb_build_object(${key}::text, ${bind(JSON.stringify(filter.value))}::jsonb)`;
+    }
+    if (filter.operator === 'in') {
+        const predicates = filter.values.map((value) => `c.analytics @> jsonb_build_object(${key}::text, ${bind(JSON.stringify(value))}::jsonb)`);
+        return `(${predicates.join(' OR ')})`;
+    }
+    const operator = { gt: '>', gte: '>=', lt: '<', lte: '<=' }[filter.operator];
+    return (`(CASE WHEN jsonb_typeof(c.analytics -> (${key}::text)) = 'number' THEN ` +
+        `(c.analytics ->> (${key}::text))::double precision ${operator} ${bind(filter.value)} ` +
+        'ELSE false END)');
+}

package/build/postgres-analytics.d.ts

@@ -0,0 +1,45 @@
+import { Pool, PoolConfig, QueryResult } from 'pg';
+import { AnalyticsScalar, AnalyticsStore, ConversationAnalyticsSummary } from './analytics';
+import { PostgresAnalyticsQueryService } from './postgres-analytics-query';
+export interface ConversationRecord {
+    conversationId: string;
+    agentId: string;
+    channel: string;
+    region?: string;
+    startedAt: Date;
+    endedAt?: Date;
+}
+export interface PhoneCallRecord {
+    phoneNumber?: string;
+    recordingUrl?: string;
+    endedReason?: string;
+    durationSeconds?: number;
+}
+interface Queryable {
+    query<TResult extends Record<string, unknown> = Record<string, unknown>>(text: string, values?: unknown[]): Promise<QueryResult<TResult>>;
+}
+export declare class PostgresAnalytics implements AnalyticsStore {
+    private readonly database;
+    constructor(database: Queryable);
+    set(conversationId: string, agentId: string, fieldName: string, value: AnalyticsScalar): Promise<void>;
+    clear(conversationId: string, agentId: string, fieldName: string): Promise<void>;
+    get(conversationId: string, agentId: string, fieldName: string): Promise<unknown | undefined>;
+    getSummary(conversationId: string, agentId: string): Promise<ConversationAnalyticsSummary | undefined>;
+}
+export declare class PostgresConversationRepository {
+    private readonly pool;
+    constructor(pool: Pool);
+    saveConversation(conversation: ConversationRecord, phoneCall?: PhoneCallRecord): Promise<void>;
+    private upsertConversation;
+    private upsertPhoneCall;
+}
+export declare function migrateAnalyticsDatabase(pool: Pool): Promise<void>;
+export interface PostgresAnalyticsServices {
+    analytics: PostgresAnalytics;
+    conversations: PostgresConversationRepository;
+    queries: PostgresAnalyticsQueryService;
+    close(): Promise<void>;
+}
+export declare function createPostgresAnalyticsServices(config: PoolConfig): Promise<PostgresAnalyticsServices>;
+export {};
+//# sourceMappingURL=postgres-analytics.d.ts.map

package/build/postgres-analytics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-analytics.d.ts","sourceRoot":"","sources":["../src/postgres-analytics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAc,UAAU,EAAE,WAAW,EAAE,MAAM,IAAI,CAAA;AAE9D,OAAO,EACH,eAAe,EACf,cAAc,EACd,4BAA4B,EAE/B,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,6BAA6B,EAAE,MAAM,4BAA4B,CAAA;AAI1E,MAAM,WAAW,kBAAkB;IAC/B,cAAc,EAAE,MAAM,CAAA;IACtB,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,IAAI,CAAA;IACf,OAAO,CAAC,EAAE,IAAI,CAAA;CACjB;AAID,MAAM,WAAW,eAAe;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,eAAe,CAAC,EAAE,MAAM,CAAA;CAC3B;AAID,UAAU,SAAS;IACf,KAAK,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnE,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,OAAO,EAAE,GACnB,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAA;CACnC;AAaD,qBAAa,iBAAkB,YAAW,cAAc;IACxC,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,SAAS;IAE1C,GAAG,CACL,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,eAAe,GACvB,OAAO,CAAC,IAAI,CAAC;IAeV,KAAK,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAchF,GAAG,CACL,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAClB,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC;IAezB,UAAU,CACZ,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,MAAM,GAChB,OAAO,CAAC,4BAA4B,GAAG,SAAS,CAAC;CAqBvD;AAgBD,qBAAa,8BAA8B;IAC3B,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,IAAI;IAEjC,gBAAgB,CAClB,YAAY,EAAE,kBAAkB,EAChC,SAAS,CAAC,EAAE,eAAe,GAC5B,OAAO,CAAC,IAAI,CAAC;YAmBF,kBAAkB;YAsClB,eAAe;CAgChC;AA2FD,wBAAsB,wBAAwB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAgDxE;AA6BD,MAAM,WAAW,yBAAyB;IACtC,SAAS,EAAE,iBAAiB,CAAA;IAC5B,aAAa,EAAE,8BAA8B,CAAA;IAC7C,OAAO,EAAE,6BAA6B,CAAA;IACtC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACzB;AAID,wBAAsB,+BAA+B,CACjD,MAAM,EAAE,UAAU,GACnB,OAAO,CAAC,yBAAyB,CAAC,CAgBpC"}