@recombine-ai/platform 0.2.6-test.2 → 0.2.6-test.4

package/build/analytics.d.ts

@@ -1,11 +1,9 @@
 import { z } from 'zod';
-export type AnalyticsValueType = 'boolean' | 'number' | 'string' | 'json';
 export type AnalyticsJsonValue = boolean | number | string | null | AnalyticsJsonValue[] | {
     [key: string]: AnalyticsJsonValue;
 };
 export interface AnalyticsKey<T> {
     readonly key: string;
-    readonly valueType: AnalyticsValueType;
     readonly schema: z.ZodType<T>;
 }
 export type AnalyticsValue<TKey extends AnalyticsKey<unknown>> = TKey extends AnalyticsKey<infer TValue> ? TValue : never;

package/build/analytics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../src/analytics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAA;AACzE,MAAM,MAAM,kBAAkB,GACxB,OAAO,GACP,MAAM,GACN,MAAM,GACN,IAAI,GACJ,kBAAkB,EAAE,GACpB;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,kBAAkB,CAAA;CAAE,CAAA;AAE3C,MAAM,WAAW,YAAY,CAAC,CAAC;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,SAAS,EAAE,kBAAkB,CAAA;IACtC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;CAChC;AAED,MAAM,MAAM,cAAc,CAAC,IAAI,SAAS,YAAY,CAAC,OAAO,CAAC,IACzD,IAAI,SAAS,YAAY,CAAC,MAAM,MAAM,CAAC,GAAG,MAAM,GAAG,KAAK,CAAA;AAE5D,MAAM,WAAW,4BAA4B;IACzC,cAAc,EAAE,MAAM,CAAA;IACtB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,IAAI,CAAA;IACf,OAAO,CAAC,EAAE,IAAI,CAAA;IACd,eAAe,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED,MAAM,WAAW,qBAAqB;IAClC,GAAG,CAAC,IAAI,SAAS,YAAY,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC9F,KAAK,CAAC,GAAG,EAAE,YAAY,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAChD,GAAG,CAAC,IAAI,SAAS,YAAY,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,IAAI,GAAG,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,CAAA;IAC7F,UAAU,IAAI,OAAO,CAAC,4BAA4B,GAAG,SAAS,CAAC,CAAA;CAClE;AAED,MAAM,WAAW,SAAS;IACtB,wBAAwB,CAAC,cAAc,EAAE,MAAM,GAAG,qBAAqB,CAAA;CAC1E;AAcD,eAAO,MAAM,YAAY;iBACR,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC;gBAG/B,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC;gBAG7B,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC;eAG9B,OAAO,SAAS,SAAS,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,OAChD,MAAM,UACH,OAAO,GAChB,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;SAG3B,CAAC,SAAS,kBAAkB,OAAO,MAAM,UAAU,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC;CAGzF,CAAA;AAED,wBAAgB,uBAAuB,CAAC,SAAS,GAAE,4BAA4B,EAAO,GAAG,SAAS,CAsCjG;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,kBAAkB,CAkB5F"}
+{"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../src/analytics.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,MAAM,MAAM,kBAAkB,GACxB,OAAO,GACP,MAAM,GACN,MAAM,GACN,IAAI,GACJ,kBAAkB,EAAE,GACpB;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,kBAAkB,CAAA;CAAE,CAAA;AAI3C,MAAM,WAAW,YAAY,CAAC,CAAC;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;CAChC;AAID,MAAM,MAAM,cAAc,CAAC,IAAI,SAAS,YAAY,CAAC,OAAO,CAAC,IACzD,IAAI,SAAS,YAAY,CAAC,MAAM,MAAM,CAAC,GAAG,MAAM,GAAG,KAAK,CAAA;AAI5D,MAAM,WAAW,4BAA4B;IACzC,cAAc,EAAE,MAAM,CAAA;IACtB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,IAAI,CAAA;IACf,OAAO,CAAC,EAAE,IAAI,CAAA;IACd,eAAe,CAAC,EAAE,MAAM,CAAA;CAC3B;AAID,MAAM,WAAW,qBAAqB;IAClC,GAAG,CAAC,IAAI,SAAS,YAAY,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC9F,KAAK,CAAC,GAAG,EAAE,YAAY,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAChD,GAAG,CAAC,IAAI,SAAS,YAAY,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,IAAI,GAAG,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,CAAA;IAC7F,UAAU,IAAI,OAAO,CAAC,4BAA4B,GAAG,SAAS,CAAC,CAAA;CAClE;AAID,MAAM,WAAW,SAAS;IACtB,wBAAwB,CAAC,cAAc,EAAE,MAAM,GAAG,qBAAqB,CAAA;CAC1E;AAgBD,eAAO,MAAM,YAAY;iBACR,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC;gBAG/B,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC;gBAG7B,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC;eAG9B,OAAO,SAAS,SAAS,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,OAChD,MAAM,UACH,OAAO,GAChB,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;SAK3B,CAAC,SAAS,kBAAkB,OAAO,MAAM,UAAU,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC;CAKzF,CAAA;AAID,wBAAgB,uBAAuB,CAAC,SAAS,GAAE,4BAA4B,EAAO,GAAG,SAAS,CAkDjG;AAID,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,kBAAkB,CA0B5F"}

package/build/analytics.js

@@ -1,25 +1,25 @@
 import { z } from 'zod';
-function defineKey(key, valueType, schema) {
+function defineKey(key, schema) {
     if (!/^[A-Za-z0-9_.:-]{1,128}$/.test(key)) {
         throw new Error('Analytics key contains unsupported characters');
     }
-    return Object.freeze({ key, valueType, schema });
+    return Object.freeze({ key, schema });
 }
 export const analyticsKey = {
     boolean(key) {
-        return defineKey(key, 'boolean', z.boolean());
+        return defineKey(key, z.boolean());
     },
     number(key) {
-        return defineKey(key, 'number', z.number().finite());
+        return defineKey(key, z.number().finite());
     },
     string(key) {
-        return defineKey(key, 'string', z.string());
+        return defineKey(key, z.string());
     },
     enum(key, values) {
-        return defineKey(key, 'string', z.enum(values));
+        return defineKey(key, z.enum(values));
     },
     json(key, schema) {
-        return defineKey(key, 'json', schema);
+        return defineKey(key, schema);
     },
 };
 export function createInMemoryAnalytics(summaries = []) {

package/build/index.d.ts

@@ -3,5 +3,6 @@ export * from './interfaces/rc-voice.js';
 export * from './context-cache.js';
 export * from './analytics.js';
 export * from './postgres-analytics.js';
+export * from './postgres-analytics-query.js';
 export * from './timeouts-manager.js';
 //# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAA;AACxC,cAAc,0BAA0B,CAAA;AACxC,cAAc,oBAAoB,CAAA;AAClC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,yBAAyB,CAAA;AACvC,cAAc,uBAAuB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,cAAc,0BAA0B,CAAA;AACxC,cAAc,0BAA0B,CAAA;AACxC,cAAc,oBAAoB,CAAA;AAGlC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,yBAAyB,CAAA;AACvC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,uBAAuB,CAAA"}

package/build/index.js

@@ -3,4 +3,5 @@ export * from './interfaces/rc-voice.js';
 export * from './context-cache.js';
 export * from './analytics.js';
 export * from './postgres-analytics.js';
+export * from './postgres-analytics-query.js';
 export * from './timeouts-manager.js';

package/build/interfaces/platform.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../../src/interfaces/platform.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAEhD,OAAO,EACH,QAAQ,EACR,cAAc,EACd,UAAU,EACV,gBAAgB,EAChB,MAAM,EACN,OAAO,EACP,QAAQ,EACR,aAAa,EAChB,MAAM,sBAAsB,CAAA;AAE7B,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAExC,MAAM,WAAW,OAAO;IACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;IAClC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAA;CACpD;AAED,MAAM,WAAW,QAAQ,CACrB,QAAQ,SAAS,EAAE,EACnB,OAAO,SAAS,OAAO,EACvB,QAAQ,GAAG,QAAQ,EACnB,eAAe,GAAG,cAAc,EAChC,aAAa,GAAG,YAAY,CAAC,QAAQ,CAAC;IAGtC,QAAQ,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAA;IAElC,EAAE,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAA;IAEtB,EAAE,EAAE,QAAQ,CAAA;IAEZ,OAAO,EAAE,QAAQ,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,cAAc,EAAE,eAAe,CAAA;IAE/B,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAA;IACzB,eAAe,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAA;IAE3C,YAAY,EAAE,aAAa,CAAA;IAE3B,SAAS,EAAE,SAAS,CAAA;CACvB;AAED,MAAM,WAAW,QAAQ;IACrB,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC;AAED,MAAM,WAAW,UAAU;IACvB,WAAW,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,OAAO,CAAC;QACrC,cAAc,EAAE,MAAM,CAAA;QACtB,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAA;KACpD,CAAC,CAAA;IACF,WAAW,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC9C,cAAc,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,KAAK,OAAO,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC,CAAA;IAC/F,SAAS,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5C,iBAAiB,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACzE,gBAAgB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IACrC,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CAC5D;AAED,wBAAgB,WAAW,CAAC,QAAQ,SAAS,EAAE,EAAE,SAAS,EAAE,OAAO,SAAS,OAAO,EAC/E,OAAO,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,SAAS,KAAK,UAAU,cAA/D,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,YAAY,SAAS,KAAK,UAAU,CAGtF"}
+{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../../src/interfaces/platform.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAEhD,OAAO,EACH,QAAQ,EACR,cAAc,EACd,UAAU,EACV,gBAAgB,EAChB,MAAM,EACN,OAAO,EACP,QAAQ,EACR,aAAa,EAChB,MAAM,sBAAsB,CAAA;AAI7B,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAExC,MAAM,WAAW,OAAO;IACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;IAClC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAA;CACpD;AAID,MAAM,WAAW,QAAQ,CACrB,QAAQ,SAAS,EAAE,EACnB,OAAO,SAAS,OAAO,EACvB,QAAQ,GAAG,QAAQ,EACnB,eAAe,GAAG,cAAc,EAChC,aAAa,GAAG,YAAY,CAAC,QAAQ,CAAC;IAGtC,QAAQ,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAA;IAElC,EAAE,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAA;IAEtB,EAAE,EAAE,QAAQ,CAAA;IAEZ,OAAO,EAAE,QAAQ,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,cAAc,EAAE,eAAe,CAAA;IAE/B,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAA;IACzB,eAAe,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAA;IAE3C,YAAY,EAAE,aAAa,CAAA;IAK3B,SAAS,EAAE,SAAS,CAAA;CACvB;AAED,MAAM,WAAW,QAAQ;IACrB,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC;AAED,MAAM,WAAW,UAAU;IACvB,WAAW,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,OAAO,CAAC;QACrC,cAAc,EAAE,MAAM,CAAA;QACtB,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAA;KACpD,CAAC,CAAA;IACF,WAAW,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC9C,cAAc,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,KAAK,OAAO,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC,CAAA;IAC/F,SAAS,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5C,iBAAiB,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACzE,gBAAgB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IACrC,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CAC5D;AAED,wBAAgB,WAAW,CAAC,QAAQ,SAAS,EAAE,EAAE,SAAS,EAAE,OAAO,SAAS,OAAO,EAC/E,OAAO,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,SAAS,KAAK,UAAU,cAA/D,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,YAAY,SAAS,KAAK,UAAU,CAGtF"}

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

@@ -0,0 +1,87 @@
+import { PoolConfig, QueryResult } from 'pg';
+import { AnalyticsJsonValue } from './analytics.js';
+export type AnalyticsFilterScalar = boolean | number | string;
+export type AnalyticsFilterValueType = 'boolean' | 'number' | 'string';
+export type AnalyticsFilterOperator = 'eq' | 'exists' | 'gt' | 'gte' | 'in' | 'lt' | 'lte';
+export interface AnalyticsFilter {
+    key: string;
+    type: AnalyticsFilterValueType;
+    operator: AnalyticsFilterOperator;
+    value?: AnalyticsFilterScalar;
+    values?: AnalyticsFilterScalar[];
+}
+export type AnalyticsMetric = {
+    operation: 'count';
+} | {
+    operation: 'rate';
+    filter: AnalyticsFilter;
+} | {
+    operation: 'average' | 'sum';
+    key: string;
+};
+export type AnalyticsTimeGranularity = 'hour' | 'day' | 'week' | 'month';
+export type AnalyticsQueryParameters = Readonly<Record<string, unknown>>;
+export interface TelescopeConversation {
+    conversationId: string;
+    medium: string;
+    agentId?: string;
+    region?: string;
+    phoneNumber?: string;
+    duration?: number;
+    audioUrl?: string;
+    createdAt: number;
+    endedAt?: number;
+    analytics: Record<string, AnalyticsJsonValue>;
+}
+export interface TelescopeConversationPage {
+    limit: number;
+    items: TelescopeConversation[];
+    lastConversationId?: string;
+}
+export interface AnalyticsFieldValue {
+    value: AnalyticsFilterScalar;
+    count: number;
+}
+export interface AnalyticsField {
+    key: string;
+    type: AnalyticsFilterValueType;
+    variantCount: number;
+    values: AnalyticsFieldValue[];
+}
+export interface AnalyticsFields {
+    items: AnalyticsField[];
+}
+export interface AnalyticsTimeSeriesItem {
+    startAt: string;
+    value: number | null;
+    numerator?: number;
+    denominator?: number;
+}
+export interface AnalyticsTimeSeries {
+    metric: AnalyticsMetric;
+    granularity: AnalyticsTimeGranularity;
+    from: string;
+    to: string;
+    items: AnalyticsTimeSeriesItem[];
+}
+interface Queryable {
+    query<TResult extends Record<string, unknown> = Record<string, unknown>>(text: string, values?: unknown[]): Promise<QueryResult<TResult>>;
+}
+export declare class AnalyticsQueryError extends Error {
+    name: string;
+}
+export declare class PostgresAnalyticsQueryService {
+    private readonly database;
+    constructor(database: Queryable);
+    getConversation(conversationId: string): Promise<TelescopeConversation | undefined>;
+    getConversations(query: AnalyticsQueryParameters): Promise<TelescopeConversationPage>;
+    getAnalyticsFields(query: AnalyticsQueryParameters): Promise<AnalyticsFields>;
+    getTimeSeries(query: AnalyticsQueryParameters): Promise<AnalyticsTimeSeries>;
+}
+export interface PostgresAnalyticsQueryServices {
+    queries: PostgresAnalyticsQueryService;
+    close(): Promise<void>;
+}
+export declare function createPostgresAnalyticsQueryServices(config: PoolConfig): PostgresAnalyticsQueryServices;
+export {};
+//# sourceMappingURL=postgres-analytics-query.d.ts.map

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

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

package/build/postgres-analytics-query.js

@@ -0,0 +1,382 @@
+import { Pool } from 'pg';
+export class AnalyticsQueryError extends Error {
+    name = 'AnalyticsQueryError';
+}
+export 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.duration_seconds, c.analytics,
+                    p.phone_number, p.recording_url
+             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 ? 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.duration_seconds, c.analytics,
+                    p.phone_number, p.recording_url
+             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 values = [];
+        let where = "WHERE jsonb_typeof(entry.value) IN ('boolean', 'number', 'string')";
+        const agentId = optionalString(query.agentId, 'agentId');
+        if (agentId) {
+            values.push(agentId);
+            where += ` AND c.agent_id = $${values.length}`;
+        }
+        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),
+                    }
+                    : {}),
+            })),
+        };
+    }
+}
+export function createPostgresAnalyticsQueryServices(config) {
+    const pool = new 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 || undefined,
+        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: row.analytics ?? {},
+    };
+}
+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 = optionalString(query.agentId, 'agentId');
+    const region = optionalString(query.region, 'region');
+    const channel = optionalString(query.channel, 'channel');
+    const phoneNumber = optionalString(query.phoneNumber, 'phoneNumber');
+    if (agentId)
+        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(`c.duration_seconds >= ${bind(minDuration)}`);
+    if (maxDuration !== undefined)
+        conditions.push(`c.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-query.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=postgres-analytics-query.spec.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-analytics-query.spec.d.ts","sourceRoot":"","sources":["../src/postgres-analytics-query.spec.ts"],"names":[],"mappings":""}

package/build/postgres-analytics-query.spec.js

@@ -0,0 +1,223 @@
+import { describe, expect, it, vi } from 'vitest';
+import { AnalyticsQueryError, PostgresAnalyticsQueryService } from './postgres-analytics-query.js';
+function result(rows = []) {
+    return { rows, rowCount: rows.length };
+}
+describe('PostgresAnalyticsQueryService', () => {
+    it('binds each analytics filter once', async () => {
+        const query = vi.fn().mockResolvedValue(result());
+        const service = new PostgresAnalyticsQueryService({ query });
+        await service.getConversations({
+            agentId: 'collection-en',
+            limit: '20',
+            filters: JSON.stringify([
+                {
+                    key: 'wandoo.disposition',
+                    type: 'string',
+                    operator: 'eq',
+                    value: 'PAID',
+                },
+            ]),
+        });
+        const [sql, values] = query.mock.calls[0];
+        expect(sql.match(/jsonb_build_object/g)).toHaveLength(1);
+        expect(values).toEqual(['collection-en', 'wandoo.disposition', '"PAID"', 21]);
+    });
+    it('ANDs a multiselect filter with the other analytics filters', async () => {
+        const query = vi.fn().mockResolvedValue(result());
+        const service = new PostgresAnalyticsQueryService({ query });
+        await service.getConversations({
+            filters: JSON.stringify([
+                {
+                    key: 'wandoo.escalated',
+                    type: 'boolean',
+                    operator: 'eq',
+                    value: true,
+                },
+                {
+                    key: 'wandoo.disposition',
+                    type: 'string',
+                    operator: 'in',
+                    values: ['PAID', 'DROPPED'],
+                },
+            ]),
+        });
+        const [sql, values] = query.mock.calls[0];
+        expect(sql).toContain('jsonb_build_object($1::text, $2::jsonb) AND');
+        expect(sql).toContain('(c.analytics @> jsonb_build_object($3::text, $4::jsonb) OR ' +
+            'c.analytics @> jsonb_build_object($3::text, $5::jsonb))');
+        expect(values).toEqual([
+            'wandoo.escalated',
+            'true',
+            'wandoo.disposition',
+            '"PAID"',
+            '"DROPPED"',
+            11,
+        ]);
+    });
+    it('uses the returned keyset cursor on the next page', async () => {
+        const firstStartedAt = new Date('2026-08-02T10:00:00Z');
+        const query = vi
+            .fn()
+            .mockResolvedValueOnce(result([
+            {
+                conversation_id: 'conversation-2',
+                channel: 'phone',
+                started_at: firstStartedAt,
+                analytics: {},
+            },
+            {
+                conversation_id: 'conversation-1',
+                channel: 'phone',
+                started_at: new Date('2026-08-01T10:00:00Z'),
+                analytics: {},
+            },
+        ]))
+            .mockResolvedValueOnce(result());
+        const service = new PostgresAnalyticsQueryService({ query });
+        const firstPage = await service.getConversations({ limit: '1' });
+        expect(firstPage.lastConversationId).toBeTypeOf('string');
+        await service.getConversations({
+            limit: '1',
+            lastConversationId: firstPage.lastConversationId,
+        });
+        const [sql, values] = query.mock.calls[1];
+        expect(sql).toContain('(c.started_at, c.conversation_id) < ($1, $2)');
+        expect(values).toEqual([firstStartedAt, 'conversation-2', 2]);
+    });
+    it('rejects malformed filters without querying PostgreSQL', async () => {
+        const query = vi.fn();
+        const service = new PostgresAnalyticsQueryService({ query });
+        await expect(service.getConversations({
+            filters: JSON.stringify([
+                {
+                    key: 'wandoo.disposition',
+                    type: 'string',
+                    operator: 'gt',
+                    value: 'PAID',
+                },
+            ]),
+        })).rejects.toBeInstanceOf(AnalyticsQueryError);
+        expect(query).not.toHaveBeenCalled();
+    });
+    it('omits value counts for fields with more than 50 variants', async () => {
+        const query = vi.fn().mockResolvedValue(result([
+            {
+                key: 'wandoo.disposition',
+                type: 'string',
+                value: 'PAID',
+                occurrence_count: '3',
+                variant_count: 2,
+            },
+            {
+                key: 'wandoo.reference',
+                type: 'string',
+                value: 'first',
+                occurrence_count: '1',
+                variant_count: 51,
+            },
+        ]));
+        const service = new PostgresAnalyticsQueryService({ query });
+        await expect(service.getAnalyticsFields({ agentId: 'collection-en' })).resolves.toEqual({
+            items: [
+                {
+                    key: 'wandoo.disposition',
+                    type: 'string',
+                    variantCount: 2,
+                    values: [{ value: 'PAID', count: 3 }],
+                },
+                {
+                    key: 'wandoo.reference',
+                    type: 'string',
+                    variantCount: 51,
+                    values: [],
+                },
+            ],
+        });
+    });
+    it('returns a rate time series with numerator and denominator', async () => {
+        const query = vi.fn().mockResolvedValue(result([
+            {
+                bucket_start: new Date('2026-08-03T00:00:00Z'),
+                metric_value: '0.25',
+                numerator: '1',
+                denominator: '4',
+            },
+        ]));
+        const service = new PostgresAnalyticsQueryService({ query });
+        const metric = {
+            operation: 'rate',
+            filter: {
+                key: 'wandoo.escalated',
+                type: 'boolean',
+                operator: 'eq',
+                value: true,
+            },
+        };
+        await expect(service.getTimeSeries({
+            from: '2026-08-01T00:00:00Z',
+            to: '2026-09-01T00:00:00Z',
+            granularity: 'week',
+            metric: JSON.stringify(metric),
+        })).resolves.toEqual({
+            metric,
+            granularity: 'week',
+            from: '2026-08-01T00:00:00.000Z',
+            to: '2026-09-01T00:00:00.000Z',
+            items: [
+                {
+                    startAt: '2026-08-03T00:00:00.000Z',
+                    value: 0.25,
+                    numerator: 1,
+                    denominator: 4,
+                },
+            ],
+        });
+        const [sql] = query.mock.calls[0];
+        expect(sql).toContain("date_trunc($3::text, c.started_at, 'UTC')");
+    });
+    it.each([
+        ['average', 'AVG'],
+        ['sum', 'SUM'],
+    ])('builds the %s metric', async (operation, sqlFunction) => {
+        const query = vi.fn().mockResolvedValue(result());
+        const service = new PostgresAnalyticsQueryService({ query });
+        await service.getTimeSeries({
+            from: '2026-08-01T00:00:00Z',
+            to: '2026-09-01T00:00:00Z',
+            metric: JSON.stringify({ operation, key: 'wandoo.score' }),
+        });
+        const [sql, values] = query.mock.calls[0];
+        expect(sql).toContain(`${sqlFunction}(CASE WHEN jsonb_typeof`);
+        expect(values).toEqual([
+            new Date('2026-08-01T00:00:00Z'),
+            new Date('2026-09-01T00:00:00Z'),
+            'day',
+            'wandoo.score',
+        ]);
+    });
+    it('maps one PostgreSQL conversation to the Telescope response', async () => {
+        const query = vi.fn().mockResolvedValue(result([
+            {
+                conversation_id: 'conversation-1',
+                agent_id: 'collection-en',
+                channel: 'phone',
+                region: 'GB',
+                started_at: new Date('2026-08-01T10:00:00Z'),
+                ended_at: new Date('2026-08-01T10:02:00Z'),
+                duration_seconds: 120,
+                analytics: { 'wandoo.escalated': true },
+                phone_number: '+440000000000',
+                recording_url: 'https://example.test/recording.wav',
+            },
+        ]));
+        const service = new PostgresAnalyticsQueryService({ query });
+        await expect(service.getConversation('conversation-1')).resolves.toMatchObject({
+            conversationId: 'conversation-1',
+            medium: 'phone',
+            duration: 120,
+            analytics: { 'wandoo.escalated': true },
+            phoneNumber: '+440000000000',
+        });
+    });
+});

package/build/postgres-analytics.d.ts

@@ -1,5 +1,6 @@
 import { Pool, PoolConfig, QueryResult } from 'pg';
 import { Analytics, ConversationAnalytics } from './analytics.js';
+import { PostgresAnalyticsQueryService } from './postgres-analytics-query.js';
 export interface ConversationRecord {
     conversationId: string;
     agentId?: string;
@@ -34,6 +35,7 @@ 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>;

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

@@ -1 +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,SAAS,EAGT,qBAAqB,EAGxB,MAAM,gBAAgB,CAAA;AAEvB,MAAM,WAAW,kBAAkB;IAC/B,cAAc,EAAE,MAAM,CAAA;IACtB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,IAAI,CAAA;IACf,OAAO,CAAC,EAAE,IAAI,CAAA;IACd,eAAe,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED,MAAM,WAAW,eAAe;IAC5B,cAAc,EAAE,MAAM,CAAA;IACtB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,WAAW,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,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;AAYD,qBAAa,iBAAkB,YAAW,SAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,SAAS;IAEhD,wBAAwB,CAAC,cAAc,EAAE,MAAM,GAAG,qBAAqB;CA6E1E;AAQD,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;YAiBF,kBAAkB;YAkClB,eAAe;CAoBhC;AA+CD,wBAAsB,wBAAwB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAuCxE;AAED,MAAM,WAAW,yBAAyB;IACtC,SAAS,EAAE,iBAAiB,CAAA;IAC5B,aAAa,EAAE,8BAA8B,CAAA;IAC7C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACzB;AAED,wBAAsB,+BAA+B,CACjD,MAAM,EAAE,UAAU,GACnB,OAAO,CAAC,yBAAyB,CAAC,CAapC"}
+{"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,SAAS,EAGT,qBAAqB,EAGxB,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAE,6BAA6B,EAAE,MAAM,+BAA+B,CAAA;AAI7E,MAAM,WAAW,kBAAkB;IAC/B,cAAc,EAAE,MAAM,CAAA;IACtB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,IAAI,CAAA;IACf,OAAO,CAAC,EAAE,IAAI,CAAA;IACd,eAAe,CAAC,EAAE,MAAM,CAAA;CAC3B;AAID,MAAM,WAAW,eAAe;IAC5B,cAAc,EAAE,MAAM,CAAA;IACtB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,WAAW,CAAC,EAAE,MAAM,CAAA;CACvB;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;AAgBD,qBAAa,iBAAkB,YAAW,SAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,SAAS;IAIhD,wBAAwB,CAAC,cAAc,EAAE,MAAM,GAAG,qBAAqB;CAqF1E;AAYD,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;YAoClB,eAAe;CAsBhC;AA4DD,wBAAsB,wBAAwB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CA2CxE;AAID,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"}

package/build/postgres-analytics.js

@@ -1,5 +1,6 @@
 import { Pool } from 'pg';
 import { assertAnalyticsJsonValue, } from './analytics.js';
+import { PostgresAnalyticsQueryService } from './postgres-analytics-query.js';
 export class PostgresAnalytics {
     database;
     constructor(database) {
@@ -142,6 +143,8 @@ const migrations = [
     {
         version: 1,
         sql: `
+            -- Analytics rationale: This is the channel-neutral parent row and top-level JSONB map.
+            -- Removing it leaves typed values with no lifecycle or common dimensions to attach to.
             CREATE TABLE conversations (
                 conversation_id text PRIMARY KEY,
                 agent_id text,
@@ -159,6 +162,8 @@ const migrations = [
                 updated_at timestamptz NOT NULL DEFAULT now()
             );
 
+            -- Analytics rationale: Phone-only data stays in a one-to-one child so text conversations
+            -- do not acquire call-specific columns or assumptions.
             CREATE TABLE phone_calls (
                 conversation_id text PRIMARY KEY REFERENCES conversations(conversation_id)
                     ON DELETE CASCADE,
@@ -167,6 +172,8 @@ const migrations = [
                 ended_reason text
             );
 
+            -- Analytics rationale: These indexes cover time-ordered listing and its common equality
+            -- filters; without them dashboards and Telescope lists degrade to full table scans.
             CREATE INDEX conversations_started_at_idx
                 ON conversations (started_at DESC, conversation_id DESC);
             CREATE INDEX conversations_agent_started_at_idx
@@ -175,6 +182,9 @@ const migrations = [
                 ON conversations (region, started_at DESC, conversation_id DESC);
             CREATE INDEX conversations_channel_started_at_idx
                 ON conversations (channel, started_at DESC, conversation_id DESC);
+
+            -- Analytics rationale: GIN accelerates JSONB containment filters while the phone index
+            -- supports exact caller lookups joined through the conversation ID.
             CREATE INDEX conversations_analytics_idx
                 ON conversations USING gin (analytics);
             CREATE INDEX phone_calls_phone_number_idx
@@ -228,6 +238,7 @@ export async function createPostgresAnalyticsServices(config) {
     return {
         analytics: new PostgresAnalytics(pool),
         conversations: new PostgresConversationRepository(pool),
+        queries: new PostgresAnalyticsQueryService(pool),
         close: () => pool.end(),
     };
 }

package/build/timeouts-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"timeouts-manager.d.ts","sourceRoot":"","sources":["../src/timeouts-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA;AAE7C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAKjD,MAAM,MAAM,aAAa,GAAG;IACxB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACnC,CAAA;AAKD,KAAK,kBAAkB,GAAG;IACtB,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAC,OAAO,CAAA;CACxB,CAAA;AAED,qBAAa,cAAc;IAOnB,QAAQ,CAAC,aAAa,EAAE,YAAY,CAAC,aAAa,CAAC;IACnD,QAAQ,CAAC,MAAM,EAAE,MAAM;IAEvB,OAAO,CAAC,SAAS;IANrB,QAAQ,CAAC,mBAAmB,kDAAwD;gBAGvE,aAAa,EAAE,YAAY,CAAC,aAAa,CAAC,EAC1C,MAAM,EAAE,MAAM,EAEf,SAAS,UAAQ;IAQ7B,gBAAgB,CAAC,MAAM,EAAE,MAAM;IAYzB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAWlE,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;IA4B7D,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,MAAM;IAmEvF,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAYxD"}
+{"version":3,"file":"timeouts-manager.d.ts","sourceRoot":"","sources":["../src/timeouts-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA;AAI7C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAKjD,MAAM,MAAM,aAAa,GAAG;IACxB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACnC,CAAA;AAKD,KAAK,kBAAkB,GAAG;IACtB,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAC,OAAO,CAAA;CACxB,CAAA;AAED,qBAAa,cAAc;IAOnB,QAAQ,CAAC,aAAa,EAAE,YAAY,CAAC,aAAa,CAAC;IACnD,QAAQ,CAAC,MAAM,EAAE,MAAM;IAEvB,OAAO,CAAC,SAAS;IANrB,QAAQ,CAAC,mBAAmB,kDAAwD;gBAGvE,aAAa,EAAE,YAAY,CAAC,aAAa,CAAC,EAC1C,MAAM,EAAE,MAAM,EAEf,SAAS,UAAQ;IAQ7B,gBAAgB,CAAC,MAAM,EAAE,MAAM;IAYzB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAWlE,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;IA4B7D,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,MAAM;IAmEvF,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAYxD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@recombine-ai/platform",
-  "version": "0.2.6-test.2",
+  "version": "0.2.6-test.4",
   "description": "Recombine AI: voice agent platform",
   "license": "EULA",
   "author": "recombine.ai",
@@ -17,6 +17,7 @@
   "dependencies": {
     "@recombine-ai/engine": "1.0.0",
     "@recombine-ai/telescope": "0.2.0",
+    "@types/pg": "8.15.5",
     "pg": "8.16.3",
     "redis": "5.11.0",
     "zod": "^4.4.3"
@@ -32,7 +33,6 @@
     "registry": "https://registry.npmjs.org"
   },
   "devDependencies": {
-    "@types/node": "^25.2.3",
-    "@types/pg": "8.15.5"
+    "@types/node": "^25.2.3"
   }
 }