@app-connect/core 1.7.32 → 1.7.33

package/docs/connectors.md

@@ -94,7 +94,7 @@ The shared framework expects these methods most often:
 - `createContact()`
 - `findContactWithName()`
 - `unAuthorize()`
-- optional methods such as `getUserList()`, `getLicenseStatus()`, `upsertCallDisposition()`, `getServerLoggingSettings()`, `updateServerLoggingSettings()`, and `onUpdateUserSettings()`
+- optional methods such as `refreshUserInfo()`, `getUserList()`, `getLicenseStatus()`, `upsertCallDisposition()`, `getServerLoggingSettings()`, `updateServerLoggingSettings()`, and `onUpdateUserSettings()`
 
 ## API-Key Managed Auth Fields
 

package/docs/handlers.md

@@ -8,12 +8,11 @@ Handlers contain the shared business workflows behind the route layer.
 | --- | --- | --- |
 | `handlers/auth.js` | Connector login, OAuth callback handling, user persistence, and auth validation | `onOAuthCallback`, `onApiKeyLogin`, `authValidation`, `getLicenseStatus`, `onRingcentralOAuthCallback` |
 | `handlers/contact.js` | Contact search, creation, and account-data caching | `findContact`, `createContact`, `findContactWithName` |
-| `handlers/log.js` | Call logging, message logging, plugin execution, call-log lookup, and note cache writes | `createCallLog`, `updateCallLog`, `createMessageLog`, `getCallLog`, `saveNoteCache` |
+| `handlers/log.js` | Call logging, message logging, plugin execution, async plugin callbacks, call-log lookup, and note cache writes | `createCallLog`, `updateCallLog`, `createMessageLog`, `getCallLog`, `saveNoteCache`, `handleAsyncPluginCallback` |
 | `handlers/admin.js` | Admin settings, RingCentral reporting, server logging settings, and user mapping | `validateAdminRole`, `upsertAdminSettings`, `getAdminSettings`, `updateAdminRcTokens`, `getServerLoggingSettings`, `updateServerLoggingSettings`, `getAdminReport`, `getUserReport`, `getUserMapping`, `reinitializeUserMapping` |
-| `handlers/user.js` | User setting reads, admin/user setting merge, and updates | `getUserSettingsByAdmin`, `getUserSettings`, `updateUserSettings` |
+| `handlers/user.js` | User info refresh, user setting reads, admin/user setting merge, and updates | `refreshUserInfo`, `getUserSettingsByAdmin`, `getUserSettings`, `updateUserSettings` |
 | `handlers/disposition.js` | Call-disposition writes against an existing log | `upsertCallDisposition` |
 | `handlers/calldown.js` | User-owned call-down scheduling | `schedule`, `list`, `remove`, `markCalled`, `update` |
-| `handlers/plugin.js` | Async plugin task polling and cleanup | `getPluginAsyncTasks` |
 | `handlers/managedAuth.js` | Shared API-key auth field discovery, secure storage, and login-time field resolution | `getManagedAuthAdminSettings`, `getManagedAuthState`, `resolveApiKeyLoginFields`, `upsertOrgManagedAuthValues`, `upsertUserManagedAuthValues` |
 
 ## Common Execution Pattern
@@ -62,7 +61,9 @@ Key responsibilities:
 
 - prevents duplicate call-log creation by checking `CallLogModel` on `sessionId`
 - loads note cache from DynamoDB when `USE_CACHE` and server-side call logging are enabled
-- runs configured plugins before creating or updating logs
+- runs configured synchronous plugins before creating or updating logs
+- dispatches configured asynchronous call plugins after call-log create or update succeeds
+- handles async plugin callbacks by appending Agent notes on success or marking task cache as failed on failure
 - composes log body content with `composeCallLog()` or `composeSharedSMSLog()`
 - stores local mappings between telephony ids and CRM log ids
 - handles normal SMS, fax, group SMS, and shared SMS cases
@@ -72,7 +73,7 @@ Important persistence behavior:
 
 - `CallLogModel` stores the App Connect to CRM mapping for call logs
 - `MessageLogModel` stores the App Connect to CRM mapping for message logs
-- `CacheModel` stores async plugin task state
+- `CacheModel` stores async plugin callback tasks with a one-week expiry; successful callbacks delete the task and failed callbacks keep the task with status `failed`
 - `NoteCache` stores temporary notes keyed by session id
 
 ## `admin.js`
@@ -89,10 +90,11 @@ Key responsibilities:
 
 ## `user.js`
 
-This module is mainly about merging account-level policy with per-user preferences.
+This module handles user-owned workflows that do not belong to login, contact, or logging handlers.
 
 Rules implemented here:
 
+- `refreshUserInfo()` loads the current user, refreshes OAuth credentials when needed or builds API-key auth, then delegates to the connector's `refreshUserInfo({ user, authHeader, proxyConfig })`
 - if no admin settings exist, return user settings directly
 - admin settings can override or hide user settings
 - plugin settings merge at both the plugin level and nested config-field level
@@ -112,8 +114,9 @@ Rules implemented here:
 
 `plugin.js`:
 
-- returns cached async task status
-- deletes terminal task cache records after the client reads them
+- registers and unregisters account-level plugins
+- validates plugin registration against RingCentral account identity
+- reads plugin license status through the installed plugin profile
 
 `managedAuth.js`:
 

package/docs/libraries.md

@@ -96,6 +96,3 @@ Exports:
 - `secondsToHoursMinutesSeconds()`
 - `getMostRecentDate()`
 - `getMediaReaderLinkByPlatformMediaLink()`
-- `getPluginsFromUserSettings()`
-
-`getPluginsFromUserSettings()` is especially important because logging handlers use it to discover which plugins should run for call, SMS, or fax workflows.

package/docs/models.md

@@ -73,12 +73,12 @@ Stores temporary task state, mainly for async plugin work.
 
 | Field | Notes |
 | --- | --- |
-| `id` | Task id, commonly `{userId}-{uuid}` |
-| `status` | Task status such as `initialized`, `completed`, or `failed` |
+| `id` | Task id. Async plugin callback tasks use the UUID sent to the plugin as `asyncTaskId`. |
+| `status` | Task status such as `pending`, `initialized`, `completed`, or `failed` |
 | `userId` | Owning user |
-| `cacheKey` | Logical task family |
-| `data` | Optional task payload |
-| `expiry` | Cleanup cutoff |
+| `cacheKey` | Logical task family. Async plugin tasks use `asyncPluginTask-<pluginId>`. |
+| `data` | Optional task payload. Async plugin tasks keep callback URL, plugin id, call-log lookup fields, original plugin input, and failure `message` when a callback fails. |
+| `expiry` | Cleanup cutoff. Async plugin callback tasks expire after one week. |
 
 ### `models/accountDataModel.js`
 

package/docs/routes.md

@@ -58,6 +58,7 @@ This page documents the non-MCP HTTP routes defined in `index.js`.
 | Method | Path | Purpose |
 | --- | --- | --- |
 | `GET` | `/user/preloadSettings` | Loads settings used to bootstrap client-side configuration |
+| `POST` | `/user/refreshInfo` | Refreshes connector-owned CRM user information for the current user |
 | `GET` | `/user/settings` | Returns merged user and admin settings |
 | `POST` | `/user/settings` | Updates per-user settings, with connector hooks when present |
 
@@ -94,7 +95,10 @@ This page documents the non-MCP HTTP routes defined in `index.js`.
 | Method | Path | Purpose |
 | --- | --- | --- |
 | `GET` | `/debug/report/url` | Returns a presigned URL for error log upload |
-| `POST` | `/pluginAsyncTask` | Returns async plugin task status and cleans up finished task cache entries |
+| `POST` | `/plugin/async-callback/:taskId` | Receives async plugin completion callbacks for call-log tasks |
+| `POST` | `/plugin/register` | Registers an account-level plugin and stores returned plugin auth data |
+| `DELETE` | `/plugin/unregister` | Removes account-level plugin auth and settings |
+| `GET` | `/plugin/licenseStatus` | Reads license status for an installed plugin |
 
 ## Development-Only Mock Routes