@open-mercato/shared 0.7.1-develop.7175.1.d49ab48ee2 → 0.7.1-develop.7177.1.9827d081d4

package/.turbo/turbo-build.log

@@ -1,2 +1,2 @@
-[build:shared] found 278 entry points
+[build:shared] found 281 entry points
 [build:shared] built successfully

package/dist/lib/version.js

@@ -1,4 +1,4 @@
-const APP_VERSION = "0.7.1-develop.7175.1.d49ab48ee2";
+const APP_VERSION = "0.7.1-develop.7177.1.9827d081d4";
 const appVersion = APP_VERSION;
 export {
   APP_VERSION,

package/dist/lib/version.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/lib/version.ts"],
-  "sourcesContent": ["// Build-time generated version\nexport const APP_VERSION = '0.7.1-develop.7175.1.d49ab48ee2';\nexport const appVersion = APP_VERSION;\n"],
+  "sourcesContent": ["// Build-time generated version\nexport const APP_VERSION = '0.7.1-develop.7177.1.9827d081d4';\nexport const appVersion = APP_VERSION;\n"],
   "mappings": "AACO,MAAM,cAAc;AACpB,MAAM,aAAa;",
   "names": []
 }

package/dist/modules/phone_calls/index.js

@@ -0,0 +1,3 @@
+export * from "./types.js";
+export * from "./provider.js";
+//# sourceMappingURL=index.js.map

package/dist/modules/phone_calls/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/modules/phone_calls/index.ts"],
+  "sourcesContent": ["export * from './types'\nexport * from './provider'\n"],
+  "mappings": "AAAA,cAAc;AACd,cAAc;",
+  "names": []
+}

package/dist/modules/phone_calls/provider.js

@@ -0,0 +1,35 @@
+const PROVIDER_REGISTRY_KEY = "__openMercatoPhoneCallProviders__";
+function getRegistry() {
+  const globalState = globalThis;
+  if (!globalState[PROVIDER_REGISTRY_KEY]) {
+    globalState[PROVIDER_REGISTRY_KEY] = /* @__PURE__ */ new Map();
+  }
+  return globalState[PROVIDER_REGISTRY_KEY];
+}
+function registerPhoneCallProvider(adapter) {
+  const registry = getRegistry();
+  registry.set(adapter.providerKey, adapter);
+  return () => {
+    if (registry.get(adapter.providerKey) === adapter) {
+      registry.delete(adapter.providerKey);
+    }
+  };
+}
+function getPhoneCallProvider(providerKey) {
+  return getRegistry().get(providerKey);
+}
+function listPhoneCallProviders() {
+  return Array.from(getRegistry().values()).sort(
+    (left, right) => left.displayName.localeCompare(right.displayName)
+  );
+}
+function clearPhoneCallProviders() {
+  getRegistry().clear();
+}
+export {
+  clearPhoneCallProviders,
+  getPhoneCallProvider,
+  listPhoneCallProviders,
+  registerPhoneCallProvider
+};
+//# sourceMappingURL=provider.js.map

package/dist/modules/phone_calls/provider.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/modules/phone_calls/provider.ts"],
+  "sourcesContent": ["import type {\n  FetchPhoneCallsInput,\n  NormalizedPhoneCallBatch,\n  ProviderValidationResult,\n  ValidatePhoneCallProviderInput,\n} from './types'\n\nexport interface PhoneCallProviderAdapter {\n  readonly providerKey: string\n  readonly displayName: string\n\n  validateConnection(input: ValidatePhoneCallProviderInput): Promise<ProviderValidationResult>\n  fetchCalls(input: FetchPhoneCallsInput): Promise<NormalizedPhoneCallBatch>\n}\n\nconst PROVIDER_REGISTRY_KEY = '__openMercatoPhoneCallProviders__'\n\nfunction getRegistry(): Map<string, PhoneCallProviderAdapter> {\n  const globalState = globalThis as typeof globalThis & {\n    [PROVIDER_REGISTRY_KEY]?: Map<string, PhoneCallProviderAdapter>\n  }\n  if (!globalState[PROVIDER_REGISTRY_KEY]) {\n    globalState[PROVIDER_REGISTRY_KEY] = new Map<string, PhoneCallProviderAdapter>()\n  }\n  return globalState[PROVIDER_REGISTRY_KEY]\n}\n\nexport function registerPhoneCallProvider(adapter: PhoneCallProviderAdapter): () => void {\n  const registry = getRegistry()\n  registry.set(adapter.providerKey, adapter)\n  return () => {\n    if (registry.get(adapter.providerKey) === adapter) {\n      registry.delete(adapter.providerKey)\n    }\n  }\n}\n\nexport function getPhoneCallProvider(providerKey: string): PhoneCallProviderAdapter | undefined {\n  return getRegistry().get(providerKey)\n}\n\nexport function listPhoneCallProviders(): PhoneCallProviderAdapter[] {\n  return Array.from(getRegistry().values()).sort((left, right) =>\n    left.displayName.localeCompare(right.displayName),\n  )\n}\n\nexport function clearPhoneCallProviders(): void {\n  getRegistry().clear()\n}\n"],
+  "mappings": "AAeA,MAAM,wBAAwB;AAE9B,SAAS,cAAqD;AAC5D,QAAM,cAAc;AAGpB,MAAI,CAAC,YAAY,qBAAqB,GAAG;AACvC,gBAAY,qBAAqB,IAAI,oBAAI,IAAsC;AAAA,EACjF;AACA,SAAO,YAAY,qBAAqB;AAC1C;AAEO,SAAS,0BAA0B,SAA+C;AACvF,QAAM,WAAW,YAAY;AAC7B,WAAS,IAAI,QAAQ,aAAa,OAAO;AACzC,SAAO,MAAM;AACX,QAAI,SAAS,IAAI,QAAQ,WAAW,MAAM,SAAS;AACjD,eAAS,OAAO,QAAQ,WAAW;AAAA,IACrC;AAAA,EACF;AACF;AAEO,SAAS,qBAAqB,aAA2D;AAC9F,SAAO,YAAY,EAAE,IAAI,WAAW;AACtC;AAEO,SAAS,yBAAqD;AACnE,SAAO,MAAM,KAAK,YAAY,EAAE,OAAO,CAAC,EAAE;AAAA,IAAK,CAAC,MAAM,UACpD,KAAK,YAAY,cAAc,MAAM,WAAW;AAAA,EAClD;AACF;AAEO,SAAS,0BAAgC;AAC9C,cAAY,EAAE,MAAM;AACtB;",
+  "names": []
+}

package/dist/modules/phone_calls/types.js

@@ -0,0 +1,5 @@
+const PHONE_CALL_RESOURCE_KIND = "phone_calls.phone_call";
+export {
+  PHONE_CALL_RESOURCE_KIND
+};
+//# sourceMappingURL=types.js.map

package/dist/modules/phone_calls/types.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/modules/phone_calls/types.ts"],
+  "sourcesContent": ["export type PhoneCallDirection = 'inbound' | 'outbound' | 'internal' | 'unknown'\n\nexport type PhoneCallStatus =\n  | 'new'\n  | 'ringing'\n  | 'answered'\n  | 'missed'\n  | 'failed'\n  | 'completed'\n  | 'unknown'\n\nexport type PhoneCallParticipantRole = 'caller' | 'callee' | 'agent' | 'unknown'\n\nexport interface NormalizedPhoneCallParticipant {\n  role: PhoneCallParticipantRole\n  providerParticipantId?: string | null\n  phoneNumber?: string | null\n  displayName?: string | null\n  email?: string | null\n  metadata?: Record<string, unknown>\n}\n\nexport interface NormalizedPhoneCallRecording {\n  url?: string | null\n  providerRecordingId?: string | null\n  mimeType?: string | null\n  durationSeconds?: number | null\n  metadata?: Record<string, unknown>\n}\n\nexport interface NormalizedPhoneCall {\n  externalCallId: string\n  externalConversationId?: string | null\n  direction: PhoneCallDirection\n  status: PhoneCallStatus\n  participants: NormalizedPhoneCallParticipant[]\n  recording?: NormalizedPhoneCallRecording | null\n  startedAt?: Date | null\n  answeredAt?: Date | null\n  endedAt?: Date | null\n  durationSeconds?: number | null\n  providerFacts?: Record<string, unknown>\n  rawPayload: Record<string, unknown>\n}\n\nexport interface PhoneCallProviderScope {\n  tenantId: string\n  organizationId: string\n}\n\n// Declared here rather than next to the ingest command so client surfaces can read it without\n// pulling the command module (and MikroORM with it) into the browser bundle.\nexport const PHONE_CALL_RESOURCE_KIND = 'phone_calls.phone_call'\n\nexport type PhoneCallProviderCredentials = Record<string, unknown>\n\nexport interface ValidatePhoneCallProviderInput {\n  credentials: PhoneCallProviderCredentials\n  scope: PhoneCallProviderScope\n  integrationId?: string | null\n}\n\nexport interface ProviderValidationResult {\n  ok: boolean\n  message?: string\n  details?: Record<string, unknown>\n}\n\nexport interface FetchPhoneCallsInput {\n  credentials: PhoneCallProviderCredentials\n  scope: PhoneCallProviderScope\n  integrationId?: string | null\n  from?: Date | null\n  to?: Date | null\n  cursor?: string | null\n  limit?: number | null\n}\n\n/**\n * Why a provider stopped walking its pages before the range was exhausted. Without this an\n * adapter that gave up on a broken response is indistinguishable from one that reached the\n * end, and the caller reports a partial sweep as a complete one.\n */\nexport type PhoneCallBatchAnomaly = 'page_not_echoed' | 'invalid_page_count' | 'empty_page'\n\nexport interface NormalizedPhoneCallBatch {\n  calls: NormalizedPhoneCall[]\n  nextCursor?: string | null\n  /** Present only when the walk stopped on a response the adapter could not trust. */\n  anomaly?: PhoneCallBatchAnomaly | null\n  /** The cursor the anomalous page was requested with, so a retry can resume from it. */\n  anomalyCursor?: string | null\n}\n"],
+  "mappings": "AAoDO,MAAM,2BAA2B;",
+  "names": []
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-mercato/shared",
-  "version": "0.7.1-develop.7175.1.d49ab48ee2",
+  "version": "0.7.1-develop.7177.1.9827d081d4",
   "license": "MIT",
   "type": "module",
   "main": "./dist/index.js",
@@ -113,7 +113,7 @@
     "@mikro-orm/core": "^7.1.14",
     "@mikro-orm/decorators": "^7.1.14",
     "@mikro-orm/postgresql": "^7.1.14",
-    "@open-mercato/cache": "0.7.1-develop.7175.1.d49ab48ee2",
+    "@open-mercato/cache": "0.7.1-develop.7177.1.9827d081d4",
     "@types/html-to-text": "^9.0.4",
     "@types/sanitize-html": "^2.16.1",
     "dotenv": "^17.4.2",

package/src/modules/phone_calls/__tests__/provider.test.ts

@@ -0,0 +1,67 @@
+import {
+  clearPhoneCallProviders,
+  getPhoneCallProvider,
+  listPhoneCallProviders,
+  registerPhoneCallProvider,
+  type PhoneCallProviderAdapter,
+} from '../provider'
+
+function adapter(providerKey: string, displayName: string): PhoneCallProviderAdapter {
+  return {
+    providerKey,
+    displayName,
+    validateConnection: async () => ({ ok: true }),
+    fetchCalls: async () => ({ calls: [], hasMore: false, nextCursor: null }),
+  }
+}
+
+describe('phone call provider registration', () => {
+  beforeEach(() => {
+    clearPhoneCallProviders()
+  })
+
+  it('resolves a registered adapter by its provider key', () => {
+    const tillio = adapter('tillio', 'Tillio')
+    registerPhoneCallProvider(tillio)
+
+    expect(getPhoneCallProvider('tillio')).toBe(tillio)
+    expect(getPhoneCallProvider('absent')).toBeUndefined()
+  })
+
+  it('keeps one entry per provider key when a second adapter claims it', () => {
+    registerPhoneCallProvider(adapter('tillio', 'Tillio'))
+    const replacement = adapter('tillio', 'Tillio v2')
+    registerPhoneCallProvider(replacement)
+
+    expect(getPhoneCallProvider('tillio')).toBe(replacement)
+    expect(listPhoneCallProviders()).toHaveLength(1)
+  })
+
+  it('lists adapters by display name rather than registration order', () => {
+    registerPhoneCallProvider(adapter('zeta', 'Zeta Telecom'))
+    registerPhoneCallProvider(adapter('alpha', 'Alpha Voice'))
+
+    expect(listPhoneCallProviders().map((entry) => entry.providerKey)).toEqual(['alpha', 'zeta'])
+  })
+
+  it('removes the adapter when its own disposer runs', () => {
+    const dispose = registerPhoneCallProvider(adapter('tillio', 'Tillio'))
+    dispose()
+
+    expect(getPhoneCallProvider('tillio')).toBeUndefined()
+    expect(listPhoneCallProviders()).toEqual([])
+  })
+
+  // A later registration takes the key from under the earlier disposer, which the caller
+  // may still hold. Deleting by key alone would let it unregister the adapter that
+  // replaced it.
+  it('ignores a disposer whose adapter was already replaced', () => {
+    const disposeFirst = registerPhoneCallProvider(adapter('tillio', 'Tillio'))
+    const replacement = adapter('tillio', 'Tillio v2')
+    registerPhoneCallProvider(replacement)
+
+    disposeFirst()
+
+    expect(getPhoneCallProvider('tillio')).toBe(replacement)
+  })
+})

package/src/modules/phone_calls/index.ts

@@ -0,0 +1,2 @@
+export * from './types'
+export * from './provider'

package/src/modules/phone_calls/provider.ts

@@ -0,0 +1,50 @@
+import type {
+  FetchPhoneCallsInput,
+  NormalizedPhoneCallBatch,
+  ProviderValidationResult,
+  ValidatePhoneCallProviderInput,
+} from './types'
+
+export interface PhoneCallProviderAdapter {
+  readonly providerKey: string
+  readonly displayName: string
+
+  validateConnection(input: ValidatePhoneCallProviderInput): Promise<ProviderValidationResult>
+  fetchCalls(input: FetchPhoneCallsInput): Promise<NormalizedPhoneCallBatch>
+}
+
+const PROVIDER_REGISTRY_KEY = '__openMercatoPhoneCallProviders__'
+
+function getRegistry(): Map<string, PhoneCallProviderAdapter> {
+  const globalState = globalThis as typeof globalThis & {
+    [PROVIDER_REGISTRY_KEY]?: Map<string, PhoneCallProviderAdapter>
+  }
+  if (!globalState[PROVIDER_REGISTRY_KEY]) {
+    globalState[PROVIDER_REGISTRY_KEY] = new Map<string, PhoneCallProviderAdapter>()
+  }
+  return globalState[PROVIDER_REGISTRY_KEY]
+}
+
+export function registerPhoneCallProvider(adapter: PhoneCallProviderAdapter): () => void {
+  const registry = getRegistry()
+  registry.set(adapter.providerKey, adapter)
+  return () => {
+    if (registry.get(adapter.providerKey) === adapter) {
+      registry.delete(adapter.providerKey)
+    }
+  }
+}
+
+export function getPhoneCallProvider(providerKey: string): PhoneCallProviderAdapter | undefined {
+  return getRegistry().get(providerKey)
+}
+
+export function listPhoneCallProviders(): PhoneCallProviderAdapter[] {
+  return Array.from(getRegistry().values()).sort((left, right) =>
+    left.displayName.localeCompare(right.displayName),
+  )
+}
+
+export function clearPhoneCallProviders(): void {
+  getRegistry().clear()
+}

package/src/modules/phone_calls/types.ts

@@ -0,0 +1,93 @@
+export type PhoneCallDirection = 'inbound' | 'outbound' | 'internal' | 'unknown'
+
+export type PhoneCallStatus =
+  | 'new'
+  | 'ringing'
+  | 'answered'
+  | 'missed'
+  | 'failed'
+  | 'completed'
+  | 'unknown'
+
+export type PhoneCallParticipantRole = 'caller' | 'callee' | 'agent' | 'unknown'
+
+export interface NormalizedPhoneCallParticipant {
+  role: PhoneCallParticipantRole
+  providerParticipantId?: string | null
+  phoneNumber?: string | null
+  displayName?: string | null
+  email?: string | null
+  metadata?: Record<string, unknown>
+}
+
+export interface NormalizedPhoneCallRecording {
+  url?: string | null
+  providerRecordingId?: string | null
+  mimeType?: string | null
+  durationSeconds?: number | null
+  metadata?: Record<string, unknown>
+}
+
+export interface NormalizedPhoneCall {
+  externalCallId: string
+  externalConversationId?: string | null
+  direction: PhoneCallDirection
+  status: PhoneCallStatus
+  participants: NormalizedPhoneCallParticipant[]
+  recording?: NormalizedPhoneCallRecording | null
+  startedAt?: Date | null
+  answeredAt?: Date | null
+  endedAt?: Date | null
+  durationSeconds?: number | null
+  providerFacts?: Record<string, unknown>
+  rawPayload: Record<string, unknown>
+}
+
+export interface PhoneCallProviderScope {
+  tenantId: string
+  organizationId: string
+}
+
+// Declared here rather than next to the ingest command so client surfaces can read it without
+// pulling the command module (and MikroORM with it) into the browser bundle.
+export const PHONE_CALL_RESOURCE_KIND = 'phone_calls.phone_call'
+
+export type PhoneCallProviderCredentials = Record<string, unknown>
+
+export interface ValidatePhoneCallProviderInput {
+  credentials: PhoneCallProviderCredentials
+  scope: PhoneCallProviderScope
+  integrationId?: string | null
+}
+
+export interface ProviderValidationResult {
+  ok: boolean
+  message?: string
+  details?: Record<string, unknown>
+}
+
+export interface FetchPhoneCallsInput {
+  credentials: PhoneCallProviderCredentials
+  scope: PhoneCallProviderScope
+  integrationId?: string | null
+  from?: Date | null
+  to?: Date | null
+  cursor?: string | null
+  limit?: number | null
+}
+
+/**
+ * Why a provider stopped walking its pages before the range was exhausted. Without this an
+ * adapter that gave up on a broken response is indistinguishable from one that reached the
+ * end, and the caller reports a partial sweep as a complete one.
+ */
+export type PhoneCallBatchAnomaly = 'page_not_echoed' | 'invalid_page_count' | 'empty_page'
+
+export interface NormalizedPhoneCallBatch {
+  calls: NormalizedPhoneCall[]
+  nextCursor?: string | null
+  /** Present only when the walk stopped on a response the adapter could not trust. */
+  anomaly?: PhoneCallBatchAnomaly | null
+  /** The cursor the anomalous page was requested with, so a retry can resume from it. */
+  anomalyCursor?: string | null
+}