@absolutejs/voice 0.0.22-beta.514 → 0.0.22-beta.515

package/dist/callerCRMLinker.d.ts

@@ -0,0 +1,29 @@
+import type { VoiceCallerIdentity } from "./callerMemory";
+import type { VoiceCRMContactSummary, VoiceCRMContract } from "./crmContract";
+export type VoiceCallerCRMLinkRecord = {
+    callerKey: string;
+    vendor: string;
+    contactId: string;
+    contact: VoiceCRMContactSummary;
+    resolvedAt: number;
+    source: "memory" | "phone-lookup" | "email-lookup" | "manual";
+};
+export type VoiceCallerCRMLinkCacheStore = {
+    get(key: string): Promise<VoiceCallerCRMLinkRecord | null> | VoiceCallerCRMLinkRecord | null;
+    put(record: VoiceCallerCRMLinkRecord): Promise<void> | void;
+    remove(key: string): Promise<boolean> | boolean;
+};
+export type CreateVoiceCallerCRMLinkerOptions = {
+    contract: VoiceCRMContract;
+    cache?: VoiceCallerCRMLinkCacheStore;
+    staleAfterMs?: number;
+    now?: () => number;
+};
+export declare const createInMemoryVoiceCallerCRMLinkCache: () => VoiceCallerCRMLinkCacheStore;
+export declare const createVoiceCallerCRMLinker: (options: CreateVoiceCallerCRMLinkerOptions) => {
+    associate: (identity: VoiceCallerIdentity, contact: VoiceCRMContactSummary) => Promise<VoiceCallerCRMLinkRecord>;
+    contract: VoiceCRMContract;
+    invalidate: (identity: VoiceCallerIdentity) => Promise<boolean>;
+    resolve: (identity: VoiceCallerIdentity) => Promise<VoiceCallerCRMLinkRecord | null>;
+};
+export type VoiceCallerCRMLinker = ReturnType<typeof createVoiceCallerCRMLinker>;

package/dist/crmCallLogger.d.ts

@@ -0,0 +1,37 @@
+import type { VoiceCRMContract } from "./crmContract";
+export type VoiceCRMCallLoggerInput = {
+    sessionId: string;
+    contactId?: string;
+    startedAt: number;
+    endedAt?: number;
+    durationSeconds?: number;
+    summary?: string;
+    disposition?: string;
+    recordingUrl?: string;
+    transcriptUrl?: string;
+    metadata?: Record<string, unknown>;
+};
+export type VoiceCRMCallLogResult = {
+    activityId: string;
+    vendor: string;
+    loggedAt: number;
+};
+export type VoiceCRMCallLogErrorPolicy = "throw" | "swallow" | "queue";
+export type CreateVoiceCRMCallLoggerOptions = {
+    contract: VoiceCRMContract;
+    errorPolicy?: VoiceCRMCallLogErrorPolicy;
+    onError?: (error: Error, input: VoiceCRMCallLoggerInput) => void | Promise<void>;
+    enqueueOnFailure?: (input: VoiceCRMCallLoggerInput) => Promise<void> | void;
+    now?: () => number;
+};
+export declare const createVoiceCRMCallLogger: (options: CreateVoiceCRMCallLoggerOptions) => {
+    contract: VoiceCRMContract;
+    logCallEnd: (input: VoiceCRMCallLoggerInput) => Promise<VoiceCRMCallLogResult | null>;
+    noteOnContact: (input: {
+        contactId: string;
+        body: string;
+    }) => Promise<{
+        noteId: string;
+    } | null>;
+};
+export type VoiceCRMCallLogger = ReturnType<typeof createVoiceCRMCallLogger>;

package/dist/crmContract.d.ts

@@ -0,0 +1,70 @@
+export type VoiceCRMContactSummary = {
+    id: string;
+    vendor?: string;
+    firstName?: string;
+    lastName?: string;
+    email?: string;
+    phone?: string;
+    jobTitle?: string;
+    metadata?: Record<string, unknown>;
+};
+export type VoiceCRMLeadInput = {
+    firstName?: string;
+    lastName?: string;
+    email?: string;
+    phone?: string;
+    company?: string;
+    jobTitle?: string;
+    source?: string;
+    notes?: string;
+    metadata?: Record<string, unknown>;
+};
+export type VoiceCRMCallActivityInput = {
+    contactId?: string;
+    sessionId: string;
+    startedAt: number;
+    endedAt: number;
+    durationSeconds: number;
+    summary?: string;
+    disposition?: string;
+    recordingUrl?: string;
+    transcriptUrl?: string;
+    metadata?: Record<string, unknown>;
+};
+export type VoiceCRMNoteInput = {
+    contactId: string;
+    body: string;
+    metadata?: Record<string, unknown>;
+};
+export type VoiceCRMTaskInput = {
+    contactId?: string;
+    subject: string;
+    description?: string;
+    dueAt?: number;
+    priority?: "low" | "normal" | "high";
+};
+export type VoiceCRMContract = {
+    readonly vendor: string;
+    lookupByPhone(phone: string): Promise<VoiceCRMContactSummary | null>;
+    lookupByEmail(email: string): Promise<VoiceCRMContactSummary | null>;
+    createLead(input: VoiceCRMLeadInput): Promise<VoiceCRMContactSummary>;
+    logCall(input: VoiceCRMCallActivityInput): Promise<{
+        activityId: string;
+    }>;
+    addNote(input: VoiceCRMNoteInput): Promise<{
+        noteId: string;
+    }>;
+    createTask?(input: VoiceCRMTaskInput): Promise<{
+        taskId: string;
+    }>;
+};
+export type VoiceCRMRegistry = {
+    default(): VoiceCRMContract | null;
+    get(vendor: string): VoiceCRMContract | null;
+    list(): VoiceCRMContract[];
+};
+export type CreateVoiceCRMRegistryOptions = {
+    contracts: VoiceCRMContract[];
+    defaultVendor?: string;
+};
+export declare const createVoiceCRMRegistry: (options: CreateVoiceCRMRegistryOptions) => VoiceCRMRegistry;

package/dist/index.d.ts

@@ -351,4 +351,10 @@ export { compileVoicePathwayToAssistant } from "./pathwayCompiler";
 export type { CompileVoicePathwayOptions, VoicePathwayCompiledAssistant, VoicePathwayCompilerToolDefinition, } from "./pathwayCompiler";
 export { renderVoicePathwayMermaid, renderVoicePathwayText, visualizeVoicePathway, } from "./pathwayVisualizer";
 export type { VoicePathwayVisualization } from "./pathwayVisualizer";
+export { createVoiceCRMRegistry } from "./crmContract";
+export type { CreateVoiceCRMRegistryOptions, VoiceCRMCallActivityInput, VoiceCRMContactSummary, VoiceCRMContract, VoiceCRMLeadInput, VoiceCRMNoteInput, VoiceCRMRegistry, VoiceCRMTaskInput, } from "./crmContract";
+export { createInMemoryVoiceCallerCRMLinkCache, createVoiceCallerCRMLinker, } from "./callerCRMLinker";
+export type { CreateVoiceCallerCRMLinkerOptions, VoiceCallerCRMLinkCacheStore, VoiceCallerCRMLinker, VoiceCallerCRMLinkRecord, } from "./callerCRMLinker";
+export { createVoiceCRMCallLogger } from "./crmCallLogger";
+export type { CreateVoiceCRMCallLoggerOptions, VoiceCRMCallLogErrorPolicy, VoiceCRMCallLogger, VoiceCRMCallLoggerInput, VoiceCRMCallLogResult, } from "./crmCallLogger";
 export * from "./types";

package/dist/index.js

@@ -51360,6 +51360,159 @@ var visualizeVoicePathway = (pathway) => ({
   mermaid: renderVoicePathwayMermaid(pathway),
   text: renderVoicePathwayText(pathway)
 });
+// src/crmContract.ts
+var createVoiceCRMRegistry = (options) => {
+  const byVendor = new Map;
+  for (const contract of options.contracts) {
+    byVendor.set(contract.vendor, contract);
+  }
+  const defaultVendor = options.defaultVendor ?? options.contracts[0]?.vendor ?? null;
+  return {
+    default() {
+      return defaultVendor ? byVendor.get(defaultVendor) ?? null : null;
+    },
+    get(vendor) {
+      return byVendor.get(vendor) ?? null;
+    },
+    list() {
+      return Array.from(byVendor.values());
+    }
+  };
+};
+// src/callerCRMLinker.ts
+var cacheKeyFor = (identity, vendor) => {
+  const id = identity.externalId ?? identity.phone ?? identity.email ?? "anonymous";
+  return `${vendor}::${id}`;
+};
+var createInMemoryVoiceCallerCRMLinkCache = () => {
+  const store = new Map;
+  return {
+    get: (key) => store.get(key) ?? null,
+    put: (record) => {
+      store.set(record.callerKey, { ...record });
+    },
+    remove: (key) => store.delete(key)
+  };
+};
+var createVoiceCallerCRMLinker = (options) => {
+  const now = options.now ?? (() => Date.now());
+  const cache = options.cache ?? createInMemoryVoiceCallerCRMLinkCache();
+  const staleAfter = options.staleAfterMs ?? 24 * 60 * 60 * 1000;
+  const isFresh = (record) => now() - record.resolvedAt < staleAfter;
+  const resolve3 = async (identity) => {
+    const key = cacheKeyFor(identity, options.contract.vendor);
+    const cached = await Promise.resolve(cache.get(key));
+    if (cached && isFresh(cached)) {
+      return cached;
+    }
+    let contact = null;
+    let source = null;
+    if (identity.phone) {
+      contact = await options.contract.lookupByPhone(identity.phone);
+      if (contact)
+        source = "phone-lookup";
+    }
+    if (!contact && identity.email) {
+      contact = await options.contract.lookupByEmail(identity.email);
+      if (contact)
+        source = "email-lookup";
+    }
+    if (!contact || !source)
+      return null;
+    const record = {
+      callerKey: key,
+      contact,
+      contactId: contact.id,
+      resolvedAt: now(),
+      source,
+      vendor: options.contract.vendor
+    };
+    await Promise.resolve(cache.put(record));
+    return record;
+  };
+  const associate = async (identity, contact) => {
+    const key = cacheKeyFor(identity, options.contract.vendor);
+    const record = {
+      callerKey: key,
+      contact,
+      contactId: contact.id,
+      resolvedAt: now(),
+      source: "manual",
+      vendor: options.contract.vendor
+    };
+    await Promise.resolve(cache.put(record));
+    return record;
+  };
+  const invalidate = async (identity) => {
+    const key = cacheKeyFor(identity, options.contract.vendor);
+    return Promise.resolve(cache.remove(key));
+  };
+  return {
+    associate,
+    contract: options.contract,
+    invalidate,
+    resolve: resolve3
+  };
+};
+// src/crmCallLogger.ts
+var createVoiceCRMCallLogger = (options) => {
+  const now = options.now ?? (() => Date.now());
+  const errorPolicy = options.errorPolicy ?? "swallow";
+  const logCallEnd = async (input) => {
+    const endedAt = input.endedAt ?? now();
+    const duration = input.durationSeconds ?? Math.max(0, Math.round((endedAt - input.startedAt) / 1000));
+    const payload = {
+      durationSeconds: duration,
+      endedAt,
+      sessionId: input.sessionId,
+      startedAt: input.startedAt,
+      ...input.contactId !== undefined ? { contactId: input.contactId } : {},
+      ...input.summary !== undefined ? { summary: input.summary } : {},
+      ...input.disposition !== undefined ? { disposition: input.disposition } : {},
+      ...input.recordingUrl !== undefined ? { recordingUrl: input.recordingUrl } : {},
+      ...input.transcriptUrl !== undefined ? { transcriptUrl: input.transcriptUrl } : {},
+      ...input.metadata !== undefined ? { metadata: input.metadata } : {}
+    };
+    try {
+      const result = await options.contract.logCall(payload);
+      return {
+        activityId: result.activityId,
+        loggedAt: now(),
+        vendor: options.contract.vendor
+      };
+    } catch (rawError) {
+      const error = rawError instanceof Error ? rawError : new Error(String(rawError));
+      await options.onError?.(error, input);
+      if (errorPolicy === "queue") {
+        await options.enqueueOnFailure?.(input);
+        return null;
+      }
+      if (errorPolicy === "throw")
+        throw error;
+      return null;
+    }
+  };
+  const noteOnContact = async (input) => {
+    try {
+      return await options.contract.addNote(input);
+    } catch (rawError) {
+      const error = rawError instanceof Error ? rawError : new Error(String(rawError));
+      await options.onError?.(error, {
+        sessionId: "(note)",
+        startedAt: now(),
+        ...input
+      });
+      if (errorPolicy === "throw")
+        throw error;
+      return null;
+    }
+  };
+  return {
+    contract: options.contract,
+    logCallEnd,
+    noteOnContact
+  };
+};
 export {
   writeVoiceProofPack,
   writeVoiceMediaPipelineArtifacts,
@@ -52031,6 +52184,7 @@ export {
   createVoiceCampaign,
   createVoiceCallingWindow,
   createVoiceCallerMemoryNamespace,
+  createVoiceCallerCRMLinker,
   createVoiceCallReviewRecorder,
   createVoiceCallReviewFromSession,
   createVoiceCallReviewFromLiveTelephonyReport,
@@ -52038,6 +52192,8 @@ export {
   createVoiceCallDispositionTagger,
   createVoiceCallDebuggerRoutes,
   createVoiceCallCompletedEvent,
+  createVoiceCRMRegistry,
+  createVoiceCRMCallLogger,
   createVoiceCRMActivitySink,
   createVoiceBrowserMediaRoutes,
   createVoiceBrowserCallProfileRoutes,
@@ -52098,6 +52254,7 @@ export {
   createLiveCallViewerFromOptions,
   createLiveCallViewer,
   createJSONVoiceAssistantModel,
+  createInMemoryVoiceCallerCRMLinkCache,
   createInMemoryVoiceCallQuota,
   createInMemoryDNCList,
   createId,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@absolutejs/voice",
-  "version": "0.0.22-beta.514",
+  "version": "0.0.22-beta.515",
   "description": "Voice primitives and Elysia plugin for AbsoluteJS",
   "repository": {
     "type": "git",